| name | dev-builder |
| description | 实施 0→1 产品、产品变更或非诊断型维护任务。产品路线依据 Product Spec 和 DEV-PLAN,维护路线依据维护任务契约;所有修改提供验证证据,并按 R0/R1/R2 决定结构检查、针对性测试或 fresh reviewer 独立审查。 |
开发技能 (dev-builder)
Purpose
在明确交付契约内实施最小完整变更,并用可复现证据证明行为、范围和风险门禁得到满足。
Trigger
- 0→1 产品已有 Product Spec 和完整 DEV-PLAN。
- 产品变更已有变更记录和增量 Phase。
- 非诊断型维护任务已有预期行为、范围、非目标、完成证据和风险级别。
未知根因的缺陷优先交给 bug-fixer。
Required context
- 当前路线、目标、范围、非目标和 R0/R1/R2 依据。
- 产品路线的 Product Spec、DEV-PLAN 与当前 Phase,或维护路线的任务契约。
- 仓库约束、现有测试、验证入口和用户授权边界。
- 设计规范或视觉产物(如果相关)。
Workflow
- 将任务映射到需求/验收/变更 ID 或维护预期行为。
- 检查仓库与现有修改,保护用户未授权覆盖的工作。
- 按契约实施最小完整修改,持续记录偏离和新风险。
- 执行与风险相称的结构检查、针对性测试、构建或冒烟验证。
- R2 或产品 Phase 只为当前“契约 + diff + 证据”创建一次 fresh reviewer;批量修复结论后,新 diff 最多进行一次聚焦复审。
- 若模型容量、网络、工具或宿主中断,保存恢复检查点,恢复后只继续未完成步骤。
Output
- 路线、风险及依据。
- 契约映射、修改文件和实现摘要。
- 验证命令、结果、失败项和跳过项。
- reviewer 结论(如适用)、偏离、阻塞和残余风险。
- 中断时的恢复检查点,而不是虚假的完成结论。
Stop or escalate
- 缺少可判断的目标契约:停止并返回前序阶段。
- 维护任务需要重新定义正确行为或改变公开边界:升级为产品变更。
- 验证失败、证据不足或影响范围无法证明:不得声明完成。
- 同一阻塞问题连续两轮复审仍存在:停止继续生成 reviewer,报告阻塞与所需决策。
- 真实发布、推送、部署或其他外部状态变更没有明确授权:停止在本地验证边界。
References
执行前读取 stage-contract.md。