doc-design-from-zero

name	doc-design-from-zero
description	从零设计开发文档（需求文档/技术方案/实施任务单）并输出可勾选结构。适用于新功能立项、重构规划、研究任务分解。关键词：开发文档设计、任务单、DoD、里程碑、验收标准、MVP。

Skill: doc-design-from-zero

1) 能力边界

本 Skill 用于“从零开始”设计开发文档，输出结构化、可执行、可追踪的文档草案。

做什么：

• 明确目标、范围、非目标、约束与风险。
• 生成“可勾选任务单”结构（阶段/步骤/验收标准）。
• 给出里程碑与 DoD（Definition of Done）。

不做什么：

• 不直接修改代码实现。
• 不把未验证的实现状态写成“已完成”。

---

2) 适用场景（触发条件）

当用户提出以下需求时使用：

• “帮我设计开发文档/技术方案”
• “从零开始规划某功能”
• “把想法整理成可执行任务单”
• “先做文档设计，再落地实现”

---

3) 输入要求

至少收集以下信息（缺失时按最小可行假设并显式标注）：

• 功能目标与业务背景
• 范围边界（含非目标）
• 参考资料（公式、接口、既有模块、规范）
• 时间/质量要求（MVP、性能、测试覆盖、回归要求）

---

4) 输出格式（默认）

输出为 Markdown 文档，推荐结构：

1. 背景与目标
2. 范围/非范围
3. 现状盘点（已实现/待实现）
4. 任务分解（可勾选）
5. 测试与验收标准
6. 里程碑
7. DoD
8. 风险与回退方案

输出路径与命名要求：

• 默认输出到：docs/dev/active/
• 文件命名遵循 docs/dev/README.md 约定：YYYY-MM-DD_描述.md
• 若用户未指定文件名，应按上述规则生成并在文档中保持一致引用

任务项必须使用可勾选格式：

• - [ ] 待完成任务
• - [x] 已确认完成任务

---

5) 设计流程

1. 提取需求关键词与目标结果。
2. 盘点现有能力与缺口。
3. 将需求映射为“模块任务 + 验证任务 + 文档任务”。
4. 增加里程碑与 DoD，确保可验收。
5. 执行一致性检查（术语、路径、状态标记）。

---

6) 质量门禁

文档必须满足：

• 任务可执行：每项能明确“做什么 + 如何验收”。
• 状态真实：已完成项必须有事实依据。
• 范围清晰：避免把后续增强项混入本期 MVP。
• 可追踪：里程碑与测试项可映射到代码/脚本/输出物。

---

7) 示例触发词

• “完善开发文档并改成任务单格式”
• “基于参考公式设计开发计划”
• “给我一份可执行的技术落地清单”