用途
pc-spec-writing 是一个用于撰写产品与技术规格文档的技能，主要应用于规格驱动（spec-driven）和瀑布式（waterfall）工作流。它适用于这样的场景：已经评审的需求需要一份共享的产品或技术规格，用以固定范围、非目标、接口、上线关注点以及待决问题，使工程师能够据此构建而无需猜测。该技能被描述为最重的规格撰写技能。
主要能力
该技能围绕结构化的文档撰写流程组织：
- 结构化文档：根据文档类型选用相应模板。产品/功能范围文档使用 templates/prd.md；技术设计提案使用 templates/rfc.md。不适用的小节需标注原因。文档结构包括：
- Overview：一段话说明这是什么以及为何重要
- Goals：成功的样子（可衡量）
- Non-Goals：明确不覆盖的内容（防止范围蔓延）
- Product and system contract：用户流程、领域规则、接口、上线边界以及下游工作必须保留的边界情况
- Security Considerations：威胁向量与缓解措施
- Testing Strategy：如何验证其有效
- Rollout Plan：如何安全发布
- Open Questions：负责人、决策阶段以及每个未决项阻塞的工作
- 面向读者写作：工程师是主要读者，要求精确——包含数据类型与校验规则、为每个操作指定错误处理、显式定义状态转换、对复杂流程使用图表（序列图、状态机）。精确不等于实现细节，规格应保持在契约层：必需行为、支持与不支持的流程、发布边界、上线与共存约束、架构必须保留的未决问题。
- 定义范围边界：对每个功能显式说明本规格包含什么、不包含什么（以及将在何处处理）、做出哪些假设（以及如何验证）。
- 评审周期：包括自审（检查歧义、矛盾和无支撑的假设）、同行评审（由另一位 PM 或架构师检查完整性）、工程评审（由实现团队检查可行性与疑问）。
使用方式
该技能以 SKILL.md 形式提供，规范作者源位于 skills/01-specification/pc-spec-writing/SKILL.md，公共安装面为 skills/.curated，该包为 npx skills add/update 兼容而导出。输入方面，I/O 契约说明定义了所需输入与权限。输出方面，仅产出声明过的输出，并达到其文档化的质量边界。
评审与门禁
评审周期需解决阻塞下一授权阶段的问题：将架构决策连同负责人带到设计阶段；实现则等待其范围所依赖的决策。规格评审不豁免更严格的工作流门禁。
质量门
质量门要求：适用小节定义当前契约且不虚构细节；待决问题标明负责人、决策阶段与依赖工作；所需评审者批准声明的下一阶段，其阻塞性关注点已解决；规格已版本化且所有团队成员可访问。
适用场景
适用于需要共享规格以固定范围、非目标、接口与上线边界的场景，尤其是规格驱动与瀑布式工作流。
限制
打包稳定性为 beta，能力就绪度为 beta，可移植性为 portable_with_caveat。公开注意事项指出：作为技能指导可移植；完整的治理保证需要 Prodcraft 仓库契约与验证检查。