6aspec 2.0.0-dev.3 → 2.0.0-dev.30

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

@@ -0,0 +1,314 @@
+# 棕地需求 - Explore SOP
+
+进入探索模式 - 深入思考、自由探索、澄清需求
+
+**流程定位**：这是一种探索姿态（stance），而非固定工作流。可以在任何阶段使用，帮助理解问题、探索方案、挑战假设。
+
+**输入**：`/6aspec:brown:explore` 后可选需求名称或探索主题。可以是：
+- 需求名称："user-permission-refactor"
+- 模糊想法："权限系统重构"
+- 具体问题："现有的权限检查逻辑为什么这么慢"
+- 方案比较："Redis vs 内存缓存"
+- 或者什么都不提供（进入开放探索）
+
+**核心理念**：
+- 你是思考伙伴，不是执行工具
+- 没有固定步骤，没有时间限制，没有强制输出
+- 探索本身就是价值，thinking IS the value
+- 默认不生成文档，除非用户明确要求
+
+---
+
+## 探索姿态
+
+**好奇而非指令式**
+- 提出自然涌现的问题，不遵循脚本
+- 开放多个有趣的方向，让用户选择感兴趣的
+- 不要把用户引导到单一路径
+
+**可视化优先**
+- 自由使用 ASCII 图表帮助澄清思考
+- 系统架构图、状态机、数据流、依赖关系、对比表格
+```
+示例：
+┌─────────────┐         ┌─────────────┐
+│   现有方案   │────────▶│   新方案    │
+│  (问题点)   │         │  (改进点)   │
+└─────────────┘         └─────────────┘
+```
+
+**适应性强**
+- 跟随有趣的线索
+- 当新信息出现时及时调整方向
+- 不急于得出结论，让问题的形状自然浮现
+
+**扎根现实**
+- 探索实际代码库，不只是理论推测
+- 理解现有模式和架构
+- 识别隐藏的复杂性
+
+**挑战假设**
+- 质疑用户的假设（也质疑自己的）
+- 重新框定问题
+- 寻找类比和替代视角
+
+---
+
+## 探索方式
+
+根据用户带来的内容，你可能会：
+
+### 探索问题空间
+- 提出澄清性问题
+- 挑战假设
+- 重新框定问题
+- 寻找类比
+
+### 调查代码库
+- 映射与讨论相关的现有架构
+- 找到集成点
+- 识别已使用的模式
+- 发现隐藏的复杂性
+
+### 比较方案
+- 头脑风暴多种方法
+- 构建对比表格
+- 勾勒权衡
+- 推荐路径（如果被问到）
+
+### 可视化思考
+- 使用 ASCII 图表展示架构、流程、状态转换
+- 绘制依赖关系图
+- 创建对比表格
+
+### 识别风险和未知
+- 识别可能出错的地方
+- 找到理解上的空白
+- 建议尖峰调查或深入研究
+
+---
+
+## 与 Brown 流程的集成
+
+### 启动探索
+
+1. **识别上下文**
+
+   如果用户提供了需求名称，读取现有内容：
+   ```bash
+   # 检查需求是否存在
+   ls 6aspecdoc/brown/<name>/
+   ```
+
+   读取相关文件获取上下文：
+   - `requirement.md` - 原始需求
+   - `proposal.md` - 需求提案（如果存在）
+   - `design.md` - 技术方案（如果存在）
+   - 其他已有的工件
+
+2. **自然引用现有内容**
+
+   在对话中自然引用已有的决策和内容：
+   - "你的 proposal 提到要支持角色继承，但我们现在发现..."
+   - "design 中选择了 Redis，但考虑到..."
+   - "原始需求说要支持 1000 并发，这意味着..."
+
+### 探索过程中
+
+**自由探索，不受限制**
+- 可以深入代码库
+- 可以绘制架构图
+- 可以比较多个方案
+- 可以质疑需求本身
+- 可以发现新的问题
+
+**提供捕获建议（但不强制）**
+
+当有重要洞察时，可以提议捕获：
+
+| 洞察类型 | 建议捕获位置 |
+|---------|------------|
+| 发现新需求 | "这是个新需求，要加到 requirement.md 吗？" |
+| 需求变更 | "这改变了原始需求，要更新 requirement.md 吗？" |
+| 设计决策 | "这是个设计决策，要记录到 design.md 吗？" |
+| 范围变化 | "这改变了范围，要更新 proposal 吗？" |
+| 识别新任务 | "这是新的工作项，要加到 tasks.md 吗？" |
+| 假设失效 | "这个假设不成立，要更新相关文档吗？" |
+
+**用户决定** - 只是提议，不施压，不自动捕获。
+
+### 结束探索
+
+探索没有固定的结束方式，可能：
+
+**流入行动**
+- "思路清晰了，要开始 `/6aspec:brown:proposal` 吗？"
+- "要继续下一阶段吗？"
+
+**生成探索摘要（可选）**
+- 用户可以要求："生成探索摘要"
+- 创建 `6aspecdoc/brown/<name>/explore-summary.md`
+- 内容根据实际探索过程动态生成，不是固定模板
+- 可用于后续的 proposal、design 或其他阶段
+
+**仅提供澄清**
+- 用户获得了需要的理解，继续其他工作
+- 不需要任何文档或后续行动
+
+**稍后继续**
+- "我们随时可以继续探索"
+- 探索可以暂停，随时恢复
+
+---
+
+## 生成探索摘要
+
+**触发条件**：用户明确要求"生成探索摘要"或类似表达
+
+**生成位置**：`6aspecdoc/brown/<name>/explore-summary.md`
+
+**更新策略**：
+
+1. **第一次生成**：
+   - 如果 explore-summary.md 不存在，创建新文件
+   - 包含当前探索的发现
+
+2. **后续探索**：
+   - 如果 explore-summary.md 已存在，询问用户：
+     ```
+     问题："explore-summary.md 已存在，如何处理？"
+     选项：
+     - 更新（整合新发现到现有内容）（推荐）
+     - 重新生成（替换全部内容）
+     ```
+   - **更新模式**（推荐）：
+     - 整合新发现到"当前理解"部分
+     - 更新"关键决策"和"未解问题"
+     - 在"探索历史"部分添加新的探索记录
+     - 更新"最后更新"时间戳
+   - **重新生成模式**：
+     - 替换整个文件内容
+     - 只包含当前探索的发现
+
+**文件结构**：
+
+```markdown
+# Explore Summary: <需求标题>
+
+> **需求**: <name>
+> **最后更新**: <timestamp>
+
+## 当前理解
+
+<最新的、综合的理解和发现>
+<整合所有探索的核心洞察>
+
+## 关键决策
+
+<已做出的重要决策及其理由>
+- 决策1：<描述及理由>
+- 决策2：<描述及理由>
+
+## 未解问题
+
+<仍需进一步调查的问题>
+- 问题1：<描述>
+- 问题2：<描述>
+
+## 架构洞察
+
+<可选：ASCII 图表展示架构理解>
+
+```
+┌─────────────┐         ┌─────────────┐
+│   组件 A    │────────▶│   组件 B    │
+└─────────────┘         └─────────────┘
+```
+
+---
+
+## 探索历史
+
+### 探索 #1 - <日期> - <探索主题>
+
+**探索时间**: <timestamp>
+
+**探索内容**:
+<这次探索的具体内容>
+
+**关键发现**:
+- 发现1
+- 发现2
+
+**决策**:
+- 决策1
+
+### 探索 #2 - <日期> - <探索主题>
+
+**探索时间**: <timestamp>
+
+**探索内容**:
+<这次探索的具体内容>
+
+**关键发现**:
+- 发现1
+- 发现2
+
+**决策**:
+- 决策1
+```
+
+**内容原则**：
+- 根据实际探索过程动态生成
+- 不使用固定模板，内容应反映真实的探索路径
+- "当前理解"部分应该是综合的、最新的结论
+- "探索历史"部分按时间顺序记录每次探索
+- 可以包含 ASCII 图表
+- 简洁但完整
+
+---
+
+## 你不必做的事
+
+- 遵循脚本
+- 每次问相同的问题
+- 产生特定的工件
+- 得出结论
+- 如果有价值的话题出现就保持主题
+- 保持简短（这是思考时间）
+- 快速完成（没有时间限制）
+
+---
+
+## 防护措施
+
+**不要实施代码**
+- 永远不要编写应用代码或实现功能
+- 创建 6aspec 工件（proposal、design、specs）是可以的
+- 探索代码库、阅读文件、搜索代码都可以
+- 但不要修改应用代码
+
+**不要伪装理解**
+- 如果不清楚，深入挖掘
+- 承认不确定性
+
+**不要急于求成**
+- 探索是思考时间，不是任务时间
+- 让理解自然浮现
+
+**不要强加结构**
+- 让模式自然涌现
+- 不要强制套用模板
+
+**不要自动捕获**
+- 提议保存洞察，但不要自动执行
+- 让用户决定
+
+**要可视化**
+- 好的图表胜过千言万语
+
+**要探索代码库**
+- 让讨论扎根于现实
+
+**要质疑假设**
+- 包括用户的和你自己的

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

@@ -25,13 +25,13 @@
 3. **根据流程深度确定要执行的阶段**
 
    **轻量级（lightweight）**：
-   - proposal → design → tasks
+   - proposal → specs → design → tasks
 
    **标准级（standard）**：
-   - understand → specs → impact → design → tasks
+   - understand → impact → proposal → specs → design → tasks
 
    **完整级（complete）**：
-   - understand → specs → impact → design → tasks → verify → review
+   - understand → impact → proposal → specs → design → tasks → verify → review
 
    **快速通道（quick）**：
    - 提示使用 `/6aspec:brown:quick` 命令
@@ -52,12 +52,17 @@
    - 显示简要进度："✓ Proposal 完成"
    - 更新待办事项
 
-   b. **Design**
+   b. **Specs**
+   - 执行 `/6aspec:brown:specs` 的逻辑
+   - 显示简要进度："✓ Specs 完成"
+   - 更新待办事项
+
+   c. **Design**
    - 执行 `/6aspec:brown:design` 的逻辑
    - 显示简要进度："✓ Design 完成"
    - 更新待办事项
 
-   c. **Tasks**
+   d. **Tasks**
    - 执行 `/6aspec:brown:tasks` 的逻辑
    - 显示简要进度："✓ Tasks 完成"
    - 更新待办事项
@@ -69,23 +74,28 @@
    - 显示简要进度："✓ Understand 完成"
    - 更新待办事项
 
-   b. **Specs**
+   b. **Impact**
+   - 执行 `/6aspec:brown:impact` 的逻辑
+   - 显示简要进度："✓ Impact 完成"
+   - 更新待办事项
+
+   c. **Proposal**
+   - 执行 `/6aspec:brown:proposal` 的逻辑
+   - 显示简要进度："✓ Proposal 完成"
+   - 更新待办事项
+
+   d. **Specs**
    - 如果需要用户输入（待明确问题），询问用户
    - 执行 `/6aspec:brown:specs` 的逻辑
    - 显示简要进度："✓ Specs 完成"
    - 更新待办事项
 
-   c. **Impact**
-   - 执行 `/6aspec:brown:impact` 的逻辑
-   - 显示简要进度："✓ Impact 完成"
-   - 更新待办事项
-
-   d. **Design**
+   e. **Design**
    - 执行 `/6aspec:brown:design` 的逻辑
    - 显示简要进度："✓ Design 完成"
    - 更新待办事项
 
-   e. **Tasks**
+   f. **Tasks**
    - 执行 `/6aspec:brown:tasks` 的逻辑
    - 显示简要进度："✓ Tasks 完成"
    - 更新待办事项
@@ -111,10 +121,11 @@
 ## 快速分析完成：<name>
 
 **流程深度**: 轻量级
-**进度**: 3/4 阶段完成（分析阶段全部完成）
+**进度**: 4/4 阶段完成（分析阶段全部完成）
 
 ### 生成的文档
 - ✓ proposal.md - 需求提案
+- ✓ specs.md - 需求规格定义
 - ✓ design.md - 技术方案设计
 - ✓ tasks.md - 任务拆解
 
@@ -133,12 +144,13 @@
 ## 快速分析完成：<name>
 
 **流程深度**: 标准级
-**进度**: 5/6 阶段完成（分析阶段全部完成）
+**进度**: 6/6 阶段完成（分析阶段全部完成）
 
 ### 生成的文档
 - ✓ understanding.md - 需求理解与现状分析
-- ✓ specs.md - 需求规格定义
 - ✓ impact-analysis.md - 影响面分析
+- ✓ proposal.md - 需求提案
+- ✓ specs.md - 需求规格定义
 - ✓ design.md - 技术方案设计
 - ✓ tasks.md - 任务拆解
 
@@ -160,12 +172,13 @@
 ## 快速分析完成：<name>
 
 **流程深度**: 完整级
-**进度**: 5/7 阶段完成（分析阶段全部完成）
+**进度**: 6/8 阶段完成（分析阶段全部完成）
 
 ### 生成的文档
 - ✓ understanding.md - 需求理解与现状分析
-- ✓ specs.md - 需求规格定义
 - ✓ impact-analysis.md - 影响面分析
+- ✓ proposal.md - 需求提案
+- ✓ specs.md - 需求规格定义
 - ✓ design.md - 技术方案设计
 - ✓ tasks.md - 任务拆解
 

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

@@ -1,6 +1,10 @@
 # 棕地需求 - Impact SOP
 
-Phase 2: 影响面分析与非功能需求评估
+影响面分析与非功能需求评估
+
+**适用流程**：标准级、完整级
+
+**流程定位**：标准级/完整级的第二阶段，基于 understand 的现状分析评估变更影响
 
 **输入**：`/6aspec:brown:impact` 后可选需求名称。如果省略，从上下文推断或提示选择。
 
@@ -9,24 +13,20 @@ Phase 2: 影响面分析与非功能需求评估
 1. **选择需求并检查状态**
 
    - 读取 `6aspecdoc/brown/<name>/status.json`
-   - 确认 `phases.specs` 为 "done"
-   - 如果未完成 Phase 1.5，提示先运行 `/6aspec:brown:specs`
+   - 确认流程深度为 "standard" 或 "complete"
+   - 如果是 "lightweight"，提示轻量级流程不需要impact阶段，应该直接运行 `/6aspec:brown:design`
+   - 确认 `phases.understand` 为 "done"
+   - 如果understand未完成，提示先运行 `/6aspec:brown:understand`
 
 2. **读取前置文档**
 
    读取以下文档获取上下文：
-   - `6aspecdoc/brown/<name>/requirement.md` - 需求描述
-   - `6aspecdoc/brown/<name>/artifacts/01-understanding.md` - 现状分析
-   - `6aspecdoc/brown/<name>/artifacts/01.5-specs.md` - 需求规格
-
-3. **收集待明确问题的答案**
+   - `6aspecdoc/brown/<name>/artifacts/original-requirement.md` - 原始需求
+   - `6aspecdoc/brown/<name>/artifacts/understanding.md` - 现状分析（含业务规则答案）
 
-   如果用户在对话中提供了答案，记录下来。
-   如果没有，询问用户关键问题。
+   **注意**：Impact 阶段不依赖 proposal，基于原始需求和现状分析来评估影响面。
 
-   **重要**：必须获得关键业务规则的答案才能继续。
-
-4. **执行影响面分析**
+3. **执行影响面分析**
 
    分析以下维度：
 
@@ -58,7 +58,7 @@ Phase 2: 影响面分析与非功能需求评估
    - 错误提示是否友好
    - 是否需要多语言支持
 
-5. **执行非功能需求评估**
+4. **执行非功能需求评估**
 
    评估以下维度：
 
@@ -86,7 +86,7 @@ Phase 2: 影响面分析与非功能需求评估
    - 是否需要文档更新
    - 是否需要培训
 
-6. **创建函数映射表**
+5. **创建函数映射表**
 
    创建详细的函数级影响映射：
    ```markdown
@@ -96,18 +96,21 @@ Phase 2: 影响面分析与非功能需求评估
    | 领域服务 | XxxDomainService | save() | 🔴 重要修改 | 必填校验+不可修改约束 | P0 |
    ```
 
-7. **创建影响面分析文档**
+6. **创建影响面分析文档**
 
-   创建 `6aspecdoc/brown/<name>/artifacts/02-impact-analysis.md`：
+   创建 `6aspecdoc/brown/<name>/artifacts/impact-analysis.md`：
    ```markdown
-   # Phase 2: 影响面分析与非功能需求评估
+   # 影响面分析与非功能需求评估
 
    > **需求**: <name>
-   > **阶段**: Phase 2 - 影响面分析
+   > **流程**: <flowDepth>
+   > **阶段**: Impact
    > **状态**: ✅ 已完成
    > **完成时间**: <timestamp>
 
-   ## 1. 业务规则确认
+   ## 1. 业务规则总结
+
+   基于 understanding.md 中收集的业务规则答案，总结关键业务规则：
 
    | 规则 | 答案 | 说明 |
    |------|------|------|
@@ -218,43 +221,72 @@ Phase 2: 影响面分析与非功能需求评估
    ### 关键风险
    <列出 2-3 个关键风险>
 
-   ### 工作量预估
-   - 后端开发：<预估>
-   - 前端开发：<预估>
-   - 测试：<预估>
-   - 总计：<预估>
-
    ## 6. 下一步
 
    运行 `/6aspec:brown:design` 进行技术方案设计。
    ```
 
-8. **更新状态**
+7. **更新状态**
 
    更新 `6aspecdoc/brown/<name>/status.json`：
+
+   **标准级流程**：
    ```json
    {
-     "status": "design_pending",
+     "status": "proposal_pending",
+     "flowDepth": "standard",
      "phases": {
        "understand": "done",
        "impact": "done",
-       "design": "pending",
-       ...
+       "proposal": "pending",
+       "specs": "blocked",
+       "design": "blocked",
+       "tasks": "blocked",
+       "implement": "blocked"
      },
-     "artifacts": ["01-understanding.md", "02-impact-analysis.md"]
+     "artifacts": ["understanding.md", "impact-analysis.md"]
    }
    ```
 
-9. **停止并等待用户指令**
+   **完整级流程**：
+   ```json
+   {
+     "status": "proposal_pending",
+     "flowDepth": "complete",
+     "phases": {
+       "understand": "done",
+       "impact": "done",
+       "proposal": "pending",
+       "specs": "blocked",
+       "design": "blocked",
+       "tasks": "blocked",
+       "implement": "blocked",
+       "verify": "blocked",
+       "review": "blocked"
+     },
+     "artifacts": ["understanding.md", "impact-analysis.md"]
+   }
+   ```
+
+   同时更新 `6aspecdoc/brown/<name>/requirement.md`：
+   - 更新"状态"字段为 `📋 Proposal 待开始`
+   - 更新"最后修改"时间戳为 `<timestamp>`
+   - 更新"当前阶段"为 `Impact - 影响面分析（已完成）`
+   - 更新"下一步操作"为 `运行 /6aspec:brown:proposal 继续下一阶段`
+   - 在"进度概览"中标记 Impact 阶段为已完成 `[x]`
+
+8. **停止并等待用户指令**
 
 **输出**
 
-完成后，显示：
+根据 `flowDepth` 显示不同的输出信息：
+
+**标准级流程**：
 ```
-## Phase 2 完成：影响面分析
+## Impact 完成：<name>
 
-**需求**: <name>
-**进度**: 2/7 阶段完成
+**流程**: 标准级
+**进度**: 2/6 阶段完成
 
 ### 影响范围
 - 数据库表：<数量>
@@ -267,30 +299,54 @@ Phase 2: 影响面分析与非功能需求评估
 ### 关键风险
 <列出 2-3 个关键风险>
 
-### 工作量预估
-总计：<预估>
+### 文档位置
+6aspecdoc/brown/<name>/artifacts/impact-analysis.md
+
+### 下一步
+- 直接回复补充遗漏的影响点或修正分析 → 我会更新本阶段文档（impact-analysis.md）
+- 运行 `/6aspec:brown:proposal` → 进入需求提案阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
+```
+
+**完整级流程**：
+```
+## Impact 完成：<name>
+
+**流程**: 完整级
+**进度**: 2/8 阶段完成
+
+### 影响范围
+- 数据库表：<数量>
+- 后端类：<数量>
+- 前端页面：<数量>
+
+### 关键发现
+<列出 2-3 个关键发现>
+
+### 关键风险
+<列出 2-3 个关键风险>
 
 ### 文档位置
-6aspecdoc/brown/<name>/artifacts/02-impact-analysis.md
+6aspecdoc/brown/<name>/artifacts/impact-analysis.md
 
 ### 下一步
-- 直接回复补充遗漏的影响点或修正分析 → 我会更新本阶段文档（02-impact-analysis.md）
-- 运行 `/6aspec:brown:design` → 进入技术方案设计阶段
+- 直接回复补充遗漏的影响点或修正分析 → 我会更新本阶段文档（impact-analysis.md）
+- 运行 `/6aspec:brown:proposal` → 进入需求提案阶段
 - 运行 `/6aspec:brown:continue` → 自动进入下一阶段
 ```
 
 **用户补充信息时的处理**
 
 当用户指出遗漏的影响点、修正分析结论、或补充业务规则时（未使用阶段命令）：
-1. 将用户的补充整合到 `02-impact-analysis.md` 的对应章节
+1. 将用户的补充整合到 `impact-analysis.md` 的对应章节
 2. 展示变更摘要
 3. 再次提示：可以继续补充，或通过命令进入下一阶段
 4. **禁止**：不得自动进入下一阶段
 
 **防护措施**
-- 必须先完成 Phase 1 才能执行 Phase 2
-- 必须获得关键业务规则的答案
+- 只适用于标准级和完整级流程
+- 必须先完成specs阶段才能执行impact阶段
+- 所有业务规则答案应该已经在 understanding.md 中收集完成
 - 影响面分析必须全面，不能遗漏间接影响
 - 非功能需求评估必须具体，不能泛泛而谈
 - 函数映射表必须精确到函数级别
-- 工作量预估要基于实际影响范围