Workbench が止まる8月17日までに、prompt tools API を手元のスクリプトへ移す

grep -rIn -E "experimental/(generate|improve|templatize)_prompt" \
  --include='*.{py,ts,tsx,js,mjs,sh,yml,yaml,json}' .

#!/usr/bin/env python3
"""具体値の入ったプロンプトを再利用可能なテンプレートへ変換する。"""
import argparse, json, re, sys
 
def templatize(prompt: str, values: dict[str, str]) -> tuple[str, list[str]]:
    # 長い値から先に置換する。短い値が長い値の一部を先に食うのを防ぐため。
    ordered = sorted(values.items(), key=lambda kv: len(kv[1]), reverse=True)
    template, used = prompt, []
    for name, value in ordered:
        if not value:
            continue
        if value not in template:
            print(f"warning: value for {name} not found in prompt: {value!r}", file=sys.stderr)
            continue
        template = template.replace(value, "{{" + name + "}}")
        used.append(name)
    return template, used
 
def fill(template: str, values: dict[str, str]) -> str:
    return re.sub(r"\{\{(\w+)\}\}", lambda m: values.get(m.group(1), m.group(0)), template)
 
def main() -> int:
    ap = argparse.ArgumentParser()
    ap.add_argument("prompt_file")
    ap.add_argument("values_file", help='JSON: {"VARIABLE_NAME": "プロンプト中の実際の文字列"}')
    args = ap.parse_args()
    prompt = open(args.prompt_file, encoding="utf-8").read()
    values = json.load(open(args.values_file, encoding="utf-8"))
 
    template, used = templatize(prompt, values)
    # 逆変換で元に戻らなければ、置換のどこかが壊れている
    if fill(template, values) != prompt:
        print("round-trip check failed: template does not restore the original", file=sys.stderr)
        return 1
    print(template)
    print(f"\n--- variables: {', '.join(used)} ---", file=sys.stderr)
    return 0
 
if __name__ == "__main__":
    raise SystemExit(main())

あなたはECサイトの問い合わせ対応担当です。
商品「ワイヤレスイヤホン Model A」について、配送が遅れているという問い合わせに、
丁寧な日本語で3文以内で返信してください。注文番号は ORD-20260814-0031 です。

{
  "PRODUCT_NAME": "ワイヤレスイヤホン Model A",
  "ISSUE": "配送が遅れている",
  "ORDER_ID": "ORD-20260814-0031",
  "MAX_SENTENCES": "3"
}

あなたはECサイトの問い合わせ対応担当です。
商品「{{PRODUCT_NAME}}」について、{{ISSUE}}という問い合わせに、
丁寧な日本語で{{MAX_SENTENCES}}文以内で返信してください。注文番号は {{ORDER_ID}} です。
 
--- variables: PRODUCT_NAME, ORDER_ID, ISSUE, MAX_SENTENCES ---

2026年3月の売上について、3文以内で要約してください。

2026年{{MAX_SENTENCES}}月の売上について、{{MAX_SENTENCES}}文以内で要約してください。

#!/usr/bin/env python3
"""プロンプトを Claude に推敲させる。improve_prompt の置き換え。"""
import argparse, json, os, urllib.error, urllib.request
 
ENDPOINT = "https://api.anthropic.com/v1/messages"
META_PROMPT = """あなたはプロンプトの推敲役です。渡されたプロンプトを、
次の観点だけを直して書き直してください。意味を変えないこと。
 
1. 指示の順序を「役割 → 入力 → 制約 → 出力形式」に並べ替える
2. 曖昧な語（適切に・いい感じに 等）を検証可能な条件に置き換える
3. 出力形式を明示する（形式の指定がない場合のみ追加する）
4. プレースホルダはそのまま残す
 
書き直したプロンプトだけを出力してください。前置きや説明は書かないでください。"""
 
def build_payload(prompt: str, model: str) -> dict:
    # temperature / top_p / top_k は入れない。既定値以外を指定すると
    # Opus 4.7 以降と Sonnet 5 では 400 が返る。
    return {
        "model": model,
        "max_tokens": 2000,
        "system": META_PROMPT,
        "messages": [{"role": "user", "content": prompt}],
    }
 
def call(payload: dict, api_key: str) -> str:
    req = urllib.request.Request(
        ENDPOINT,
        data=json.dumps(payload).encode("utf-8"),
        headers={
            "content-type": "application/json",
            "x-api-key": api_key,
            "anthropic-version": "2023-06-01",
        },
    )
    try:
        with urllib.request.urlopen(req, timeout=120) as res:
            body = json.load(res)
    except urllib.error.HTTPError as e:
        raise SystemExit(f"HTTP {e.code}: {e.read().decode('utf-8', 'replace')}")
    except urllib.error.URLError as e:
        raise SystemExit(f"network error: {e.reason}")
    return "".join(b.get("text", "") for b in body.get("content", []) if b.get("type") == "text")
 
def main() -> int:
    ap = argparse.ArgumentParser()
    ap.add_argument("prompt_file")
    ap.add_argument("--model", default="claude-sonnet-5")
    ap.add_argument("--dry-run", action="store_true", help="送信せずにリクエスト本文を表示する")
    args = ap.parse_args()
 
    prompt = open(args.prompt_file, encoding="utf-8").read().strip()
    payload = build_payload(prompt, args.model)
    if args.dry_run:
        print(json.dumps(payload, ensure_ascii=False, indent=2))
        return 0
 
    api_key = os.environ.get("ANTHROPIC_API_KEY")
    if not api_key:
        raise SystemExit("ANTHROPIC_API_KEY が設定されていません")
    print(call(payload, api_key))
    return 0
 
if __name__ == "__main__":
    raise SystemExit(main())

{
  "model": "claude-sonnet-5",
  "max_tokens": 2000,
  "system": "あなたはプロンプトの推敲役です。...",
  "messages": [
    {
      "role": "user",
      "content": "レビューをいい感じに要約して。"
    }
  ]
}