用途:sdd-propose 是 SDD(规格驱动开发)流程中的提案子代理,负责把探索分析或用户直接输入整理成结构化的 proposal.md,作为后续 specs 或 design 阶段的输入。
主要能力:写入提案文档,包含 Intent、Scope(In/Out of Scope)、Capabilities(新增与修改能力的契约)、Approach、Affected Areas、Risks、Rollback Plan、Dependencies、Success Criteria;提案字数须控制在 450 词以内,用要点和表格代替长段文字;每条提案必须含回滚计划与成功标准。
使用方式:由编排器以子代理方式调用;若是子代理,直接执行阶段工作,不得委派或调用 Skill 工具;若是通过 skill() 直接加载,则应停止并委派给专用 sdd-propose 子代理。产物持久化支持四种模式:engram(存为 sdd/{change-name}/proposal)、openspec(写入 openspec/changes/{change-name}/proposal.md)、hybrid(两者都写)、none(仅返回结果,不创建或修改项目文件)。openspec/hybrid 模式下需读取 openspec/specs/ 中相关规格;engram 模式从 Engram 取上下文。
适用场景:需要发起 SDD 变更提案、明确范围与能力契约、为规格阶段准备输入时。
限制:要求已确认的预提案交接,提案方不得自行访谈或推断同意,缺失时返回 blocked;技术产物默认英文,除非用户明确要求其他语言;除 openspec 或 hybrid 模式外不得强制创建 openspec/ 目录;Capabilities 必须填写,纯重构或配置变更需显式写 None。