6aspec 2.0.0-dev.9 → 3.0.0-dev.1

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

@@ -1,6 +1,10 @@
 # 棕地需求 - Impact SOP
 
-Phase 2: 影响面分析与非功能需求评估
+影响面分析与非功能需求评估
+
+**适用流程**：标准级、完整级
+
+**流程定位**：标准级/完整级的第二阶段，基于 understand 的现状分析评估变更影响
 
 **输入**：`/6aspec:brown:impact` 后可选需求名称。如果省略，从上下文推断或提示选择。
 
@@ -9,24 +13,20 @@ Phase 2: 影响面分析与非功能需求评估
 1. **选择需求并检查状态**
 
    - 读取 `6aspecdoc/brown/<name>/status.json`
-   - 确认 `phases.specs` 为 "done"
-   - 如果未完成 Phase 1.5，提示先运行 `/6aspec:brown:specs`
+   - 确认流程深度为 "standard" 或 "complete"
+   - 如果是 "lightweight"，提示轻量级流程不需要impact阶段，应该直接运行 `/6aspec:brown:design`
+   - 确认 `phases.understand` 为 "done"
+   - 如果understand未完成，提示先运行 `/6aspec:brown:understand`
 
 2. **读取前置文档**
 
    读取以下文档获取上下文：
-   - `6aspecdoc/brown/<name>/requirement.md` - 需求描述
-   - `6aspecdoc/brown/<name>/artifacts/01-understanding.md` - 现状分析
-   - `6aspecdoc/brown/<name>/artifacts/01.5-specs.md` - 需求规格
-
-3. **收集待明确问题的答案**
+   - `6aspecdoc/brown/<name>/artifacts/original-requirement.md` - 原始需求
+   - `6aspecdoc/brown/<name>/artifacts/understanding.md` - 现状分析（含业务规则答案）
 
-   如果用户在对话中提供了答案，记录下来。
-   如果没有，询问用户关键问题。
+   **注意**：Impact 阶段不依赖 proposal，基于原始需求和现状分析来评估影响面。
 
-   **重要**：必须获得关键业务规则的答案才能继续。
-
-4. **执行影响面分析**
+3. **执行影响面分析**
 
    分析以下维度：
 
@@ -58,7 +58,7 @@ Phase 2: 影响面分析与非功能需求评估
    - 错误提示是否友好
    - 是否需要多语言支持
 
-5. **执行非功能需求评估**
+4. **执行非功能需求评估**
 
    评估以下维度：
 
@@ -86,7 +86,7 @@ Phase 2: 影响面分析与非功能需求评估
    - 是否需要文档更新
    - 是否需要培训
 
-6. **创建函数映射表**
+5. **创建函数映射表**
 
    创建详细的函数级影响映射：
    ```markdown
@@ -96,18 +96,21 @@ Phase 2: 影响面分析与非功能需求评估
    | 领域服务 | XxxDomainService | save() | 🔴 重要修改 | 必填校验+不可修改约束 | P0 |
    ```
 
-7. **创建影响面分析文档**
+6. **创建影响面分析文档**
 
-   创建 `6aspecdoc/brown/<name>/artifacts/02-impact-analysis.md`：
+   创建 `6aspecdoc/brown/<name>/artifacts/impact-analysis.md`：
    ```markdown
-   # Phase 2: 影响面分析与非功能需求评估
+   # 影响面分析与非功能需求评估
 
    > **需求**: <name>
-   > **阶段**: Phase 2 - 影响面分析
+   > **流程**: <flowDepth>
+   > **阶段**: Impact
    > **状态**: ✅ 已完成
    > **完成时间**: <timestamp>
 
-   ## 1. 业务规则确认
+   ## 1. 业务规则总结
+
+   基于 understanding.md 中收集的业务规则答案，总结关键业务规则：
 
    | 规则 | 答案 | 说明 |
    |------|------|------|
@@ -218,43 +221,72 @@ Phase 2: 影响面分析与非功能需求评估
    ### 关键风险
    <列出 2-3 个关键风险>
 
-   ### 工作量预估
-   - 后端开发：<预估>
-   - 前端开发：<预估>
-   - 测试：<预估>
-   - 总计：<预估>
-
    ## 6. 下一步
 
    运行 `/6aspec:brown:design` 进行技术方案设计。
    ```
 
-8. **更新状态**
+7. **更新状态**
 
    更新 `6aspecdoc/brown/<name>/status.json`：
+
+   **标准级流程**：
    ```json
    {
-     "status": "design_pending",
+     "status": "proposal_pending",
+     "flowDepth": "standard",
      "phases": {
        "understand": "done",
        "impact": "done",
-       "design": "pending",
-       ...
+       "proposal": "pending",
+       "specs": "blocked",
+       "design": "blocked",
+       "tasks": "blocked",
+       "implement": "blocked"
      },
-     "artifacts": ["01-understanding.md", "02-impact-analysis.md"]
+     "artifacts": ["understanding.md", "impact-analysis.md"]
    }
    ```
 
-9. **停止并等待用户指令**
+   **完整级流程**：
+   ```json
+   {
+     "status": "proposal_pending",
+     "flowDepth": "complete",
+     "phases": {
+       "understand": "done",
+       "impact": "done",
+       "proposal": "pending",
+       "specs": "blocked",
+       "design": "blocked",
+       "tasks": "blocked",
+       "implement": "blocked",
+       "verify": "blocked",
+       "review": "blocked"
+     },
+     "artifacts": ["understanding.md", "impact-analysis.md"]
+   }
+   ```
+
+   同时更新 `6aspecdoc/brown/<name>/requirement.md`：
+   - 更新"状态"字段为 `📋 Proposal 待开始`
+   - 更新"最后修改"时间戳为 `<timestamp>`
+   - 更新"当前阶段"为 `Impact - 影响面分析（已完成）`
+   - 更新"下一步操作"为 `运行 /6aspec:brown:proposal 继续下一阶段`
+   - 在"进度概览"中标记 Impact 阶段为已完成 `[x]`
+
+8. **停止并等待用户指令**
 
 **输出**
 
-完成后，显示：
+根据 `flowDepth` 显示不同的输出信息：
+
+**标准级流程**：
 ```
-## Phase 2 完成：影响面分析
+## Impact 完成：<name>
 
-**需求**: <name>
-**进度**: 2/7 阶段完成
+**流程**: 标准级
+**进度**: 2/6 阶段完成
 
 ### 影响范围
 - 数据库表：<数量>
@@ -267,30 +299,54 @@ Phase 2: 影响面分析与非功能需求评估
 ### 关键风险
 <列出 2-3 个关键风险>
 
-### 工作量预估
-总计：<预估>
+### 文档位置
+6aspecdoc/brown/<name>/artifacts/impact-analysis.md
+
+### 下一步
+- 直接回复补充遗漏的影响点或修正分析 → 我会更新本阶段文档（impact-analysis.md）
+- 运行 `/6aspec:brown:proposal` → 进入需求提案阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
+```
+
+**完整级流程**：
+```
+## Impact 完成：<name>
+
+**流程**: 完整级
+**进度**: 2/8 阶段完成
+
+### 影响范围
+- 数据库表：<数量>
+- 后端类：<数量>
+- 前端页面：<数量>
+
+### 关键发现
+<列出 2-3 个关键发现>
+
+### 关键风险
+<列出 2-3 个关键风险>
 
 ### 文档位置
-6aspecdoc/brown/<name>/artifacts/02-impact-analysis.md
+6aspecdoc/brown/<name>/artifacts/impact-analysis.md
 
 ### 下一步
-- 直接回复补充遗漏的影响点或修正分析 → 我会更新本阶段文档（02-impact-analysis.md）
-- 运行 `/6aspec:brown:design` → 进入技术方案设计阶段
+- 直接回复补充遗漏的影响点或修正分析 → 我会更新本阶段文档（impact-analysis.md）
+- 运行 `/6aspec:brown:proposal` → 进入需求提案阶段
 - 运行 `/6aspec:brown:continue` → 自动进入下一阶段
 ```
 
 **用户补充信息时的处理**
 
 当用户指出遗漏的影响点、修正分析结论、或补充业务规则时（未使用阶段命令）：
-1. 将用户的补充整合到 `02-impact-analysis.md` 的对应章节
+1. 将用户的补充整合到 `impact-analysis.md` 的对应章节
 2. 展示变更摘要
 3. 再次提示：可以继续补充，或通过命令进入下一阶段
 4. **禁止**：不得自动进入下一阶段
 
 **防护措施**
-- 必须先完成 Phase 1 才能执行 Phase 2
-- 必须获得关键业务规则的答案
+- 只适用于标准级和完整级流程
+- 必须先完成specs阶段才能执行impact阶段
+- 所有业务规则答案应该已经在 understanding.md 中收集完成
 - 影响面分析必须全面，不能遗漏间接影响
 - 非功能需求评估必须具体，不能泛泛而谈
 - 函数映射表必须精确到函数级别
-- 工作量预估要基于实际影响范围

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

@@ -2,65 +2,92 @@
 
 执行任务实现。
 
+> **阶段定位**：Implement 的目标是按 Tasks 阶段拆解的 `TASK-*.md` 逐个交付实现结果，并保持”变更最小化、可验证、可追溯”。
+> - 默认执行策略：**里程碑优先 + 依赖优先**（优先完成更早里程碑中依赖已满足的任务），串行执行。
+> - 执行模型：主 agent 作为协调者，每个任务派发独立的 implementer subagent 执行；实现完成后派发 spec compliance reviewer subagent 验证；主 agent 只管理队列和状态，不直接写代码。
+> - 关键承接：Tasks 中定义的「契约/数据库变更/迁移兼容回滚」等交付物，必须在 Implement 阶段逐项落地并验收。
+
 **输入**：`/6aspec:brown:implement` 后可选需求名称。
 
-**步骤**
+---
+
+## 步骤
 
 1. **选择需求并检查状态**
 
    - 读取 `6aspecdoc/brown/<name>/status.json`
-   - 确认 `phases.tasks` 为 "done"
+   - 确认 `phases.tasks` 为 “done”
    - 如果未完成 Phase 4，提示先运行 `/6aspec:brown:tasks`
 
-2. **读取上下文文件**
+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`
+   - `6aspecdoc/brown/<name>/artifacts/tasks-overview.md`（任务列表、里程碑归属、完成状态）
+   - 扫描各 `6aspecdoc/brown/<name>/tasks/TASK-*.md` 的**前置依赖**字段（只读该字段，不读全文）
 
-3. **显示当前进度**
+3. **分析依赖关系，建立任务队列**
+
+   读取每个 `TASK-*.md` 的"前置依赖"字段（以此为准，`tasks-overview.md` 的 mermaid 图仅供参考），按里程碑优先 + 依赖优先排列执行顺序：
+   - 优先选择最早里程碑中前置依赖全部完成的任务
+   - 若最早里程碑所有任务均被阻塞，暂停并报告阻塞原因
 
    显示：
-   - 总任务数
-   - 已完成任务数
-   - 待完成任务数
-   - 下一个待执行的任务
+   - 总任务数 / 已完成任务数 / 待完成任务数
+   - 各里程碑完成度（M0~Mn：已完成/总数）
+   - 下一个可执行任务
 
 4. **执行任务（循环直到完成或阻塞）**
 
-   对每个待完成的任务：
+   对每个待完成的任务，按以下流程执行：
+
+   **a. 派发 implementer agent**
 
-   a. **显示正在执行的任务**
+   调用 `implementer` agent，传入以下内容：
+
+   ```
+   请用 implementer agent 实现以下任务：
+
+   需求名称：[name]
+   TASK 文件路径：6aspecdoc/brown/[name]/tasks/TASK-<序号>.md
+   specs.md 路径：6aspecdoc/brown/[name]/artifacts/specs.md
+   design.md 路径：6aspecdoc/brown/[name]/artifacts/design.md
+   analysis.md 路径：6aspecdoc/brown/[name]/artifacts/analysis.md（如果存在）
+   explore-summary.md 路径：6aspecdoc/brown/[name]/explore-summary.md（如果存在）
    ```
-   ## 执行任务 3/8: TASK-003-domain-service-logic
 
-   **任务描述**: 实现领域服务业务逻辑
-   **预估工时**: 2人日
+   **处理 agent 状态**：
+   - `DONE`：进入 spec compliance review
+   - `DONE_WITH_CONCERNS`：读取关注点，判断是否影响正确性；若影响则先处理，否则进入 review
+   - `NEEDS_CONTEXT`：补充缺失信息后重新调用
+   - `BLOCKED`：暂停，向用户报告阻塞原因和选项
+   - **agent 开始前提问**：若 agent 在实现前提出疑问，主 agent 回答后重新调用（携带原有上下文 + 补充答案）
+
+   **b. 派发 spec compliance reviewer agent**
+
+   调用 `spec-compliance-reviewer` agent，传入以下内容：
+
    ```
+   请用 spec-compliance-reviewer agent 审查以下任务的实现：
+
+   需求名称：[name]
+   TASK 文件路径：6aspecdoc/brown/[name]/tasks/TASK-<序号>.md
+   specs.md 路径：6aspecdoc/brown/[name]/artifacts/specs.md
 
-   b. **读取任务详情**
-   - 读取 `6aspecdoc/brown/<name>/tasks/TASK-<序号>.md`
-   - 理解任务目标、输入、输出、详细步骤
+   Implementer 报告：
+   [implementer agent 的完整报告]
+   ```
 
-   c. **执行代码变更**
-   - 根据任务步骤进行代码修改
-   - 保持变更最小化和聚焦
-   - 遵循技术方案设计
+   **处理 review 结果**：
+   - `✅ 通过`：标记任务完成，继续下一个任务
+   - `❌ 有问题`：重新调用 implementer agent 修复，传入原有上下文 + reviewer 的完整反馈（具体缺失/多余/偏差及文件路径）；修复后再次调用 reviewer；循环直到通过
 
-   d. **标记任务完成**
+   **c. 标记任务完成**
    - 在任务文件中更新状态：`📋 待开始` → `✅ 已完成`
-   - 在 `04-tasks-overview.md` 中更新任务状态：`- [ ]` → `- [x]`
+   - 在 `tasks-overview.md` 中更新：`- [ ]` → `- [x]`（只修改勾选，不破坏链接结构）
    - 更新 `status.json` 中的任务计数
 
-   e. **继续下一个任务**
-
    **暂停条件**：
-   - 任务不清晰 → 询问澄清
-   - 实现发现设计问题 → 建议更新 artifacts
-   - 遇到错误或阻塞 → 报告并等待指导
+   - `BLOCKED`：实现遇到阻塞，向用户报告
+   - 发现设计问题：暂停，建议更新 artifacts（design/specs/tasks）
    - 用户中断
 
 5. **完成或暂停时显示状态**
@@ -69,25 +96,23 @@
    ```
    ## 实现完成：<name>
 
-   **进度**: 5/7 阶段完成
-   **任务完成**: 8/8 (100%)
+   **任务完成**: <N>/<N> (100%)
 
    ### 本次完成的任务
-   - [x] TASK-001: 数据库字段配置
-   - [x] TASK-002: 实体类字段添加
-   - [x] TASK-003: 领域服务逻辑实现
-   ...
+   - [x] TASK-001: ...
+   - [x] TASK-002: ...
+   - ...
 
    ### 下一步
-   所有任务已完成！运行 `/6aspec:brown:verify` 进行验证。
+   - 运行 `/6aspec:brown:verify` 进行质量检查（可选）
+   - 运行 `/6aspec:brown:archive` 归档此需求
    ```
 
    **如果暂停**：
    ```
    ## 实现暂停：<name>
 
-   **进度**: 5/7 阶段完成
-   **任务完成**: 4/8 (50%)
+   **任务完成**: <完成数>/<总数> (<百分比>)
 
    ### 暂停原因
    <描述遇到的问题>
@@ -102,32 +127,37 @@
 
 6. **更新状态**
 
-   如果全部完成，更新 `status.json`：
+   如果全部完成，根据流程深度更新 `status.json`：
+
+   **轻量级/标准级流程**：
    ```json
    {
-     "status": "verify_pending",
+     "status": "completed",
      "phases": {
-       ...
-       "implement": "done",
-       "verify": "pending"
+       "implement": "done"
      },
      "tasks": {
-       "total": 8,
-       "completed": 8,
+       "total": <N>,
+       "completed": <N>,
        "pending": 0
      }
    }
    ```
 
-**输出**
+---
+
+## 输出
 
 根据执行情况显示相应的输出（见步骤 5）。
 
-**防护措施**
-- 必须先完成 Phase 4
-- 必须读取上下文文件再开始实现
-- 如果任务模糊，暂停并询问
-- 如果实现发现设计问题，暂停并建议更新 artifacts
-- 保持代码变更最小化和聚焦
-- 立即更新任务状态
-- 遇到错误时暂停并报告
+---
+
+## 防护措施
+
+- 必须先完成 Phase 4（Tasks）
+- 主 agent 只做协调，不直接写代码；实现由 `implementer` agent 完成，验证由 `spec-compliance-reviewer` agent 完成
+- 串行执行，不并行调用多个 implementer agent
+- implementer agent 报告 BLOCKED 时必须暂停并向用户报告，不得强行重试
+- spec compliance review 必须通过才能标记任务完成，不得跳过
+- 发现设计问题时暂停，建议更新 artifacts（design/specs/tasks），不得在实现阶段临时发明新方案
+- 立即更新任务状态（TASK 文件、tasks-overview、status.json）

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

@@ -30,24 +30,24 @@
 
 ### 进行中 (2)
 
-| 需求 | 优先级 | 当前阶段 | 进度 | 最后修改 |
-|------|--------|----------|------|----------|
-| add-user-auth | P0 | Phase 3: 技术方案设计 | 3/7 | 2小时前 |
-| fix-login-bug | P1 | Phase 2: 影响面分析 | 2/7 | 1天前 |
+| 需求 | 当前阶段 | 进度 | 最后修改 |
+|------|----------|------|----------|
+| add-user-auth | Phase 3: 技术方案设计 | 3/6 | 2小时前 |
+| fix-login-bug | Phase 2: 需求分析 | 1/6 | 1天前 |
 
 ### 已完成 (1)
 
-| 需求 | 优先级 | 完成时间 | 任务完成率 |
-|------|--------|----------|-----------|
-| add-export-feature | P1 | 3天前 | 8/8 (100%) |
+| 需求 | 完成时间 | 任务完成率 |
+|------|----------|-----------|
+| add-export-feature | 3天前 | 8/8 (100%) |
 
 ### 已归档 (3)
 
-| 需求 | 优先级 | 归档时间 |
-|------|--------|----------|
-| refactor-api | P0 | 1周前 |
-| update-ui | P1 | 2周前 |
-| fix-typo | P2 | 1个月前 |
+| 需求 | 归档时间 |
+|------|----------|
+| refactor-api | 1周前 |
+| update-ui | 2周前 |
+| fix-typo | 1个月前 |
 
 ### 统计