LeoYeAI cr-commit-check
Code Review 流水线的第一道门控：Commit Message 合规校验子 Agent。
由 spec-driven-dev 的 code_review 阶段作为 Sub-Agent 调用，校验通过后才解锁门控二。
调用契约
输入（由 Orchestrator 注入上下文）
| 字段 | 类型 | 说明 |
|---|---|---|
us_id |
string | 用户故事 ID，如 US042 |
iter_id |
string | 当前迭代 ID，如 iter_003 |
git_log |
string | git log main..HEAD --pretty=full 的完整输出 |
tasks_json_path |
string | requirements/{us_id}/docs/tasks.json 路径，用于核对 task 列表完整性 |
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 — 解析 commit 列表
从 git_log 中提取本迭代全部 commit，按以下顺序校验每一条：
校验规则
| 规则 ID | 检查项 | 通过条件 | 失败影响 |
|---|---|---|---|
| CM-01 | Conventional Commits 格式 | 满足正则 ^(feat|fix|config|docs|test|refactor|perf|style|chore|build)(\(.+\))?: .+ |
FAIL |
| CM-02 | type 在允许列表内 | type ∈ feat|fix|config|docs|test|refactor|perf|style|chore|build |
FAIL |
| CM-03 | 每迭代仅一次 commit | commit 数量 = 1 | FAIL |
| CM-04 | scope 包含正确的 us_id/iter_id | scope 满足 #<us_id>/<iter_id> 格式，如 #US042/iter_003 |
FAIL |
| CM-05 | 描述中列出全部 task | 读取 tasks.json，验证每个 task id 都以 task-XX/描述 形式出现在 message 中 |
FAIL |
| CM-06 | 无 WIP / 临时提交 | message 不含 wip、temp、fixup!、squash!，且 message 非空 |
FAIL |
所有规则均为硬性规则：任意一条失败 → 整体裁决 FAIL。
Step 2 — 输出规则结果表
逐条输出结构化结果：
[cr-commit-check] CM-01 ✅ PASS
[cr-commit-check] CM-02 ✅ PASS
[cr-commit-check] CM-03 ❌ FAIL — 发现 2 条 commit，迭代只允许 1 条
[cr-commit-check] CM-04 ✅ PASS
[cr-commit-check] CM-05 ❌ FAIL — task-03 未出现在 commit message 中
[cr-commit-check] CM-06 ✅ PASS
Step 3 — 生成修复指引（仅 FAIL 时）
若裁决为 FAIL，输出可直接执行的修复命令，例如：
# 合并多余 commit 并修正 message
git rebase -i HEAD~2
# 或直接修正最后一条 commit
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 条 commit，应为 1 条" },
{ "id": "CM-04", "result": "PASS", "note": "" },
{ "id": "CM-05", "result": "FAIL", "note": "task-03 未在 message 中声明" },
{ "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
裁决规则
| 裁决 | 条件 | Orchestrator 行为 |
|---|---|---|
| PASS | 全部 6 条规则通过 | 继续调用 cr-code-gate |
| FAIL | 任意规则失败 | 终止流水线，返回修复指引，阻塞 release |
禁止行为
- 禁止对不符合规范的 commit 自动修正，只输出修复命令供人工确认执行。
- 禁止将
m/l的建议性问题升级为 FAIL。 - 禁止在
git_log为空时静默通过，应报告CM-03 FAIL（未找到任何 commit）。