product-spec-builder

name product-spec-builder description 将一句话或模糊产品创意整理成可验收的 Product Spec，并为已有产品记录增量变更。用于 0→1 产品定义，或新增能力、改变用户可见行为、公开 API、持久化格式、公开数据模型、权限和业务流程的产品变更；不用于只恢复既定行为的普通维护。 需求构建技能 (product-spec-builder) Purpose 从用户文字中拆出真实目的、用户、场景、边界和成功条件，形成可验收的产品契约；不要把一句话包装成完整需求。 Trigger 0→1：产品目标、用户、核心场景或首版范围尚未形成。 产品变更：新增或改变外部行为，但变更目的、范围、兼容性或验收记录仍缺失/不充分。 “Bug 修复”实际需要重新定义正确行为。 有效变更记录已经确认目的、外部行为和验收标准时直接进入 dev-planner ；仅恢复既定行为、内部重构、测试、CI 或文档时不触发。 Required context 用户原始想法、痛点或变更请求。 已有 Product Spec、仓库事实、接口和设计材料（如果存在）。 已确认约束、参考案例、截图、反例和不可接受结果。 当前已知事实、推断和未知项。 Workflow 先判断 0→1、产品变更或维护执行，不按用户使用的“优化/修复”字眼机械分类。 抽取已知目的、目标用户、核心场景、外部行为、范围和非目标。 只追问会改变路线、首版范围、公开行为或验收方式的高信息量问题；每轮通常 1 个，最多 2 个。 信息足够时停止追问，把未知项写成临时假设或明确阻塞。 0→1 生成完整 Product Spec；产品变更更新受影响章节并追加变更记录。 Output 路线与依据。 已确认事实、临时假设和待确认问题。 编号需求 REQ-* 与可观察验收标准 AC-* 。 docs/Product-Spec.md 或项目约定文件；产品变更包含变更 ID、兼容性、迁移、回滚和非目标。 Stop or escalate 无法判断是恢复行为还是重新定义行为：最多追问 2 个关键问题。 目标用户、核心场景或成功条件缺失且会改变方案：停止等待确认。 依赖未确认的外部接口或业务规则：记录阻塞，不编造答案。 产品契约已充分且请求只是维护：转交 bug-fixer 或 dev-builder 。 References 执行前读取 stage-contract.md 。