cr-commit-check
【Code Review 子 Agent · 门控一】校验本迭代所有 commit 是否符合 Conventional Commits 规范及项目可追溯性格式。输入 git log 片段和项目元数据，输出结构化校验报告并以 STATUS=OK|FAIL 结尾。由 spec-driven-dev 的 code_review 阶段自动调用，不建议单独触发。
Best for CI pipelinesWorks with GitHubLow risk
⌘source
- author
@LeoYeAI- language
- Python
★2kstars
306forks
May 6, 2026
✦overview.md
Key Features
- ·Validates commit messages against Conventional Commits
- ·Checks project traceability format
- ·Outputs structured compliance report
- ·Acts as first gate in code review pipeline
- ·Provides auto-generated fix commands
Use Cases
- →Enforce commit message standards in CI pipelines
- →Ensure traceability to tasks/user stories before merging
- →Automate pre-review compliance checks for pull requests
Best for
- ✓CI pipelines
- ✓multi-developer projects
- ✓spec-driven development workflows
Not ideal for
- !solo projects with no commit standards
- !one-off scripts
FAQs
name
cr-commit-check
description
【Code Review 子 Agent · 门控一】校验本迭代所有 commit 是否符合 Conventional Commits 规范及项目可追溯性格式。输入 git log 片段和项目元数据，输出结构化校验报告并以 STATUS=OK|FAIL 结尾。由 spec-driven-dev 的 code_review 阶段自动调用，不建议单独触发。
user-invocable:false
metadata:{"openclaw":{"emoji":"📝","requires":{"bins":["git"]},"calledBy":["spec-driven-dev"]}}
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 | 检查项 | 通过条件 | 失败影响 |
$install
1-click copynpx skills add LeoYeAI/openclaw-master-skills --skill cr-commit-checkSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
5/ 5
very highHighly actionable with clear, concrete steps that an agent can follow directly.