用途:为 Warp 中重要的用户可见功能编写 PRODUCT.md 产品规格,使期望行为足够明确,让智能体可正确实现并避免回归。规格纯从消费者视角描述:用户看到什么、做什么、体验什么,以及必须成立的不变量,不包含内部类型、状态布局、模块边界、数据流或算法等实现细节。
主要能力:规格写入 specs/<id>/PRODUCT.md,<id> 可为 Linear 工单号(如 specs/APP-1234/PRODUCT.md)、加 gh- 前缀的 GitHub issue id(如 specs/gh-4567/PRODUCT.md)或短 kebab-case 功能名(如 specs/vertical-tabs-hover-sidecar/PRODUCT.md)。specs/ 下只允许 id 命名的目录。必填章节为 Summary(1–3 句)与 Behavior(核心,编号、可测试的不变量)。可选章节包括 Problem、Goals/Non-goals、Figma、Open questions,仅在增加信息时保留,为空则省略标题。不写 Validation、Success criteria 或 Testing,这些属于配套 TECH.md。
使用方式:先收集目录 id、功能摘要、目标用户、关键行为、边界情况与验证方式,缺失时用 ask_user_question 询问而非猜测。若功能涉及 UI 或交互设计,起草 Behavior 前询问是否有 Figma 稿,有则写 Figma: <link>,无则写 Figma: none provided;纯后端功能跳过并省略该节。工单/issue 引用可选,仅在用户明确要求时才创建。写完 PRODUCT.md 后通常调用 write-tech-spec 生成同一功能的 TECH.md。
适用场景:Warp 中单模块小功能、跨模块多状态的中型功能,以及行为丰富的大型功能;琐碎修复或窄 UI 调整无需规格。
限制:Behavior 需详尽枚举默认行为、各状态与转换、输入响应、空/错误/加载/取消状态、权限拒绝、离线、超时、竞态、并发实例、陈旧数据、焦点丢失、相邻功能交互、键盘与无障碍期望等边界情况,长度随功能而定,其余章节保持精简。已批准规格可与实现同 PR 提交,用户可见行为变化时需同步更新。大型功能可选维护 DECISIONS.md。相关技能:implement-specs、write-tech-spec、spec-driven-implementation。