spec-drafterlisted

# Spec 起草助手 (Spec Drafter) > **版本**: 2.0.0 | **十步循环**: A.1 Spec管理 > **架构**: 双层任务架构 (tasks.md + detailed-tasks.yaml) ## 快速开始 ### 我应该使用这个 Skill 吗？ **使用场景**: - A.1: 为新功能/变更创建 OpenSpec 规范 - 需要自动判断 Spec 级别 (Level 1/2/3) - 需要生成符合模板的 proposal.md - 需要拆解大功能为 tasks.md **不使用场景**: - 简单的 typo/格式修复 → Level 1，直接跳过 A.1 - 查询项目状态 → 使用 `state-scanner` (A.0) - 规划任务执行 → 使用 `task-planner` (A.2) --- ## 核心功能 | 功能 | 描述 | |------|------| | Level 自动判断 | 根据需求内容判断 Spec 级别 (1/2/3) | | 信息提取 | 从用户输入提取 Why/What/Tasks 等信息 | | 模板生成 | 生成符合 OpenSpec 规范的 proposal.md | | Level 3 扩展 | 架构变更时额外生成 tasks.md | | 交互模式 | 逐章节确认和修改 | | 上下文增强 | 集成 state-scanner 获取项目状态 | | **头脑风暴集成** | 内置 brainstorm 流程，基于决策记录预填充 | --- ## 三级 Spec 策略 | Level | 名称 | 触发条件 | 产出物 | |-------|------|---------|--------| | **1** | Skip | 简单修复、配置、格式 | 无 Spec | | **2** | Minimal | 中等功能 (1-3 天) | proposal.md | | **3** | Full | 架构变更、跨模块 | proposal.md + tasks.md | **详细判断规则**: [LEVEL_GUIDE.md](./LEVEL_GUIDE.md) --- ## 输入参数 | 参数 | 必需 | 说明 | 示例 | |------|------|------|------| | `requirement` | ✅ | 需求描述 | "创建用户认证功能" | | `module` | ❌ | 目标模块 (自动检测) | `mobile`, `backend`, `standards` | | `interactive` | ❌ | 是否交互模式 (默认 `true`) | `true`, `false` | | `create_file` | ❌ | 是否直接创建文件 (默认 `false`) | `true`, `false` | | `level_override` | ❌ | 强制指定 Level | `1`, `2`, `3` | --- ## 执行流程 ```yaml A.1.0 - 头脑风暴检查 (新增): - 检查是否有现有决策记录 (docs/decisions/) - 根据文档类型决定是否需要头脑风暴: * 创建 PRD: 检查是否有 probl