SuperAPI AI 工具集

implement-plan

编程与开发

查看项目

更新于 10-16 06:45

技能介绍

用途:implement-plan 用于把一份已保存的计划(plan)连同其 ADR 落实为代码,最终产出经过测试并通过独立审查的拉取请求(PR)。

主要能力与流程:

  1. 交接:在 herdr 环境(HERDR_ENV=1)中,若不是实现者或未被要求本地实现,则把计划交给新智能体。做法是创建 worktree(见 use-worktrees),若计划与 ADR 未提交则复制进去;在当前 herdr 工作区的新窗格中打开该 worktree 并标记为 worker,以同类智能体启动,告知计划路径与补充上下文,并指示其“你是实现者,在此检出中使用 implement-plan,不要再交接”。
  2. 实现:阅读计划与 ADR,不清楚或有误时先询问;按任务顺序推进,只做满足任务的最简实现,不给不可能发生的场景加多余层级、选项或防御代码;复杂或并行任务交给子智能体;仅为保护重要行为添加或更新测试(见 awesome-tests);自行验证每个任务,运行计划指定的检查,UI 需用 agent-browser 在真实浏览器中检查,自行准备服务与测试数据;保持计划文件最新,偏离则更新计划,决策变更则写新 ADR。
  3. 审查轮次:每次实现都由未编写该代码的智能体审查一次,目的是发现作者看不到的问题,而非扩张代码。审查者阅读计划、ADR、完整 diff 及其接入的代码(见 code-review),运行检查并像用户一样尝试破坏它,只报告真实且可能的问题与可移除的复杂度,每条附具体失败场景与修复方案,跳过小众边界情况、推测性加固与风格偏好。实现者逐条判断而非全盘接受,用最简修复解决真实问题,拒绝增加过多复杂度的修复并给出理由。分歧当面解决,未解决的交给用户;仅在大量修复后再次审查。
  4. 收尾:审查结束后退出审查者并关闭其窗格;有未解决分歧交给用户。实现者报告 PR 后,确认分支已完全推送,退出智能体、关闭窗格、移除 worktree 并报告 PR。最终报告 PR 链接、验证情况、审查结果与遗留事项。

限制:资料未提供具体依赖、版本或安装方式;流程依赖 herdr、worktree、agent-browser、awesome-tests、code-review 等相关技能与环境。