6aspec 2.0.0-dev.15 → 2.0.0-dev.18

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

@@ -30,29 +30,29 @@
    ```
    问题："请选择适合的流程深度："
    选项：
-   - 轻量级 - 快速迭代（proposal → design → tasks）（推荐用于需求明确的变更）
-   - 标准级 - 深入分析（understand → specs → impact → design → tasks）（推荐用于复杂业务变更）
-   - 完整级 - 全生命周期（understand → specs → impact → design → tasks → verify → review）（推荐用于关键变更）
+   - 轻量级 - 快速迭代（proposal → specs → design → tasks）（推荐用于需求明确的变更）
+   - 标准级 - 深入分析（proposal → understand → specs → impact → design → tasks）（推荐用于复杂业务变更）
+   - 完整级 - 全生命周期（proposal → understand → specs → impact → design → tasks → verify → review）（推荐用于关键变更）
    - 快速通道 - 简单修复（直接实现，适用于Bug修复、单文件改动）
    ```
 
    **流程深度说明**：
 
    **轻量级（Lightweight）**：
-   - 阶段：proposal → design → tasks → implement
-   - 产出：proposal.md, design.md, tasks.md
+   - 阶段：proposal → specs → design → tasks
+   - 产出：proposal.md, specs.md, design.md, tasks-overview.md
    - 适用：需求明确、快速迭代、小范围变更
    - 示例：新增简单功能、UI调整、配置变更
 
    **标准级（Standard）**：
-   - 阶段：understand → specs → impact → design → tasks → implement
-   - 产出：understanding.md, specs.md, impact-analysis.md, design.md, tasks.md
+   - 阶段：understand → impact → proposal → specs → design → tasks
+   - 产出：understanding.md, impact-analysis.md, proposal.md, specs.md, design.md, tasks-overview.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
+   - 阶段：understand → impact → proposal → specs → design → tasks → verify → review
+   - 产出：understanding.md, impact-analysis.md, proposal.md, specs.md, design.md, tasks-overview.md, verification-report.md, post-implementation-review.md
    - 适用：关键变更、需要完整追踪和评估
    - 示例：核心业务逻辑变更、重要功能重构
 
@@ -91,6 +91,7 @@
      },
      "phases": {
        "proposal": "pending",
+       "specs": "blocked",
        "design": "blocked",
        "tasks": "blocked",
        "implement": "blocked"
@@ -113,8 +114,9 @@
      },
      "phases": {
        "understand": "pending",
-       "specs": "blocked",
        "impact": "blocked",
+       "proposal": "blocked",
+       "specs": "blocked",
        "design": "blocked",
        "tasks": "blocked",
        "implement": "blocked"
@@ -137,8 +139,9 @@
      },
      "phases": {
        "understand": "pending",
-       "specs": "blocked",
        "impact": "blocked",
+       "proposal": "blocked",
+       "specs": "blocked",
        "design": "blocked",
        "tasks": "blocked",
        "implement": "blocked",
@@ -189,23 +192,25 @@
 
    **轻量级流程（4阶段）**：
    - [ ] Proposal - 需求提案
+   - [ ] Specs - 需求规格定义
    - [ ] Design - 技术方案设计
    - [ ] Tasks - 任务拆解
-   - [ ] Implement - 执行实现
 
-   **标准级流程（5阶段）**：
+   **标准级流程（6阶段）**：
    - [ ] Understand - 需求理解与现状分析
    - [ ] Impact - 影响面分析
+   - [ ] Proposal - 需求提案
+   - [ ] Specs - 需求规格定义
    - [ ] Design - 技术方案设计
    - [ ] Tasks - 任务拆解
-   - [ ] Implement - 执行实现
 
-   **完整级流程（7阶段）**：
+   **完整级流程（8阶段）**：
    - [ ] Understand - 需求理解与现状分析
    - [ ] Impact - 影响面分析
+   - [ ] Proposal - 需求提案
+   - [ ] Specs - 需求规格定义
    - [ ] Design - 技术方案设计
    - [ ] Tasks - 任务拆解
-   - [ ] Implement - 执行实现
    - [ ] Verify - 验证实现
    - [ ] Review - 实施后评估
 
@@ -245,9 +250,8 @@
 
 ### 下一步
 - 轻量级: 运行 `/6aspec:brown:proposal` 创建需求提案
-- 标准级/完整级: 运行 `/6aspec:brown:understand` 开始需求理解与现状分析
+- 标准级/完整级: 运行 `/6aspec:brown:understand` 进行需求理解与现状分析
 - 快速通道: 运行 `/6aspec:brown:quick` 直接实现
-- 或运行 `/6aspec:brown:ff` 快速完成分析阶段
 - 或运行 `/6aspec:brown:continue` 自动进入下一阶段
 ```
 
@@ -256,4 +260,4 @@
 - 不要超出初始化范围
 - 如果名称无效（非 kebab-case），要求提供有效名称
 - 如果同名需求已存在，建议使用 `/6aspec:brown:continue` 或选择新名称
-- 必须让用户选择流程深度
+- 必须让用户选择流程深度

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,95 @@
 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. **收集需求信息**
+   根据 `flowDepth` 读取不同的前置文档：
 
-   首先读取 `6aspecdoc/brown/<name>/requirement.md` 中的"原始需求"部分：
-   - 如果 `inputSource.type = "text"`：直接使用其中记录的需求描述。
-   - 如果 `inputSource.type = "file"`：读取记录的来源文件路径，获取完整需求内容。
+   **轻量级流程**：
+   - `6aspecdoc/brown/<name>/requirement.md` - 原始需求
+   - `6aspecdoc/brown/<name>/explore-summary.md` - 探索摘要（如果存在）
 
-   如果原始需求信息不足以生成提案，再询问用户补充：
-   - 为什么需要这个变更？（Why）
-   - 要做什么？（What）
-   - 预期影响是什么？（Impact）
+   **标准级/完整级流程**：
+   - `6aspecdoc/brown/<name>/requirement.md` - 原始需求
+   - `6aspecdoc/brown/<name>/artifacts/understanding.md` - 现状分析
+   - `6aspecdoc/brown/<name>/artifacts/impact-analysis.md` - 影响面分析
 
-3. **创建提案文档**
+3. **创建提案文档（OpenSpec 格式）**
 
    创建 `6aspecdoc/brown/<name>/artifacts/proposal.md`：
    ```markdown
-   # 需求提案：<需求标题>
+   # Proposal: <需求标题>
 
    > **需求**: <name>
-   > **流程**: 轻量级
+   > **流程**: <flowDepth>
    > **阶段**: Proposal
    > **状态**: ✅ 已完成
    > **创建时间**: <timestamp>
 
-   ## 为什么做（Why）
-
-   ### 业务背景
-   <业务背景描述>
-
-   ### 要解决的问题
-   <要解决的问题>
-
-   ### 预期收益
-   <预期收益>
-
-   ## 要做什么（What）
-
-   ### 功能概述
-   <功能概述>
-
-   ### 功能需求
+   ## Why
 
-   #### FR-001: <功能名称>
-   **描述**：<功能描述>
+   <1-2 sentences explaining the problem/opportunity>
 
-   **验收标准**：
-   - <验收标准1>
-   - <验收标准2>
+   ## What Changes
 
-   #### FR-002: <功能名称>
-   **描述**：<功能描述>
+   <Bullet points of what will be different>
+   - <变更点1>
+   - <变更点2>
+   - <变更点3>
 
-   **验收标准**：
-   - <验收标准1>
-   - <验收标准2>
+   ## Capabilities
 
-   ### 范围界定
-   **包含**：
-   - <包含的内容>
+   ### New Capabilities
+   - `<capability-name>`: <brief description>
+   - `<capability-name>`: <brief description>
 
-   **不包含**：
-   - <不包含的内容>
+   ### Modified Capabilities
+   <!-- If modifying existing behavior -->
+   - `<capability-name>`: <brief description>
 
-   ### 整体验收标准
-   - AC-001: <整体验收标准1>
-   - AC-002: <整体验收标准2>
+   ## Impact
 
-   ## 预期影响（Impact）
+   **轻量级流程**（基于需求描述或 explore 摘要）：
+   - `<file-path>`: <what changes>
+   - `<file-path>`: <what changes>
 
-   ### 技术影响
-   - 数据库：<影响描述>
-   - 后端代码：<影响描述>
-   - 前端代码：<影响描述>
-   - API接口：<影响描述>
+   **标准级/完整级流程**（基于 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` 进行需求规格定义
    ```
 
+   **注意**：
+   - Proposal 格式遵循 OpenSpec 规范，保持简洁
+   - Why 部分：1-2 句话说明问题或机会
+   - What Changes 部分：列出主要变更点
+   - Capabilities 部分：列出新增或修改的系统能力（每个 capability 将对应一个 spec 文件）
+   - Impact 部分：列出受影响的文件和简要描述
+   - 轻量级流程的 Impact 基于需求描述或 explore 摘要（高层次评估）
+   - 标准级/完整级流程的 Impact 基于 impact-analysis.md（详细分析的摘要）
+
 4. **更新状态**
 
    更新 `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 +111,51 @@
    }
    ```
 
+   **标准级流程**：
+   ```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"]
+   }
+   ```
+
 5. **停止并等待用户指令**
 
 **输出**
 
+根据 `flowDepth` 显示不同的输出信息：
+
+**轻量级流程**：
 ```
 ## Proposal 完成：<name>
 
@@ -129,19 +163,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:specs` → 进入需求规格定义阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
+```
+
+**完整级流程**：
+```
+## Proposal 完成：<name>
+
+**流程**: 完整级
+**进度**: 3/8 阶段完成
+
+### 提案概要
+- Why: <简述>
+- What Changes: <数量> 项变更
+- Capabilities: <数量> 个能力
 
 ### 文档位置
 6aspecdoc/brown/<name>/artifacts/proposal.md
 
 ### 下一步
 - 直接回复补充或修正提案内容 → 我会更新本阶段文档（proposal.md）
-- 运行 `/6aspec:brown:design` → 进入技术方案设计阶段
+- 运行 `/6aspec:brown:specs` → 进入需求规格定义阶段
 - 运行 `/6aspec:brown:continue` → 自动进入下一阶段
 ```
 
@@ -154,7 +227,9 @@
 4. **禁止**：不得自动进入下一阶段
 
 **防护措施**
-- 仅适用于轻量级流程
+- 适用于所有流程（轻量级、标准级、完整级）
 - 如果需求信息不明确，必须询问用户
 - 提案必须包含Why、What、Impact三个核心部分
+- 提案应聚焦高层次的业务目标和核心能力，不包含详细的功能需求（FR）和验收标准（AC）
+- 详细的功能需求和验收标准应该在specs阶段定义
 - 风险评估不能省略

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. **确认回退操作**
@@ -136,6 +142,7 @@
      "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，提示没有可回退的阶段
 - 如果文件删除失败，提示错误信息但继续更新状态