6aspec 2.0.0-dev.5 → 2.0.0-dev.7

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

@@ -21,11 +21,21 @@ Phase 1.5: 需求规格定义
    - `6aspecdoc/brown/<name>/requirement.md`
    - `6aspecdoc/brown/<name>/artifacts/01-understanding.md`
 
-3. **回答待明确问题**
+3. **提出并收集需求问题**
 
-   从 understanding.md 中提取"待明确问题清单"，引导用户回答这些问题。
+   基于 understanding.md 的现状分析和"发现的疑问点"，系统性地提出需求问题：
 
-   如果用户已经在对话中提供了答案，直接使用。否则，询问用户关键问题（选择最重要的 3-5 个问题）。
+   **需求问题类型**：
+   - 字段设计问题（名称、类型、必填、默认值、值域）
+   - 业务规则问题（是否可修改、是否继承、是否同步）
+   - 权限和统计问题（权限控制、统计报表）
+   - 集成和兼容问题（与其他模块的集成、数据迁移）
+
+   **收集答案**：
+   - 引导用户回答这些需求问题
+   - 如果用户已经在对话中提供了答案，直接使用
+   - 否则，询问用户关键问题（选择最重要的 3-5 个问题）
+   - 在同一阶段内完成问题提出和答案收集
 
 4. **定义功能需求**
 
@@ -159,11 +169,7 @@ Phase 1.5: 需求规格定义
    ### 5.3 数据验收
    - AC-005: <数据验收标准>
 
-   ## 6. 待明确问题的答案
-
-   <列出 understanding 阶段提出的问题及其答案>
-
-   ## 7. 下一步
+   ## 6. 下一步
 
    运行 `/6aspec:brown:impact` 进行影响面分析。
    ```
@@ -214,7 +220,7 @@ Phase 1.5: 需求规格定义
 
 **用户补充信息时的处理**
 
-当用户补充需求细节、修正功能需求、或回答问题时（未使用阶段命令）：
+当用户补充需求细节、修正功能需求时（未使用阶段命令）：
 1. 将用户的补充整合到 `01.5-specs.md` 的对应章节（功能需求、非功能需求、验收标准等）
 2. 展示变更摘要
 3. 再次提示：可以继续补充，或通过命令进入下一阶段
@@ -225,3 +231,4 @@ Phase 1.5: 需求规格定义
 - 只适用于标准级和完整级流程
 - 功能需求必须从用户视角描述，避免技术实现细节
 - 验收标准必须具体、可验证
+- 需求问题的答案应该体现在功能需求定义中，而不是单独列出

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

@@ -64,12 +64,14 @@ Phase 1: 需求理解与现状分析
    - 识别状态机约束
    - 识别权限控制逻辑
 
-5. **生成待明确问题清单**
+5. **记录发现的疑问点**
 
-   基于分析结果，生成问题清单：
-   - 字段设计问题（名称、类型、必填、默认值、值域）
-   - 业务规则问题（是否可修改、是否继承、是否同步）
-   - 权限和统计问题（权限控制、统计报表）
+   基于现状分析，记录在分析过程中发现的疑问点（观察性备注）：
+   - 现有实现中不清楚的地方
+   - 可能影响需求实现的关键点
+   - 需要在 specs 阶段明确的技术或业务细节
+
+   注意：这些疑问点是观察性的，不是正式的需求问题清单。正式的需求问题将在 specs 阶段提出。
 
 6. **创建分析文档**
 
@@ -78,27 +80,19 @@ Phase 1: 需求理解与现状分析
    # Phase 1: 需求理解与现状分析
 
    > **需求**: <name>
-   > **阶段**: Phase 1 - 需求理解
+   > **阶段**: Phase 1 - 现状分析
    > **状态**: ✅ 已完成
    > **完成时间**: <timestamp>
 
-   ## 1. 需求概述
-
-   ### 业务目标
-   <为什么需要这个功能>
-
-   ### 使用场景
-   <谁用、什么时候用、怎么用>
+   ## 1. 现有系统分析
 
-   ## 2. 现有系统分析
-
-   ### 2.1 相关实体类
+   ### 1.1 相关实体类
    <列出相关实体类及其职责>
 
-   ### 2.2 相关服务类
+   ### 1.2 相关服务类
    <列出相关服务类及其职责>
 
-   ### 2.3 数据库表关系图
+   ### 1.3 数据库表关系图
    ```mermaid
    erDiagram
        TableA ||--o{ TableB : "关系"
@@ -112,7 +106,7 @@ Phase 1: 需求理解与现状分析
        }
    ```
 
-   ### 2.4 核心业务流程图
+   ### 1.4 核心业务流程图
    ```mermaid
    flowchart TB
        Start[开始] --> Process[处理步骤]
@@ -121,30 +115,25 @@ Phase 1: 需求理解与现状分析
        Decision -->|否| End2[结束路径2]
    ```
 
-   ### 2.5 隐性假设和约束
+   ### 1.5 隐性假设和约束
    <列出识别的隐性假设和约束>
 
-   ## 3. 待明确问题清单
+   ## 2. 发现的疑问点
+
+   基于现状分析，记录以下疑问点（这些疑问点将在 specs 阶段转化为正式的需求问题）：
 
-   ### 字段设计
-   1. 字段名称：[待确认]
-   2. 字段类型：[待确认]
-   3. 是否必填：[待确认]
-   4. 默认值：[待确认]
-   5. 值域范围：[待确认]
+   ### 技术实现相关
+   - <现有实现中不清楚的地方>
 
-   ### 业务规则
-   6. 是否可以修改：[待确认]
-   7. 子项目是否继承：[待确认]
-   8. 是否需要同步到其他表：[待确认]
+   ### 业务逻辑相关
+   - <可能影响需求实现的关键点>
 
-   ### 权限和统计
-   9. 是否需要权限控制：[待确认]
-   10. 是否需要统计报表：[待确认]
+   ### 数据和集成相关
+   - <需要在 specs 阶段明确的技术或业务细节>
 
-   ## 4. 下一步
+   ## 3. 下一步
 
-   请回答上述待明确问题，然后运行 `/6aspec:brown:specs` 定义需求规格。
+   运行 `/6aspec:brown:specs` 进入需求规格定义阶段，在该阶段将提出正式的需求问题并定义系统应该具备的能力。
    ```
 
 7. **更新状态**
@@ -169,7 +158,7 @@ Phase 1: 需求理解与现状分析
 
 完成后，显示：
 ```
-## Phase 1 完成：需求理解与现状分析
+## Phase 1 完成：现状分析
 
 **需求**: <name>
 **进度**: 1/7 阶段完成
@@ -178,29 +167,29 @@ Phase 1: 需求理解与现状分析
 - 相关实体类：<数量>
 - 相关服务类：<数量>
 - 数据库表：<数量>
-- 待明确问题：<数量>
+- 发现的疑问点：<数量>
 
 ### 关键发现
 <列出 2-3 个关键发现>
 
-### 待明确问题（重要）
-<列出最重要的 3-5 个问题>
+### 发现的疑问点
+<列出主要的疑问点>
 
 ### 文档位置
 6aspecdoc/brown/<name>/artifacts/01-understanding.md
 
 ### 下一步
-- 直接回答上述待明确问题 → 我会更新本阶段文档（01-understanding.md）
-- 运行 `/6aspec:brown:specs` → 进入需求规格定义阶段
+- 直接补充现状分析信息 → 我会更新本阶段文档（01-understanding.md）
+- 运行 `/6aspec:brown:specs` → 进入需求规格定义阶段（将提出正式的需求问题）
 - 运行 `/6aspec:brown:continue` → 自动进入下一阶段
 ```
 
 **用户补充信息时的处理**
 
-当用户回答待明确问题或补充需求信息时（未使用阶段命令）：
-1. 将用户的回答整合到 `01-understanding.md` 中对应的问题项（将"[待确认]"替换为实际答案）
-2. 如果回答引发新的发现或问题，同步更新文档的相关章节
-3. 展示变更摘要（更新了哪些问题的答案、新增了哪些发现）
+当用户补充现状分析信息时（未使用阶段命令）：
+1. 将用户的补充整合到 `01-understanding.md` 的相关章节
+2. 如果补充引发新的发现或疑问点，同步更新文档
+3. 展示变更摘要（更新了哪些内容、新增了哪些发现）
 4. 再次提示：可以继续补充，或通过命令进入下一阶段
 5. **禁止**：不得自动进入下一阶段
 
@@ -208,4 +197,4 @@ Phase 1: 需求理解与现状分析
 - 必须先读取需求描述再开始分析
 - 如果找不到相关代码，询问用户提供更多关键词
 - 如果分析不充分，不要强行生成文档，而是询问用户
-- 待明确问题必须具体，避免模糊问题
+- 发现的疑问点应该是观察性的，不是正式的需求问题

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "6aspec",
-  "version": "2.0.0-dev.5",
+  "version": "2.0.0-dev.7",
   "description": "6Aspec - 轻量级 spec 驱动开发框架，支持 Cursor 和 Claude Code",
   "main": "lib/installer.js",
   "bin": {