6aspec 2.0.0-dev.14 → 2.0.0-dev.17

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 → implement
+   - 产出：proposal.md, specs.md, design.md, tasks.md
    - 适用：需求明确、快速迭代、小范围变更
    - 示例：新增简单功能、UI调整、配置变更
 
    **标准级（Standard）**：
-   - 阶段：understand → specs → impact → design → tasks → implement
-   - 产出：understanding.md, specs.md, impact-analysis.md, design.md, tasks.md
+   - 阶段：proposal → understand → specs → impact → design → tasks → implement
+   - 产出：proposal.md, 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
+   - 阶段：proposal → understand → specs → impact → design → tasks → implement → verify → review
+   - 产出：proposal.md, understanding.md, specs.md, impact-analysis.md, design.md, tasks.md, verification-report.md, post-implementation-review.md
    - 适用：关键变更、需要完整追踪和评估
    - 示例：核心业务逻辑变更、重要功能重构
 
@@ -91,6 +91,7 @@
      },
      "phases": {
        "proposal": "pending",
+       "specs": "blocked",
        "design": "blocked",
        "tasks": "blocked",
        "implement": "blocked"
@@ -104,7 +105,7 @@
    {
      "name": "<name>",
      "flowDepth": "standard",
-     "status": "understanding_pending",
+     "status": "proposal_pending",
      "createdAt": "<timestamp>",
      "lastModified": "<timestamp>",
      "inputSource": {
@@ -112,7 +113,8 @@
        "filePath": "<仅 type=file 时填写>"
      },
      "phases": {
-       "understand": "pending",
+       "proposal": "pending",
+       "understand": "blocked",
        "specs": "blocked",
        "impact": "blocked",
        "design": "blocked",
@@ -128,7 +130,7 @@
    {
      "name": "<name>",
      "flowDepth": "complete",
-     "status": "understanding_pending",
+     "status": "proposal_pending",
      "createdAt": "<timestamp>",
      "lastModified": "<timestamp>",
      "inputSource": {
@@ -136,7 +138,8 @@
        "filePath": "<仅 type=file 时填写>"
      },
      "phases": {
-       "understand": "pending",
+       "proposal": "pending",
+       "understand": "blocked",
        "specs": "blocked",
        "impact": "blocked",
        "design": "blocked",
@@ -187,21 +190,26 @@
 
    根据流程深度显示不同的阶段列表：
 
-   **轻量级流程（4阶段）**：
+   **轻量级流程（5阶段）**：
    - [ ] Proposal - 需求提案
+   - [ ] Specs - 需求规格定义
    - [ ] Design - 技术方案设计
    - [ ] Tasks - 任务拆解
    - [ ] Implement - 执行实现
 
-   **标准级流程（5阶段）**：
+   **标准级流程（7阶段）**：
+   - [ ] Proposal - 需求提案
    - [ ] Understand - 需求理解与现状分析
+   - [ ] Specs - 需求规格定义
    - [ ] Impact - 影响面分析
    - [ ] Design - 技术方案设计
    - [ ] Tasks - 任务拆解
    - [ ] Implement - 执行实现
 
-   **完整级流程（7阶段）**：
+   **完整级流程（9阶段）**：
+   - [ ] Proposal - 需求提案
    - [ ] Understand - 需求理解与现状分析
+   - [ ] Specs - 需求规格定义
    - [ ] Impact - 影响面分析
    - [ ] Design - 技术方案设计
    - [ ] Tasks - 任务拆解
@@ -245,7 +253,7 @@
 
 ### 下一步
 - 轻量级: 运行 `/6aspec:brown:proposal` 创建需求提案
-- 标准级/完整级: 运行 `/6aspec:brown:understand` 开始需求理解与现状分析
+- 标准级/完整级: 运行 `/6aspec:brown:proposal` 创建需求提案
 - 快速通道: 运行 `/6aspec:brown:quick` 直接实现
 - 或运行 `/6aspec:brown:ff` 快速完成分析阶段
 - 或运行 `/6aspec:brown:continue` 自动进入下一阶段
@@ -256,4 +264,4 @@
 - 不要超出初始化范围
 - 如果名称无效（非 kebab-case），要求提供有效名称
 - 如果同名需求已存在，建议使用 `/6aspec:brown:continue` 或选择新名称
-- 必须让用户选择流程深度
+- 必须让用户选择流程深度

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

@@ -1,8 +1,8 @@
 # 棕地需求 - Proposal SOP
 
-创建需求提案 - 轻量级流程的第一阶段。
+创建需求提案 - 所有流程的第一阶段。
 
-**适用流程**：轻量级（类似OpenSpec）
+**适用流程**：轻量级、标准级、完整级
 
 **输入**：`/6aspec:brown:proposal` 后可选需求名称。
 
@@ -11,8 +11,8 @@
 1. **选择需求并检查状态**
 
    - 读取 `6aspecdoc/brown/<name>/status.json`
-   - 确认 `flowDepth` 为 "lightweight"
-   - 如果不是轻量级流程，提示使用 `/6aspec:brown:understand`
+   - 确认 `phases.proposal` 为 "pending"
+   - 如果proposal已完成，提示使用 `/6aspec:brown:continue` 进入下一阶段
 
 2. **收集需求信息**
 
@@ -32,7 +32,7 @@
    # 需求提案：<需求标题>
 
    > **需求**: <name>
-   > **流程**: 轻量级
+   > **流程**: <flowDepth>
    > **阶段**: Proposal
    > **状态**: ✅ 已完成
    > **创建时间**: <timestamp>
@@ -51,23 +51,12 @@
    ## 要做什么（What）
 
    ### 功能概述
-   <功能概述>
+   <高层次的功能概述，描述核心能力>
 
-   ### 功能需求
-
-   #### FR-001: <功能名称>
-   **描述**：<功能描述>
-
-   **验收标准**：
-   - <验收标准1>
-   - <验收标准2>
-
-   #### FR-002: <功能名称>
-   **描述**：<功能描述>
-
-   **验收标准**：
-   - <验收标准1>
-   - <验收标准2>
+   ### 核心能力
+   - 能力1：<简要描述>
+   - 能力2：<简要描述>
+   - 能力3：<简要描述>
 
    ### 范围界定
    **包含**：
@@ -76,10 +65,6 @@
    **不包含**：
    - <不包含的内容>
 
-   ### 整体验收标准
-   - AC-001: <整体验收标准1>
-   - AC-002: <整体验收标准2>
-
    ## 预期影响（Impact）
 
    ### 技术影响
@@ -98,19 +83,41 @@
 
    ## 下一步
 
-   运行 `/6aspec:brown:design` 进行技术方案设计。
+   - 轻量级流程：运行 `/6aspec:brown:specs` 进行需求规格定义
+   - 标准级/完整级流程：运行 `/6aspec:brown:understand` 进行需求理解与现状分析
    ```
 
 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"
+     },
+     "artifacts": ["proposal.md"]
+   }
+   ```
+
+   **标准级流程**：
+   ```json
+   {
+     "status": "understanding_pending",
+     "flowDepth": "standard",
+     "phases": {
+       "proposal": "done",
+       "understand": "pending",
+       "specs": "blocked",
+       "impact": "blocked",
+       "design": "blocked",
        "tasks": "blocked",
        "implement": "blocked"
      },
@@ -118,15 +125,86 @@
    }
    ```
 
+   **完整级流程**：
+   ```json
+   {
+     "status": "understanding_pending",
+     "flowDepth": "complete",
+     "phases": {
+       "proposal": "done",
+       "understand": "pending",
+       "specs": "blocked",
+       "impact": "blocked",
+       "design": "blocked",
+       "tasks": "blocked",
+       "implement": "blocked",
+       "verify": "blocked",
+       "review": "blocked"
+     },
+     "artifacts": ["proposal.md"]
+   }
+   ```
+
 5. **停止并等待用户指令**
 
 **输出**
 
+根据 `flowDepth` 显示不同的输出信息：
+
+**轻量级流程**：
 ```
 ## Proposal 完成：<name>
 
 **流程**: 轻量级
-**进度**: 1/4 阶段完成
+**进度**: 1/5 阶段完成
+
+### 提案概要
+- 业务目标：<简述>
+- 核心能力：<数量> 个
+- 预期影响：<简述>
+
+### 关键风险
+<列出关键风险>
+
+### 文档位置
+6aspecdoc/brown/<name>/artifacts/proposal.md
+
+### 下一步
+- 直接回复补充或修正提案内容 → 我会更新本阶段文档（proposal.md）
+- 运行 `/6aspec:brown:specs` → 进入需求规格定义阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
+```
+
+**标准级流程**：
+```
+## Proposal 完成：<name>
+
+**流程**: 标准级
+**进度**: 1/7 阶段完成
+
+### 提案概要
+- 业务目标：<简述>
+- 核心能力：<数量> 个
+- 预期影响：<简述>
+
+### 关键风险
+<列出关键风险>
+
+### 文档位置
+6aspecdoc/brown/<name>/artifacts/proposal.md
+
+### 下一步
+- 直接回复补充或修正提案内容 → 我会更新本阶段文档（proposal.md）
+- 运行 `/6aspec:brown:understand` → 进入需求理解与现状分析阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
+```
+
+**完整级流程**：
+```
+## Proposal 完成：<name>
+
+**流程**: 完整级
+**进度**: 1/9 阶段完成
 
 ### 提案概要
 - 业务目标：<简述>
@@ -141,7 +219,7 @@
 
 ### 下一步
 - 直接回复补充或修正提案内容 → 我会更新本阶段文档（proposal.md）
-- 运行 `/6aspec:brown:design` → 进入技术方案设计阶段
+- 运行 `/6aspec:brown:understand` → 进入需求理解与现状分析阶段
 - 运行 `/6aspec:brown:continue` → 自动进入下一阶段
 ```
 
@@ -154,7 +232,9 @@
 4. **禁止**：不得自动进入下一阶段
 
 **防护措施**
-- 仅适用于轻量级流程
+- 适用于所有流程（轻量级、标准级、完整级）
 - 如果需求信息不明确，必须询问用户
 - 提案必须包含Why、What、Impact三个核心部分
+- 提案应聚焦高层次的业务目标和核心能力，不包含详细的功能需求（FR）和验收标准（AC）
+- 详细的功能需求和验收标准应该在specs阶段定义
 - 风险评估不能省略

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

@@ -1,6 +1,6 @@
 # 棕地需求 - Quick SOP
 
-P2 需求快速通道 - 适用于简单修复和小改动。
+快速通道 - 适用于简单修复和小改动。
 
 **输入**：`/6aspec:brown:quick` 后的参数是需求名称（kebab-case）或需求描述。
 
@@ -33,7 +33,6 @@ P2 需求快速通道 - 适用于简单修复和小改动。
    ```json
    {
      "name": "<name>",
-     "priority": "P2",
      "status": "quick_track",
      "createdAt": "<timestamp>",
      "lastModified": "<timestamp>",
@@ -46,7 +45,6 @@ P2 需求快速通道 - 适用于简单修复和小改动。
    # <需求标题>
 
    > **需求ID**: <name>
-   > **优先级**: P2（快速通道）
    > **状态**: 🚀 快速处理中
    > **创建时间**: <timestamp>
 
@@ -105,7 +103,6 @@ P2 需求快速通道 - 适用于简单修复和小改动。
 ```
 ## 快速处理完成：<name>
 
-**优先级**: P2（快速通道）
 **处理时间**: <时间戳>
 
 ### 修改内容
@@ -121,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）
+- 不能从实施阶段回退（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）**：
+   - understand → proposal
    - specs → understand
    - impact → specs
    - design → impact
    - tasks → design
-   - implement → tasks
+   - ~~implement → tasks~~（禁止：代码已修改）
 
    **完整级流程（complete）**：
+   - understand → proposal
    - specs → understand
    - impact → specs
    - design → impact
    - tasks → design
-   - implement → tasks
-   - verify → implement
-   - review → verify
+   - ~~implement → tasks~~（禁止：代码已修改）
+   - ~~verify → implement~~（禁止：代码已修改）
+   - ~~review → verify~~（禁止：代码已修改）
 
    **边界情况**：
-   - 如果当前在第一个阶段（proposal/understand），提示无法回退
+   - 如果当前在第一个阶段（proposal），提示无法回退
+   - 如果当前在实施阶段（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）
+- 不能从实施阶段回退（implement、verify、review）
+- 只允许在分析阶段回退（proposal、understand、specs、impact、design、tasks）
 - 必须用户确认后才能执行回退
 - 删除文件前检查文件是否存在
 - 更新状态时保持一致性
@@ -183,6 +192,7 @@
 
 - 如果需求不存在，提示创建新需求
 - 如果需求已归档，提示先取消归档
-- 如果当前在第一个阶段，提示无法回退
+- 如果当前在第一个阶段（proposal），提示无法回退
+- 如果当前在实施阶段（implement、verify、review），提示无法回退，原因：代码已修改，回退文档会导致文档和代码不一致
 - 如果所有阶段都是 pending，提示没有可回退的阶段
 - 如果文件删除失败，提示错误信息但继续更新状态