6aspec 2.0.0-dev.10

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

@@ -0,0 +1,135 @@
+# 棕地需求 - Status SOP
+
+查看需求的当前状态和进度。
+
+**输入**：`/6aspec:brown:status` 后可选需求名称。如果省略，显示所有需求的状态。
+
+**步骤**
+
+1. **确定查询范围**
+
+   如果提供了需求名称：
+   - 显示该需求的详细状态
+
+   如果没有提供：
+   - 显示所有需求的概览
+
+2. **读取状态文件**
+
+   读取 `6aspecdoc/brown/<name>/status.json` 或所有需求的状态文件。
+
+3. **显示状态信息**
+
+   **单个需求详细状态**：
+   ```
+   ## 需求状态：<name>
+
+   **流程深度**: 轻量级/标准级/完整级/快速通道
+   **当前状态**: <状态描述>
+   **创建时间**: <timestamp>
+   **最后修改**: <timestamp>
+
+   ### 阶段进度
+
+   **轻量级流程（4阶段）**：
+   | 阶段 | 状态 | 完成时间 |
+   |------|------|----------|
+   | Proposal | ✅ 已完成 / 🔄 进行中 / 📋 待开始 / 🔒 阻塞 | <timestamp> |
+   | Design | ... | ... |
+   | Tasks | ... | ... |
+   | Implement | ... | ... |
+
+   **标准级流程（5阶段）**：
+   | 阶段 | 状态 | 完成时间 |
+   |------|------|----------|
+   | Understand | ✅ 已完成 / 🔄 进行中 / 📋 待开始 / 🔒 阻塞 | <timestamp> |
+   | Impact | ... | ... |
+   | Design | ... | ... |
+   | Tasks | ... | ... |
+   | Implement | ... | ... |
+
+   **完整级流程（7阶段）**：
+   | 阶段 | 状态 | 完成时间 |
+   |------|------|----------|
+   | Understand | ✅ 已完成 / 🔄 进行中 / 📋 待开始 / 🔒 阻塞 | <timestamp> |
+   | Impact | ... | ... |
+   | Design | ... | ... |
+   | Tasks | ... | ... |
+   | Implement | ... | ... |
+   | Verify | ... | ... |
+   | Review | ... | ... |
+
+   ### 任务进度（如果已拆解）
+
+   - 总任务数：<数量>
+   - 已完成：<数量>
+   - 进行中：<数量>
+   - 待开始：<数量>
+
+   ### 生成的文档
+
+   **轻量级**：
+   - [ ] proposal.md
+   - [ ] design.md
+   - [ ] tasks.md
+
+   **标准级**：
+   - [ ] understanding.md
+   - [ ] impact-analysis.md
+   - [ ] design.md
+   - [ ] tasks.md
+
+   **完整级**：
+   - [ ] understanding.md
+   - [ ] impact-analysis.md
+   - [ ] design.md
+   - [ ] tasks.md
+   - [ ] verification-report.md
+   - [ ] post-implementation-review.md
+
+   ### 下一步
+
+   <根据当前状态和流程深度给出建议>
+   ```
+
+   **所有需求概览**：
+   ```
+   ## 需求概览
+
+   ### 进行中的需求
+
+   | 需求 | 流程深度 | 当前阶段 | 进度 | 最后修改 |
+   |------|----------|----------|------|----------|
+   | <name-1> | 标准级 | Impact | 2/5 | 2小时前 |
+   | <name-2> | 轻量级 | Design | 1/4 | 1天前 |
+
+   ### 已完成的需求
+
+   | 需求 | 流程深度 | 完成时间 |
+   |------|----------|----------|
+   | <name-3> | 完整级 | 3天前 |
+
+   ### 统计
+
+   - 总需求数：<数量>
+   - 进行中：<数量>
+   - 已完成：<数量>
+   - 已归档：<数量>
+
+   ### 流程深度分布
+
+   - 轻量级：<数量>
+   - 标准级：<数量>
+   - 完整级：<数量>
+   - 快速通道：<数量>
+   ```
+
+**输出**
+
+根据查询范围显示相应的状态信息。
+
+**防护措施**
+- 如果需求不存在，提示创建新需求
+- 如果状态文件损坏，提示修复
+- 显示的时间使用相对时间（如"2小时前"）更友好
+- 必须根据 flowDepth 显示正确的阶段列表

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

@@ -0,0 +1,202 @@
+# 棕地需求 - Tasks SOP
+
+Phase 4: 任务拆解与排期
+
+**输入**：`/6aspec:brown:tasks` 后可选需求名称。
+
+**步骤**
+
+1. **选择需求并检查状态**
+
+   - 读取 `6aspecdoc/brown/<name>/status.json`
+   - 确认 `phases.design` 为 "done"
+   - 如果未完成 Phase 3，提示先运行 `/6aspec:brown:design`
+
+2. **读取前置文档**
+
+   - `6aspecdoc/brown/<name>/artifacts/01-understanding.md`
+   - `6aspecdoc/brown/<name>/artifacts/02-impact-analysis.md`
+   - `6aspecdoc/brown/<name>/artifacts/03-technical-design.md`
+
+3. **原子任务拆解**
+
+   按以下维度拆解任务：
+
+   **拆解原则**：
+   - 可以独立完成
+   - 有明确的输入和输出
+   - 有清晰的验收标准
+   - 预估工作量在 0.5-3 人日
+
+   **拆解维度**：
+   - 按技术层次：数据层 → 业务层 → 表现层 → 测试
+   - 按功能模块：模块A → 模块B → 模块C
+   - 按依赖关系：前置任务 → 核心任务 → 后置任务
+
+4. **任务命名**
+
+   使用规范：`TASK-<序号>-<简短描述>`
+
+   示例：
+   - TASK-001-database-fields
+   - TASK-002-entity-classes
+   - TASK-003-domain-service-logic
+
+5. **创建任务文档**
+
+   为每个任务创建 `6aspecdoc/brown/<name>/tasks/TASK-<序号>.md`：
+   ```markdown
+   # TASK-<序号>: <任务名称>
+
+   > **任务ID**: TASK-<序号>
+   > **状态**: 📋 待开始
+   > **优先级**: 🔴 P0 / 🟡 P1
+   > **预估工作量**: X人日
+   > **负责人**: 待分配
+
+   ## 任务概述
+   ### 任务描述
+   ### 目标
+   ### 涉及文件
+
+   ## 依赖关系
+   ### 前置依赖
+   ### 后置任务
+
+   ## 输入
+   ## 输出
+   ## 详细步骤
+   ## 验收标准
+   ## 风险与注意事项
+   ## 参考资料
+   ```
+
+6. **创建任务总览**
+
+   创建 `6aspecdoc/brown/<name>/artifacts/04-tasks-overview.md`：
+   ```markdown
+   # Phase 4: 任务拆解与排期
+
+   > **需求**: <name>
+   > **阶段**: Phase 4 - 任务拆解
+   > **状态**: ✅ 已完成
+   > **完成时间**: <timestamp>
+
+   ## 任务列表
+
+   ### 阶段 1: 数据层
+   - [ ] TASK-001: 数据库字段配置
+   - [ ] TASK-002: 实体类字段添加
+
+   ### 阶段 2: 业务层
+   - [ ] TASK-003: 领域服务逻辑实现
+   - [ ] TASK-004: 应用服务逻辑实现
+
+   ### 阶段 3: 表现层
+   - [ ] TASK-005: API 接口更新
+   - [ ] TASK-006: 前端 UI 开发
+
+   ### 阶段 4: 测试
+   - [ ] TASK-007: 单元测试
+   - [ ] TASK-008: 集成测试
+
+   ## 依赖关系图
+
+   ```mermaid
+   graph TD
+       TASK-001 --> TASK-002
+       TASK-002 --> TASK-003
+       TASK-003 --> TASK-004
+       TASK-004 --> TASK-005
+       TASK-005 --> TASK-006
+       TASK-006 --> TASK-007
+       TASK-007 --> TASK-008
+   ```
+
+   ## 工作量统计
+
+   | 阶段 | 任务数 | 预估工时 |
+   |------|--------|----------|
+   | 数据层 | 2 | 1.5人日 |
+   | 业务层 | 2 | 4人日 |
+   | 表现层 | 2 | 5人日 |
+   | 测试 | 2 | 4人日 |
+   | **总计** | **8** | **14.5人日** |
+
+   ## 关键里程碑
+
+   - 里程碑 1: 数据层完成（TASK-001, TASK-002）
+   - 里程碑 2: 业务层完成（TASK-003, TASK-004）
+   - 里程碑 3: 表现层完成（TASK-005, TASK-006）
+   - 里程碑 4: 测试完成（TASK-007, TASK-008）
+
+   ## 风险清单
+
+   | 风险 | 影响 | 应对措施 |
+   |------|------|----------|
+   | 历史数据迁移失败 | 高 | 提前备份，准备回滚方案 |
+   | API 不兼容 | 中 | 版本控制，灰度发布 |
+
+   ## 下一步
+
+   运行 `/6aspec:brown:implement` 开始执行任务。
+   ```
+
+7. **更新状态**
+
+   更新 `6aspecdoc/brown/<name>/status.json`：
+   ```json
+   {
+     "status": "implement_pending",
+     "phases": {
+       "understand": "done",
+       "impact": "done",
+       "design": "done",
+       "tasks": "done",
+       "implement": "pending",
+       ...
+     },
+     "tasks": {
+       "total": 8,
+       "completed": 0,
+       "pending": 8
+     }
+   }
+   ```
+
+**输出**
+
+```
+## Phase 4 完成：任务拆解
+
+**需求**: <name>
+**进度**: 4/7 阶段完成
+
+### 任务统计
+- 总任务数：<数量>
+- 预估总工时：<工时>
+
+### 任务分布
+- 数据层：<数量> 个任务
+- 业务层：<数量> 个任务
+- 表现层：<数量> 个任务
+- 测试：<数量> 个任务
+
+### 关键里程碑
+<列出关键里程碑>
+
+### 文档位置
+- 6aspecdoc/brown/<name>/artifacts/04-tasks-overview.md
+- 6aspecdoc/brown/<name>/tasks/TASK-*.md
+
+### 下一步
+- 运行 `/6aspec:brown:implement` 开始执行任务
+- 或运行 `/6aspec:brown:continue` 自动进入下一阶段
+```
+
+**防护措施**
+- 必须先完成 Phase 3
+- 任务必须是原子的、可独立完成的
+- 任务依赖关系必须明确
+- 验收标准必须具体
+- 工作量评估要合理

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

@@ -0,0 +1,208 @@
+# 棕地需求 - Understand SOP
+
+Phase 1: 需求理解与现状分析
+
+**输入**：`/6aspec:brown:understand` 后可选需求名称。如果省略，从上下文推断或提示选择。
+
+**步骤**
+
+1. **选择需求**
+
+   如果提供了名称，使用它。否则：
+   - 从对话上下文推断
+   - 如果模糊，读取 `6aspecdoc/brown/` 目录，让用户选择
+
+   显示："正在分析需求：<name>"
+
+2. **检查状态**
+
+   读取 `6aspecdoc/brown/<name>/status.json`：
+   - 如果 `phases.understand` 不是 "pending"，提示已完成或跳过
+   - 确认需求级别（P0/P1/P2）
+   - P2 需求提示使用 `/6aspec:brown:quick`
+
+3. **读取需求描述**
+
+   读取 `6aspecdoc/brown/<name>/status.json` 中的 `inputSource` 字段判断输入类型：
+   - `type = "text"`：读取 `requirement.md` 中的"原始需求"部分获取需求描述。
+   - `type = "file"`：读取 `requirement.md` 中记录的来源文件路径，然后读取该文件获取完整需求内容。
+
+4. **分析现有系统**
+
+   执行以下分析任务：
+
+   a. **搜索相关实体类**
+   ```bash
+   # 根据需求关键词搜索实体类
+   rg "class.*Entity" --type java
+   rg "<关键词>" --type java -g "*Entity.java"
+   ```
+
+   b. **搜索相关服务类**
+   ```bash
+   rg "class.*Service" --type java
+   rg "<关键词>" --type java -g "*Service.java"
+   ```
+
+   c. **搜索相关业务逻辑**
+   ```bash
+   rg "<关键方法名>" --type java -C 5
+   ```
+
+   d. **分析数据库表关系**
+   - 读取相关实体类
+   - 识别表关系（OneToMany, ManyToOne, ManyToMany）
+   - 绘制 ERD 图（使用 Mermaid）
+
+   e. **分析业务流程**
+   - 读取相关服务类
+   - 识别核心业务流程
+   - 绘制流程图（使用 Mermaid）
+
+   f. **识别隐性假设和约束**
+   - 分析现有代码中的校验逻辑
+   - 识别状态机约束
+   - 识别权限控制逻辑
+
+5. **生成待明确问题清单**
+
+   基于现状分析和需求描述，生成需要用户明确的问题清单：
+
+   **问题类型**：
+   - 字段设计问题（名称、类型、必填、默认值、值域）
+   - 业务规则问题（是否可修改、是否继承、是否同步）
+   - 权限和统计问题（权限控制、统计报表）
+   - 集成和兼容问题（与其他模块的集成、数据迁移）
+
+   这些问题将在本阶段提出，并引导用户回答，为 specs 阶段的需求定义提供依据。
+
+6. **创建分析文档**
+
+   创建 `6aspecdoc/brown/<name>/artifacts/01-understanding.md`：
+   ```markdown
+   # Phase 1: 需求理解与现状分析
+
+   > **需求**: <name>
+   > **阶段**: Phase 1 - 现状分析
+   > **状态**: ✅ 已完成
+   > **完成时间**: <timestamp>
+
+   ## 1. 现有系统分析
+
+   ### 1.1 相关实体类
+   <列出相关实体类及其职责>
+
+   ### 1.2 相关服务类
+   <列出相关服务类及其职责>
+
+   ### 1.3 数据库表关系图
+   ```mermaid
+   erDiagram
+       TableA ||--o{ TableB : "关系"
+       TableA {
+           string id PK
+           string name
+       }
+       TableB {
+           string id PK
+           string tableA_id FK
+       }
+   ```
+
+   ### 1.4 核心业务流程图
+   ```mermaid
+   flowchart TB
+       Start[开始] --> Process[处理步骤]
+       Process --> Decision{判断条件}
+       Decision -->|是| End1[结束路径1]
+       Decision -->|否| End2[结束路径2]
+   ```
+
+   ### 1.5 隐性假设和约束
+   <列出识别的隐性假设和约束>
+
+   ## 2. 待明确问题清单
+
+   ### 字段设计
+   1. 字段名称：[待确认]
+   2. 字段类型：[待确认]
+   3. 是否必填：[待确认]
+   4. 默认值：[待确认]
+   5. 值域范围：[待确认]
+
+   ### 业务规则
+   6. 是否可以修改：[待确认]
+   7. 子项目是否继承：[待确认]
+   8. 是否需要同步到其他表：[待确认]
+
+   ### 权限和统计
+   9. 是否需要权限控制：[待确认]
+   10. 是否需要统计报表：[待确认]
+
+   ## 3. 下一步
+
+   请回答上述待明确问题，然后运行 `/6aspec:brown:specs` 定义需求规格。
+   ```
+
+7. **更新状态**
+
+   更新 `6aspecdoc/brown/<name>/status.json`：
+   ```json
+   {
+     "status": "specs_pending",
+     "phases": {
+       "understand": "done",
+       "specs": "pending",
+       "impact": "blocked",
+       ...
+     },
+     "artifacts": ["01-understanding.md"]
+   }
+   ```
+
+8. **停止并等待用户指令**
+
+**输出**
+
+完成后，显示：
+```
+## Phase 1 完成：需求理解与现状分析
+
+**需求**: <name>
+**进度**: 1/7 阶段完成
+
+### 分析结果
+- 相关实体类：<数量>
+- 相关服务类：<数量>
+- 数据库表：<数量>
+- 待明确问题：<数量>
+
+### 关键发现
+<列出 2-3 个关键发现>
+
+### 待明确问题（重要）
+<列出最重要的 3-5 个问题>
+
+### 文档位置
+6aspecdoc/brown/<name>/artifacts/01-understanding.md
+
+### 下一步
+- 直接回答上述待明确问题 → 我会更新本阶段文档（01-understanding.md）中的问题答案
+- 运行 `/6aspec:brown:specs` → 进入需求规格定义阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
+```
+
+**用户补充信息时的处理**
+
+当用户回答待明确问题或补充需求信息时（未使用阶段命令）：
+1. 将用户的回答整合到 `01-understanding.md` 中对应的问题项（将"[待确认]"替换为实际答案）
+2. 如果回答引发新的发现或问题，同步更新文档的相关章节
+3. 展示变更摘要（更新了哪些问题的答案、新增了哪些发现）
+4. 再次提示：可以继续补充，或通过命令进入下一阶段
+5. **禁止**：不得自动进入下一阶段
+
+**防护措施**
+- 必须先读取需求描述再开始分析
+- 如果找不到相关代码，询问用户提供更多关键词
+- 如果分析不充分，不要强行生成文档，而是询问用户
+- 待明确问题必须具体，避免模糊问题