6aspec 2.0.0-dev.10

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

@@ -0,0 +1,132 @@
+# 棕地需求 - Archive SOP
+
+归档已完成的需求。
+
+**输入**：`/6aspec:brown:archive` 后可选需求名称。
+
+**步骤**
+
+1. **选择需求并检查状态**
+
+   - 读取 `6aspecdoc/brown/<name>/status.json`
+   - 确认 `phases.review` 为 "done"
+   - 如果未完成 Phase 7，询问是否强制归档
+
+2. **确认归档**
+
+   询问用户确认：
+   ```
+   问题："确认归档需求 <name>？归档后需求将移至归档目录。"
+   选项：
+   - 是，归档此需求
+   - 否，取消归档
+   ```
+
+3. **执行归档操作**
+
+   a. **创建归档目录**
+   ```bash
+   mkdir -p 6aspecdoc/brown/.archived/<timestamp>-<name>
+   ```
+
+   b. **移动需求目录**
+   ```bash
+   mv 6aspecdoc/brown/<name> 6aspecdoc/brown/.archived/<timestamp>-<name>/
+   ```
+
+   c. **更新归档状态**
+   在归档目录中创建 `archive-info.json`：
+   ```json
+   {
+     "name": "<name>",
+     "archivedAt": "<timestamp>",
+     "archivedBy": "6aspec:brown",
+     "originalPath": "6aspecdoc/brown/<name>",
+     "archivePath": "6aspecdoc/brown/.archived/<timestamp>-<name>",
+     "completedPhases": 7,
+     "totalTasks": 8,
+     "priority": "P0/P1/P2"
+   }
+   ```
+
+4. **生成归档摘要**
+
+   创建 `6aspecdoc/brown/.archived/<timestamp>-<name>/ARCHIVE-SUMMARY.md`：
+   ```markdown
+   # 归档摘要：<name>
+
+   > **归档时间**: <timestamp>
+   > **优先级**: P0/P1/P2
+   > **完成阶段**: 7/7
+   > **总任务数**: 8
+   > **总工时**: <工时>
+
+   ## 需求概述
+
+   <从 requirement.md 提取>
+
+   ## 关键成果
+
+   - 数据库变更：<数量> 个表
+   - 代码变更：<数量> 个类
+   - 前端变更：<数量> 个页面
+   - 测试用例：<数量> 个
+
+   ## 关键文档
+
+   - 01-understanding.md - 需求理解与现状分析
+   - 02-impact-analysis.md - 影响面分析
+   - 03-technical-design.md - 技术方案设计
+   - 04-tasks-overview.md - 任务拆解
+   - 05-verification-report.md - 验证报告
+   - 06-post-implementation-review.md - 实施后评估
+   - ADR-<name>.md - 架构决策记录（P0）
+
+   ## 经验教训
+
+   <从 06-post-implementation-review.md 提取>
+
+   ## 可复用方案
+
+   <从 06-post-implementation-review.md 提取>
+
+   ## 归档位置
+
+   6aspecdoc/brown/.archived/<timestamp>-<name>/
+   ```
+
+**输出**
+
+```
+## 需求已归档：<name>
+
+**归档时间**: <timestamp>
+**归档位置**: 6aspecdoc/brown/.archived/<timestamp>-<name>/
+
+### 需求统计
+- 优先级：P0/P1/P2
+- 完成阶段：7/7
+- 总任务数：8
+- 总工时：<工时>
+
+### 关键成果
+<列出关键成果>
+
+### 归档文件
+所有需求文档已移至归档目录，包括：
+- 分析文档（Phase 1-4）
+- 验证报告（Phase 6）
+- 实施后评估（Phase 7）
+- 任务详情
+- 归档摘要
+
+### 查看归档
+可以随时查看归档的需求文档：
+6aspecdoc/brown/.archived/<timestamp>-<name>/
+```
+
+**防护措施**
+- 如果未完成所有阶段，警告用户并询问是否强制归档
+- 归档前必须确认
+- 归档操作不可逆（除非手动恢复）
+- 保留完整的归档信息和摘要

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

@@ -0,0 +1,20 @@
+# 棕地需求工作流总纲（Brown Field Constitution）
+
+本文件定义适用于**所有阶段**的全局规则，当与具体 SOP 冲突时以本文件为准。各阶段的具体流程、产出模板、防护措施见对应的 SOP 文件。
+
+## 语言要求
+
+**所有生成的文档内容必须使用中文**，包括标题、字段名、描述等所有文本内容。
+
+## 核心行为规则
+
+1. **阶段化推进**：每个阶段完成后必须停止，等待用户通过显式命令推进
+2. **阶段切换纪律**（最重要的规则）：
+   - **只有显式命令才能触发阶段切换**：必须通过 `/6aspec:brown:continue` 或具体的阶段命令（如 `/6aspec:brown:specs`）才能进入下一阶段
+   - **用户的普通回复不是阶段切换信号**：回答问题、补充信息、讨论 — 这些都属于当前阶段的交互
+   - **收到用户补充信息时的正确行为**：更新当前阶段文档 → 展示变更摘要 → 再次提示可继续补充或用命令推进
+3. **前置检查**：每个阶段开始前必须检查前置阶段是否完成
+4. **状态一致性**：每个阶段完成后必须更新 status.json
+5. **不猜测**：信息不明确时必须询问用户，不要假设
+6. **Mermaid 图表**：避免使用双引号和 emoji
+7. **需求命名**：使用 kebab-case 格式（例如：`add-user-auth`）

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

@@ -0,0 +1,97 @@
+# 棕地需求 - Continue SOP
+
+继续当前需求的下一个阶段。
+
+**输入**：`/6aspec:brown:continue` 后可选需求名称。
+
+**步骤**
+
+1. **选择需求**
+
+   如果提供了名称，使用它。否则：
+   - 从对话上下文推断
+   - 如果模糊，读取 `6aspecdoc/brown/` 目录，让用户选择
+
+   显示最近修改的 3-4 个需求作为选项，标注最近修改的为 "(推荐)"。
+
+2. **检查当前状态**
+
+   读取 `6aspecdoc/brown/<name>/status.json`，解析：
+   - `flowDepth`: 流程深度（lightweight/standard/complete/quick）
+   - `status`: 当前状态
+   - `phases`: 各阶段状态
+
+3. **根据流程深度和状态执行相应操作**
+
+   **如果是快速通道（flowDepth: "quick"）**：
+   - 提示使用 `/6aspec:brown:quick` 命令
+   - 停止
+
+   **如果所有阶段都完成 (`phases` 全部为 "done")**：
+   - 祝贺用户
+   - 显示最终状态
+   - 建议："所有阶段已完成！可以运行 `/6aspec:brown:implement` 开始实施，或运行 `/6aspec:brown:archive` 归档。"
+   - 停止
+
+   **如果有待执行的阶段**：
+   - 找到第一个状态为 "pending" 的阶段
+   - 根据流程深度和阶段名称调用相应命令：
+
+   **轻量级流程（lightweight）**：
+   - `proposal` → 调用 `/6aspec:brown:proposal`
+   - `design` → 调用 `/6aspec:brown:design`
+   - `tasks` → 调用 `/6aspec:brown:tasks`
+   - `implement` → 调用 `/6aspec:brown:implement`
+
+   **标准级流程（standard）**：
+   - `understand` → 调用 `/6aspec:brown:understand`
+   - `specs` → 调用 `/6aspec:brown:specs`
+   - `impact` → 调用 `/6aspec:brown:impact`
+   - `design` → 调用 `/6aspec:brown:design`
+   - `tasks` → 调用 `/6aspec:brown:tasks`
+   - `implement` → 调用 `/6aspec:brown:implement`
+
+   **完整级流程（complete）**：
+   - `understand` → 调用 `/6aspec:brown:understand`
+   - `specs` → 调用 `/6aspec:brown:specs`
+   - `impact` → 调用 `/6aspec:brown:impact`
+   - `design` → 调用 `/6aspec:brown:design`
+   - `tasks` → 调用 `/6aspec:brown:tasks`
+   - `implement` → 调用 `/6aspec:brown:implement`
+   - `verify` → 调用 `/6aspec:brown:verify`
+   - `review` → 调用 `/6aspec:brown:review`
+
+   **如果所有阶段都被阻塞**：
+   - 这不应该发生
+   - 显示状态并建议检查问题
+
+4. **执行下一阶段后显示进度**
+
+   显示：
+   - 刚完成的阶段
+   - 流程深度
+   - 当前进度（N/M 完成）
+   - 下一个待执行的阶段
+   - 提示："运行 `/6aspec:brown:continue` 继续下一阶段"
+
+**输出**
+
+```
+## 继续需求：<name>
+
+**流程深度**: 轻量级/标准级/完整级
+**当前进度**: N/M 阶段完成
+
+### 下一阶段
+<阶段名称>
+
+<执行该阶段的命令>
+```
+
+**防护措施**
+- 每次只执行一个阶段
+- 必须按顺序执行阶段
+- 不能跳过阶段
+- 如果需求不存在，提示创建新需求
+- 快速通道提示使用 `/6aspec:brown:quick`
+- 必须根据 flowDepth 确定正确的阶段顺序

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

@@ -0,0 +1,155 @@
+# 棕地需求 - Design SOP
+
+Phase 3: 技术方案设计
+
+**输入**：`/6aspec:brown:design` 后可选需求名称。
+
+**步骤**
+
+1. **选择需求并检查状态**
+
+   - 读取 `6aspecdoc/brown/<name>/status.json`
+   - 确认 `phases.impact` 为 "done"
+   - 如果未完成 Phase 2，提示先运行 `/6aspec:brown:impact`
+
+2. **读取前置文档**
+
+   - `6aspecdoc/brown/<name>/requirement.md`
+   - `6aspecdoc/brown/<name>/artifacts/01-understanding.md`
+   - `6aspecdoc/brown/<name>/artifacts/01.5-specs.md`（标准级/完整级）
+   - `6aspecdoc/brown/<name>/artifacts/02-impact-analysis.md`
+
+3. **设计数据库变更方案**
+
+   - 字段名、类型、约束
+   - 默认值和历史数据处理
+   - 索引建议
+   - 数据迁移脚本（如需要）
+
+4. **设计代码实现方案**
+
+   - 实体类字段添加（含注解）
+   - 业务逻辑实现（含关键代码示例）
+   - 校验逻辑（必填、值域、约束）
+   - 错误提示（使用多语言资源）
+
+5. **设计前端 UI 方案**
+
+   - 各页面字段状态（可编辑/只读/隐藏）
+   - 交互逻辑（下拉选择、提示信息）
+   - 错误提示
+   - 多语言支持
+
+6. **设计测试方案**
+
+   - 单元测试（函数级别）
+   - 集成测试（流程级别）
+   - 数据一致性验证（SQL 验证）
+
+7. **架构决策记录（P0 需求必须）**
+
+   如果是 P0 级需求，创建 ADR：
+
+   创建 `6aspecdoc/brown/<name>/artifacts/ADR-<name>.md`：
+   ```markdown
+   # ADR: <决策标题>
+
+   **状态**: 提议中 / 已接受
+   **日期**: <timestamp>
+   **需求**: <name>
+
+   ## 背景
+   <为什么需要做这个决策>
+
+   ## 决策
+   <我们决定采用什么方案>
+
+   ## 备选方案
+
+   | 方案 | 优点 | 缺点 | 为何不选 |
+   |------|------|------|----------|
+   | 方案A | ... | ... | ... |
+   | 方案B | ... | ... | ... |
+
+   ## 后果
+
+   - 正面影响：...
+   - 负面影响：...
+   - 技术债务：...
+   - 风险：...
+
+   ## 验证方式
+   <如何验证这个决策是正确的>
+   ```
+
+8. **技术债务识别**
+
+   识别实现过程中可能引入的技术债务：
+
+   | 债务ID | 描述 | 类型 | 影响 | 偿还成本 | 优先级 |
+   |--------|------|------|------|----------|--------|
+   | DEBT-001 | 临时的硬编码逻辑 | 代码质量 | 中 | 2人日 | P1 |
+
+9. **创建技术方案文档**
+
+   创建 `6aspecdoc/brown/<name>/artifacts/03-technical-design.md`
+
+10. **更新状态**
+
+    更新 `6aspecdoc/brown/<name>/status.json`：
+    ```json
+    {
+      "status": "tasks_pending",
+      "phases": {
+        "understand": "done",
+        "impact": "done",
+        "design": "done",
+        "tasks": "pending",
+        ...
+      }
+    }
+    ```
+
+**输出**
+
+```
+## Phase 3 完成：技术方案设计
+
+**需求**: <name>
+**进度**: 4/5 阶段完成（标准级）或 4/6 阶段完成（完整级）
+
+### 方案概要
+- 数据库变更：<数量> 个表
+- 代码变更：<数量> 个类
+- 前端变更：<数量> 个页面
+- 测试用例：<数量> 个
+
+### 关键设计决策
+<列出 2-3 个关键决策>
+
+### 技术债务
+<列出识别的技术债务>
+
+### 文档位置
+- 6aspecdoc/brown/<name>/artifacts/03-technical-design.md
+- 6aspecdoc/brown/<name>/artifacts/ADR-<name>.md (P0)
+
+### 下一步
+- 直接回复修正设计方案或补充细节 → 我会更新本阶段文档（03-technical-design.md）
+- 运行 `/6aspec:brown:tasks` → 进入任务拆解阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
+```
+
+**用户补充信息时的处理**
+
+当用户修正设计方案、补充技术细节、或对设计决策提出异议时（未使用阶段命令）：
+1. 将用户的修正/补充整合到 `03-technical-design.md` 的对应章节
+2. 展示变更摘要
+3. 再次提示：可以继续补充，或通过命令进入下一阶段
+4. **禁止**：不得自动进入下一阶段
+
+**防护措施**
+- 必须先完成 Phase 2
+- P0 需求必须创建 ADR
+- 代码示例必须完整可用
+- 技术债务必须明确标注

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

@@ -0,0 +1,194 @@
+# 棕地需求 - Fast Forward SOP
+
+快速完成分析阶段，一次性生成所有分析文档。
+
+**输入**：`/6aspec:brown:ff` 后的参数是需求名称（kebab-case）或需求描述。
+
+**步骤**
+
+1. **如果没有提供输入，询问需求内容**
+
+   询问用户：
+   > "你想分析什么需求？请描述要实现的功能或要解决的问题。"
+
+   从描述中提取 kebab-case 名称。
+
+2. **创建或读取需求**
+
+   如果需求不存在，先执行 `/6aspec:brown:new` 的逻辑：
+   - 选择流程深度
+   - 创建目录结构
+   - 创建状态文件
+
+   如果需求已存在，读取 `status.json` 获取 `flowDepth`。
+
+3. **根据流程深度确定要执行的阶段**
+
+   **轻量级（lightweight）**：
+   - proposal → design → tasks
+
+   **标准级（standard）**：
+   - understand → specs → impact → design → tasks
+
+   **完整级（complete）**：
+   - understand → specs → impact → design → tasks → verify → review
+
+   **快速通道（quick）**：
+   - 提示使用 `/6aspec:brown:quick` 命令
+   - 停止
+
+4. **使用 TodoWrite 工具跟踪进度**
+
+   根据流程深度创建待办事项。
+
+5. **按顺序执行所有阶段**
+
+   循环执行阶段，直到所有分析阶段完成：
+
+   **轻量级流程**：
+
+   a. **Proposal**
+   - 执行 `/6aspec:brown:proposal` 的逻辑
+   - 显示简要进度："✓ Proposal 完成"
+   - 更新待办事项
+
+   b. **Design**
+   - 执行 `/6aspec:brown:design` 的逻辑
+   - 显示简要进度："✓ Design 完成"
+   - 更新待办事项
+
+   c. **Tasks**
+   - 执行 `/6aspec:brown:tasks` 的逻辑
+   - 显示简要进度："✓ Tasks 完成"
+   - 更新待办事项
+
+   **标准级/完整级流程**：
+
+   a. **Understand**
+   - 执行 `/6aspec:brown:understand` 的逻辑
+   - 显示简要进度："✓ Understand 完成"
+   - 更新待办事项
+
+   b. **Specs**
+   - 如果需要用户输入（待明确问题），询问用户
+   - 执行 `/6aspec:brown:specs` 的逻辑
+   - 显示简要进度："✓ Specs 完成"
+   - 更新待办事项
+
+   c. **Impact**
+   - 执行 `/6aspec:brown:impact` 的逻辑
+   - 显示简要进度："✓ Impact 完成"
+   - 更新待办事项
+
+   d. **Design**
+   - 执行 `/6aspec:brown:design` 的逻辑
+   - 显示简要进度："✓ Design 完成"
+   - 更新待办事项
+
+   e. **Tasks**
+   - 执行 `/6aspec:brown:tasks` 的逻辑
+   - 显示简要进度："✓ Tasks 完成"
+   - 更新待办事项
+
+   **完整级流程额外阶段**（如果 flowDepth 为 complete）：
+
+   e. **Verify**（可选，在实施后执行）
+   - 提示："Verify 阶段需要在实施后执行"
+
+   f. **Review**（可选，在上线后执行）
+   - 提示："Review 阶段需要在上线后执行"
+
+6. **显示最终状态**
+
+   读取 `6aspecdoc/brown/<name>/status.json` 显示完整状态。
+
+**输出**
+
+完成所有阶段后，总结：
+
+**轻量级流程**：
+```
+## 快速分析完成：<name>
+
+**流程深度**: 轻量级
+**进度**: 3/4 阶段完成（分析阶段全部完成）
+
+### 生成的文档
+- ✓ proposal.md - 需求提案
+- ✓ design.md - 技术方案设计
+- ✓ tasks.md - 任务拆解
+
+### 任务统计
+- 总任务数：<数量>
+- 预估总工时：<工时>
+
+### 下一步
+所有分析阶段已完成！可以：
+- 运行 `/6aspec:brown:implement` 开始执行任务
+- 查看详细文档：6aspecdoc/brown/<name>/artifacts/
+```
+
+**标准级流程**：
+```
+## 快速分析完成：<name>
+
+**流程深度**: 标准级
+**进度**: 5/6 阶段完成（分析阶段全部完成）
+
+### 生成的文档
+- ✓ understanding.md - 需求理解与现状分析
+- ✓ specs.md - 需求规格定义
+- ✓ impact-analysis.md - 影响面分析
+- ✓ design.md - 技术方案设计
+- ✓ tasks.md - 任务拆解
+
+### 任务统计
+- 总任务数：<数量>
+- 预估总工时：<工时>
+
+### 关键发现
+<列出 2-3 个关键发现>
+
+### 下一步
+所有分析阶段已完成！可以：
+- 运行 `/6aspec:brown:implement` 开始执行任务
+- 查看详细文档：6aspecdoc/brown/<name>/artifacts/
+```
+
+**完整级流程**：
+```
+## 快速分析完成：<name>
+
+**流程深度**: 完整级
+**进度**: 5/7 阶段完成（分析阶段全部完成）
+
+### 生成的文档
+- ✓ understanding.md - 需求理解与现状分析
+- ✓ specs.md - 需求规格定义
+- ✓ impact-analysis.md - 影响面分析
+- ✓ design.md - 技术方案设计
+- ✓ tasks.md - 任务拆解
+
+### 任务统计
+- 总任务数：<数量>
+- 预估总工时：<工时>
+
+### 关键发现
+<列出 2-3 个关键发现>
+
+### 下一步
+所有分析阶段已完成！可以：
+- 运行 `/6aspec:brown:implement` 开始执行任务
+- 实施后运行 `/6aspec:brown:verify` 进行验证
+- 上线后运行 `/6aspec:brown:review` 进行评估
+- 查看详细文档：6aspecdoc/brown/<name>/artifacts/
+```
+
+**防护措施**
+- 如果关键信息不明确，必须询问用户，不能猜测
+- 保持前进动力，但在关键决策点询问用户
+- 如果需求已存在且部分阶段已完成，从未完成的阶段继续
+- 验证每个阶段的文档已创建后再继续下一阶段
+- 快速通道提示使用 `/6aspec:brown:quick` 而不是完整流程
+- 必须根据 flowDepth 执行正确的阶段序列
+- 完整级流程的 verify 和 review 阶段在实施后执行，不在 ff 中执行