SuperAPI AI 工具集

implement-plan

编程与开发

查看项目

更新于 10-20 05:53

技能介绍

用途

implement-plan 是一个分阶段实施编排技能,负责按照 .humanlayer/tasks/ 目录中的技术计划,系统性地推进各阶段实现。它仅在用户明确按名称调用时使用。

主要能力

  • 定位计划文件:支持直接提供计划文件路径,或提供任务目录(如 .humanlayer/tasks/<task slug>)并通过 ls -La 查找内部计划文件;注意目录可能是符号链接,不应使用 Glob、Grep 或不带 -L 的 ls。
  • 启动实现代理:使用 Task 工具并指定 subagent_type=implementer-agent 执行当前阶段,提示词保持简短,不重复计划中已有的细节。
  • 审查输出:检查已完成事项、问题或不匹配报告,以及需要手动验证的步骤。
  • 执行自动化检查:运行构建命令、测试套件、代码检查/格式化检查及计划中提到的其他自动化验证。
  • 向人类汇报:按固定格式提供阶段完成摘要,包括实现代理完成的任务、自动化验证结果和需要人工手动验证的检查项。
  • 等待人工确认:等待用户确认手动检查通过、报告问题或授权继续下一阶段。
  • 提交变更:为变更创建新提交;注意 .humanlayer/tasks/ 目录不应被提交,因为它是指向另一仓库的符号链接。
  • 进入下一阶段:用户提示后重复上述工作流。

使用方式

当技能被调用时,若未提供计划路径则先询问;读取计划以理解阶段划分;从第一阶段(或恢复时的第一个未勾选项)开始;按工作流逐步执行。多阶段连续实施时,仍为每个阶段启动独立的实现代理,在阶段之间进行验证,所有请求阶段完成后再暂停等待人工验证。除明确要求外,在人类审查并批准上一阶段之前,不应提交或进入下一阶段。

适用场景

适用于需要按阶段实施技术计划并希望有人工审查环节的软件开发任务;支持从中断的部分完成计划恢复(检查计划文件中的 - [x] 标记,指示实现代理从第一个未勾选项继续);当实现代理报告不匹配或卡住时,清晰呈现问题并等待指导,考虑计划是否需要根据代码库演变更新。

限制

该技能仅在用户明确调用时使用;其角色是编排与验证,实际实现工作由 implementer agent 完成。最终阶段全部完成并验证后(所有复选框标记、所有自动化测试通过),提交最终变更并读取 {SKILLBASE}/references/implement_plan_final_answer.md,严格按照模板回复,不包含摘要或其他信息。资料未提供具体运行环境、依赖安装或价格信息。