6aspec 2.0.0-dev.2 → 2.0.0-dev.22

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

@@ -1,8 +1,12 @@
 # 棕地需求 - Proposal SOP
 
-创建需求提案 - 轻量级流程的第一阶段。
+创建需求提案
 
-**适用流程**：轻量级（类似OpenSpec）
+**适用流程**：轻量级、标准级、完整级
+
+**流程定位**：
+- **轻量级**：第一阶段，基于需求描述（如果之前使用了探索模式并生成了 explore-summary.md，也会参考探索发现）
+- **标准级/完整级**：第三阶段，基于 understand 和 impact 的分析结果
 
 **输入**：`/6aspec:brown:proposal` 后可选需求名称。
 
@@ -11,106 +15,190 @@
 1. **选择需求并检查状态**
 
    - 读取 `6aspecdoc/brown/<name>/status.json`
-   - 确认 `flowDepth` 为 "lightweight"
-   - 如果不是轻量级流程，提示使用 `/6aspec:brown:understand`
+   - 根据 `flowDepth` 检查前置阶段：
+     - **轻量级**：确认 `phases.proposal` 为 "pending"
+     - **标准级/完整级**：确认 `phases.impact` 为 "done"，如果未完成提示先运行 `/6aspec:brown:impact`
+   - 如果proposal已完成，提示使用 `/6aspec:brown:continue` 进入下一阶段
 
-2. **收集需求信息**
+2. **读取前置文档**
 
-   首先读取 `6aspecdoc/brown/<name>/requirement.md` 中的"原始需求"部分：
-   - 如果 `inputSource.type = "text"`：直接使用其中记录的需求描述。
-   - 如果 `inputSource.type = "file"`：读取记录的来源文件路径，获取完整需求内容。
+   根据 `flowDepth` 读取不同的前置文档：
 
-   如果原始需求信息不足以生成提案，再询问用户补充：
-   - 为什么需要这个变更？（Why）
-   - 要做什么？（What）
-   - 预期影响是什么？（Impact）
+   **轻量级流程**：
+   - `6aspecdoc/brown/<name>/artifacts/original-requirement.md` - 原始需求
+   - `6aspecdoc/brown/<name>/explore-summary.md` - 探索摘要（如果存在）
 
-3. **创建提案文档**
+   **标准级/完整级流程**：
+   - `6aspecdoc/brown/<name>/artifacts/original-requirement.md` - 原始需求
+   - `6aspecdoc/brown/<name>/artifacts/understanding.md` - 现状分析
+   - `6aspecdoc/brown/<name>/artifacts/impact-analysis.md` - 影响面分析
 
-   创建 `6aspecdoc/brown/<name>/artifacts/proposal.md`：
-   ```markdown
-   # 需求提案：<需求标题>
+3. **执行轻量级探索并识别待明确问题**（仅轻量级流程）
 
-   > **需求**: <name>
-   > **流程**: 轻量级
-   > **阶段**: Proposal
-   > **状态**: ✅ 已完成
-   > **创建时间**: <timestamp>
+   **触发条件**：`flowDepth` 为 "lightweight" **且满足以下任一条件**：
+   - 不存在 `explore-summary.md` **且** 对话上下文中没有探索内容
+   - 用户明确要求探索（例如："先了解一下现有实现"、"需要探索代码库"）
+
+   **上下文识别**：
+
+   在执行探索前，先检查是否已有探索内容：
+
+   a. **检查explore-summary.md**：
+   - 如果存在 `6aspecdoc/brown/<name>/explore-summary.md`，读取它
+   - 除非用户明确要求重新探索，否则使用已有的探索摘要
+
+   b. **检查对话上下文**：
+   - 检查对话历史中是否包含探索内容（用户之前执行了 `/6aspec:brown:explore` 命令）
+   - 即使没有生成explore-summary.md文件，探索内容仍在对话上下文中
+   - 如果发现对话上下文中有探索内容，可以直接利用这些信息，不需要重新探索
+
+   c. **判断是否需要执行新的探索**：
+   - 如果既没有explore-summary.md，也没有对话上下文中的探索内容 → 执行轻量级探索
+   - 如果用户明确要求探索（即使已有探索内容） → 执行轻量级探索
+   - 如果已有探索内容（explore-summary.md或对话上下文）且用户未明确要求 → 跳过探索，直接使用已有内容
+
+   **步骤**：
+
+   a. **执行轻量级探索**（如果需要）
+
+   从需求描述中提取关键词（实体名、功能名、业务术语），然后执行快速搜索：
+
+   ```bash
+   # 搜索相关实体类
+   rg "class.*<关键词>.*Entity" --type java -g "*Entity.java"
+
+   # 搜索相关服务类
+   rg "class.*<关键词>.*Service" --type java -g "*Service.java"
+
+   # 搜索相关Controller类
+   rg "class.*<关键词>.*Controller" --type java -g "*Controller.java"
+
+   # 搜索关键业务逻辑
+   rg "<关键方法名>" --type java -C 3
+   ```
+
+   识别受影响的核心文件（3-5个），快速阅读关键代码片段。
+
+   b. **识别待明确问题**
+
+   基于探索结果（explore-summary.md、对话上下文中的探索内容、或刚刚执行的轻量级探索）和需求描述，识别不清楚的地方，生成待明确问题清单：
+
+   **问题类型**：
+   - 字段设计问题（名称、类型、必填、默认值、值域）
+   - 业务规则问题（是否可修改、是否继承、是否同步）
+   - 权限和统计问题（权限控制、统计报表）
+   - 集成和兼容问题（与其他模块的集成、数据迁移）
+
+   **问题数量**：2-5个最重要的问题（保持轻量）
+
+   c. **询问用户**
 
-   ## 为什么做（Why）
+   如果有待明确问题，展示问题清单并等待用户回答：
 
-   ### 业务背景
-   <业务背景描述>
+   ```
+   ## 需要明确的问题
+
+   基于代码库探索，发现以下问题需要明确：
 
-   ### 要解决的问题
-   <要解决的问题>
+   ### 字段设计
+   1. <问题1>
+   2. <问题2>
 
-   ### 预期收益
-   <预期收益>
+   ### 业务规则
+   3. <问题3>
+   4. <问题4>
+
+   请回答上述问题，我会基于你的回答生成proposal。
+   ```
 
-   ## 要做什么（What）
+   **等待用户回答**，不要自动进入下一步。
 
-   ### 功能概述
-   <功能概述>
+   d. **处理用户回答**
 
-   ### 功能需求
+   当用户回答问题后：
+   - 记录用户的回答（用于proposal生成）
+   - 继续执行步骤4（创建提案文档）
 
-   #### FR-001: <功能名称>
-   **描述**：<功能描述>
+   **注意**：
+   - 探索结果和用户回答不生成独立文档，直接用于proposal生成
+   - 如果没有待明确问题，直接跳过询问步骤，继续生成proposal
+   - 优先使用explore-summary.md（如果存在且用户未明确要求重新探索）
+   - 其次利用对话上下文中的探索内容（如果用户之前执行了explore命令）
+   - 最后才执行新的轻量级探索（如果既没有explore-summary.md也没有对话上下文中的探索内容）
+   - 即使已有探索内容，如果用户明确要求探索，也应该执行新的探索
+
+4. **创建提案文档（OpenSpec 格式）**
+
+   创建 `6aspecdoc/brown/<name>/artifacts/proposal.md`：
+   ```markdown
+   # Proposal: <需求标题>
+
+   > **需求**: <name>
+   > **流程**: <flowDepth>
+   > **阶段**: Proposal
+   > **状态**: ✅ 已完成
+   > **创建时间**: <timestamp>
 
-   **验收标准**：
-   - <验收标准1>
-   - <验收标准2>
+   ## Why
 
-   #### FR-002: <功能名称>
-   **描述**：<功能描述>
+   <1-2 sentences explaining the problem/opportunity>
 
-   **验收标准**：
-   - <验收标准1>
-   - <验收标准2>
+   ## What Changes
 
-   ### 范围界定
-   **包含**：
-   - <包含的内容>
+   <Bullet points of what will be different>
+   - <变更点1>
+   - <变更点2>
+   - <变更点3>
 
-   **不包含**：
-   - <不包含的内容>
+   ## Capabilities
 
-   ### 整体验收标准
-   - AC-001: <整体验收标准1>
-   - AC-002: <整体验收标准2>
+   ### New Capabilities
+   - `<capability-name>`: <brief description>
+   - `<capability-name>`: <brief description>
 
-   ## 预期影响（Impact）
+   ### Modified Capabilities
+   <!-- If modifying existing behavior -->
+   - `<capability-name>`: <brief description>
 
-   ### 技术影响
-   - 数据库：<影响描述>
-   - 后端代码：<影响描述>
-   - 前端代码：<影响描述>
-   - API接口：<影响描述>
+   ## Impact
 
-   ### 业务影响
-   - 用户体验：<影响描述>
-   - 业务流程：<影响描述>
+   **轻量级流程**（基于需求描述或 explore 摘要）：
+   - `<file-path>`: <what changes>
+   - `<file-path>`: <what changes>
 
-   ### 风险评估
-   - 技术风险：<风险描述>
-   - 业务风险：<风险描述>
+   **标准级/完整级流程**（基于 understanding 和 impact 分析）：
+   - `<file-path>`: <what changes>（来自 impact-analysis.md）
+   - `<file-path>`: <what changes>（来自 impact-analysis.md）
 
-   ## 下一步
+   ## Next Steps
 
-   运行 `/6aspec:brown:design` 进行技术方案设计。
+   - 轻量级流程：运行 `/6aspec:brown:specs` 进行需求规格定义
+   - 标准级/完整级流程：运行 `/6aspec:brown:specs` 进行需求规格定义
    ```
 
-4. **更新状态**
+   **注意**：
+   - Proposal 格式遵循 OpenSpec 规范，保持简洁
+   - Why 部分：1-2 句话说明问题或机会
+   - What Changes 部分：列出主要变更点
+   - Capabilities 部分：列出新增或修改的系统能力（每个 capability 将对应一个 spec 文件）
+   - Impact 部分：列出受影响的文件和简要描述
+   - 轻量级流程的 Impact 基于需求描述、explore 摘要或轻量级探索结果（高层次评估）
+   - 标准级/完整级流程的 Impact 基于 impact-analysis.md（详细分析的摘要）
+   - 如果轻量级流程在步骤3中询问了用户问题，基于用户的回答生成proposal
+
+5. **更新状态**
 
    更新 `6aspecdoc/brown/<name>/status.json`：
+
+   **轻量级流程**：
    ```json
    {
-     "status": "design_pending",
+     "status": "specs_pending",
      "flowDepth": "lightweight",
      "phases": {
        "proposal": "done",
-       "design": "pending",
+       "specs": "pending",
+       "design": "blocked",
        "tasks": "blocked",
        "implement": "blocked"
      },
@@ -118,10 +206,89 @@
    }
    ```
 
-5. **停止并等待用户指令**
+   **标准级流程**：
+   ```json
+   {
+     "status": "specs_pending",
+     "flowDepth": "standard",
+     "phases": {
+       "understand": "done",
+       "impact": "done",
+       "proposal": "done",
+       "specs": "pending",
+       "design": "blocked",
+       "tasks": "blocked",
+       "implement": "blocked"
+     },
+     "artifacts": ["understanding.md", "impact-analysis.md", "proposal.md"]
+   }
+   ```
+
+   **完整级流程**：
+   ```json
+   {
+     "status": "specs_pending",
+     "flowDepth": "complete",
+     "phases": {
+       "understand": "done",
+       "impact": "done",
+       "proposal": "done",
+       "specs": "pending",
+       "design": "blocked",
+       "tasks": "blocked",
+       "implement": "blocked",
+       "verify": "blocked",
+       "review": "blocked"
+     },
+     "artifacts": ["understanding.md", "impact-analysis.md", "proposal.md"]
+   }
+   ```
+
+   同时更新 `6aspecdoc/brown/<name>/requirement.md`：
+   - 更新"状态"字段为 `📋 Specs 待开始`
+   - 更新"最后修改"时间戳为 `<timestamp>`
+   - 更新"当前阶段"为 `Proposal - 需求提案（已完成）`
+   - 更新"下一步操作"为 `运行 /6aspec:brown:specs 继续下一阶段`
+   - 在"进度概览"中标记 Proposal 阶段为已完成 `[x]`
+
+6. **停止并等待用户指令**
 
 **输出**
 
+根据 `flowDepth` 和执行阶段显示不同的输出信息：
+
+**轻量级流程 - 待明确问题阶段**（如果步骤3中发现有待明确问题）：
+```
+## 需要明确的问题：<name>
+
+**流程**: 轻量级
+**阶段**: Proposal（探索中）
+
+### 代码库探索结果
+- 相关实体类：<数量>
+- 相关服务类：<数量>
+- 受影响文件：<数量>
+
+### 待明确问题
+
+基于代码库探索，发现以下问题需要明确：
+
+#### 字段设计
+1. <问题1>
+2. <问题2>
+
+#### 业务规则
+3. <问题3>
+4. <问题4>
+
+#### 其他
+5. <问题5>
+
+### 下一步
+请回答上述问题，我会基于你的回答生成proposal。
+```
+
+**轻量级流程 - Proposal完成**：
 ```
 ## Proposal 完成：<name>
 
@@ -129,19 +296,58 @@
 **进度**: 1/4 阶段完成
 
 ### 提案概要
-- 业务目标：<简述>
-- 核心能力：<数量> 个
-- 预期影响：<简述>
+- Why: <简述>
+- What Changes: <数量> 项变更
+- Capabilities: <数量> 个能力
 
-### 关键风险
-<列出关键风险>
+### 文档位置
+6aspecdoc/brown/<name>/artifacts/proposal.md
+
+### 下一步
+- 直接回复补充或修正提案内容 → 我会更新本阶段文档（proposal.md）
+- 运行 `/6aspec:brown:specs` → 进入需求规格定义阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
+```
+
+**标准级流程**：
+```
+## Proposal 完成：<name>
+
+**流程**: 标准级
+**进度**: 3/6 阶段完成
+
+### 提案概要
+- Why: <简述>
+- What Changes: <数量> 项变更
+- Capabilities: <数量> 个能力
 
 ### 文档位置
 6aspecdoc/brown/<name>/artifacts/proposal.md
 
 ### 下一步
 - 直接回复补充或修正提案内容 → 我会更新本阶段文档（proposal.md）
-- 运行 `/6aspec:brown:design` → 进入技术方案设计阶段
+- 运行 `/6aspec:brown:specs` → 进入需求规格定义阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
+```
+
+**完整级流程**：
+```
+## Proposal 完成：<name>
+
+**流程**: 完整级
+**进度**: 3/8 阶段完成
+
+### 提案概要
+- Why: <简述>
+- What Changes: <数量> 项变更
+- Capabilities: <数量> 个能力
+
+### 文档位置
+6aspecdoc/brown/<name>/artifacts/proposal.md
+
+### 下一步
+- 直接回复补充或修正提案内容 → 我会更新本阶段文档（proposal.md）
+- 运行 `/6aspec:brown:specs` → 进入需求规格定义阶段
 - 运行 `/6aspec:brown:continue` → 自动进入下一阶段
 ```
 
@@ -154,7 +360,19 @@
 4. **禁止**：不得自动进入下一阶段
 
 **防护措施**
-- 仅适用于轻量级流程
+- 适用于所有流程（轻量级、标准级、完整级）
 - 如果需求信息不明确，必须询问用户
 - 提案必须包含Why、What、Impact三个核心部分
+- 提案应聚焦高层次的业务目标和核心能力，不包含详细的功能需求（FR）和验收标准（AC）
+- 详细的功能需求和验收标准应该在specs阶段定义
 - 风险评估不能省略
+
+**轻量级流程的特殊防护措施**：
+- 如果没有explore-summary.md，必须执行轻量级探索（步骤3）
+- 轻量级探索应该快速、聚焦，只搜索关键实体类、服务类和受影响文件
+- 轻量级探索不生成独立文档，探索结果直接用于proposal生成
+- 如果探索过程中发现待明确问题，必须询问用户，不能基于假设生成proposal
+- 待明确问题数量应该控制在2-5个，保持轻量（与标准级/完整级的5-10个问题相比）
+- 如果没有待明确问题，可以直接生成proposal
+- 不要在轻量级流程中执行过于深入的分析（如绘制ERD图、流程图等），这些应该在标准级/完整级流程中完成
+- 轻量级探索的目标是"快速理解现有实现"，而不是"深入分析系统架构"

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

@@ -1,6 +1,6 @@
 # 棕地需求 - Quick SOP
 
-P2 需求快速通道 - 适用于简单修复和小改动。
+快速通道 - 适用于简单修复和小改动。
 
 **输入**：`/6aspec:brown:quick` 后的参数是需求名称（kebab-case）或需求描述。
 
@@ -27,10 +27,12 @@ P2 需求快速通道 - 适用于简单修复和小改动。
    ```
 
    创建状态文件 `6aspecdoc/brown/<name>/status.json`：
+
+   **注意**：所有时间戳必须使用东八区（北京时间）格式：`yyyy-MM-dd HH:mm:ss`（例如：`2026-02-20 12:36:23`）
+
    ```json
    {
      "name": "<name>",
-     "priority": "P2",
      "status": "quick_track",
      "createdAt": "<timestamp>",
      "lastModified": "<timestamp>",
@@ -43,7 +45,6 @@ P2 需求快速通道 - 适用于简单修复和小改动。
    # <需求标题>
 
    > **需求ID**: <name>
-   > **优先级**: P2（快速通道）
    > **状态**: 🚀 快速处理中
    > **创建时间**: <timestamp>
 
@@ -102,7 +103,6 @@ P2 需求快速通道 - 适用于简单修复和小改动。
 ```
 ## 快速处理完成：<name>
 
-**优先级**: P2（快速通道）
 **处理时间**: <时间戳>
 
 ### 修改内容
@@ -118,7 +118,7 @@ P2 需求快速通道 - 适用于简单修复和小改动。
 - 或归档：运行 `/6aspec:brown:archive` 归档此需求
 
 ### 注意
-P2 需求使用快速通道，跳过了详细的分析和设计阶段。
+快速通道跳过了详细的分析和设计阶段。
 如果发现需求比预期复杂，建议使用完整流程（/6aspec:brown:new）。
 ```
 

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

@@ -20,7 +20,7 @@ Phase 7: 实施后评估
    - `6aspecdoc/brown/<name>/requirement.md` - 原始需求
    - `6aspecdoc/brown/<name>/artifacts/02-impact-analysis.md` - 预期影响
    - `6aspecdoc/brown/<name>/artifacts/03-technical-design.md` - 技术方案
-   - `6aspecdoc/brown/<name>/artifacts/ADR-<name>.md` - 架构决策（P0）
+   - `6aspecdoc/brown/<name>/artifacts/ADR-<name>.md` - 架构决策（如有）
 
 3. **参考相关归档需求（可选）**
 
@@ -60,7 +60,7 @@ Phase 7: 实施后评估
    - 用户反馈如何？
    - 是否需要调整？
 
-   **架构决策回顾**（P0 需求）：
+   **架构决策回顾**（如有）：
    - 当初的架构决策是否正确？
    - 有哪些经验教训？
    - 需要更新 ADR 吗？
@@ -144,7 +144,7 @@ Phase 7: 实施后评估
    调整计划（如需要）：
    <调整计划>
 
-   ## 3. 架构决策回顾（P0 需求）
+   ## 3. 架构决策回顾（如有）
 
    ### 3.1 决策回顾
 
@@ -266,5 +266,5 @@ Phase 7: 实施后评估
 - 必须先完成 Phase 6
 - 评估必须基于实际数据，不能主观臆断
 - 必须收集用户反馈
-- P0 需求必须回顾架构决策
+- 涉及架构决策的需求必须回顾架构决策
 - 必须进行知识沉淀

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

@@ -12,7 +12,9 @@
 **限制**：
 - 只能一级一级往上退，不允许跨节点
 - 只能回退已完成的阶段（状态为 "done"）
-- 不能回退第一个阶段（proposal/understand）
+- 不能回退第一个阶段（轻量级流程：proposal，标准级/完整级流程：understand）
+- 不能从实施阶段回退（implement、verify、review），因为代码已修改，回退文档会导致文档和代码不一致
+- 只允许在分析阶段回退（proposal、understand、specs、impact、design、tasks）
 - 已归档的需求不能回退
 
 **步骤**
@@ -35,28 +37,32 @@
    根据流程深度和当前阶段，确定上一个阶段：
 
    **轻量级流程（lightweight）**：
-   - design → proposal
+   - specs → proposal
+   - design → specs
    - tasks → design
-   - implement → tasks
+   - ~~implement → tasks~~（禁止：代码已修改）
 
    **标准级流程（standard）**：
-   - specs → understand
-   - impact → specs
-   - design → impact
+   - impact → understand
+   - proposal → impact
+   - specs → proposal
+   - design → specs
    - tasks → design
-   - implement → tasks
+   - ~~implement → tasks~~（禁止：代码已修改）
 
    **完整级流程（complete）**：
-   - specs → understand
-   - impact → specs
-   - design → impact
+   - impact → understand
+   - proposal → impact
+   - specs → proposal
+   - design → specs
    - tasks → design
-   - implement → tasks
-   - verify → implement
-   - review → verify
+   - ~~implement → tasks~~（禁止：代码已修改）
+   - ~~verify → implement~~（禁止：代码已修改）
+   - ~~review → verify~~（禁止：代码已修改）
 
    **边界情况**：
-   - 如果当前在第一个阶段（proposal/understand），提示无法回退
+   - 如果当前在第一个阶段（轻量级流程：proposal，标准级/完整级流程：understand），提示无法回退
+   - 如果当前在实施阶段（implement、verify、review），提示无法回退（代码已修改）
    - 如果所有阶段都是 pending，提示没有可回退的阶段
 
 4. **确认回退操作**
@@ -133,9 +139,10 @@
      "name": "example",
      "flowDepth": "standard",
      "status": "tasks_pending",
-     "createdAt": "2026-02-15T10:00:00Z",
-     "lastModified": "2026-02-15T10:30:00Z",
+     "createdAt": "2026-02-15 18:00:00",
+     "lastModified": "2026-02-15 18:30:00",
      "phases": {
+       "proposal": "done",
        "understand": "done",
        "specs": "done",
        "impact": "done",
@@ -143,7 +150,7 @@
        "tasks": "pending",
        "implement": "blocked"
      },
-     "artifacts": ["understanding.md", "specs.md", "impact-analysis.md", "design.md"]
+     "artifacts": ["proposal.md", "understanding.md", "specs.md", "impact-analysis.md", "design.md"]
    }
    ```
 
@@ -174,7 +181,9 @@
 **防护措施**
 - 必须确认需求未归档
 - 必须确认当前阶段已完成（状态为 "done"）
-- 不能回退第一个阶段
+- 不能回退第一个阶段（轻量级流程：proposal，标准级/完整级流程：understand）
+- 不能从实施阶段回退（implement、verify、review）
+- 只允许在分析阶段回退（proposal、understand、specs、impact、design、tasks）
 - 必须用户确认后才能执行回退
 - 删除文件前检查文件是否存在
 - 更新状态时保持一致性
@@ -183,6 +192,7 @@
 
 - 如果需求不存在，提示创建新需求
 - 如果需求已归档，提示先取消归档
-- 如果当前在第一个阶段，提示无法回退
+- 如果当前在第一个阶段（轻量级流程：proposal，标准级/完整级流程：understand），提示无法回退
+- 如果当前在实施阶段（implement、verify、review），提示无法回退，原因：代码已修改，回退文档会导致文档和代码不一致
 - 如果所有阶段都是 pending，提示没有可回退的阶段
 - 如果文件删除失败，提示错误信息但继续更新状态