Gemini API の Managed Antigravity Agent で多言語リリースノートを生成する実装メモ

import subprocess
import json
 
def extract_commits(since_tag: str) -> list[dict]:
    """直近タグからの commit を Conventional Commits 風に分類して返す。"""
    # %s=件名, %b=本文 を区切り文字付きで取得
    fmt = "%s%x1f%b%x1e"
    raw = subprocess.run(
        ["git", "log", f"{since_tag}..HEAD", f"--pretty=format:{fmt}"],
        capture_output=True, text=True, check=True,
    ).stdout
 
    commits = []
    for entry in raw.split("\x1e"):
        entry = entry.strip()
        if not entry:
            continue
        subject, _, body = entry.partition("\x1f")
        # feat: / fix: / perf: などの prefix を type として拾う
        ctype = "other"
        if ":" in subject:
            head = subject.split(":", 1)[0].strip().lower()
            if head in {"feat", "fix", "perf", "refactor", "chore", "docs"}:
                ctype = head
        commits.append({"type": ctype, "subject": subject, "body": body.strip()})
    return commits
 
 
if __name__ == "__main__":
    items = extract_commits("v2.0.0")
    # ユーザーに見せたいのは feat / fix / perf だけ。chore/docs は除外する
    visible = [c for c in items if c["type"] in {"feat", "fix", "perf"}]
    print(json.dumps(visible, ensure_ascii=False, indent=2))

import os
import json
from google import genai
from google.genai import types
 
client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
 
# ストアごとの実用上の文字数上限（半角換算の目安）
STORE_LIMITS = {
    "app_store": 4000,   # 「このバージョンの新機能」
    "google_play": 500,  # 「最新情報」
}
TARGET_LOCALES = ["ja", "en", "zh-Hans", "ko", "es"]
 
SYSTEM = """あなたはモバイルアプリのリリースノートを書く編集者です。
渡された commit 要約をもとに、ユーザーに伝わる短いリリースノートを各言語で作成します。
- 機能追加・不具合修正・パフォーマンス改善を、開発用語ではなく利用者の言葉で書く
- アプリ名・バージョン番号・固有名詞は翻訳しない（原文のまま残す）
- 各ストアの文字数上限を必ず守る。超えそうなら情報を削って収める
出力は指定された JSON スキーマに厳密に従うこと。"""
 
def build_prompt(commits, store, locales, limit):
    return (
        f"# 対象ストア: {store}（上限 {limit} 文字）\n"
        f"# 対象言語: {', '.join(locales)}\n\n"
        f"# commit 要約\n{json.dumps(commits, ensure_ascii=False)}\n\n"
        "各言語のリリースノートを作り、文字数が上限以内に収まっているか自分で数えて確認してください。"
    )

def validate_length(text: str, limit: int) -> dict:
    """エージェントが呼び出す検証ツール。超過分を返す。"""
    n = len(text)
    return {"length": n, "limit": limit, "over_by": max(0, n - limit)}
 
length_tool = types.Tool(function_declarations=[
    types.FunctionDeclaration(
        name="validate_length",
        description="リリースノート1件の文字数が上限以内か検証する",
        parameters={
            "type": "object",
            "properties": {
                "text": {"type": "string"},
                "limit": {"type": "integer"},
            },
            "required": ["text", "limit"],
        },
    )
])
 
def generate_notes(commits, store):
    limit = STORE_LIMITS[store]
    prompt = build_prompt(commits, store, TARGET_LOCALES, limit)
    resp = client.models.generate_content(
        model="antigravity-preview-05-2026",
        contents=prompt,
        config=types.GenerateContentConfig(
            system_instruction=SYSTEM,
            tools=[length_tool],
            response_mime_type="application/json",
            temperature=0.4,
        ),
    )
    return json.loads(resp.text)

def verify(notes: dict, store: str) -> list[str]:
    """呼び出し側の最終ガード。問題があればメッセージのリストを返す。"""
    limit = STORE_LIMITS[store]
    problems = []
    for locale, text in notes.items():
        if locale not in TARGET_LOCALES:
            problems.append(f"想定外の言語: {locale}")
            continue
        if len(text) > limit:
            problems.append(f"{locale}: {len(text)}字 / 上限{limit}字（{len(text) - limit}字オーバー）")
        if not text.strip():
            problems.append(f"{locale}: 空のノート")
    return problems
 
 
for store in ("app_store", "google_play"):
    notes = generate_notes(visible, store)
    issues = verify(notes, store)
    if issues:
        print(f"⚠️ {store} に要修正:")
        for m in issues:
            print(f"  - {m}")
    else:
        print(f"✅ {store}: 全{len(notes)}言語が上限内")