用途:为 Git / GitHub 上的实现作业提供统一流程与操作规约,覆盖 Issue 起票、专用分支、实现、PR、合并的完整链路。除补丁式缺陷修复外,实现作业都按此流程进行;判断不清时按常规流程处理,不在默认分支上直接开工,也不省略 Issue、分支或 PR。跨公司、团队、领域的变更需在 Issue 与 PR 中写明影响范围、验证内容和剩余风险。
主要能力:规定 Issue 需写目的、背景、验收条件(用 - [ ] 任务列表)、影响范围与验证方针;分支命名为 <type>/<issue-number>-<short-kebab-summary>,type 取 feat、fix、refactor、docs、test、chore、ci、build;提交信息用 type: 说明,单仓库用 type(scope): 说明,scope 取顶层目录名或 monorepo 叶子包名,整体变更用 repo,隐藏目录带点号,不用斜杠分层。
使用方式:开始前执行 git status --short --branch 与 git fetch --prune,确认默认分支、当前分支和远程跟踪状态;提交前逐文件 git diff 确认作者,禁止 git add . 与 git add -A,不覆盖 committer,不写 Co-Authored-By;仅当全部改动均由代理完成时用 --author 标明代理类型,例如 git commit --author="Claude noreply@anthropic.com" -m "<message>"。PR 用 gh pr create --body 或 --body-file 显式写正文,合并用 gh pr merge <编号> --merge --subject "merge(scope): 说明" --body "",采用 merge commit,不用 squash。
限制:任何 Git 操作前先 fetch 并检查 ahead/behind/diverged,未经用户批准不执行 pull、rebase,不擅自删除本地分支;存在冲突、CI 失败、未解决评审或未确认同步状态时不合并;不绕过评审与 CI;合并后确认 Issue 是否自动关闭,否则手动关闭,未决事项保留为 pending 并留言。资料未提供具体平台支持范围、收费与价格信息。