6aspec 2.0.0-dev.2

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

@@ -0,0 +1,360 @@
+# 棕地需求 - Verify SOP
+
+验证实现是否符合需求和设计。
+
+**设计理念**：借鉴 OpenSpec 的三维验证框架（Completeness、Correctness、Coherence），结合棕地工作流的业务系统特点（业务规则、非功能需求、影响面覆盖）。
+
+**输入**：`/6aspec:brown:verify` 后可选需求名称。
+
+**步骤**
+
+1. **选择需求并检查状态**
+
+   - 读取 `6aspecdoc/brown/<name>/status.json`
+   - 确认 `phases.implement` 为 "done"
+   - 获取 `flowDepth`（流程深度）
+   - 如果未完成 Phase 5，提示先运行 `/6aspec:brown:implement`
+
+2. **读取验证基准文档**
+
+   根据流程深度读取不同的文档：
+
+   **轻量级流程**：
+   - `artifacts/proposal.md` - 需求提案
+   - `artifacts/design.md` - 技术方案
+   - `artifacts/tasks.md` - 任务列表
+
+   **标准级流程**：
+   - `artifacts/understanding.md` - 需求理解
+   - `artifacts/impact-analysis.md` - 影响面分析
+   - `artifacts/design.md` - 技术方案
+   - `artifacts/tasks.md` - 任务列表
+
+   **完整级流程**：
+   - 所有标准级文档
+   - 加上非功能需求评估（在 impact-analysis.md 中）
+
+3. **初始化验证报告结构**
+
+   创建三维验证框架：
+
+   **Completeness（完整性）**：
+   - 任务完成度
+   - 影响面覆盖（棕地特色）
+
+   **Correctness（正确性）**：
+   - 需求实现映射
+   - 业务规则验证（棕地特色）
+   - 场景覆盖
+
+   **Coherence（一致性）**：
+   - 设计遵循
+   - 代码模式一致性
+   - 非功能需求符合（棕地特色）
+
+4. **验证 Completeness（完整性）**
+
+   **4.1 任务完成度验证**（借鉴 OpenSpec）
+
+   - 读取 `artifacts/tasks.md` 或 `artifacts/04-tasks-overview.md`
+   - 解析 checkbox：`- [ ]`（未完成）vs `- [x]`（已完成）
+   - 统计完成率：X/Y 任务完成
+   - 如果有未完成任务：
+     - 添加 **CRITICAL** 问题：`Task incomplete: <task-id> - <description>`
+     - 建议：`Complete task or mark as done if already implemented`
+
+   **4.2 影响面覆盖验证**（棕地特色）
+
+   仅适用于标准级/完整级流程：
+
+   - 读取 `artifacts/impact-analysis.md`
+   - 提取影响点列表：
+     - 数据库表
+     - 实体类
+     - 服务类
+     - 控制器
+     - 前端页面
+   - 对每个影响点：
+     - 搜索代码库验证是否有相应修改
+     - 检查 git diff 或最近的提交
+   - 如果影响点未覆盖：
+     - 添加 **CRITICAL** 问题：`Impact point not covered: <entity/service/table>`
+     - 建议：`Implement changes for <specific-file>:<line> as per impact analysis`
+
+5. **验证 Correctness（正确性）**
+
+   **5.1 需求实现映射**（借鉴 OpenSpec）
+
+   - 提取需求关键点：
+     - 轻量级：从 proposal.md 提取 What 部分
+     - 标准级/完整级：从 understanding.md 提取需求描述
+   - 对每个需求点：
+     - 搜索代码库查找实现证据
+     - 如果找到，记录文件路径和行号
+     - 评估实现是否符合需求意图
+   - 如果需求未实现或偏离：
+     - 添加 **WARNING** 问题：`Requirement not found or diverges: <requirement>`
+     - 建议：`Review <file>:<lines> against requirement`
+
+   **5.2 业务规则验证**（棕地特色）
+
+   仅适用于标准级/完整级流程：
+
+   - 读取 `artifacts/impact-analysis.md` 中的"业务规则确认"部分
+   - 提取关键业务规则：
+     - 必填校验
+     - 不可修改约束
+     - 继承逻辑
+     - 数据同步规则
+   - 对每个业务规则：
+     - 搜索代码库验证实现
+     - 检查校验逻辑、约束条件
+   - 如果业务规则未实现：
+     - 添加 **CRITICAL** 问题：`Business rule not implemented: <rule>`
+     - 建议：`Add validation/constraint in <service>:<method>`
+
+   **5.3 场景覆盖验证**（借鉴 OpenSpec）
+
+   - 提取测试场景：
+     - 从 design.md 的测试方案部分
+     - 从 tasks.md 的测试任务
+   - 对每个场景：
+     - 检查是否有对应的测试代码
+     - 检查测试是否通过
+   - 如果场景未覆盖：
+     - 添加 **WARNING** 问题：`Scenario not covered: <scenario>`
+     - 建议：`Add test for scenario: <description>`
+
+6. **验证 Coherence（一致性）**
+
+   **6.1 设计遵循验证**（借鉴 OpenSpec）
+
+   - 读取 `artifacts/design.md` 或 `artifacts/03-technical-design.md`
+   - 提取关键设计决策：
+     - 数据库变更方案
+     - 代码实现方案
+     - 前端 UI 方案
+   - 验证实现是否遵循设计：
+     - 检查数据库字段是否按设计添加
+     - 检查代码结构是否符合设计
+     - 检查 UI 是否按设计实现
+   - 如果设计未遵循：
+     - 添加 **WARNING** 问题：`Design decision not followed: <decision>`
+     - 建议：`Update implementation or revise design.md to match reality`
+
+   **6.2 代码模式一致性**（借鉴 OpenSpec）
+
+   - 检查新代码的一致性：
+     - 文件命名规范
+     - 目录结构
+     - 编码风格
+     - 错误处理模式
+   - 如果有明显偏离：
+     - 添加 **SUGGESTION** 问题：`Code pattern deviation: <details>`
+     - 建议：`Consider following project pattern: <example>`
+
+   **6.3 非功能需求符合验证**（棕地特色）
+
+   仅适用于完整级流程：
+
+   - 读取 `artifacts/impact-analysis.md` 中的"非功能需求评估"部分
+   - 验证四个维度：
+
+   **性能**：
+   - 检查是否添加了必要的索引
+   - 检查是否优化了查询
+   - 检查是否有性能测试
+   - 如果性能要求未满足：
+     - 添加 **WARNING** 问题：`Performance requirement not met: <requirement>`
+     - 建议：`Add index/optimize query in <file>:<line>`
+
+   **安全**：
+   - 检查是否有权限控制
+   - 检查是否有数据脱敏
+   - 检查是否有审计日志
+   - 如果安全要求未满足：
+     - 添加 **CRITICAL** 问题：`Security requirement not met: <requirement>`
+     - 建议：`Add permission check/audit log in <file>:<line>`
+
+   **可用性**：
+   - 检查是否有降级方案
+   - 检查是否有监控告警
+   - 如果可用性要求未满足：
+     - 添加 **WARNING** 问题：`Availability requirement not met: <requirement>`
+     - 建议：`Add fallback/monitoring in <file>:<line>`
+
+   **可维护性**：
+   - 检查代码注释是否充分
+   - 检查是否有文档更新
+   - 如果可维护性要求未满足：
+     - 添加 **SUGGESTION** 问题：`Maintainability concern: <details>`
+     - 建议：`Add comments/update docs`
+
+7. **生成验证报告**
+
+   创建 `6aspecdoc/brown/<name>/artifacts/verification-report.md`（标准级/完整级）或 `6aspecdoc/brown/<name>/artifacts/05-verification-report.md`（完整级）：
+
+   ```markdown
+   # 验证报告：<name>
+
+   > **需求**: <name>
+   > **流程深度**: 轻量级/标准级/完整级
+   > **验证时间**: <timestamp>
+   > **验证状态**: ✅ 通过 / ⚠️ 有警告 / ❌ 有严重问题
+
+   ## 验证概览
+
+   | 维度 | 状态 | 说明 |
+   |------|------|------|
+   | Completeness（完整性） | X/Y 任务, M/N 影响点 | <说明> |
+   | Correctness（正确性） | P/Q 需求, R/S 业务规则 | <说明> |
+   | Coherence（一致性） | 设计遵循/代码一致 | <说明> |
+
+   ## 问题清单
+
+   ### CRITICAL（必须修复）
+
+   如果有 CRITICAL 问题，列出：
+
+   #### 1. Task incomplete: TASK-003
+   - **问题**: 任务未完成：领域服务逻辑实现
+   - **位置**: tasks/TASK-003.md
+   - **建议**: Complete task or mark as done if already implemented
+
+   #### 2. Business rule not implemented: 不可修改约束
+   - **问题**: 业务规则未实现：项目类型一旦确定后不允许修改
+   - **位置**: 应该在 ProjectDomainService:save() 中
+   - **建议**: Add validation in ProjectDomainService:save() to prevent modification
+
+   ### WARNING（应该修复）
+
+   如果有 WARNING 问题，列出：
+
+   #### 1. Design decision not followed: 索引优化
+   - **问题**: 设计中要求添加索引，但未找到相应的数据库迁移脚本
+   - **位置**: design.md 第 45 行
+   - **建议**: Add database migration script for index creation
+
+   ### SUGGESTION（建议修复）
+
+   如果有 SUGGESTION 问题，列出：
+
+   #### 1. Code pattern deviation: 错误处理
+   - **问题**: 新代码使用了不同的错误处理模式
+   - **位置**: ProjectApplicationService:123
+   - **建议**: Consider using BusinessLogicException pattern like other services
+
+   ## 最终评估
+
+   根据问题严重程度给出评估：
+
+   - 如果有 CRITICAL 问题：
+     ```
+     ❌ 发现 X 个严重问题，必须修复后才能归档。
+     ```
+
+   - 如果只有 WARNING：
+     ```
+     ⚠️ 没有严重问题，但有 Y 个警告需要考虑。可以归档，但建议修复警告。
+     ```
+
+   - 如果全部通过：
+     ```
+     ✅ 所有检查通过，可以归档。
+     ```
+
+   ## 验证详情
+
+   ### Completeness 详情
+   ...
+
+   ### Correctness 详情
+   ...
+
+   ### Coherence 详情
+   ...
+
+   ## 下一步
+
+   根据验证结果给出建议：
+   - 如果有 CRITICAL：修复严重问题后重新验证
+   - 如果只有 WARNING：可以归档，但建议修复警告
+   - 如果全部通过：运行 `/6aspec:brown:review` 进行实施后评估（完整级）或 `/6aspec:brown:archive` 归档
+   ```
+
+8. **更新状态**
+
+   如果验证通过（无 CRITICAL 问题），更新 `status.json`：
+   ```json
+   {
+     "status": "review_pending",
+     "status": "completed",
+     "phases": {
+       ...
+       "verify": "done",
+       "review": "pending"
+     }
+   }
+   ```
+
+**输出**
+
+```
+## 验证完成：<name>
+
+**流程深度**: 轻量级/标准级/完整级
+**验证状态**: ✅ 通过 / ⚠️ 有警告 / ❌ 有严重问题
+
+### 验证概览
+- Completeness: X/Y 任务完成, M/N 影响点覆盖
+- Correctness: P/Q 需求实现, R/S 业务规则验证
+- Coherence: 设计遵循/代码一致
+
+### 问题统计
+- CRITICAL: X 个（必须修复）
+- WARNING: Y 个（应该修复）
+- SUGGESTION: Z 个（建议修复）
+
+### 最终评估
+<根据问题严重程度给出评估>
+
+### 文档位置
+6aspecdoc/brown/<name>/artifacts/verification-report.md
+
+### 下一步
+<根据验证结果给出建议>
+```
+
+**验证启发式规则**（借鉴 OpenSpec）
+
+- **Completeness**：关注客观的检查清单项（checkbox、影响点列表）
+- **Correctness**：使用关键词搜索、文件路径分析、合理推断 - 不要求完美确定性
+- **Coherence**：寻找明显的不一致，不要过度挑剔风格
+- **误报处理**：不确定时，优先使用 SUGGESTION 而不是 WARNING，WARNING 而不是 CRITICAL
+- **可操作性**：每个问题必须有具体的、可操作的建议，包含文件/行号引用
+
+**优雅降级**（借鉴 OpenSpec）
+
+根据流程深度调整验证范围：
+
+- **轻量级流程**：
+  - 验证：任务完成度 + 设计遵循
+  - 跳过：影响面覆盖、业务规则、非功能需求
+  - 说明：`Lightweight flow: skipped impact/business rule checks`
+
+- **标准级流程**：
+  - 验证：任务完成度 + 影响面覆盖 + 业务规则 + 设计遵循
+  - 跳过：非功能需求详细验证
+  - 说明：`Standard flow: skipped detailed non-functional requirement checks`
+
+- **完整级流程**：
+  - 验证：所有三个维度的全部检查
+  - 说明：`Complete flow: all checks performed`
+
+**防护措施**
+- 必须先完成 Phase 5（implement）
+- 验证必须基于文档基准，不能主观判断
+- 发现问题必须明确标注严重程度（CRITICAL/WARNING/SUGGESTION）
+- 每个问题必须提供具体的、可操作的建议
+- 如果验证未通过（有 CRITICAL 问题），不能进入下一阶段
+- 根据流程深度优雅降级，不要对轻量级流程执行完整级的验证

package/.6aspec/rules/green/6A_archive_sop.md

@@ -0,0 +1,301 @@
+# 绿地需求归档 SOP
+
+## 目标
+
+归档已完成的绿地需求，将需求目录移动到归档位置，并更新状态。
+
+## 前置条件
+
+- 需求的所有工件已完成
+- 需求的所有任务已完成
+- 需求状态为 `completed`
+
+## 执行步骤
+
+### Step 1: 检测当前需求
+
+**1.1 检查是否在需求目录下**
+
+检查当前工作目录是否在 `6aspecdoc/green/<feature-name>/` 下：
+
+```bash
+pwd
+```
+
+如果在需求目录下，自动识别需求名称（从路径中提取）。
+
+**1.2 如果不在需求目录下，列出所有可归档的需求**
+
+```bash
+find 6aspecdoc/green -maxdepth 2 -name ".green-status.json" -type f
+```
+
+读取每个状态文件，筛选出状态为 `completed` 的需求。
+
+如果找到多个可归档的需求，使用 **AskUserQuestion** 让用户选择要归档的需求。
+
+选项应该显示：
+- 需求名称
+- 完成时间
+- 任务完成情况（如：8/8 任务已完成）
+
+如果没有找到任何可归档的需求，输出：
+```
+未找到可归档的需求。
+
+只有状态为 "completed" 的需求才能归档。
+
+运行 /6aspec:green:status 查看当前需求状态。
+```
+
+### Step 2: 读取状态文件
+
+读取 `6aspecdoc/green/<feature-name>/.green-status.json` 文件。
+
+如果文件不存在或格式错误，输出错误信息并退出。
+
+### Step 3: 检查归档条件
+
+**3.1 检查工件完成状态**
+
+检查状态文件中的 `artifacts` 字段，确认所有工件的状态都是 `done`：
+
+```json
+{
+  "artifacts": {
+    "requirement": { "status": "done" },
+    "models": { "status": "done" },
+    "design": { "status": "done" },
+    "tasks": { "status": "done" }
+  }
+}
+```
+
+如果有任何工件状态不是 `done`，**拒绝归档**，停止并提示：
+
+```
+❌ 未通过依赖检查，不允许归档
+
+存在未完成的工件：
+- <artifact-name>: <status>
+
+请先完成主流程中对应步骤（new → model → design → tasks），待所有工件状态为 done 后再运行 /6aspec:green:archive。
+```
+
+**3.2 检查任务完成状态**
+
+检查状态文件中的 `tasks` 字段：
+
+```json
+{
+  "tasks": {
+    "total": 8,
+    "completed": 8,
+    "remaining": 0
+  }
+}
+```
+
+如果 `completed` < `total`，**拒绝归档**，停止并提示：
+
+```
+❌ 未通过依赖检查，不允许归档
+
+任务进度：<completed>/<total> 已完成，剩余 <remaining> 个任务未完成。
+
+请先运行 /6aspec:green:execute-task 完成所有任务，待状态变为 completed 后再运行 /6aspec:green:archive。
+```
+
+**3.3 检查状态（硬性门禁）**
+
+如果状态不是 `completed`，**拒绝归档**，不得提供“仍要继续”选项，直接停止并提示：
+
+```
+❌ 未通过依赖检查，不允许归档
+
+当前状态：<current-status>
+要求状态：completed（所有任务已完成）
+
+归档前必须完成主流程至“所有任务已完成”。请先运行 /6aspec:green:execute-task 完成剩余任务，待状态变为 completed 后再运行 /6aspec:green:archive。
+```
+
+### Step 4: 执行归档
+
+**4.1 创建归档目录**
+
+如果归档目录不存在，创建它：
+
+```bash
+mkdir -p 6aspecdoc/green/archive
+```
+
+**4.2 生成归档目标名称**
+
+使用当前日期和需求名称生成归档目标名称：
+
+格式：`YYYY-MM-DD-<feature-name>`
+
+例如：`2026-02-16-user-authentication`
+
+**4.3 检查目标是否已存在**
+
+检查归档目标目录是否已存在：
+
+```bash
+ls -d 6aspecdoc/green/archive/YYYY-MM-DD-<feature-name> 2>/dev/null
+```
+
+如果已存在，输出错误并停止：
+
+```
+❌ 归档失败
+
+目标目录已存在：6aspecdoc/green/archive/YYYY-MM-DD-<feature-name>
+
+可能的原因：
+1. 今天已经归档过同名需求
+2. 归档目录中存在重复
+
+建议：
+1. 重命名现有归档目录
+2. 删除现有归档（如果是重复的）
+3. 等到明天再归档
+```
+
+**4.4 移动需求目录**
+
+将需求目录移动到归档位置：
+
+```bash
+mv 6aspecdoc/green/<feature-name> 6aspecdoc/green/archive/YYYY-MM-DD-<feature-name>
+```
+
+**4.5 更新状态文件**
+
+读取归档后的状态文件，更新状态：
+
+```json
+{
+  "status": "archived",
+  "lastModified": "<current-timestamp>"
+}
+```
+
+写回状态文件：
+
+```bash
+# 更新 6aspecdoc/green/archive/YYYY-MM-DD-<feature-name>/.green-status.json
+```
+
+### Step 5: 显示归档摘要
+
+输出归档完成的摘要信息：
+
+```
+✅ 归档完成
+
+需求：<feature-name>
+归档位置：6aspecdoc/green/archive/YYYY-MM-DD-<feature-name>/
+归档时间：<current-timestamp>
+
+工件完成情况：
+✓ 需求澄清文档
+✓ 领域模型
+✓ 技术方案
+✓ 任务列表
+
+任务完成情况：
+✓ 所有任务已完成 (<total>/<total>)
+
+状态：已归档
+```
+
+如果有警告（如未完成的工件或任务），在摘要中显示：
+
+```
+✅ 归档完成（带警告）
+
+需求：<feature-name>
+归档位置：6aspecdoc/green/archive/YYYY-MM-DD-<feature-name>/
+归档时间：<current-timestamp>
+
+⚠️  警告：
+- 归档时有 <N> 个工件未完成
+- 归档时有 <M> 个任务未完成
+
+请检查归档内容是否符合预期。
+```
+
+## 错误处理
+
+### 错误 1: 状态文件不存在
+
+```
+错误：未找到状态文件
+
+路径：6aspecdoc/green/<feature-name>/.green-status.json
+
+无法归档没有状态文件的需求。
+
+建议：
+1. 检查需求目录是否正确
+2. 手动创建状态文件（参考 green_status_schema.md）
+```
+
+### 错误 2: 归档目录已存在
+
+```
+错误：归档目标已存在
+
+目标：6aspecdoc/green/archive/YYYY-MM-DD-<feature-name>/
+
+建议：
+1. 重命名现有归档目录
+2. 删除现有归档（如果是重复的）
+3. 等到明天再归档
+```
+
+### 错误 3: 移动失败
+
+```
+错误：无法移动需求目录
+
+源：6aspecdoc/green/<feature-name>
+目标：6aspecdoc/green/archive/YYYY-MM-DD-<feature-name>
+
+错误信息：<error-message>
+
+请检查文件权限和磁盘空间。
+```
+
+## 注意事项
+
+1. **不可逆操作**：归档是移动操作，不是复制。归档后原位置的需求目录将不存在
+2. **状态检查**：归档前会检查工件和任务完成状态，但允许用户强制归档
+3. **日期命名**：使用日期前缀可以方便地按时间排序归档
+4. **状态更新**：归档后状态文件会被更新为 `archived`
+5. **保留结构**：归档时保留完整的需求目录结构，包括所有文件和子目录
+
+## 归档后的目录结构
+
+```
+6aspecdoc/green/
+├── archive/
+│   ├── 2026-02-15-feature-a/
+│   │   ├── .green-status.json
+│   │   ├── requirement.md
+│   │   ├── domain-model.md
+│   │   ├── tech-design.md
+│   │   ├── api-definition.md
+│   │   ├── tasks/
+│   │   └── ...
+│   └── 2026-02-16-feature-b/
+│       └── ...
+└── active-feature/
+    └── ...
+```
+
+## 参考文档
+
+- 状态文件结构定义：`.6aspec/rules/green/green_status_schema.md`
+- 状态查询SOP：`.6aspec/rules/green/6A_status_sop.md`