用途
implement-feature 用于将一个功能作为单个 PR 交付到默认分支。它通过调度就绪工单并整合已完成工作来实现这一目标。该技能使用 orchestrator-mode 进行协调,并为每个工单使用 implement-ticket。沟通通过 spec、ticket、research、commit 和 handoff 指针进行,详细证据保存在持久化产物中。
主要能力
- 范围与所有权管理:仅 spec 输入承诺整个 spec;显式工单列表定义工作集,其父 spec 提供上下文。记录完成模式和覆盖缺口。
- 前沿调度:前沿包含没有活跃实现者且其阻塞项在已验证、保留的集成尖端中已满足的工单。每个调度将该尖端固定为其不可变的 base_sha。
- 工单分支与隔离工作树:每个工单有自己的分支和隔离工作树,即使只有一个就绪。集成分支收集已验证的工作。
- 协调者职责:协调者通过其 tracker worker 拥有资格、声明、问题评论、标签和功能 PR。工单 worker 实现并返回证据。
- 容量管理:根和所有活跃后代计入容量。使用瞬态 setup、tracker 和集成角色。一个 worker 拥有每个工单,无辅助扇出。
使用方式
工作流包括以下步骤:
-
解析范围并准备:通过路径定位 implement-ticket 的安装根目录,读取其 references/setup.md。在调度 setup worker 之前完成 Setup。如果文件缺失,报告所需的配对更新,并在没有工单调度的情况下继续范围发现。从每个已安装技能自己的根目录解析跨技能引用,并将绝对路径传递给 worker。
-
调度、集成并刷新前沿:遵循 Frontier scheduling。固定每个就绪工单的调度 SHA,并记录其工作树、分支和先决条件证据。让 tracker worker 在调度前声明它并发布其开始评论。在容量内后台运行工单 worker。传递快照和 handoff 路径、调度元数据、implement-ticket 的 SKILL.md 的绝对路径以读取,以及 Orchestrated ticket contract。
-
验证并审查功能:在固定的集成 SHA 上使用新的 worker 进行 Verify 和 Integration review。Verify 运行配置的 lint、类型检查、测试以及适用的运行时或产物检查。Review 在该 SHA 的隔离检出中运行,并接收物化的 scope.md 作为其唯一来源 spec 加上固定的 PR-base 提交。
-
定稿功能 PR:一个 worker 使用 pr 编写正文并定稿 Feature PR。传递已验证的 SHA、覆盖证据、运行记录和报告。新发现的缺陷返回修复和验证循环。在声称整个 spec 完成之前刷新 tracker 覆盖。
适用场景
适用于需要将功能实现为单个 PR 并交付到默认分支的场景,特别是当工作可以分解为多个工单并通过协调者模式进行调度和集成时。
限制
- 仅 spec 输入承诺整个 spec;显式工单列表定义工作集。
- 每个工单有自己的分支和隔离工作树。
- 协调者拥有资格、声明、问题评论、标签和功能 PR。
- 一个 worker 拥有每个工单,无辅助扇出。
- 失败与恢复:保留原始基线证据、决策、所有权记录和 WIP 跨调用。中断的合并不是树等于最后推送尖端的证明。仅推送已验证的集成状态,或明确授权的 WIP 到单独恢复分支。
- 在暂停、取消或交接之前,停止活跃工单 worker 并发布每个已开始尝试的停止评论。
- 其他具体功能、收费、价格、平台、效果或使用步骤暂未提供。