6aspec 2.0.0-dev.10

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

@@ -0,0 +1,293 @@
+# 棕地需求 - Impact SOP
+
+Phase 2: 影响面分析与非功能需求评估
+
+**输入**：`/6aspec:brown:impact` 后可选需求名称。如果省略，从上下文推断或提示选择。
+
+**步骤**
+
+1. **选择需求并检查状态**
+
+   - 读取 `6aspecdoc/brown/<name>/status.json`
+   - 确认 `phases.specs` 为 "done"
+   - 如果未完成 Phase 1.5，提示先运行 `/6aspec:brown:specs`
+
+2. **读取前置文档**
+
+   读取以下文档获取上下文：
+   - `6aspecdoc/brown/<name>/requirement.md` - 需求描述
+   - `6aspecdoc/brown/<name>/artifacts/01-understanding.md` - 现状分析（含业务规则答案）
+   - `6aspecdoc/brown/<name>/artifacts/01.5-specs.md` - 需求规格
+
+   注意：所有需要的业务规则答案应该已经在 understanding.md 中收集完成。
+
+3. **执行影响面分析**
+
+   分析以下维度：
+
+   a. **直接影响**
+   - 哪些表需要加字段
+   - 哪些实体类需要修改
+   - 哪些 DAO 需要更新
+   - 哪些服务类需要修改
+   - 哪些控制器需要更新
+   - 哪些 API 需要变更
+
+   b. **间接影响**
+   - 是否影响缓存逻辑
+   - 是否影响权限控制
+   - 是否影响历史数据兼容
+   - 是否影响事件订阅者
+   - 是否影响数据同步逻辑
+   - 是否影响 Excel 导入导出
+
+   c. **数据层影响**
+   - 是否改变数据语义
+   - 是否需要数据迁移
+   - 是否影响已有记录
+   - 是否需要索引优化
+
+   d. **UI/UX 影响**
+   - 字段如何展示
+   - 是否需要新的交互逻辑
+   - 错误提示是否友好
+   - 是否需要多语言支持
+
+4. **执行非功能需求评估**
+
+   评估以下维度：
+
+   a. **性能影响**
+   - 是否影响核心查询路径
+   - 是否需要新增索引
+   - 是否影响缓存策略
+   - 预估 QPS 变化
+
+   b. **安全影响**
+   - 是否涉及敏感数据
+   - 是否需要权限控制
+   - 是否需要审计日志
+   - 是否需要数据脱敏
+
+   c. **可用性影响**
+   - 是否需要降级方案
+   - 是否需要灰度发布
+   - 回滚方案是什么
+   - 监控告警如何配置
+
+   d. **可维护性影响**
+   - 是否增加系统复杂度
+   - 是否引入技术债务
+   - 是否需要文档更新
+   - 是否需要培训
+
+5. **创建函数映射表**
+
+   创建详细的函数级影响映射：
+   ```markdown
+   | 模块 | 类 | 函数 | 影响类型 | 影响描述 | 优先级 |
+   |------|-----|------|----------|----------|--------|
+   | 实体层 | XxxEntity | 所有字段访问 | ✏️ 修改 | 新增字段属性 | P0 |
+   | 领域服务 | XxxDomainService | save() | 🔴 重要修改 | 必填校验+不可修改约束 | P0 |
+   ```
+
+6. **创建影响面分析文档**
+
+   创建 `6aspecdoc/brown/<name>/artifacts/02-impact-analysis.md`：
+   ```markdown
+   # Phase 2: 影响面分析与非功能需求评估
+
+   > **需求**: <name>
+   > **阶段**: Phase 2 - 影响面分析
+   > **状态**: ✅ 已完成
+   > **完成时间**: <timestamp>
+
+   ## 1. 业务规则总结
+
+   基于 understanding.md 中收集的业务规则答案，总结关键业务规则：
+
+   | 规则 | 答案 | 说明 |
+   |------|------|------|
+   | 字段名称 | <答案> | <说明> |
+   | 是否必填 | <答案> | <说明> |
+   | 是否可修改 | <答案> | 🔴 关键约束 |
+   ...
+
+   ## 2. 影响面分析
+
+   ### 2.1 直接影响
+
+   #### 数据库表
+   <列出需要修改的表>
+
+   #### 实体类
+   <列出需要修改的实体类>
+
+   #### 服务类
+   <列出需要修改的服务类>
+
+   #### API 接口
+   <列出需要修改的 API>
+
+   ### 2.2 间接影响
+
+   #### 缓存逻辑
+   <是否影响，如何影响>
+
+   #### 权限控制
+   <是否影响，如何影响>
+
+   #### 历史数据
+   <是否影响，如何处理>
+
+   #### 事件订阅
+   <是否影响，哪些订阅者>
+
+   ### 2.3 数据层影响
+
+   #### 数据语义变化
+   <是否改变，如何改变>
+
+   #### 数据迁移需求
+   <是否需要，迁移方案>
+
+   #### 索引优化
+   <是否需要，优化建议>
+
+   ### 2.4 UI/UX 影响
+
+   | 页面 | 字段状态 | 交互逻辑 | 错误提示 |
+   |------|----------|----------|----------|
+   | XX新增页面 | ✅ 可编辑（必填） | 下拉选择 | "请选择XX" |
+   | XX编辑页面 | 🔴 置灰/隐藏 | 不可修改 | "不允许修改" |
+
+   ## 3. 非功能需求评估
+
+   ### 3.1 性能影响
+
+   | 评估项 | 影响 | 说明 |
+   |--------|------|------|
+   | 核心查询路径 | ✅ 无影响 / ⚠️ 有影响 | <说明> |
+   | 索引需求 | ✅ 需要 / ❌ 不需要 | <说明> |
+   | 缓存策略 | ✅ 需要调整 / ❌ 无需调整 | <说明> |
+   | QPS 变化 | <预估> | <说明> |
+
+   ### 3.2 安全影响
+
+   | 评估项 | 影响 | 说明 |
+   |--------|------|------|
+   | 敏感数据 | ✅ 是 / ❌ 否 | <说明> |
+   | 权限控制 | ✅ 需要 / ❌ 不需要 | <说明> |
+   | 审计日志 | ✅ 需要 / ❌ 不需要 | <说明> |
+   | 数据脱敏 | ✅ 需要 / ❌ 不需要 | <说明> |
+
+   ### 3.3 可用性影响
+
+   | 评估项 | 方案 |
+   |--------|------|
+   | 降级方案 | <方案> |
+   | 灰度发布 | <方案> |
+   | 回滚方案 | <方案> |
+   | 监控告警 | <方案> |
+
+   ### 3.4 可维护性影响
+
+   | 评估项 | 评估 | 说明 |
+   |--------|------|------|
+   | 系统复杂度 | ⬆️ 增加 / ➡️ 不变 / ⬇️ 降低 | <说明> |
+   | 技术债务 | ✅ 引入 / ❌ 不引入 | <说明> |
+   | 文档更新 | ✅ 需要 / ❌ 不需要 | <说明> |
+   | 培训需求 | ✅ 需要 / ❌ 不需要 | <说明> |
+
+   ## 4. 函数级影响映射
+
+   <详细的函数映射表>
+
+   ## 5. 影响面总结
+
+   ### 影响范围
+   - 数据库表：<数量>
+   - 实体类：<数量>
+   - 服务类：<数量>
+   - 控制器：<数量>
+   - 前端页面：<数量>
+
+   ### 关键风险
+   <列出 2-3 个关键风险>
+
+   ### 工作量预估
+   - 后端开发：<预估>
+   - 前端开发：<预估>
+   - 测试：<预估>
+   - 总计：<预估>
+
+   ## 6. 下一步
+
+   运行 `/6aspec:brown:design` 进行技术方案设计。
+   ```
+
+7. **更新状态**
+
+   更新 `6aspecdoc/brown/<name>/status.json`：
+   ```json
+   {
+     "status": "design_pending",
+     "phases": {
+       "understand": "done",
+       "impact": "done",
+       "design": "pending",
+       ...
+     },
+     "artifacts": ["01-understanding.md", "02-impact-analysis.md"]
+   }
+   ```
+
+8. **停止并等待用户指令**
+
+**输出**
+
+完成后，显示：
+```
+## Phase 2 完成：影响面分析
+
+**需求**: <name>
+**进度**: 2/7 阶段完成
+
+### 影响范围
+- 数据库表：<数量>
+- 后端类：<数量>
+- 前端页面：<数量>
+
+### 关键发现
+<列出 2-3 个关键发现>
+
+### 关键风险
+<列出 2-3 个关键风险>
+
+### 工作量预估
+总计：<预估>
+
+### 文档位置
+6aspecdoc/brown/<name>/artifacts/02-impact-analysis.md
+
+### 下一步
+- 直接回复补充遗漏的影响点或修正分析 → 我会更新本阶段文档（02-impact-analysis.md）
+- 运行 `/6aspec:brown:design` → 进入技术方案设计阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
+```
+
+**用户补充信息时的处理**
+
+当用户指出遗漏的影响点、修正分析结论、或补充业务规则时（未使用阶段命令）：
+1. 将用户的补充整合到 `02-impact-analysis.md` 的对应章节
+2. 展示变更摘要
+3. 再次提示：可以继续补充，或通过命令进入下一阶段
+4. **禁止**：不得自动进入下一阶段
+
+**防护措施**
+- 必须先完成 Phase 1.5（specs）才能执行 Phase 2
+- 所有业务规则答案应该已经在 understanding.md 中收集完成
+- 影响面分析必须全面，不能遗漏间接影响
+- 非功能需求评估必须具体，不能泛泛而谈
+- 函数映射表必须精确到函数级别
+- 工作量预估要基于实际影响范围

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

@@ -0,0 +1,133 @@
+# 棕地需求 - Implement SOP
+
+执行任务实现。
+
+**输入**：`/6aspec:brown:implement` 后可选需求名称。
+
+**步骤**
+
+1. **选择需求并检查状态**
+
+   - 读取 `6aspecdoc/brown/<name>/status.json`
+   - 确认 `phases.tasks` 为 "done"
+   - 如果未完成 Phase 4，提示先运行 `/6aspec:brown:tasks`
+
+2. **读取上下文文件**
+
+   读取以下文档：
+   - `6aspecdoc/brown/<name>/artifacts/01-understanding.md`
+   - `6aspecdoc/brown/<name>/artifacts/02-impact-analysis.md`
+   - `6aspecdoc/brown/<name>/artifacts/03-technical-design.md`
+   - `6aspecdoc/brown/<name>/artifacts/04-tasks-overview.md`
+   - `6aspecdoc/brown/<name>/tasks/TASK-*.md`
+
+3. **显示当前进度**
+
+   显示：
+   - 总任务数
+   - 已完成任务数
+   - 待完成任务数
+   - 下一个待执行的任务
+
+4. **执行任务（循环直到完成或阻塞）**
+
+   对每个待完成的任务：
+
+   a. **显示正在执行的任务**
+   ```
+   ## 执行任务 3/8: TASK-003-domain-service-logic
+
+   **任务描述**: 实现领域服务业务逻辑
+   **预估工时**: 2人日
+   ```
+
+   b. **读取任务详情**
+   - 读取 `6aspecdoc/brown/<name>/tasks/TASK-<序号>.md`
+   - 理解任务目标、输入、输出、详细步骤
+
+   c. **执行代码变更**
+   - 根据任务步骤进行代码修改
+   - 保持变更最小化和聚焦
+   - 遵循技术方案设计
+
+   d. **标记任务完成**
+   - 在任务文件中更新状态：`📋 待开始` → `✅ 已完成`
+   - 在 `04-tasks-overview.md` 中更新任务状态：`- [ ]` → `- [x]`
+   - 更新 `status.json` 中的任务计数
+
+   e. **继续下一个任务**
+
+   **暂停条件**：
+   - 任务不清晰 → 询问澄清
+   - 实现发现设计问题 → 建议更新 artifacts
+   - 遇到错误或阻塞 → 报告并等待指导
+   - 用户中断
+
+5. **完成或暂停时显示状态**
+
+   **如果全部完成**：
+   ```
+   ## 实现完成：<name>
+
+   **进度**: 5/7 阶段完成
+   **任务完成**: 8/8 (100%)
+
+   ### 本次完成的任务
+   - [x] TASK-001: 数据库字段配置
+   - [x] TASK-002: 实体类字段添加
+   - [x] TASK-003: 领域服务逻辑实现
+   ...
+
+   ### 下一步
+   所有任务已完成！运行 `/6aspec:brown:verify` 进行验证。
+   ```
+
+   **如果暂停**：
+   ```
+   ## 实现暂停：<name>
+
+   **进度**: 5/7 阶段完成
+   **任务完成**: 4/8 (50%)
+
+   ### 暂停原因
+   <描述遇到的问题>
+
+   ### 选项
+   1. <选项 1>
+   2. <选项 2>
+   3. 其他方法
+
+   你想怎么做？
+   ```
+
+6. **更新状态**
+
+   如果全部完成，更新 `status.json`：
+   ```json
+   {
+     "status": "verify_pending",
+     "phases": {
+       ...
+       "implement": "done",
+       "verify": "pending"
+     },
+     "tasks": {
+       "total": 8,
+       "completed": 8,
+       "pending": 0
+     }
+   }
+   ```
+
+**输出**
+
+根据执行情况显示相应的输出（见步骤 5）。
+
+**防护措施**
+- 必须先完成 Phase 4
+- 必须读取上下文文件再开始实现
+- 如果任务模糊，暂停并询问
+- 如果实现发现设计问题，暂停并建议更新 artifacts
+- 保持代码变更最小化和聚焦
+- 立即更新任务状态
+- 遇到错误时暂停并报告

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

@@ -0,0 +1,69 @@
+# 棕地需求 - List SOP
+
+列出所有需求及其状态。
+
+**输入**：`/6aspec:brown:list` 无需参数。
+
+**步骤**
+
+1. **扫描需求目录**
+
+   读取 `6aspecdoc/brown/` 目录下的所有子目录。
+
+2. **读取每个需求的状态**
+
+   对每个需求，读取 `6aspecdoc/brown/<name>/status.json`。
+
+3. **按状态分组显示**
+
+   将需求按状态分组：
+   - 进行中（任何阶段未完成）
+   - 已完成（所有阶段完成，未归档）
+   - 已归档
+
+4. **显示需求列表**
+
+**输出**
+
+```
+## 需求列表
+
+### 进行中 (2)
+
+| 需求 | 优先级 | 当前阶段 | 进度 | 最后修改 |
+|------|--------|----------|------|----------|
+| add-user-auth | P0 | Phase 3: 技术方案设计 | 3/7 | 2小时前 |
+| fix-login-bug | P1 | Phase 2: 影响面分析 | 2/7 | 1天前 |
+
+### 已完成 (1)
+
+| 需求 | 优先级 | 完成时间 | 任务完成率 |
+|------|--------|----------|-----------|
+| add-export-feature | P1 | 3天前 | 8/8 (100%) |
+
+### 已归档 (3)
+
+| 需求 | 优先级 | 归档时间 |
+|------|--------|----------|
+| refactor-api | P0 | 1周前 |
+| update-ui | P1 | 2周前 |
+| fix-typo | P2 | 1个月前 |
+
+### 统计
+
+- 总需求数：6
+- 进行中：2
+- 已完成：1
+- 已归档：3
+
+### 快速操作
+
+- 继续最近的需求：`/6aspec:brown:continue`
+- 查看需求详情：`/6aspec:brown:status <name>`
+- 创建新需求：`/6aspec:brown:new`
+```
+
+**防护措施**
+- 如果 6aspecdoc/brown 目录不存在，提示创建第一个需求
+- 如果状态文件损坏，标记为"状态异常"
+- 按最后修改时间排序