用途：把模糊想法转化为 AI 工具可执行、相关方（如承包方、团队、预算方）可评估的规格文档。适用于新功能或新产品起步、雇佣开发者或估算成本前、AI 反复做错方向（规格不清）、需要评审范围与预算时。
主要能力：提供两套流程。快速功能规格（10-15 分钟）用于单一功能、迭代与增量，可直接交给 AI 工具（如 Claude Code、Lovable、Replit）构建，参考 QUICK-SPEC.md。完整项目范围（1-2 小时）用于新产品、重大版本与相关方评审，交给承包方或团队并用于预算规划，参考 PROJECT-SCOPE.md。
使用方式（快速功能规格）：按检查清单完成各节——用 2-3 句写用户会做什么、展示它长什么样（参考产品、截图或描述三选一）、定义 3-5 步主流程、列出 2-4 个边界情况、明确不在范围内的事项，保存到 docs/specs/YYYY-MM-DD-feature-name.md。
使用方式（完整项目范围）：包含 7 个必需章节——引言（背景、范围内/范围外）、用户角色、页面与屏幕（每个页面一句话用途）、核心功能（以结果为导向）、集成（外部服务及复杂度/风险说明）、里程碑与任务（分阶段并附工时估算）、开放问题（假设与未决事项），保存到 docs/specs/YYYY-MM-DD-project-name.md。
与 AI 工具配合：Claude Code/Cursor 可粘贴快速功能规格并说“Build this feature”；Lovable/Replit/Bolt 可作为初始提示词粘贴；复杂功能拆小分块迭代。与承包方合作时发送完整项目范围，询问“哪里不清楚？你会改什么？”，并索取工时估算与你自己的对比。
常见错误与修正：只说“做个仪表盘”应改为描述仪表盘上有什么及其作用；描述“怎么写代码”应改为描述“它应该做什么”；忘记移动端应在每份规格加“支持移动端”；跳过边界情况应定义出错时的行为；缺少范围外事项会导致范围蔓延。
卡住时：不确定想要什么就试用竞品 20 分钟、截图 3 个喜欢的点，写“我要这 3 点但更简单”；AI 总做错说明规格太模糊，填满模板每一节。
限制：未提供具体价格、平台支持范围、效果保证或自动化能力等信息；文档模板与示例需查阅仓库内的 QUICK-SPEC.md 与 PROJECT-SCOPE.md，仓库未提供这些文件的在线内容细节。