SuperAPI AI 工具集

commit

编程与开发

查看项目

更新于 10-16 08:36

技能介绍

用途:在 Codex 中以技能方式完成 Git 暂存与提交,按 Conventional Commits 格式生成结构化提交信息;当改动涉及代码时,提交前需用户决定是否先做测试验证(默认先验证),仅在用户明确要求或传入 --push 时才推送。

主要能力:分析 git status/diff 与最近提交风格;暂存文件;检测文档影响文件并可触发 $docs-update 后重新暂存;提交前(只读)按每个暂存文件的上次作者生成 Reviewers 区块并排除提交作者;按暂存差异自底向上推导估算(story_points、man_days_ai、man_days_traditional),无估算产物时现场推导,生成/锁文件/纯文档改动不计分;提交信息采用 type(scope): subject,正文首行为 Estimate 行,随后为 purpose/kind、what changed、how it works 及 Reviewers 区块;提交后用 git status 与 git log 校验并复述评审人分配;若存在 .code-graph/,后台触发 $graph-build --scope=sync,不阻塞提交。

使用方式:在 Codex 中用 $commit 调用该技能。执行 git add/git commit 前先创建绕过标记:PROJ=$(git rev-parse --show-toplevel) && mkdir -p "$PROJ/tmp/claude-temp" && touch "$PROJ/tmp/claude-temp/.commit-skill-active";提交成功或失败后清理:rm -f "$(git rev-parse --show-toplevel)/tmp/claude-temp/.commit-skill-active"。常用命令包括 git status、git diff --cached、git diff、git log --oneline -5、git add . 或 git add <file-path>。传入 --push(或要求 commit and push)时经 git-manager 推送。

适用场景:需要在提交信息中保留可读上下文、估算和评审人归属的仓库;要求遵循 Conventional Commits 与分区域评审的项目。

限制与约束:禁止提交密钥、凭证或 .env;除非明确要求不使用 --amend 或 --no-verify;未要求时提交后停止、不自行推送;测试验证门禁不得由代理替用户选择跳过;若某必需步骤或工具在当前环境无法运行,应先停下来询问用户;技能依赖项目配置(如 docs/project-config.json、docs/project-reference 文档)与若干子技能($docs-update、$workflow-integration-test-green、$graph-build 等),这些在资料中仅被引用,未提供其完整内容,缺失或过期的上下文需按路由先运行 $project-init 等初始化步骤。官方收录页面未提供更多细节,暂未提供。