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

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

@@ -45,19 +45,19 @@
    - `implement` → 调用 `/6aspec:brown:implement`
 
    **标准级流程（standard）**：
-   - `proposal` → 调用 `/6aspec:brown:proposal`
    - `understand` → 调用 `/6aspec:brown:understand`
-   - `specs` → 调用 `/6aspec:brown:specs`
    - `impact` → 调用 `/6aspec:brown:impact`
+   - `proposal` → 调用 `/6aspec:brown:proposal`
+   - `specs` → 调用 `/6aspec:brown:specs`
    - `design` → 调用 `/6aspec:brown:design`
    - `tasks` → 调用 `/6aspec:brown:tasks`
    - `implement` → 调用 `/6aspec:brown:implement`
 
    **完整级流程（complete）**：
-   - `proposal` → 调用 `/6aspec:brown:proposal`
    - `understand` → 调用 `/6aspec:brown:understand`
-   - `specs` → 调用 `/6aspec:brown:specs`
    - `impact` → 调用 `/6aspec:brown:impact`
+   - `proposal` → 调用 `/6aspec:brown:proposal`
+   - `specs` → 调用 `/6aspec:brown:specs`
    - `design` → 调用 `/6aspec:brown:design`
    - `tasks` → 调用 `/6aspec:brown:tasks`
    - `implement` → 调用 `/6aspec:brown:implement`

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

@@ -11,7 +11,7 @@
    - 读取 `6aspecdoc/brown/<name>/status.json`
    - 根据 `flowDepth` 检查前置阶段：
      - **轻量级**：确认 `phases.specs` 为 "done"，如果未完成提示先运行 `/6aspec:brown:specs`
-     - **标准级/完整级**：确认 `phases.impact` 为 "done"，如果未完成提示先运行 `/6aspec:brown:impact`
+     - **标准级/完整级**：确认 `phases.specs` 为 "done"，如果未完成提示先运行 `/6aspec:brown:specs`
 
 2. **读取前置文档**
 

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

@@ -28,10 +28,10 @@
    - proposal → specs → design → tasks
 
    **标准级（standard）**：
-   - proposal → understand → specs → impact → design → tasks
+   - understand → impact → proposal → specs → design → tasks
 
    **完整级（complete）**：
-   - proposal → understand → specs → impact → design → tasks → verify → review
+   - understand → impact → proposal → specs → design → tasks → verify → review
 
    **快速通道（quick）**：
    - 提示使用 `/6aspec:brown:quick` 命令
@@ -69,27 +69,27 @@
 
    **标准级/完整级流程**：
 
-   a. **Proposal**
-   - 执行 `/6aspec:brown:proposal` 的逻辑
-   - 显示简要进度："✓ Proposal 完成"
-   - 更新待办事项
-
-   b. **Understand**
+   a. **Understand**
    - 执行 `/6aspec:brown:understand` 的逻辑
    - 显示简要进度："✓ Understand 完成"
    - 更新待办事项
 
-   c. **Specs**
+   b. **Impact**
+   - 执行 `/6aspec:brown:impact` 的逻辑
+   - 显示简要进度："✓ Impact 完成"
+   - 更新待办事项
+
+   c. **Proposal**
+   - 执行 `/6aspec:brown:proposal` 的逻辑
+   - 显示简要进度："✓ Proposal 完成"
+   - 更新待办事项
+
+   d. **Specs**
    - 如果需要用户输入（待明确问题），询问用户
    - 执行 `/6aspec:brown:specs` 的逻辑
    - 显示简要进度："✓ Specs 完成"
    - 更新待办事项
 
-   d. **Impact**
-   - 执行 `/6aspec:brown:impact` 的逻辑
-   - 显示简要进度："✓ Impact 完成"
-   - 更新待办事项
-
    e. **Design**
    - 执行 `/6aspec:brown:design` 的逻辑
    - 显示简要进度："✓ Design 完成"
@@ -121,10 +121,11 @@
 ## 快速分析完成：<name>
 
 **流程深度**: 轻量级
-**进度**: 3/4 阶段完成（分析阶段全部完成）
+**进度**: 4/4 阶段完成（分析阶段全部完成）
 
 ### 生成的文档
 - ✓ proposal.md - 需求提案
+- ✓ specs.md - 需求规格定义
 - ✓ design.md - 技术方案设计
 - ✓ tasks.md - 任务拆解
 
@@ -143,12 +144,13 @@
 ## 快速分析完成：<name>
 
 **流程深度**: 标准级
-**进度**: 5/6 阶段完成（分析阶段全部完成）
+**进度**: 6/6 阶段完成（分析阶段全部完成）
 
 ### 生成的文档
 - ✓ understanding.md - 需求理解与现状分析
-- ✓ specs.md - 需求规格定义
 - ✓ impact-analysis.md - 影响面分析
+- ✓ proposal.md - 需求提案
+- ✓ specs.md - 需求规格定义
 - ✓ design.md - 技术方案设计
 - ✓ tasks.md - 任务拆解
 
@@ -170,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` 后可选需求名称。如果省略，从上下文推断或提示选择。
 
@@ -11,18 +15,16 @@ Phase 2: 影响面分析与非功能需求评估
    - 读取 `6aspecdoc/brown/<name>/status.json`
    - 确认流程深度为 "standard" 或 "complete"
    - 如果是 "lightweight"，提示轻量级流程不需要impact阶段，应该直接运行 `/6aspec:brown:design`
-   - 确认 `phases.specs` 为 "done"
-   - 如果specs未完成，提示先运行 `/6aspec:brown:specs`
+   - 确认 `phases.understand` 为 "done"
+   - 如果understand未完成，提示先运行 `/6aspec:brown:understand`
 
 2. **读取前置文档**
 
    读取以下文档获取上下文：
    - `6aspecdoc/brown/<name>/requirement.md` - 需求描述
-   - `6aspecdoc/brown/<name>/artifacts/proposal.md` - 需求提案
    - `6aspecdoc/brown/<name>/artifacts/understanding.md` - 现状分析（含业务规则答案）
-   - `6aspecdoc/brown/<name>/artifacts/specs.md` - 需求规格
 
-   注意：所有需要的业务规则答案应该已经在 understanding.md 中收集完成。
+   **注意**：Impact 阶段不依赖 proposal，基于需求描述和现状分析来评估影响面。
 
 3. **执行影响面分析**
 
@@ -237,38 +239,38 @@ Phase 2: 影响面分析与非功能需求评估
    **标准级流程**：
    ```json
    {
-     "status": "design_pending",
+     "status": "proposal_pending",
      "flowDepth": "standard",
      "phases": {
-       "proposal": "done",
        "understand": "done",
-       "specs": "done",
        "impact": "done",
-       "design": "pending",
+       "proposal": "pending",
+       "specs": "blocked",
+       "design": "blocked",
        "tasks": "blocked",
        "implement": "blocked"
      },
-     "artifacts": ["proposal.md", "understanding.md", "specs.md", "impact-analysis.md"]
+     "artifacts": ["understanding.md", "impact-analysis.md"]
    }
    ```
 
    **完整级流程**：
    ```json
    {
-     "status": "design_pending",
+     "status": "proposal_pending",
      "flowDepth": "complete",
      "phases": {
-       "proposal": "done",
        "understand": "done",
-       "specs": "done",
        "impact": "done",
-       "design": "pending",
+       "proposal": "pending",
+       "specs": "blocked",
+       "design": "blocked",
        "tasks": "blocked",
        "implement": "blocked",
        "verify": "blocked",
        "review": "blocked"
      },
-     "artifacts": ["proposal.md", "understanding.md", "specs.md", "impact-analysis.md"]
+     "artifacts": ["understanding.md", "impact-analysis.md"]
    }
    ```
 
@@ -283,7 +285,7 @@ Phase 2: 影响面分析与非功能需求评估
 ## Impact 完成：<name>
 
 **流程**: 标准级
-**进度**: 4/7 阶段完成
+**进度**: 2/6 阶段完成
 
 ### 影响范围
 - 数据库表：<数量>
@@ -304,7 +306,7 @@ Phase 2: 影响面分析与非功能需求评估
 
 ### 下一步
 - 直接回复补充遗漏的影响点或修正分析 → 我会更新本阶段文档（impact-analysis.md）
-- 运行 `/6aspec:brown:design` → 进入技术方案设计阶段
+- 运行 `/6aspec:brown:proposal` → 进入需求提案阶段
 - 运行 `/6aspec:brown:continue` → 自动进入下一阶段
 ```
 
@@ -313,7 +315,7 @@ Phase 2: 影响面分析与非功能需求评估
 ## Impact 完成：<name>
 
 **流程**: 完整级
-**进度**: 4/9 阶段完成
+**进度**: 2/8 阶段完成
 
 ### 影响范围
 - 数据库表：<数量>
@@ -334,7 +336,7 @@ Phase 2: 影响面分析与非功能需求评估
 
 ### 下一步
 - 直接回复补充遗漏的影响点或修正分析 → 我会更新本阶段文档（impact-analysis.md）
-- 运行 `/6aspec:brown:design` → 进入技术方案设计阶段
+- 运行 `/6aspec:brown:proposal` → 进入需求提案阶段
 - 运行 `/6aspec:brown:continue` → 自动进入下一阶段
 ```
 

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

@@ -39,20 +39,20 @@
    **流程深度说明**：
 
    **轻量级（Lightweight）**：
-   - 阶段：proposal → specs → design → tasks → implement
-   - 产出：proposal.md, specs.md, design.md, tasks.md
+   - 阶段：proposal → specs → design → tasks
+   - 产出：proposal.md, specs.md, design.md, tasks-overview.md
    - 适用：需求明确、快速迭代、小范围变更
    - 示例：新增简单功能、UI调整、配置变更
 
    **标准级（Standard）**：
-   - 阶段：proposal → understand → specs → impact → design → tasks → implement
-   - 产出：proposal.md, 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）**：
-   - 阶段：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
+   - 阶段：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
    - 适用：关键变更、需要完整追踪和评估
    - 示例：核心业务逻辑变更、重要功能重构
 
@@ -105,7 +105,7 @@
    {
      "name": "<name>",
      "flowDepth": "standard",
-     "status": "proposal_pending",
+     "status": "understanding_pending",
      "createdAt": "<timestamp>",
      "lastModified": "<timestamp>",
      "inputSource": {
@@ -113,10 +113,10 @@
        "filePath": "<仅 type=file 时填写>"
      },
      "phases": {
-       "proposal": "pending",
-       "understand": "blocked",
-       "specs": "blocked",
+       "understand": "pending",
        "impact": "blocked",
+       "proposal": "blocked",
+       "specs": "blocked",
        "design": "blocked",
        "tasks": "blocked",
        "implement": "blocked"
@@ -130,7 +130,7 @@
    {
      "name": "<name>",
      "flowDepth": "complete",
-     "status": "proposal_pending",
+     "status": "understanding_pending",
      "createdAt": "<timestamp>",
      "lastModified": "<timestamp>",
      "inputSource": {
@@ -138,10 +138,10 @@
        "filePath": "<仅 type=file 时填写>"
      },
      "phases": {
-       "proposal": "pending",
-       "understand": "blocked",
-       "specs": "blocked",
+       "understand": "pending",
        "impact": "blocked",
+       "proposal": "blocked",
+       "specs": "blocked",
        "design": "blocked",
        "tasks": "blocked",
        "implement": "blocked",
@@ -190,30 +190,27 @@
 
    根据流程深度显示不同的阶段列表：
 
-   **轻量级流程（5阶段）**：
+   **轻量级流程（4阶段）**：
    - [ ] Proposal - 需求提案
    - [ ] Specs - 需求规格定义
    - [ ] Design - 技术方案设计
    - [ ] Tasks - 任务拆解
-   - [ ] Implement - 执行实现
 
-   **标准级流程（7阶段）**：
-   - [ ] Proposal - 需求提案
+   **标准级流程（6阶段）**：
    - [ ] Understand - 需求理解与现状分析
-   - [ ] Specs - 需求规格定义
    - [ ] Impact - 影响面分析
+   - [ ] Proposal - 需求提案
+   - [ ] Specs - 需求规格定义
    - [ ] Design - 技术方案设计
    - [ ] Tasks - 任务拆解
-   - [ ] Implement - 执行实现
 
-   **完整级流程（9阶段）**：
-   - [ ] Proposal - 需求提案
+   **完整级流程（8阶段）**：
    - [ ] Understand - 需求理解与现状分析
-   - [ ] Specs - 需求规格定义
    - [ ] Impact - 影响面分析
+   - [ ] Proposal - 需求提案
+   - [ ] Specs - 需求规格定义
    - [ ] Design - 技术方案设计
    - [ ] Tasks - 任务拆解
-   - [ ] Implement - 执行实现
    - [ ] Verify - 验证实现
    - [ ] Review - 实施后评估
 
@@ -253,9 +250,8 @@
 
 ### 下一步
 - 轻量级: 运行 `/6aspec:brown:proposal` 创建需求提案
-- 标准级/完整级: 运行 `/6aspec:brown:proposal` 创建需求提案
+- 标准级/完整级: 运行 `/6aspec:brown:understand` 进行需求理解与现状分析
 - 快速通道: 运行 `/6aspec:brown:quick` 直接实现
-- 或运行 `/6aspec:brown:ff` 快速完成分析阶段
 - 或运行 `/6aspec:brown:continue` 自动进入下一阶段
 ```