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

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

@@ -1,29 +1,37 @@
 # 棕地需求 - Specs SOP
 
-Phase 1.5: 需求规格定义
+需求规格定义
 
 **输入**：`/6aspec:brown:specs` 后可选需求名称。
 
-**适用流程**：标准级、完整级
+**适用流程**：轻量级、标准级、完整级
 
 **步骤**
 
 1. **选择需求并检查状态**
 
    - 读取 `6aspecdoc/brown/<name>/status.json`
-   - 确认 `phases.understand` 为 "done"
-   - 如果未完成 Phase 1，提示先运行 `/6aspec:brown:understand`
-   - 确认流程深度为 "standard" 或 "complete"
-   - 如果是 "lightweight"，提示应该使用 `/6aspec:brown:proposal`
+   - 根据 `flowDepth` 检查前置阶段：
+     - **轻量级**：确认 `phases.proposal` 为 "done"，如果未完成提示先运行 `/6aspec:brown:proposal`
+     - **标准级/完整级**：确认 `phases.impact` 为 "done"，如果未完成提示先运行 `/6aspec:brown:impact`
 
 2. **读取前置文档**
 
+   根据 `flowDepth` 读取不同的前置文档：
+
+   **轻量级流程**：
+   - `6aspecdoc/brown/<name>/requirement.md`
+   - `6aspecdoc/brown/<name>/artifacts/proposal.md`
+
+   **标准级/完整级流程**：
    - `6aspecdoc/brown/<name>/requirement.md`
-   - `6aspecdoc/brown/<name>/artifacts/01-understanding.md`
+   - `6aspecdoc/brown/<name>/artifacts/proposal.md`
+   - `6aspecdoc/brown/<name>/artifacts/understanding.md`
+   - `6aspecdoc/brown/<name>/artifacts/impact-analysis.md`
 
-3. **读取问题答案**
+3. **读取问题答案（仅标准级/完整级）**
 
-   从 understanding.md 中读取"待明确问题清单"及用户的答案：
+   如果是标准级或完整级流程，从 understanding.md 中读取"待明确问题清单"及用户的答案：
 
    - 检查问题清单中哪些问题已经有答案（标记为具体值而非"[待确认]"）
    - 如果有未回答的问题，提示用户这些问题需要明确，但不阻塞 specs 阶段
@@ -33,17 +41,30 @@ Phase 1.5: 需求规格定义
 
 4. **定义功能需求**
 
-   基于需求理解和问题答案，明确定义系统应该具备的能力：
+   基于需求理解和问题答案，使用 Requirement + Scenario 格式明确定义系统应该具备的能力：
+
+   **功能需求格式**（借鉴 OpenSpec 的 WHEN/THEN 格式）：
+   ```markdown
+   ### Requirement: <需求名称>
+
+   <需求描述，使用 SHALL/MUST 关键字表示强制性要求>
+
+   #### Scenario: <场景名称>
+
+   - **WHEN** <触发条件>
+   - **THEN** <预期结果>
+   - **AND** <额外的预期结果>（可选）
 
-   **功能需求格式**：
-   - FR-001: <功能描述>
-     - 输入：<输入内容>
-     - 输出：<输出内容>
-     - 业务规则：<业务规则>
-     - 验收标准：<验收标准>
+   #### Scenario: <另一个场景名称>
+
+   - **WHEN** <触发条件>
+   - **THEN** <预期结果>
+   ```
 
    **拆解原则**：
-   - 每个功能需求应该是独立的、可验证的
+   - 每个 Requirement 应该是独立的、可验证的
+   - 每个 Scenario 使用 WHEN/THEN 格式，天然可测试
+   - 使用 SHALL/MUST 关键字表示强制性要求，SHOULD 表示推荐性要求
    - 功能需求应该从用户视角描述（做什么，而不是怎么做）
    - 避免技术实现细节（技术细节放在 design 阶段）
 
@@ -51,10 +72,26 @@ Phase 1.5: 需求规格定义
 
    明确系统应该满足的质量标准：
 
-   - NFR-001: 性能需求（响应时间、并发量等）
-   - NFR-002: 安全需求（权限控制、数据加密等）
-   - NFR-003: 可用性需求（易用性、可维护性等）
-   - NFR-004: 兼容性需求（浏览器、数据库等）
+   **非功能需求格式**：
+   ```markdown
+   ### 性能需求
+   - 响应时间 SHALL < 200ms
+   - 并发量 SHALL 支持 1000+ QPS
+
+   ### 安全需求
+   - 权限控制：只有管理员 SHALL 可以修改
+   - 数据加密：敏感数据 SHALL 加密存储
+
+   ### 可用性需求
+   - 易用性：界面 SHOULD 符合团队 UI 规范
+   - 可维护性：代码 SHOULD 遵循现有架构模式
+
+   ### 兼容性需求
+   - 浏览器：SHALL 支持 Chrome/Firefox/Safari 最新版本
+   - 数据库：SHALL 兼容现有数据库版本
+   ```
+
+   注意：使用 SHALL/MUST 表示强制性要求，SHOULD 表示推荐性要求
 
 6. **定义范围和约束**
 
@@ -69,22 +106,17 @@ Phase 1.5: 需求规格定义
    - 业务约束：<业务上的限制>
    - 时间约束：<时间上的限制>
 
-7. **定义验收标准**
-
-   明确如何验证需求已经实现：
+7. **创建需求规格文档**
 
-   - AC-001: <功能验收标准>
-   - AC-002: <非功能验收标准>
-   - AC-003: <数据验收标准>
+   注意：使用 WHEN/THEN 格式定义的 Scenario 本身就是验证标准，无需单独定义验收标准。
 
-8. **创建需求规格文档**
-
-   创建 `6aspecdoc/brown/<name>/artifacts/01.5-specs.md`：
+   创建 `6aspecdoc/brown/<name>/artifacts/specs.md`：
    ```markdown
-   # Phase 1.5: 需求规格定义
+   # 需求规格定义
 
    > **需求**: <name>
-   > **阶段**: Phase 1.5 - 需求规格
+   > **流程**: <flowDepth>
+   > **阶段**: Specs
    > **状态**: ✅ 已完成
    > **完成时间**: <timestamp>
 
@@ -93,10 +125,7 @@ Phase 1.5: 需求规格定义
    ### 1.1 业务目标
    <为什么需要这个功能>
 
-   ### 1.2 使用场景
-   <谁用、什么时候用、怎么用>
-
-   ### 1.3 范围定义
+   ### 1.2 范围定义
    **包含**：
    - <明确包含的功能>
 
@@ -105,124 +134,224 @@ Phase 1.5: 需求规格定义
 
    ## 2. 功能需求
 
-   ### FR-001: <功能名称>
-   **描述**：<功能描述>
+   ### Requirement: <需求名称>
 
-   **输入**：
-   - <输入内容>
+   <需求描述，使用 SHALL/MUST 关键字表示强制性要求>
 
-   **输出**：
-   - <输出内容>
+   #### Scenario: <场景名称>
 
-   **业务规则**：
-   - <业务规则1>
-   - <业务规则2>
+   - **WHEN** <触发条件>
+   - **THEN** <预期结果>
+   - **AND** <额外的预期结果>（可选）
 
-   **验收标准**：
-   - <验收标准1>
-   - <验收标准2>
+   #### Scenario: <另一个场景名称>
 
-   ### FR-002: <功能名称>
-   ...
+   - **WHEN** <触发条件>
+   - **THEN** <预期结果>
+
+   ### Requirement: <另一个需求名称>
+
+   <需求描述>
+
+   #### Scenario: <场景名称>
+
+   - **WHEN** <触发条件>
+   - **THEN** <预期结果>
 
    ## 3. 非功能需求
 
-   ### 3.1 性能需求
-   - NFR-001: <性能要求>
+   ### 性能需求
+   - 响应时间 SHALL < <具体值>
+   - 并发量 SHALL 支持 <具体值>
 
-   ### 3.2 安全需求
-   - NFR-002: <安全要求>
+   ### 安全需求
+   - 权限控制：<具体要求>
+   - 数据加密：<具体要求>
 
-   ### 3.3 可用性需求
-   - NFR-003: <可用性要求>
+   ### 可用性需求
+   - 易用性：<具体要求>
+   - 可维护性：<具体要求>
 
-   ### 3.4 兼容性需求
-   - NFR-004: <兼容性要求>
+   ### 兼容性需求
+   - 浏览器：SHALL 支持 <具体版本>
+   - 数据库：SHALL 兼容 <具体版本>
 
    ## 4. 约束条件
 
-   ### 4.1 技术约束
+   ### 技术约束
    - <技术上的限制>
 
-   ### 4.2 业务约束
+   ### 业务约束
    - <业务上的限制>
 
-   ### 4.3 时间约束
+   ### 时间约束
    - <时间上的限制>
 
-   ## 5. 验收标准
-
-   ### 5.1 功能验收
-   - AC-001: <功能验收标准>
-   - AC-002: <功能验收标准>
+   ## 5. 下一步
 
-   ### 5.2 非功能验收
-   - AC-003: <非功能验收标准>
-   - AC-004: <非功能验收标准>
+   - 轻量级流程：运行 `/6aspec:brown:design` 进行技术方案设计
+   - 标准级/完整级流程：运行 `/6aspec:brown:impact` 进行影响面分析
+   ```
 
-   ### 5.3 数据验收
-   - AC-005: <数据验收标准>
+9. **更新状态**
 
-   ## 6. 下一步
+   更新 `6aspecdoc/brown/<name>/status.json`：
 
-   运行 `/6aspec:brown:impact` 进行影响面分析。
+   **轻量级流程**：
+   ```json
+   {
+     "status": "design_pending",
+     "flowDepth": "lightweight",
+     "phases": {
+       "proposal": "done",
+       "specs": "done",
+       "design": "pending",
+       "tasks": "blocked",
+       "implement": "blocked"
+     },
+     "artifacts": ["proposal.md", "specs.md"]
+   }
    ```
 
-9. **更新状态**
+   **标准级流程**：
+   ```json
+   {
+     "status": "design_pending",
+     "flowDepth": "standard",
+     "phases": {
+       "proposal": "done",
+       "understand": "done",
+       "impact": "done",
+       "specs": "done",
+       "design": "pending",
+       "tasks": "blocked",
+       "implement": "blocked"
+     },
+     "artifacts": ["proposal.md", "understanding.md", "impact-analysis.md", "specs.md"]
+   }
+   ```
 
-   更新 `6aspecdoc/brown/<name>/status.json`：
+   **完整级流程**：
    ```json
    {
-     "status": "impact_pending",
+     "status": "design_pending",
+     "flowDepth": "complete",
      "phases": {
+       "proposal": "done",
        "understand": "done",
+       "impact": "done",
        "specs": "done",
-       "impact": "pending",
-       ...
+       "design": "pending",
+       "tasks": "blocked",
+       "implement": "blocked",
+       "verify": "blocked",
+       "review": "blocked"
      },
-     "artifacts": ["01-understanding.md", "01.5-specs.md"]
+     "artifacts": ["proposal.md", "understanding.md", "impact-analysis.md", "specs.md"]
    }
    ```
 
 **输出**
 
+根据 `flowDepth` 显示不同的输出信息：
+
+**轻量级流程**：
+```
+## Specs 完成：<name>
+
+**流程**: 轻量级
+**进度**: 2/5 阶段完成
+
+### 需求概要
+- 功能需求：<数量> 个 Requirement
+- 测试场景：<数量> 个 Scenario
+- 非功能需求：<数量> 项
+
+### 核心功能
+<列出 2-3 个核心 Requirement>
+
+### 关键约束
+<列出 1-2 个关键约束>
+
+### 文档位置
+6aspecdoc/brown/<name>/artifacts/specs.md
+
+### 下一步
+- 直接回复补充或修正需求规格 → 我会更新本阶段文档（specs.md）
+- 运行 `/6aspec:brown:design` → 进入技术方案设计阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
+```
+
+**标准级流程**：
+```
+## Specs 完成：<name>
+
+**流程**: 标准级
+**进度**: 4/6 阶段完成
+
+### 需求概要
+- 功能需求：<数量> 个 Requirement
+- 测试场景：<数量> 个 Scenario
+- 非功能需求：<数量> 项
+
+### 核心功能
+<列出 2-3 个核心 Requirement>
+
+### 关键约束
+<列出 1-2 个关键约束>
+
+### 文档位置
+6aspecdoc/brown/<name>/artifacts/specs.md
+
+### 下一步
+- 直接回复补充或修正需求规格 → 我会更新本阶段文档（specs.md）
+- 运行 `/6aspec:brown:design` → 进入技术方案设计阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
+```
+
+**完整级流程**：
 ```
-## Phase 1.5 完成：需求规格定义
+## Specs 完成：<name>
 
-**需求**: <name>
-**进度**: 2/8 阶段完成（标准级）或 2/9 阶段完成（完整级）
+**流程**: 完整级
+**进度**: 4/8 阶段完成
 
 ### 需求概要
-- 功能需求：<数量> 个
-- 非功能需求：<数量> 个
-- 验收标准：<数量> 个
+- 功能需求：<数量> 个 Requirement
+- 测试场景：<数量> 个 Scenario
+- 非功能需求：<数量> 项
 
 ### 核心功能
-<列出 2-3 个核心功能需求>
+<列出 2-3 个核心 Requirement>
 
 ### 关键约束
 <列出 1-2 个关键约束>
 
 ### 文档位置
-6aspecdoc/brown/<name>/artifacts/01.5-specs.md
+6aspecdoc/brown/<name>/artifacts/specs.md
 
 ### 下一步
-- 直接回复补充或修正需求规格 → 我会更新本阶段文档（01.5-specs.md）
-- 运行 `/6aspec:brown:impact` → 进入影响面分析阶段
+- 直接回复补充或修正需求规格 → 我会更新本阶段文档（specs.md）
+- 运行 `/6aspec:brown:design` → 进入技术方案设计阶段
 - 运行 `/6aspec:brown:continue` → 自动进入下一阶段
 ```
 
 **用户补充信息时的处理**
 
 当用户补充需求细节、修正功能需求时（未使用阶段命令）：
-1. 将用户的补充整合到 `01.5-specs.md` 的对应章节（功能需求、非功能需求、验收标准等）
+1. 将用户的补充整合到 `specs.md` 的对应章节（功能需求、非功能需求、验收标准等）
 2. 展示变更摘要
 3. 再次提示：可以继续补充，或通过命令进入下一阶段
 4. **禁止**：不得自动进入下一阶段
 
 **防护措施**
-- 必须先完成 Phase 1（understand）
-- 只适用于标准级和完整级流程
+- 适用于所有流程（轻量级、标准级、完整级）
+- 根据flowDepth检查不同的前置阶段：
+  - 轻量级：必须先完成proposal阶段
+  - 标准级/完整级：必须先完成understand阶段
+- 功能需求必须使用 Requirement + Scenario (WHEN/THEN) 格式
+- 使用 SHALL/MUST 表示强制性要求，SHOULD 表示推荐性要求
+- 每个 Scenario 必须可测试、可验证
 - 功能需求必须从用户视角描述，避免技术实现细节
-- 验收标准必须具体、可验证
 - 需求问题的答案应该体现在功能需求定义中，而不是单独列出
+- specs的详细程度保持一致，不区分流程深度

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

@@ -31,28 +31,33 @@
 
    ### 阶段进度
 
-   **轻量级流程（4阶段）**：
+   **轻量级流程（5阶段）**：
    | 阶段 | 状态 | 完成时间 |
    |------|------|----------|
    | Proposal | ✅ 已完成 / 🔄 进行中 / 📋 待开始 / 🔒 阻塞 | <timestamp> |
+   | Specs | ... | ... |
    | Design | ... | ... |
    | Tasks | ... | ... |
    | Implement | ... | ... |
 
-   **标准级流程（5阶段）**：
+   **标准级流程（7阶段）**：
    | 阶段 | 状态 | 完成时间 |
    |------|------|----------|
    | Understand | ✅ 已完成 / 🔄 进行中 / 📋 待开始 / 🔒 阻塞 | <timestamp> |
    | Impact | ... | ... |
+   | Proposal | ... | ... |
+   | Specs | ... | ... |
    | Design | ... | ... |
    | Tasks | ... | ... |
    | Implement | ... | ... |
 
-   **完整级流程（7阶段）**：
+   **完整级流程（9阶段）**：
    | 阶段 | 状态 | 完成时间 |
    |------|------|----------|
    | Understand | ✅ 已完成 / 🔄 进行中 / 📋 待开始 / 🔒 阻塞 | <timestamp> |
    | Impact | ... | ... |
+   | Proposal | ... | ... |
+   | Specs | ... | ... |
    | Design | ... | ... |
    | Tasks | ... | ... |
    | Implement | ... | ... |
@@ -70,18 +75,23 @@
 
    **轻量级**：
    - [ ] proposal.md
+   - [ ] specs.md
    - [ ] design.md
    - [ ] tasks.md
 
    **标准级**：
    - [ ] understanding.md
    - [ ] impact-analysis.md
+   - [ ] proposal.md
+   - [ ] specs.md
    - [ ] design.md
    - [ ] tasks.md
 
    **完整级**：
    - [ ] understanding.md
    - [ ] impact-analysis.md
+   - [ ] proposal.md
+   - [ ] specs.md
    - [ ] design.md
    - [ ] tasks.md
    - [ ] verification-report.md

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

@@ -14,9 +14,21 @@ Phase 4: 任务拆解与排期
 
 2. **读取前置文档**
 
-   - `6aspecdoc/brown/<name>/artifacts/01-understanding.md`
-   - `6aspecdoc/brown/<name>/artifacts/02-impact-analysis.md`
-   - `6aspecdoc/brown/<name>/artifacts/03-technical-design.md`
+   根据 `flowDepth` 读取不同的前置文档：
+
+   **轻量级流程**：
+   - `6aspecdoc/brown/<name>/requirement.md`
+   - `6aspecdoc/brown/<name>/artifacts/proposal.md`
+   - `6aspecdoc/brown/<name>/artifacts/specs.md`
+   - `6aspecdoc/brown/<name>/artifacts/design.md`
+
+   **标准级/完整级流程**：
+   - `6aspecdoc/brown/<name>/requirement.md`
+   - `6aspecdoc/brown/<name>/artifacts/proposal.md`
+   - `6aspecdoc/brown/<name>/artifacts/understanding.md`
+   - `6aspecdoc/brown/<name>/artifacts/impact-analysis.md`
+   - `6aspecdoc/brown/<name>/artifacts/specs.md`
+   - `6aspecdoc/brown/<name>/artifacts/design.md`
 
 3. **原子任务拆解**
 
@@ -73,7 +85,7 @@ Phase 4: 任务拆解与排期
 
 6. **创建任务总览**
 
-   创建 `6aspecdoc/brown/<name>/artifacts/04-tasks-overview.md`：
+   创建 `6aspecdoc/brown/<name>/artifacts/tasks-overview.md`：
    ```markdown
    # Phase 4: 任务拆解与排期
 
@@ -186,7 +198,7 @@ Phase 4: 任务拆解与排期
 <列出关键里程碑>
 
 ### 文档位置
-- 6aspecdoc/brown/<name>/artifacts/04-tasks-overview.md
+- 6aspecdoc/brown/<name>/artifacts/tasks-overview.md
 - 6aspecdoc/brown/<name>/tasks/TASK-*.md
 
 ### 下一步