用途:为 AI(尤其 Claude)在执行期间提供一份精简、省 token 的 Git 操作参考,规范提交与 PR 流程。
主要能力:
- 暂存与安全扫描:暂存文件后查看 diff 统计,并扫描 api_key、token、password、secret、credential 等敏感信息;若发现密钥则停止、展示匹配内容并阻止提交。
- 拆分判断:混合类型(如 feat+fix)、超过 10 个不相关文件、或跨多个范围(前端+后端)时拆分提交;类型与范围一致、文件数不超过 3 且行数不超过 50、逻辑相关时合并为单次提交。
- 提交信息格式:type(scope): description,描述不超过 72 字符,使用现在时、祈使语气;类型包括 feat、fix、docs、chore、refactor、test、perf。
- 提交与推送:仅在用户明确要求时才推送。
- PR 流程:执行 git fetch origin main,查看自 main 以来的提交与 diff 统计,再用 gh pr create 创建 PR,标题采用 type(scope): description,正文包含 Summary 要点与 Test Plan 步骤。
使用方式:按上述步骤顺序执行,目标是将 Git 操作控制在 2 至 4 次工具调用以内。输出示例格式为:staged: 3 files (+45/-12 lines) | security: passed | commit: a3f8d92 feat(auth): add token refresh。
适用场景:需要 AI 代理自动完成代码提交、拆分提交与创建 PR 的开发流程。
限制:资料未提供安装方式、依赖环境、支持平台及收费信息;安全扫描基于关键词匹配,可能无法覆盖所有密钥形态。