关于 implement-spec
通过 Roundfix 准备并委派 Spec 实施的入口技能,供负责协调交付的维护者使用。它先检查交付计划和阻塞项,再将单个 Spec 或交付队列交给 Roundfix 与 Daemon 执行,并监控结果。
主要功能
- 01运行交付计划并检查阻塞项
- 02委派单个 Spec 或交付队列
- 03监控 Run 事件与队列状态
- 04按原文转达待处理问题
- 05遵守 Spec 与 Git 操作边界
适用场景
- 01启动当前分支上的 Spec 实施
- 02委派一组连续交付的 Spec
- 03监控执行结果并处理恢复流程
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ marcioaltoe/ skills --skill implement-spec安装后在 Claude Code 中输入/implement-spec确认已加载。
详细介绍
实现 Spec
此入口用于准备 Spec 并将其交由 Roundfix 执行。Supervisor 永远不会编写代码或测试,不会自行运行 Task 或 implement-task 周期,也不会自行运行 qa-gate。QA gate 是 Spec 的终止 Task,由 Daemon 运行。
1. 准备
$ARGUMENTS 指定 Spec(docs/specs/ 下的 slug 或路径)。选择实现路线前,先运行 roundfix deliver plan <slug>...。如果计划报告 Spec 受阻,请停止并报告原因。不要启动受阻的 Spec,也不要要求维护者批准常规实现步骤。
Roundfix 技能是 Delivery Plan 输出、阻塞项和命令详情的准确信息来源。
2. 委派
对于当前分支上的单个 Spec,将实现交由 roundfix implement --spec <slug>。如果会话可能在 Run 结束前终止,请添加 --detach。
对于合并推进序列,将队列交由 roundfix deliver start [--max-duration <duration>] [--max-retries <n>] <slug>...。不要在此技能中规划波次、执行 Task,也不要执行实现或 Verification;这些工作由 Roundfix 及其 Daemon 负责。
Roundfix 技能是 implement 和 delivery 命令、选项、生命周期及恢复行为的准确信息来源。
3. 监控并提问
使用 roundfix deliver status 监控交付队列,或通过事件监控 Run。报告观察到的 Run 或队列结果,并在 Roundfix 技能提供恢复路径时遵循该路径。
队列出现 Pending Question 时,只向维护者询问该问题。保留其原有措辞和指定操作;不要自行添加确认、批准、建议或第二个问题。只有在维护者通过问题指定的明确操作作答后,才能继续。
保护措施
- 不要编辑
_prd.md、_techspec.md或_tasks.md;Spec 修订属于维护者的决策,不在此委派范围内。 - 未经明确许可,不要运行具有破坏性的 Git 命令。
- 命令语义和交付生命周期详情应保留在 Roundfix 技能中;不要将其复制到此入口。