用途:将评审后的需求写成一份可共享的产品或技术规范,冻结“首版必须做什么、明确不做什么、下游架构必须保留哪些约束、哪些问题仍需公开”,让工程师无需猜测即可动工。适用于规范驱动与瀑布式流程;绿地项目可用较轻形式锁定首版契约,棕地项目可记录现状、目标态边界或现代化约束。日常敏捷故事细化不宜使用,除非变更大到需要书面契约。
输入:requirements-doc、domain-model(均由生命周期前一技能产出)。
流程:一、按模板组织文档,产品/功能范围用 templates/prd.md,技术设计提案用 templates/rfc.md;应含 Overview、Goals(可度量)、Non-Goals、产品与系统契约(用户流程、领域规则、接口、上线边界、边界情况)、安全考量、测试策略、上线计划、Open Questions(实现前须清空)。二、面向工程师写作,精确到数据类型、校验规则、各操作的错误处理、状态转换,复杂流程用图;但保持在契约层,不写实现细节。三、明确范围边界:包含什么、不包含什么(及在哪处理)、做了哪些假设及如何验证。四、评审:24 小时后自审、由 PM 或架构师同行评审、由实现团队做可行性评审,批准实施前解决所有开放问题。
输出:spec-doc。质量门:模板各节完成、Open Questions 为空、工程团队无阻塞性意见、有版本且全员可访问。
反模式:写成小说(超过 15 页应拆分)、没有非目标、把规范当瀑布式一次性产物、写入实现细节、把未解决的同步/兼容/上线假设当作已关闭。
相关技能:requirements-engineering、domain-modeling、system-design、task-breakdown。分发:公开安装面 skills/.curated,权威撰写源 skills/01-specification/spec-writing/SKILL.md,导出以兼容 npx skills add/update;打包稳定性 beta,能力就绪度 beta。收费、价格与具体平台支持暂未提供。