6aspec 2.0.0-dev.9 → 3.0.0-dev.1

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,10 @@
 3. **根据流程深度确定要执行的阶段**
 
    **轻量级（lightweight）**：
-   - proposal → design → tasks
+   - proposal → specs → design → tasks
 
    **标准级（standard）**：
-   - understand → specs → impact → design → tasks
-
-   **完整级（complete）**：
-   - understand → specs → impact → design → tasks → verify → review
+   - analyze → proposal → specs → design → tasks
 
    **快速通道（quick）**：
    - 提示使用 `/6aspec:brown:quick` 命令
@@ -52,32 +49,37 @@
    - 显示简要进度："✓ Proposal 完成"
    - 更新待办事项
 
-   b. **Design**
+   b. **Specs**
+   - 执行 `/6aspec:brown:specs` 的逻辑
+   - 显示简要进度："✓ Specs 完成"
+   - 更新待办事项
+
+   c. **Design**
    - 执行 `/6aspec:brown:design` 的逻辑
    - 显示简要进度："✓ Design 完成"
    - 更新待办事项
 
-   c. **Tasks**
+   d. **Tasks**
    - 执行 `/6aspec:brown:tasks` 的逻辑
    - 显示简要进度："✓ Tasks 完成"
    - 更新待办事项
 
-   **标准级/完整级流程**：
+   **标准级流程**：
 
-   a. **Understand**
-   - 执行 `/6aspec:brown:understand` 的逻辑
-   - 显示简要进度："✓ Understand 完成"
+   a. **Analyze**
+   - 执行 `/6aspec:brown:analyze` 的逻辑
+   - **注意**：analyze 阶段包含对话式澄清，ff 模式下跳过澄清交互，直接基于原始需求和代码分析生成 analysis.md
+   - 显示简要进度："✓ Analyze 完成"
    - 更新待办事项
 
-   b. **Specs**
-   - 如果需要用户输入（待明确问题），询问用户
-   - 执行 `/6aspec:brown:specs` 的逻辑
-   - 显示简要进度："✓ Specs 完成"
+   b. **Proposal**
+   - 执行 `/6aspec:brown:proposal` 的逻辑
+   - 显示简要进度："✓ Proposal 完成"
    - 更新待办事项
 
-   c. **Impact**
-   - 执行 `/6aspec:brown:impact` 的逻辑
-   - 显示简要进度："✓ Impact 完成"
+   c. **Specs**
+   - 执行 `/6aspec:brown:specs` 的逻辑
+   - 显示简要进度："✓ Specs 完成"
    - 更新待办事项
 
    d. **Design**
@@ -90,14 +92,6 @@
    - 显示简要进度："✓ Tasks 完成"
    - 更新待办事项
 
-   **完整级流程额外阶段**（如果 flowDepth 为 complete）：
-
-   e. **Verify**（可选，在实施后执行）
-   - 提示："Verify 阶段需要在实施后执行"
-
-   f. **Review**（可选，在上线后执行）
-   - 提示："Review 阶段需要在上线后执行"
-
 6. **显示最终状态**
 
    读取 `6aspecdoc/brown/<name>/status.json` 显示完整状态。
@@ -111,16 +105,16 @@
 ## 快速分析完成：<name>
 
 **流程深度**: 轻量级
-**进度**: 3/4 阶段完成（分析阶段全部完成）
+**进度**: 4/4 阶段完成（分析阶段全部完成）
 
 ### 生成的文档
 - ✓ proposal.md - 需求提案
+- ✓ specs.md - 需求规格定义
 - ✓ design.md - 技术方案设计
-- ✓ tasks.md - 任务拆解
+- ✓ tasks-overview.md - 任务拆解
 
 ### 任务统计
 - 总任务数：<数量>
-- 预估总工时：<工时>
 
 ### 下一步
 所有分析阶段已完成！可以：
@@ -133,45 +127,17 @@
 ## 快速分析完成：<name>
 
 **流程深度**: 标准级
-**进度**: 5/6 阶段完成（分析阶段全部完成）
-
-### 生成的文档
-- ✓ understanding.md - 需求理解与现状分析
-- ✓ specs.md - 需求规格定义
-- ✓ impact-analysis.md - 影响面分析
-- ✓ design.md - 技术方案设计
-- ✓ tasks.md - 任务拆解
-
-### 任务统计
-- 总任务数：<数量>
-- 预估总工时：<工时>
-
-### 关键发现
-<列出 2-3 个关键发现>
-
-### 下一步
-所有分析阶段已完成！可以：
-- 运行 `/6aspec:brown:implement` 开始执行任务
-- 查看详细文档：6aspecdoc/brown/<name>/artifacts/
-```
-
-**完整级流程**：
-```
-## 快速分析完成：<name>
-
-**流程深度**: 完整级
-**进度**: 5/7 阶段完成（分析阶段全部完成）
+**进度**: 5/5 阶段完成（分析阶段全部完成）
 
 ### 生成的文档
-- ✓ understanding.md - 需求理解与现状分析
+- ✓ analysis.md - 需求分析
+- ✓ proposal.md - 需求提案
 - ✓ specs.md - 需求规格定义
-- ✓ impact-analysis.md - 影响面分析
 - ✓ design.md - 技术方案设计
-- ✓ tasks.md - 任务拆解
+- ✓ tasks-overview.md - 任务拆解
 
 ### 任务统计
 - 总任务数：<数量>
-- 预估总工时：<工时>
 
 ### 关键发现
 <列出 2-3 个关键发现>
@@ -179,8 +145,6 @@
 ### 下一步
 所有分析阶段已完成！可以：
 - 运行 `/6aspec:brown:implement` 开始执行任务
-- 实施后运行 `/6aspec:brown:verify` 进行验证
-- 上线后运行 `/6aspec:brown:review` 进行评估
 - 查看详细文档：6aspecdoc/brown/<name>/artifacts/
 ```
 
@@ -191,4 +155,3 @@
 - 验证每个阶段的文档已创建后再继续下一阶段
 - 快速通道提示使用 `/6aspec:brown:quick` 而不是完整流程
 - 必须根据 flowDepth 执行正确的阶段序列
-- 完整级流程的 verify 和 review 阶段在实施后执行，不在 ff 中执行