[Skill 名] cr-commit-check

cr-commit-check

コードレビューパイプラインの最初のゲート：コミットメッセージのコンプライアンス検証サブエージェントです。 spec-driven-dev の code_review フェーズによってサブエージェントとして呼び出され、検証が通過した後にのみゲート2が解除されます。

呼び出し規約

入力（Orchestrator がコンテキストを注入）

Orchestrator 呼び出し例（OpenCode Sub-Agent 形式）：

invoke_skill: cr-commit-check
with:
  us_id: "US042"
  iter_id: "iter_003"
  git_log: "<git log output>"
  tasks_json_path: "requirements/US042/docs/tasks.json"

出力（Orchestrator に書き戻す）

{
  "agent": "cr-commit-check",
  "verdict": "PASS | FAIL",
  "h_count": 0,
  "rules": [
    { "id": "CM-01", "result": "PASS | FAIL", "note": "…" }
  ],
  "fix_commands": ["git commit --amend", "git rebase -i HEAD~N"]
}

実行プロトコル

Step 0 — 起動チェックポイントの発行

[AGENT:cr-commit-check] START  us_id={us_id}  iter_id={iter_id}

Step 1 — コミットリストの解析

git_log からこのイテレーションのすべてのコミットを抽出し、以下の順序で各コミットを検証します。

検証ルール

すべてのルールは厳格なルールです：いずれか1つでも失敗した場合、全体的な裁定は FAIL となります。

Step 2 — ルール結果表の出力

構造化された結果を1つずつ出力します：

[cr-commit-check] CM-01  ✅ PASS
[cr-commit-check] CM-02  ✅ PASS
[cr-commit-check] CM-03  ❌ FAIL  — 2件のコミットが検出されましたが、イテレーションでは1件のみ許可されています
[cr-commit-check] CM-04  ✅ PASS
[cr-commit-check] CM-05  ❌ FAIL  — task-03 がコミットメッセージに現れていません
[cr-commit-check] CM-06  ✅ PASS

Step 3 — 修正ガイドの生成（FAIL 時のみ）

裁定が FAIL の場合、直接実行可能な修正コマンドを出力します。例：

# 余分なコミットをマージし、メッセージを修正する
git rebase -i HEAD~2
# または最後のコミットを直接修正する
git commit --amend -m "feat(#US042/iter_003): task-01/login flow, task-02/jwt, task-03/tests"

Step 4 — 構造化された結果の返却

{
  "agent": "cr-commit-check",
  "verdict": "FAIL",
  "h_count": 2,
  "rules": [
    { "id": "CM-01", "result": "PASS", "note": "" },
    { "id": "CM-02", "result": "PASS", "note": "" },
    { "id": "CM-03", "result": "FAIL", "note": "2件のコミットが検出されましたが、1件であるべきです" },
    { "id": "CM-04", "result": "PASS", "note": "" },
    { "id": "CM-05", "result": "FAIL", "note": "task-03 がメッセージで宣言されていません" },
    { "id": "CM-06", "result": "PASS", "note": "" }
  ],
  "fix_commands": [
    "git rebase -i HEAD~2",
    "git commit --amend -m 'feat(#US042/iter_003): task-01/…, task-02/…, task-03/…'"
  ]
}

Step 5 — 終了チェックポイントの発行

[AGENT:cr-commit-check] DONE  verdict=PASS|FAIL  h_count=N

裁定ルール

禁止行為

• 規範に合致しないコミットを自動修正することは禁止します。修正コマンドのみを出力し、手動での確認と実行を促します。
• m/l の推奨事項を FAIL に格上げすることは禁止します。
• git_log が空の場合にサイレントに通過させることは禁止します。CM-03 FAIL（コミットが見つかりませんでした） を報告すべきです。