用途
git-workflow 是一份供 AI(尤其是 Claude)在执行期间阅读的 Git 操作参考,目标是实现 token 高效的 Git 工作流,将工具调用控制在最多 2-4 次。它并非面向人类的教程,而是为 AI 消费而优化的执行指南。
主要能力
提交流程
-
暂存与安全扫描:暂存文件,检查 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 统计,然后使用以下命令创建 PR:
gh pr create --title "type(scope): description" --body "## Summary\n- bullets\n\n## Test Plan\n- steps"
输出示例
staged: 3 files (+45/-12 lines) | security: passed | commit: a3f8d92 feat(auth): add token refresh
使用方式
该技能以参考文档形式提供,供 AI 在执行 Git 操作时读取并遵循上述流程。人类可读的说明可参见 docs/architecture/HIERARCHICAL_PLANNING.md 或 docs/getting-started/ 下的相关文档(具体取决于主题)。
适用场景
适用于需要 AI 辅助执行 Git 提交与 PR 创建的场景,尤其是希望减少 token 消耗、自动进行密钥扫描、并根据变更内容智能决定是否拆分提交的自动化开发流程。
限制
资料未提供关于安装方式、收费模式、支持平台或具体效果验证的说明,这些信息暂未提供。