6aspec 2.0.0-dev.2

package/.6aspec/rules/brown/brown_new_sop.md

@@ -0,0 +1,257 @@
+# 棕地需求 - New SOP
+
+开始一个新的需求分析流程。
+
+**输入**：`/6aspec:brown:new` 后的参数支持三种形式：
+- **需求名称**：kebab-case 名称（例如：`add-user-auth`）
+- **需求描述**：直接的文字描述（例如："在项目中添加用户认证功能"）
+- **文件引用**：通过 @文件路径 引用需求文档（例如：`@docs/prd-user-auth.md`）
+
+**步骤**
+
+1. **获取需求内容并识别输入类型**
+
+   根据用户输入判断类型：
+
+   **情况A：无输入** — 询问用户（开放式问题）：
+   > "你想分析什么需求？请描述要实现的功能或要解决的问题，也可以 @引用 一个需求文档。"
+
+   **情况B：直接文字描述** — 记录原始描述文本，标记 `inputSource.type = "text"`。
+
+   **情况C：文件引用（@文件路径）** — 读取文件确认存在且内容相关，标记 `inputSource.type = "file"`，记录文件路径。
+
+   从描述/文件内容中提取 kebab-case 名称（例如："添加用户认证" → `add-user-auth`）。
+
+   **重要**：必须理解用户想做什么才能继续。
+
+2. **选择流程深度**
+
+   让用户选择流程深度：
+   ```
+   问题："请选择适合的流程深度："
+   选项：
+   - 轻量级 - 快速迭代（proposal → design → tasks）（推荐用于需求明确的变更）
+   - 标准级 - 深入分析（understand → specs → impact → design → tasks）（推荐用于复杂业务变更）
+   - 完整级 - 全生命周期（understand → specs → impact → design → tasks → verify → review）（推荐用于关键变更）
+   - 快速通道 - 简单修复（直接实现，适用于Bug修复、单文件改动）
+   ```
+
+   **流程深度说明**：
+
+   **轻量级（Lightweight）**：
+   - 阶段：proposal → design → tasks → implement
+   - 产出：proposal.md, design.md, tasks.md
+   - 适用：需求明确、快速迭代、小范围变更
+   - 示例：新增简单功能、UI调整、配置变更
+
+   **标准级（Standard）**：
+   - 阶段：understand → specs → impact → design → tasks → implement
+   - 产出：understanding.md, specs.md, impact-analysis.md, design.md, tasks.md
+   - 适用：复杂业务变更、多表联动、需要风险控制
+   - 示例：新增业务字段、复杂报表、工作流改造
+
+   **完整级（Complete）**：
+   - 阶段：understand → specs → impact → design → tasks → implement → verify → review
+   - 产出：understanding.md, specs.md, impact-analysis.md, design.md, tasks.md, verification-report.md, post-implementation-review.md
+   - 适用：关键变更、需要完整追踪和评估
+   - 示例：核心业务逻辑变更、重要功能重构
+
+   **快速通道（Quick）**：
+   - 阶段：直接实现
+   - 产出：requirement.md（最小化）
+   - 适用：Bug修复、文案调整、单文件改动
+   - 示例：修复验证逻辑、调整提示文案、简单重构
+
+3. **创建需求目录结构**
+
+   根据流程深度创建不同的目录结构：
+
+   **轻量级/标准级/完整级**：
+   ```bash
+   mkdir -p "6aspecdoc/brown/<name>"
+   mkdir -p "6aspecdoc/brown/<name>/artifacts"
+   mkdir -p "6aspecdoc/brown/<name>/tasks"
+   ```
+
+   创建状态文件 `6aspecdoc/brown/<name>/status.json`：
+
+   **轻量级**：
+   ```json
+   {
+     "name": "<name>",
+     "flowDepth": "lightweight",
+     "status": "proposal_pending",
+     "createdAt": "<timestamp>",
+     "lastModified": "<timestamp>",
+     "inputSource": {
+       "type": "text | file",
+       "filePath": "<仅 type=file 时填写>"
+     },
+     "phases": {
+       "proposal": "pending",
+       "design": "blocked",
+       "tasks": "blocked",
+       "implement": "blocked"
+     },
+     "artifacts": []
+   }
+   ```
+
+   **标准级**：
+   ```json
+   {
+     "name": "<name>",
+     "flowDepth": "standard",
+     "status": "understanding_pending",
+     "createdAt": "<timestamp>",
+     "lastModified": "<timestamp>",
+     "inputSource": {
+       "type": "text | file",
+       "filePath": "<仅 type=file 时填写>"
+     },
+     "phases": {
+       "understand": "pending",
+       "specs": "blocked",
+       "impact": "blocked",
+       "design": "blocked",
+       "tasks": "blocked",
+       "implement": "blocked"
+     },
+     "artifacts": []
+   }
+   ```
+
+   **完整级**：
+   ```json
+   {
+     "name": "<name>",
+     "flowDepth": "complete",
+     "status": "understanding_pending",
+     "createdAt": "<timestamp>",
+     "lastModified": "<timestamp>",
+     "inputSource": {
+       "type": "text | file",
+       "filePath": "<仅 type=file 时填写>"
+     },
+     "phases": {
+       "understand": "pending",
+       "specs": "blocked",
+       "impact": "blocked",
+       "design": "blocked",
+       "tasks": "blocked",
+       "implement": "blocked",
+       "verify": "blocked",
+       "review": "blocked"
+     },
+     "artifacts": []
+   }
+   ```
+
+   创建需求索引文件 `6aspecdoc/brown/<name>/requirement.md`：
+   ```markdown
+   # <需求标题>
+
+   > **需求ID**: <name>
+   > **流程深度**: 轻量级/标准级/完整级
+   > **状态**: 📋 <当前阶段>
+   > **创建时间**: <timestamp>
+   > **最后修改**: <timestamp>
+
+   ## 原始需求
+
+   <!-- 根据输入类型选择以下其一 -->
+
+   <!-- 情况A：直接文字描述（inputSource.type = "text"） -->
+   <用户输入的原始需求描述，原文记录，不做加工>
+
+   <!-- 情况B：文件引用（inputSource.type = "file"） -->
+   > **需求来源文件**：`<文件路径>`
+   >
+   > 完整需求内容请参考上述文件。
+
+   ## 快速导航
+
+   **需求详情**：
+   - 轻量级流程：[proposal.md](artifacts/proposal.md) - 需求提案（Why、What、Impact）
+   - 标准级/完整级流程：[understanding.md](artifacts/understanding.md) - 需求理解与现状分析
+
+   **当前阶段**：<当前阶段名称>
+
+   **下一步操作**：
+   - 运行 `/6aspec:brown:<next-command>` 继续下一阶段
+   - 或运行 `/6aspec:brown:continue` 自动进入下一阶段
+
+   ## 进度概览
+
+   根据流程深度显示不同的阶段列表：
+
+   **轻量级流程（4阶段）**：
+   - [ ] Proposal - 需求提案
+   - [ ] Design - 技术方案设计
+   - [ ] Tasks - 任务拆解
+   - [ ] Implement - 执行实现
+
+   **标准级流程（5阶段）**：
+   - [ ] Understand - 需求理解与现状分析
+   - [ ] Impact - 影响面分析
+   - [ ] Design - 技术方案设计
+   - [ ] Tasks - 任务拆解
+   - [ ] Implement - 执行实现
+
+   **完整级流程（7阶段）**：
+   - [ ] Understand - 需求理解与现状分析
+   - [ ] Impact - 影响面分析
+   - [ ] Design - 技术方案设计
+   - [ ] Tasks - 任务拆解
+   - [ ] Implement - 执行实现
+   - [ ] Verify - 验证实现
+   - [ ] Review - 实施后评估
+
+   ## 查看详细信息
+
+   运行 `/6aspec:brown:status <name>` 查看完整状态和所有文档。
+   ```
+
+   **快速通道**：
+   创建简化的目录结构，并提示使用 `/6aspec:brown:quick` 快速通道。
+
+4. **显示初始化结果**
+
+   展示：
+   - 需求名称和位置
+   - 流程深度和说明
+   - 当前状态：0/N 阶段完成
+   - 下一步提示
+
+5. **停止并等待用户指令**
+
+**输出**
+
+完成步骤后，总结：
+```
+## 需求已创建：<name>
+
+**位置**: 6aspecdoc/brown/<name>/
+**流程深度**: 轻量级/标准级/完整级/快速通道
+**当前状态**: <第一阶段>（0/N 完成）
+
+### 需求描述
+<简要描述>
+
+### 流程说明
+<根据流程深度说明>
+
+### 下一步
+- 轻量级: 运行 `/6aspec:brown:proposal` 创建需求提案
+- 标准级/完整级: 运行 `/6aspec:brown:understand` 开始需求理解与现状分析
+- 快速通道: 运行 `/6aspec:brown:quick` 直接实现
+- 或运行 `/6aspec:brown:ff` 快速完成分析阶段
+- 或运行 `/6aspec:brown:continue` 自动进入下一阶段
+```
+
+**防护措施**
+- 不要创建任何 artifacts - 只创建目录结构和状态文件
+- 不要超出初始化范围
+- 如果名称无效（非 kebab-case），要求提供有效名称
+- 如果同名需求已存在，建议使用 `/6aspec:brown:continue` 或选择新名称
+- 必须让用户选择流程深度

package/.6aspec/rules/brown/brown_proposal_sop.md

@@ -0,0 +1,160 @@
+# 棕地需求 - Proposal SOP
+
+创建需求提案 - 轻量级流程的第一阶段。
+
+**适用流程**：轻量级（类似OpenSpec）
+
+**输入**：`/6aspec:brown:proposal` 后可选需求名称。
+
+**步骤**
+
+1. **选择需求并检查状态**
+
+   - 读取 `6aspecdoc/brown/<name>/status.json`
+   - 确认 `flowDepth` 为 "lightweight"
+   - 如果不是轻量级流程，提示使用 `/6aspec:brown:understand`
+
+2. **收集需求信息**
+
+   首先读取 `6aspecdoc/brown/<name>/requirement.md` 中的"原始需求"部分：
+   - 如果 `inputSource.type = "text"`：直接使用其中记录的需求描述。
+   - 如果 `inputSource.type = "file"`：读取记录的来源文件路径，获取完整需求内容。
+
+   如果原始需求信息不足以生成提案，再询问用户补充：
+   - 为什么需要这个变更？（Why）
+   - 要做什么？（What）
+   - 预期影响是什么？（Impact）
+
+3. **创建提案文档**
+
+   创建 `6aspecdoc/brown/<name>/artifacts/proposal.md`：
+   ```markdown
+   # 需求提案：<需求标题>
+
+   > **需求**: <name>
+   > **流程**: 轻量级
+   > **阶段**: Proposal
+   > **状态**: ✅ 已完成
+   > **创建时间**: <timestamp>
+
+   ## 为什么做（Why）
+
+   ### 业务背景
+   <业务背景描述>
+
+   ### 要解决的问题
+   <要解决的问题>
+
+   ### 预期收益
+   <预期收益>
+
+   ## 要做什么（What）
+
+   ### 功能概述
+   <功能概述>
+
+   ### 功能需求
+
+   #### FR-001: <功能名称>
+   **描述**：<功能描述>
+
+   **验收标准**：
+   - <验收标准1>
+   - <验收标准2>
+
+   #### FR-002: <功能名称>
+   **描述**：<功能描述>
+
+   **验收标准**：
+   - <验收标准1>
+   - <验收标准2>
+
+   ### 范围界定
+   **包含**：
+   - <包含的内容>
+
+   **不包含**：
+   - <不包含的内容>
+
+   ### 整体验收标准
+   - AC-001: <整体验收标准1>
+   - AC-002: <整体验收标准2>
+
+   ## 预期影响（Impact）
+
+   ### 技术影响
+   - 数据库：<影响描述>
+   - 后端代码：<影响描述>
+   - 前端代码：<影响描述>
+   - API接口：<影响描述>
+
+   ### 业务影响
+   - 用户体验：<影响描述>
+   - 业务流程：<影响描述>
+
+   ### 风险评估
+   - 技术风险：<风险描述>
+   - 业务风险：<风险描述>
+
+   ## 下一步
+
+   运行 `/6aspec:brown:design` 进行技术方案设计。
+   ```
+
+4. **更新状态**
+
+   更新 `6aspecdoc/brown/<name>/status.json`：
+   ```json
+   {
+     "status": "design_pending",
+     "flowDepth": "lightweight",
+     "phases": {
+       "proposal": "done",
+       "design": "pending",
+       "tasks": "blocked",
+       "implement": "blocked"
+     },
+     "artifacts": ["proposal.md"]
+   }
+   ```
+
+5. **停止并等待用户指令**
+
+**输出**
+
+```
+## Proposal 完成：<name>
+
+**流程**: 轻量级
+**进度**: 1/4 阶段完成
+
+### 提案概要
+- 业务目标：<简述>
+- 核心能力：<数量> 个
+- 预期影响：<简述>
+
+### 关键风险
+<列出关键风险>
+
+### 文档位置
+6aspecdoc/brown/<name>/artifacts/proposal.md
+
+### 下一步
+- 直接回复补充或修正提案内容 → 我会更新本阶段文档（proposal.md）
+- 运行 `/6aspec:brown:design` → 进入技术方案设计阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
+```
+
+**用户补充信息时的处理**
+
+当用户补充需求细节、修正提案内容时（未使用阶段命令）：
+1. 将用户的补充整合到 `proposal.md` 的对应章节
+2. 展示变更摘要
+3. 再次提示：可以继续补充，或通过命令进入下一阶段
+4. **禁止**：不得自动进入下一阶段
+
+**防护措施**
+- 仅适用于轻量级流程
+- 如果需求信息不明确，必须询问用户
+- 提案必须包含Why、What、Impact三个核心部分
+- 风险评估不能省略

package/.6aspec/rules/brown/brown_quick_sop.md

@@ -0,0 +1,134 @@
+# 棕地需求 - Quick SOP
+
+P2 需求快速通道 - 适用于简单修复和小改动。
+
+**输入**：`/6aspec:brown:quick` 后的参数是需求名称（kebab-case）或需求描述。
+
+**适用场景**：
+- Bug 修复
+- 文案调整
+- 简单重构
+- 单文件修改
+- 无架构影响的小改动
+
+**步骤**
+
+1. **如果没有提供输入，询问需求内容**
+
+   询问用户：
+   > "你想快速处理什么需求？请描述要修复的问题或要做的改动。"
+
+   从描述中提取 kebab-case 名称。
+
+2. **创建简化的需求目录**
+
+   ```bash
+   mkdir -p "6aspecdoc/brown/<name>"
+   ```
+
+   创建状态文件 `6aspecdoc/brown/<name>/status.json`：
+   ```json
+   {
+     "name": "<name>",
+     "priority": "P2",
+     "status": "quick_track",
+     "createdAt": "<timestamp>",
+     "lastModified": "<timestamp>",
+     "quickTrack": true
+   }
+   ```
+
+   创建需求描述文件 `6aspecdoc/brown/<name>/requirement.md`：
+   ```markdown
+   # <需求标题>
+
+   > **需求ID**: <name>
+   > **优先级**: P2（快速通道）
+   > **状态**: 🚀 快速处理中
+   > **创建时间**: <timestamp>
+
+   ## 需求描述
+
+   <用户提供的需求描述>
+
+   ## 快速分析
+
+   ### 影响范围
+   - 影响文件：<列出>
+   - 影响类型：Bug修复 / 文案调整 / 简单重构
+
+   ### 实现方案
+   <简要说明实现方案>
+
+   ### 验收标准
+   - [ ] <标准1>
+   - [ ] <标准2>
+   ```
+
+3. **快速分析**
+
+   执行简化的分析：
+   - 找到需要修改的文件
+   - 理解当前代码逻辑
+   - 确定修改方案
+
+4. **直接实现**
+
+   - 执行代码修改
+   - 保持变更最小化
+   - 确保不引入新问题
+
+5. **快速验证**
+
+   - 检查代码语法
+   - 运行相关测试（如有）
+   - 确认修改符合需求
+
+6. **更新状态**
+
+   更新 `6aspecdoc/brown/<name>/status.json`：
+   ```json
+   {
+     "status": "completed",
+     "completedAt": "<timestamp>",
+     "quickTrack": true
+   }
+   ```
+
+   在 `requirement.md` 中更新验收标准为已完成。
+
+**输出**
+
+```
+## 快速处理完成：<name>
+
+**优先级**: P2（快速通道）
+**处理时间**: <时间戳>
+
+### 修改内容
+- 修改文件：<文件列表>
+- 修改类型：<类型>
+
+### 验收标准
+- [x] <标准1>
+- [x] <标准2>
+
+### 下一步
+- 提交代码：使用 git 提交修改
+- 或归档：运行 `/6aspec:brown:archive` 归档此需求
+
+### 注意
+P2 需求使用快速通道，跳过了详细的分析和设计阶段。
+如果发现需求比预期复杂，建议使用完整流程（/6aspec:brown:new）。
+```
+
+**防护措施**
+- 如果需求比预期复杂，警告用户并建议使用完整流程
+- 保持修改最小化
+- 不要跳过必要的验证
+- 如果不确定影响范围，建议使用完整流程
+- 快速通道不适用于：
+  - 多表联动
+  - 复杂业务逻辑
+  - 架构变更
+  - 新功能开发