SuperAPI AI 工具集

git-workflow

编程与开发

查看项目

更新于 10-31 13:16

技能介绍

用途

git-workflow 是一份供 AI(尤其是 Claude)在执行期间阅读的 Git 操作参考,目标是实现 token 高效的 Git 工作流,将工具调用控制在最多 2-4 次。它并非面向人类的教程,而是为 AI 消费而优化的执行指南。

主要能力

提交流程

  1. 暂存与安全扫描:暂存文件,检查 diff 统计,并扫描密钥(匹配 api_key、token、password、secret、credential)。如果发现密钥,则停止操作,展示匹配内容,并阻止提交。

  2. 拆分决策:在以下情况拆分提交——混合类型(如 feat 与 fix 同时出现)、超过 10 个不相关文件、多个作用域(如前端与后端同时涉及)。在以下情况保持单一提交——类型与作用域相同、文件数不超过 3 且行数不超过 50、逻辑上相关。

  3. 提交信息:格式为 type(scope): description,描述不超过 72 个字符,使用现在时、祈使语气。类型包括 feat、fix、docs、chore、refactor、test、perf。

  4. 提交与推送:仅在用户要求时才执行推送。

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 消耗、自动进行密钥扫描、并根据变更内容智能决定是否拆分提交的自动化开发流程。

限制

资料未提供关于安装方式、收费模式、支持平台或具体效果验证的说明,这些信息暂未提供。