用途
PM Spec Writing 用于把想法（往往是模糊的）转化为开发者或 AI 智能体真正能据以构建的规格说明。它不绑定技术栈，适用于新功能、缺陷修复、内容变更或基础设施工作。
适用场景包括：把想法转化为可构建的功能规格；撰写 PRD 或产品需求文档；提交他人可执行的缺陷报告；在项目启动前界定范围；对功能请求积压进行优先级排序；为已有功能编写验收标准；把大型计划拆分为可交付的增量。
不适用场景：跨多个计划的季度或年度规划（应使用 roadmap-planning）；代码审查或调试现有代码（应使用 code-review-web）；对已定规格的功能做设计决策（应使用 design-standards）；用于验证想法的用户研究（应使用 ux-research）。
主要能力
该技能围绕一个四阶段框架组织工作流：
阶段一：澄清想法。 在写任何规格前回答四个问题：解决什么用户问题（先有问题，功能是提出的解决方案）；具体谁受益（要精确，“用户”不够具体）；成功指标是什么（选一个主要指标）；为什么是现在（什么变化使现在成为合适的时机）。任一问题答不上来，就回到用户处澄清，不围绕模糊性写规格。
阶段二：按影响与工作量界定范围。 把候选想法放到影响/工作量网格上：高影响/低工作量立即交付；高影响/高工作量规划并批量处理；低影响/低工作量归入锦上添花批次；低影响/高工作量跳过或无限期推迟。该框架并非完美，某些“低影响”事项是强制性的（合规、无障碍、安全），需注明例外。
阶段三：撰写规格。 根据工作类型选择三种格式之一。
格式 A：功能规格（用于新功能），包含标题、问题、用户、提案、用户故事、验收标准、不在范围内、依赖项、成功指标、预估工作量（Small 数小时 / Medium 1-3 天 / Large 1-2 周 / XL 多个冲刺）、优先级（P0 发布阻塞 / P1 下个冲刺 / P2 本季度内 / P3 积压）。
格式 B：开发简报（交给开发者或 AI 智能体），用于战术性、可直接构建的工作，比完整规格更轻，包含上下文、任务（具体文件与确切改动）、约束（不得改变和需保留的内容）、验证（确认工作正确完成的确切步骤）。验证部分最常被跳过也最重要，没有它，“完成”就取决于实现者的理解。
格式 C：缺陷报告，包含 URL 或上下文、症状、预期、复现步骤、假设（可能的根因）、需排查的文件、优先级（P0 阻塞关键用户流程立即交付 / P1 显著降低体验本冲刺修复 / P2 小问题方便时修复 / P3 锦上添花）、浏览器或设备。
阶段四：排序并交付。 单个功能要找出最小可交付增量——能带来用户价值的最小版本，先交付再迭代。对积压项，先按依赖排序，再按优先级，再按影响/工作量；顺序比优先级标签更重要。
使用方式
工作流为：澄清（想法模糊时先问阶段一的四个问题）→ 界定范围（放到影响/工作量网格）→ 选择正确格式（新功能用功能规格，战术工作用开发简报，缺陷用缺陷报告）→ 撰写规格（使用模板格式，填满每个部分，空的部分是警示信号）→ 定义完成（验证步骤必须无歧义，“测试一下”不是验证步骤）→ 获得认可（在开始前与构建者一起过一遍规格）→ 排序（找出最小可交付增量）。
输出为三种格式之一，均为 Markdown：功能规格命名为 spec-[feature-name].md，开发简报命名为 brief-[task-name].md，缺陷报告命名为 bug-[summary].md。大型计划可按文件夹组织，例如 specs/initiative-name/ 下放 spec-feature-1.md、spec-feature-2.md、brief-task-1.md 以及 README.md（概述与排序）。
适用场景与限制
该技能强调若干失败模式：先描述方案而非问题；没有成功指标；验收标准不可测试（“用户体验得到改善”不可测试，“用户在 60 秒内完成注册”可测试）；规格里写“怎么做”而非“做什么”（实现细节属于开发简报）；没有“不在范围内”部分导致范围蔓延；缺陷报告没有复现步骤；验证步骤含糊（“确保它能用”无用，必须是带可观察结果的具体动作）；跳过最小可交付增量练习，导致本应是两周实验的项目拖成六个月。
关于数据缺失：该技能的产出依赖它自身无法生成的数据、测量或工具结果。当所需输入、工具或数据源不可用或无法验证时，被认可的产出是带缺口说明的交付物——说明需要什么、实际获得或验证了什么、输出的哪些部分受影响。为完成交付物而编造、估算或插值所需数字绝不被认可；说明缺口本身就是完整答案。
参考文件包括：references/feature-spec-template.md（完整功能规格模板）、references/dev-brief-template.md（战术工作的紧凑开发简报模板）、references/prioritization-frameworks.md（影响/工作量之外的 RICE、加权评分、MoSCoW）。