SuperAPI AI 工具集

implement

编程与开发

查看项目

更新于 10-23 17:18

技能介绍

用途:implement 是“决定 → 写 spec → 拆 ticket → 构建”流水线的第 4 步(构建)。它只承担构建工作,默认每次会话处理一个工作项,完成从认领到验证的完整闭环。工作项可以是 ticket、一次会话能完成的 spec,或对话中约定的范围;例外是 spec 运行,一次构建某 spec 的全部 ticket。

主要能力:先界定范围并明确验收标准,读取 ticket 的正文、评论、父 spec 的 Build Contract 及直接阻塞项的 Resolution;确认所有阻塞项已关闭后再认领,写入 status: in-progress 与 claimed-by,并复读确认认领成功;记录 git rev-parse HEAD 作为不可变的 base_sha。随后按 tdd 技能在选定的接缝处执行测试先行循环,使用仓库配置的聚焦测试命令与静态分析,仅在改动的路径上运行格式化器并显式按路径暂存,提交可评审的检查点。再用 code-review 技能基于 base_sha、限定本次工作项路径进行评审,处理可执行发现并复评,评审预算为两轮。之后按规则或用户意见决定是否运行全量测试套件;再运行 verify 技能做端到端验证;最后写入 Resolution(构建内容、合理偏差、验证证据、提交 SHA、供后继复用的公共接缝),对 ticket 或直接实现的 spec 将状态设为 closed 并追加 ## Resolution,对 wayfinder 决策 ticket 使用 Wayfinding Resolve 操作。

使用方式:该技能以 Markdown 文件为工作项,位于 .scratch/ 下,无外部跟踪器;若已有启动上下文指明所选文件、状态与阻塞项,则复核这些文件,否则通过 .agents/issue-tracker.md(由 /setup 生成)读取布局,旧版回退到 docs/agents/issue-tracker.md。可识别 Laravel 技术栈(composer.json 含 laravel/framework),此时先读取 references/laravel.md 获取破坏性命令、格式化器、测试命令与 worktree 设置。spec 运行与 PR 交付流程见 references/spec-run.md,每次运行第 1 步前需先读。会话结束会按 wayfinder/references/pipeline-end-block.md 的框架打印结束块,给出 Done 与按条件列出的 Next 建议。

适用场景:需要按测试先行、可验证、可评审的方式推进单个 ticket 或小型 spec;需要一次运行构建整个 spec 的全部 ticket;需要把实现、评审、验证与问题跟踪状态收尾串成一条可追溯流程的仓库工作。

限制与约束:不得在未获明确批准时重置、回滚、删除或清空数据库,或执行其他破坏性数据操作;架构变更放入新迁移,线上表变更采用 expand–contract 顺序。使用标识符前需核实路由名、配置键、枚举值、图标名与包 API。若工作项已被认领或进行中则停止,除非其工作已明显提交或明确放弃。ticket 类型为 task 时属于人工解除阻塞工作,跳过接缝/TDD/提交/评审/验证循环;wayfinder 决策 ticket 仅在类型为 task 时可用。外部依赖阻塞验证时保留实现并报告具体阻塞,工作项保持打开,不得仅凭推断标记为已验证。父项不因 ticket 关闭而关闭,implement 不触碰 map;resolution 写入不得混入代码提交。关于具体收费、价格、平台支持与效果,资料未提供。