SuperAPI AI 工具集

issue-driven-development

编程与开发

查看项目

更新于 10-16 02:33

技能介绍

用途:这是一套贯穿开发全程的主流程技能,按顺序编排 issue 跟踪、分支、测试驱动开发、评审与合并等步骤,每一步引用具体子技能,用于约束开发工作从立项到完成的规范化执行。

核心原则:没有 issue 就不开始工作;不做捷径、不设例外。开始时需声明“I'm using issue-driven-development to implement this work.”,并为每个步骤创建 TodoWrite 项。

13 步流程:1)Issue 检查,确认有明确 GitHub issue 且已在项目看板中,并设置 Status;2)阅读 issue 评论;3)评估 issue 是否过大,必要时用拆解技能拆成子 issue;4)检索记忆,查找既往工作;5)按需调研;6)分支检查并更新看板状态为 In Progress,禁止在 main 分支开发;7)按 RED→GREEN→REFACTOR 进行 TDD,同时应用严格类型、内联文档、包容性语言、不遗留 TODO 等标准;8)验收标准验证,必要时触发失败后研究;9)强制代码评审,区分小改动与大改动,覆盖盲点、清晰度、可维护性、安全、性能、文档、风格七项标准,并强制将评审产物发到 issue 评论;10)落实全部评审发现,未修复的须建跟踪 issue,要求“Unaddressed: 0”;11)运行完整测试;12)提 PR,受钩子门禁控制;13)监控 CI、合并 PR、更新看板为 Done 并继续下一 issue。

看板与评论更新:状态变更属于强制门禁,包括 In Progress、In Review、Done、Blocked,并需实际验证;issue 评论在开始、遇阻、重大决策、验证完成、提 PR 等节点更新。

限制与执行机制:使用缓存的看板数据(GH_CACHE_ITEMS)查询状态,不用标签表示状态;无评审产物会阻止 gh pr create,CI 未通过会阻止合并,评审未完成会阻止停止;门禁失败必须先修复。文中提及的命令、环境变量与技能名称需保持原样,具体环境配置与缓存变量由会话启动设置。