SuperAPI AI 工具集

implement-spec

通用与其它

查看项目

更新于 10-16 06:20

技能介绍

用途:当已有经过评审的规格、工单包含验收标准与阻塞关系,且用户希望实现整个规格而非单个工单时使用;规格含糊、工单缺依赖或只做单个工单时不适用,应先用相关规划技能补齐输入。

主要能力:先读取规格与全部工单,提取紧凑工作图(工单、阻塞项、涉及文件/区域、验收检查、状态);所有阻塞项完成的工单进入前沿,可并发执行。用一次探索遍历定位既有模式、归属边界、相关测试与外部文档,并把重要发现存入临时笔记目录供后续工作者使用。

用法:变更代码前先确认规格路径或权威 issue/plan、工单来源与状态格式、依赖字段、仓库的测试/检查/类型检查/构建命令、基础分支与集成分支名;任何一项找不到就停止并报告缺失输入,不得凭空编造任务图。随后从最新远程基础分支创建集成分支,例如 git fetch origin <base>、git status --short --branch、git switch -c <integration-branch> origin/<base>,并保留不相关的脏工作,不隐式重置或 stash 用户改动。每个就绪工单在独立 worktree 与分支中由一个实现者完成,需确认基于当前集成分支、行为变更遵循 tdd、做满足工单的最小改动、运行聚焦测试及更广检查、用规范消息提交,并返回提交 SHA、改动文件与真实命令输出;超时、部分结果或无提交 SHA 不算完成。由合并者或控制者逐个把已验证工单合入集成分支,按规格和领域术语解决冲突,每次合并后运行聚焦检查、更新图状态、重算前沿并启动新解除阻塞的工单。全部完成后对完整集成分支做代码评审,修复后重复直至无未解决的关键或重要问题。

限制与常见陷阱:把工单当简单清单而漏掉阻塞项;两个工作者静默重定义同一字段、API 或文件契约;把超时工作者报告为已完成;在集成分支通过完整评审前开 PR;只跑单元测试而漏掉集成、类型或构建失败;重置脏 worktree 破坏无关用户工作;让每个实现者重新发现仓库。结束时需运行仓库完整验证套件,确认每个工单有提交与已解决状态、分支只含预期改动、无遗留工作 worktree、生成文件与临时笔记未被误提交,并报告最终分支与提交 SHA。针对代理技能或工作流变更,还应做学习检查:保留代表性输入与旧输出,记录人工纠正及决策,用有界规则而非口号更新技能,重跑同一输入并比较,机械性教训尽量转为确定性检查。