SuperAPI AI 工具集

git-workflow-and-versioning

编程与开发

查看项目

更新于 10-16 05:41

技能介绍

用途:为任何代码变更提供结构化的 Git 实践,适用于提交、分支、解决冲突以及整理 AI 智能体高速产出的代码,让改动可管理、可审查、可回退。

主要能力:提倡主干开发(Trunk-Based Development),main 始终可部署,功能分支 1-3 天内合并;长生命周期开发分支被视为成本,发布分支可接受,未完成功能优先用特性开关而非长分支。核心提交纪律包括:尽早频繁提交(实现→测试→验证→提交→下一片)、原子提交(一次只做一件逻辑事)、描述性信息(解释“为什么”,格式为 <type>: <short description>,类型有 feat、fix、refactor、test、docs、chore)、关注点分离(格式化与行为变更分开,重构与功能分开)、控制变更规模(约 100 行/提交,超过约 1000 行应拆分)。

使用方式:分支命名如 feature/task-creation、fix/duplicate-tasks、chore/update-deps、refactor/auth-module,从 main 分出、合并后删除。并行智能体可用 git worktree add ../project-feature-a feature/task-creation 等方式在同一仓库多目录并行工作,完成后 git worktree remove。提交前执行 git diff --staged、检查密钥、运行测试与 lint,可用 lint-staged + husky 自动化。调试可用 git bisect、git log --oneline、git blame、git log --grep。每次改动后输出结构化变更摘要(CHANGES MADE / THINGS I DIDN'T TOUCH / POTENTIAL CONCERNS)。

适用场景:AI 智能体或人类开发者进行日常编码、修复、重构、测试与依赖更新。

限制:仅在任务与上游来源及本地项目上下文明确匹配时使用;命令、生成代码、依赖、凭据与外部服务行为需在应用前自行验证;示例不能替代环境专属测试、安全审查或对破坏性、高成本操作的用户批准。资料未提供具体收费与平台信息。