SuperAPI AI 工具集

implement

编程与开发

查看项目

更新于 10-16 05:29

技能介绍

用途

implement 用于执行实施计划中的各个阶段。它读取 ideas/ 目录下问题(issue)中的 PLAN.md,将代码写入 spaces/ 目录中的项目仓库,并在 ideas/ 中记录工作日志与进度。该命令应在使用 /plan 创建实施计划之后使用。

主要能力

  • 按阶段执行实施计划,支持指定阶段、自动查找下一未完成阶段或执行全部剩余阶段。
  • 在首次执行阶段时创建功能分支(feature/###-slug 或 bugfix/###-slug),并将问题状态更新为 in_progress。
  • 读取 worklog/_state.json 获取当前阶段进度、关键决策、先前代理上下文和阻塞项。
  • 根据阶段领域选择对应代理(如前端 UI 使用 frontend-specialist,后端 API 使用 backend-specialist,数据库使用 database-specialist,测试使用 test-engineer,重构使用 code-reviewer)。
  • 在涉及认证/授权、密钥/API 密钥、数据库操作、文件操作、外部 API、部署配置时,条件性触发 security-auditor 进行安全检查。
  • 每个阶段完成后创建 JSON 格式的工作日志条目,文件名格式为 {sequence:03d}-phase-{slug}.json,包含 type、phase、author、summary、work、learnings、next_steps、blockers 等字段。
  • 在 --full 模式下,所有阶段完成后启动 code-reviewer 和 security-auditor 进行最终审查,若存在 CRITICAL 问题则阻止继续。

使用方式

命令格式为 /implement [项目] [问题编号] [阶段] [选项]。示例:

  • /implement yourbench YB-2 1.1 —— 执行问题 YB-2 的第 1.1 阶段
  • /implement yourbench YB-2 --next —— 自动查找下一个未完成阶段
  • /implement yourbench --next —— 自动检测问题及下一阶段
  • /implement coordinatr 003 --full —— 执行所有剩余阶段

可用标志:

  • --full:执行所有剩余阶段
  • --next:自动检测下一阶段
  • --skip-branch-check:跳过分支警告
  • --skip-security-checks:跳过每阶段安全检查
  • --skip-reviews:跳过最终审查
  • --force:跳过依赖警告

前置条件:issues/###-name/PLAN.md 必须存在;需有活跃的问题上下文(问题编号已指定或可推断);spaces/{project}/ 必须存在(代码仓库)。若 PLAN.md 缺失,需先运行 /plan 创建实施计划。

适用场景

适用于已通过 /spec、/issue、/plan 完成规划后,需要按阶段实际编写代码并跟踪进度的开发工作流。典型工作流为:/spec → /issue → /plan → /implement → /commit → /complete。

限制

  • 必须存在 PLAN.md 和 spaces/{project}/ 目录,否则无法执行。
  • 在 main/develop 分支上运行会发出警告。
  • 依赖未完成时会发出警告(可用 --force 跳过)。
  • 最终审查中若发现 CRITICAL 问题会阻止继续。
  • 代码需满足问题中 implements: 字段所引用规格部分的要求,/complete 命令将验证所有规格要求是否满足。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。