6a-spec-install 1.0.8-dev.4 → 1.0.9-dev.0

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

@@ -0,0 +1,287 @@
+# 棕地需求 - 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` - 需求规格
+
+3. **收集待明确问题的答案**
+
+   如果用户在对话中提供了答案，记录下来。
+   如果没有，询问用户关键问题。
+
+   **重要**：必须获得关键业务规则的答案才能继续。
+
+4. **执行影响面分析**
+
+   分析以下维度：
+
+   a. **直接影响**
+   - 哪些表需要加字段
+   - 哪些实体类需要修改
+   - 哪些 DAO 需要更新
+   - 哪些服务类需要修改
+   - 哪些控制器需要更新
+   - 哪些 API 需要变更
+
+   b. **间接影响**
+   - 是否影响缓存逻辑
+   - 是否影响权限控制
+   - 是否影响历史数据兼容
+   - 是否影响事件订阅者
+   - 是否影响数据同步逻辑
+   - 是否影响 Excel 导入导出
+
+   c. **数据层影响**
+   - 是否改变数据语义
+   - 是否需要数据迁移
+   - 是否影响已有记录
+   - 是否需要索引优化
+
+   d. **UI/UX 影响**
+   - 字段如何展示
+   - 是否需要新的交互逻辑
+   - 错误提示是否友好
+   - 是否需要多语言支持
+
+5. **执行非功能需求评估**
+
+   评估以下维度：
+
+   a. **性能影响**
+   - 是否影响核心查询路径
+   - 是否需要新增索引
+   - 是否影响缓存策略
+   - 预估 QPS 变化
+
+   b. **安全影响**
+   - 是否涉及敏感数据
+   - 是否需要权限控制
+   - 是否需要审计日志
+   - 是否需要数据脱敏
+
+   c. **可用性影响**
+   - 是否需要降级方案
+   - 是否需要灰度发布
+   - 回滚方案是什么
+   - 监控告警如何配置
+
+   d. **可维护性影响**
+   - 是否增加系统复杂度
+   - 是否引入技术债务
+   - 是否需要文档更新
+   - 是否需要培训
+
+6. **创建函数映射表**
+
+   创建详细的函数级影响映射：
+   ```markdown
+   | 模块 | 类 | 函数 | 影响类型 | 影响描述 | 优先级 |
+   |------|-----|------|----------|----------|--------|
+   | 实体层 | XxxEntity | 所有字段访问 | ✏️ 修改 | 新增字段属性 | P0 |
+   | 领域服务 | XxxDomainService | save() | 🔴 重要修改 | 必填校验+不可修改约束 | P0 |
+   ```
+
+7. **创建影响面分析文档**
+
+   创建 `6aspecdoc/brown/<name>/artifacts/02-impact-analysis.md`：
+   ```markdown
+   # Phase 2: 影响面分析与非功能需求评估
+
+   > **需求**: <name>
+   > **阶段**: Phase 2 - 影响面分析
+   > **状态**: ✅ 已完成
+   > **完成时间**: <timestamp>
+
+   ## 1. 业务规则确认
+
+   | 规则 | 答案 | 说明 |
+   |------|------|------|
+   | 字段名称 | <答案> | <说明> |
+   | 是否必填 | <答案> | <说明> |
+   | 是否可修改 | <答案> | 🔴 关键约束 |
+   ...
+
+   ## 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` 进行技术方案设计。
+   ```
+
+8. **更新状态**
+
+   更新 `6aspecdoc/brown/<name>/status.json`：
+   ```json
+   {
+     "status": "design_pending",
+     "phases": {
+       "understand": "done",
+       "impact": "done",
+       "design": "pending",
+       ...
+     },
+     "artifacts": ["01-understanding.md", "02-impact-analysis.md"]
+   }
+   ```
+
+9. **停止并等待用户确认**
+
+**输出**
+
+完成后，显示：
+```
+## Phase 2 完成：影响面分析
+
+**需求**: <name>
+**进度**: 2/7 阶段完成
+
+### 影响范围
+- 数据库表：<数量>
+- 后端类：<数量>
+- 前端页面：<数量>
+
+### 关键发现
+<列出 2-3 个关键发现>
+
+### 关键风险
+<列出 2-3 个关键风险>
+
+### 工作量预估
+总计：<预估>
+
+### 文档位置
+6aspecdoc/brown/<name>/artifacts/02-impact-analysis.md
+
+### 下一步
+- 运行 `/6aspec:brown:design` 进行技术方案设计
+- 或运行 `/6aspec:brown:continue` 自动进入下一阶段
+```
+
+**防护措施**
+- 必须先完成 Phase 1 才能执行 Phase 2
+- 必须获得关键业务规则的答案
+- 影响面分析必须全面，不能遗漏间接影响
+- 非功能需求评估必须具体，不能泛泛而谈
+- 函数映射表必须精确到函数级别
+- 工作量预估要基于实际影响范围

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 目录不存在，提示创建第一个需求
+- 如果状态文件损坏，标记为"状态异常"
+- 按最后修改时间排序

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

@@ -0,0 +1,228 @@
+# 棕地需求 - New SOP
+
+开始一个新的需求分析流程。
+
+**输入**：`/6aspec:brown:new` 后的参数是需求名称（kebab-case）或需求描述。
+
+**步骤**
+
+1. **如果没有提供输入，询问需求内容**
+
+   询问用户（开放式问题）：
+   > "你想分析什么需求？请描述要实现的功能或要解决的问题。"
+
+   从描述中提取 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>",
+     "phases": {
+       "proposal": "pending",
+       "design": "blocked",
+       "tasks": "blocked",
+       "implement": "blocked"
+     },
+     "artifacts": []
+   }
+   ```
+
+   **标准级**：
+   ```json
+   {
+     "name": "<name>",
+     "flowDepth": "standard",
+     "status": "understanding_pending",
+     "createdAt": "<timestamp>",
+     "lastModified": "<timestamp>",
+     "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>",
+     "phases": {
+       "understand": "pending",
+       "specs": "blocked",
+       "impact": "blocked",
+       "design": "blocked",
+       "tasks": "blocked",
+       "implement": "blocked",
+       "verify": "blocked",
+       "review": "blocked"
+     },
+     "artifacts": []
+   }
+   ```
+
+   创建需求索引文件 `6aspecdoc/brown/<name>/requirement.md`（方案B：简化为索引页）：
+   ```markdown
+   # <需求标题>
+
+   > **需求ID**: <name>
+   > **流程深度**: 轻量级/标准级/完整级
+   > **状态**: 📋 <当前阶段>
+   > **创建时间**: <timestamp>
+   > **最后修改**: <timestamp>
+
+   ## 快速导航
+
+   **需求详情**：
+   - 轻量级流程：[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>` 查看完整状态和所有文档。
+
+   ---
+
+   **说明**：本文件是需求的索引页，只包含元信息和导航链接。需求的详细内容在第一个 artifact 中（proposal.md 或 understanding.md）。
+   ```
+
+   **快速通道**：
+   创建简化的目录结构，并提示使用 `/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` 或选择新名称
+- 必须让用户选择流程深度