用途:这是 Spec Forge 工作流中的组件阶段,把已批准的旅程(journeys)和组件索引转换为足够支撑实现的组件级契约,回答每个组件拥有什么、暴露哪些接口、管理哪些状态与数据、有哪些代码级约束。
主要能力:按可评审批次逐个定义组件,填写 purpose、职责与非职责、输入输出与事件、真实来源与持久化/派生状态、依赖、算法与校验规则与错误处理、并发或顺序约束、性能/安全/可访问性/可观测性要求、特性开关与迁移与测试预期,并回链到旅程。产物写入 .spec-forge/specs/<spec-id>/components/<component-id>.yaml、batches.yaml 和 gates/components.yaml。
使用方式:仅在 Plan 模式下运行,否则停止并让用户切换。先运行 spec-forge-cli resolve --target <target-dir> --skill spec-forge-components --stage components --write,确认聊天语言与文件语言,再逐步收集缺失参数并用 spec-forge-cli apply 记录。用 spec-forge-cli focus --target <target-dir> --spec-id <spec-id> --stage components --max-items 1 --write 选择批次,用 artifact get/merge/put 读写产物,用 approve 记录聊天中的批准,最后运行 gate check 与 stage advance。
适用场景:需要把架构设计细化为可实现的组件契约、并希望以聊天摘要而非直接查看 YAML 来审批的团队。
限制:本阶段不修改实现代码;不接受含糊的代码细节;不得隐藏迁移、特性开关或测试预期;不强制一次评审多个复杂组件;不在非 Plan 模式继续;入口要求旅程产物存在且已批准。其余细节资料未提供。