6aspec 2.0.0-dev.2 → 2.0.0-dev.20

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

@@ -36,6 +36,9 @@
 
    c. **更新归档状态**
    在归档目录中创建 `archive-info.json`：
+
+   **注意**：所有时间戳必须使用东八区（北京时间）格式：`yyyy-MM-dd HH:mm:ss`（例如：`2026-02-20 12:36:23`）
+
    ```json
    {
      "name": "<name>",
@@ -44,8 +47,7 @@
      "originalPath": "6aspecdoc/brown/<name>",
      "archivePath": "6aspecdoc/brown/.archived/<timestamp>-<name>",
      "completedPhases": 7,
-     "totalTasks": 8,
-     "priority": "P0/P1/P2"
+     "totalTasks": 8
    }
    ```
 
@@ -56,7 +58,6 @@
    # 归档摘要：<name>
 
    > **归档时间**: <timestamp>
-   > **优先级**: P0/P1/P2
    > **完成阶段**: 7/7
    > **总任务数**: 8
    > **总工时**: <工时>
@@ -74,13 +75,13 @@
 
    ## 关键文档
 
-   - 01-understanding.md - 需求理解与现状分析
-   - 02-impact-analysis.md - 影响面分析
-   - 03-technical-design.md - 技术方案设计
+   - understanding.md - 需求理解与现状分析
+   - impact-analysis.md - 影响面分析
+   - design.md - 技术方案设计
    - 04-tasks-overview.md - 任务拆解
    - 05-verification-report.md - 验证报告
    - 06-post-implementation-review.md - 实施后评估
-   - ADR-<name>.md - 架构决策记录（P0）
+   - ADR-<name>.md - 架构决策记录（如有）
 
    ## 经验教训
 
@@ -104,7 +105,6 @@
 **归档位置**: 6aspecdoc/brown/.archived/<timestamp>-<name>/
 
 ### 需求统计
-- 优先级：P0/P1/P2
 - 完成阶段：7/7
 - 总任务数：8
 - 总工时：<工时>

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

@@ -6,6 +6,17 @@
 
 **所有生成的文档内容必须使用中文**，包括标题、字段名、描述等所有文本内容。
 
+## 时间格式规范
+
+**所有时间戳必须使用东八区（北京时间）格式**：`yyyy-MM-dd HH:mm:ss`
+
+示例：`2026-02-20 12:36:23`
+
+适用范围：
+- status.json 中的 `createdAt`、`lastModified`、`completedAt` 等字段
+- 所有 artifacts 文档中的时间戳（创建时间、完成时间、评估时间等）
+- 归档时使用的时间戳
+
 ## 核心行为规则
 
 1. **阶段化推进**：每个阶段完成后必须停止，等待用户通过显式命令推进

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

@@ -39,22 +39,25 @@
 
    **轻量级流程（lightweight）**：
    - `proposal` → 调用 `/6aspec:brown:proposal`
+   - `specs` → 调用 `/6aspec:brown:specs`
    - `design` → 调用 `/6aspec:brown:design`
    - `tasks` → 调用 `/6aspec:brown:tasks`
    - `implement` → 调用 `/6aspec:brown:implement`
 
    **标准级流程（standard）**：
    - `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）**：
    - `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

@@ -1,6 +1,6 @@
 # 棕地需求 - Design SOP
 
-Phase 3: 技术方案设计
+技术方案设计 - 适用于所有流程级别
 
 **输入**：`/6aspec:brown:design` 后可选需求名称。
 
@@ -9,46 +9,99 @@ Phase 3: 技术方案设计
 1. **选择需求并检查状态**
 
    - 读取 `6aspecdoc/brown/<name>/status.json`
-   - 确认 `phases.impact` 为 "done"
-   - 如果未完成 Phase 2，提示先运行 `/6aspec:brown:impact`
+   - 根据 `flowDepth` 检查前置阶段：
+     - **轻量级**：确认 `phases.specs` 为 "done"，如果未完成提示先运行 `/6aspec:brown:specs`
+     - **标准级/完整级**：确认 `phases.specs` 为 "done"，如果未完成提示先运行 `/6aspec:brown:specs`
 
 2. **读取前置文档**
 
-   - `6aspecdoc/brown/<name>/requirement.md`
-   - `6aspecdoc/brown/<name>/artifacts/01-understanding.md`
-   - `6aspecdoc/brown/<name>/artifacts/01.5-specs.md`（标准级/完整级）
-   - `6aspecdoc/brown/<name>/artifacts/02-impact-analysis.md`
+   根据 `flowDepth` 读取不同的前置文档：
 
-3. **设计数据库变更方案**
+   **轻量级流程**：
+   - `6aspecdoc/brown/<name>/artifacts/proposal.md`
+   - `6aspecdoc/brown/<name>/artifacts/specs.md`
+
+   **标准级/完整级流程**：
+   - `6aspecdoc/brown/<name>/artifacts/specs.md`
+   - `6aspecdoc/brown/<name>/artifacts/understanding.md`
+   - `6aspecdoc/brown/<name>/artifacts/impact-analysis.md`
+
+3. **按需探索代码库（可选）**
+
+   **触发条件**：
+   - 需要了解现有架构模式、技术选型
+   - 需要了解现有的数据库设计模式（如字段类型、索引策略）
+   - 需要了解现有的前端组件和交互模式
+   - 需要了解现有的测试框架和测试模式
+   - 用户明确要求探索（例如："先了解一下现有架构"）
+   - 信息不足，需要参考现有代码才能设计准确的技术方案
+
+   **探索方式**：
+
+   a. **简单搜索**（使用Grep/Glob工具）：
+   ```bash
+   # 搜索相关Service类的实现模式
+   rg "class.*Service" --type java -g "*Service.java"
+
+   # 搜索相关Controller类的实现模式
+   rg "class.*Controller" --type java -g "*Controller.java"
+
+   # 搜索配置文件
+   rg "spring.datasource|mybatis" --type yaml -g "*.yml"
+
+   # 搜索测试框架使用
+   rg "@Test|@SpringBootTest" --type java -g "*Test.java"
+
+   # 搜索前端组件
+   rg "export.*component" --type typescript -g "*.tsx"
+   ```
+
+   b. **复杂探索**（使用Task工具调用Explore agent）：
+   - 当需要深入理解现有架构模式时
+   - 当需要跨多个文件理解技术选型时
+   - 当需要了解复杂的集成方案时
+
+   **探索结果处理**：
+   - 探索发现直接用于技术方案设计
+   - 不生成独立文档
+   - 在design.md中可以标注"参考现有实现：<文件路径>"
+
+   **注意**：
+   - 探索是可选的，不是强制的
+   - 如果前置文档（specs、understanding、impact）已经提供了足够信息，可以跳过探索
+   - 探索应该聚焦、快速，避免过度探索
+   - 重点关注架构模式、技术选型、实现风格，而不是具体业务逻辑
+
+4. **设计数据库变更方案**
 
    - 字段名、类型、约束
    - 默认值和历史数据处理
    - 索引建议
    - 数据迁移脚本（如需要）
 
-4. **设计代码实现方案**
+5. **设计代码实现方案**
 
    - 实体类字段添加（含注解）
    - 业务逻辑实现（含关键代码示例）
    - 校验逻辑（必填、值域、约束）
    - 错误提示（使用多语言资源）
 
-5. **设计前端 UI 方案**
+6. **设计前端 UI 方案**
 
    - 各页面字段状态（可编辑/只读/隐藏）
    - 交互逻辑（下拉选择、提示信息）
    - 错误提示
    - 多语言支持
 
-6. **设计测试方案**
+7. **设计测试方案**
 
    - 单元测试（函数级别）
    - 集成测试（流程级别）
    - 数据一致性验证（SQL 验证）
 
-7. **架构决策记录（P0 需求必须）**
+8. **架构决策记录（涉及架构决策时创建）**
 
-   如果是 P0 级需求，创建 ADR：
+   如果需求涉及重要的架构决策（如技术选型、数据模型设计、集成方案等），创建 ADR：
 
    创建 `6aspecdoc/brown/<name>/artifacts/ADR-<name>.md`：
    ```markdown
@@ -82,7 +135,7 @@ Phase 3: 技术方案设计
    <如何验证这个决策是正确的>
    ```
 
-8. **技术债务识别**
+9. **技术债务识别**
 
    识别实现过程中可能引入的技术债务：
 
@@ -90,33 +143,118 @@ Phase 3: 技术方案设计
    |--------|------|------|------|----------|--------|
    | DEBT-001 | 临时的硬编码逻辑 | 代码质量 | 中 | 2人日 | P1 |
 
-9. **创建技术方案文档**
+10. **创建技术方案文档**
 
-   创建 `6aspecdoc/brown/<name>/artifacts/03-technical-design.md`
+   创建 `6aspecdoc/brown/<name>/artifacts/design.md`
 
 10. **更新状态**
 
     更新 `6aspecdoc/brown/<name>/status.json`：
+
+    **轻量级流程**：
+    ```json
+    {
+      "status": "tasks_pending",
+      "flowDepth": "lightweight",
+      "phases": {
+        "proposal": "done",
+        "design": "done",
+        "tasks": "pending",
+        "implement": "blocked"
+      },
+      "artifacts": ["proposal.md", "design.md"]
+    }
+    ```
+
+    **标准级/完整级流程**：
     ```json
     {
       "status": "tasks_pending",
+      "flowDepth": "standard",
       "phases": {
         "understand": "done",
+        "specs": "done",
         "impact": "done",
         "design": "done",
         "tasks": "pending",
-        ...
-      }
+        "implement": "blocked"
+      },
+      "artifacts": ["understanding.md", "specs.md", "impact-analysis.md", "design.md"]
     }
     ```
 
+   同时更新 `6aspecdoc/brown/<name>/requirement.md`：
+   - 更新"状态"字段为 `📋 Tasks 待开始`
+   - 更新"最后修改"时间戳为 `<timestamp>`
+   - 更新"当前阶段"为 `Design - 技术方案设计（已完成）`
+   - 更新"下一步操作"为 `运行 /6aspec:brown:tasks 继续下一阶段`
+   - 在"进度概览"中标记 Design 阶段为已完成 `[x]`
+
 **输出**
 
+根据 `flowDepth` 显示不同的输出信息：
+
+**轻量级流程**：
+```
+## Design 完成：<name>
+
+**流程**: 轻量级
+**进度**: 2/4 阶段完成
+
+### 方案概要
+- 数据库变更：<数量> 个表
+- 代码变更：<数量> 个类
+- 前端变更：<数量> 个页面
+- 测试用例：<数量> 个
+
+### 关键设计决策
+<列出 2-3 个关键决策>
+
+### 文档位置
+- 6aspecdoc/brown/<name>/artifacts/design.md
+- 6aspecdoc/brown/<name>/artifacts/ADR-<name>.md (如涉及架构决策)
+
+### 下一步
+- 直接回复修正设计方案或补充细节 → 我会更新本阶段文档（design.md）
+- 运行 `/6aspec:brown:tasks` → 进入任务拆解阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
+```
+
+**标准级流程**：
+```
+## Design 完成：<name>
+
+**流程**: 标准级
+**进度**: 4/6 阶段完成
+
+### 方案概要
+- 数据库变更：<数量> 个表
+- 代码变更：<数量> 个类
+- 前端变更：<数量> 个页面
+- 测试用例：<数量> 个
+
+### 关键设计决策
+<列出 2-3 个关键决策>
+
+### 技术债务
+<列出识别的技术债务>
+
+### 文档位置
+- 6aspecdoc/brown/<name>/artifacts/design.md
+- 6aspecdoc/brown/<name>/artifacts/ADR-<name>.md (如涉及架构决策)
+
+### 下一步
+- 直接回复修正设计方案或补充细节 → 我会更新本阶段文档（design.md）
+- 运行 `/6aspec:brown:tasks` → 进入任务拆解阶段
+- 运行 `/6aspec:brown:continue` → 自动进入下一阶段
+```
+
+**完整级流程**：
 ```
-## Phase 3 完成：技术方案设计
+## Design 完成：<name>
 
-**需求**: <name>
-**进度**: 4/5 阶段完成（标准级）或 4/6 阶段完成（完整级）
+**流程**: 完整级
+**进度**: 4/8 阶段完成
 
 ### 方案概要
 - 数据库变更：<数量> 个表
@@ -131,11 +269,11 @@ Phase 3: 技术方案设计
 <列出识别的技术债务>
 
 ### 文档位置
-- 6aspecdoc/brown/<name>/artifacts/03-technical-design.md
-- 6aspecdoc/brown/<name>/artifacts/ADR-<name>.md (P0)
+- 6aspecdoc/brown/<name>/artifacts/design.md
+- 6aspecdoc/brown/<name>/artifacts/ADR-<name>.md (如涉及架构决策)
 
 ### 下一步
-- 直接回复修正设计方案或补充细节 → 我会更新本阶段文档（03-technical-design.md）
+- 直接回复修正设计方案或补充细节 → 我会更新本阶段文档（design.md）
 - 运行 `/6aspec:brown:tasks` → 进入任务拆解阶段
 - 运行 `/6aspec:brown:continue` → 自动进入下一阶段
 ```
@@ -143,13 +281,15 @@ Phase 3: 技术方案设计
 **用户补充信息时的处理**
 
 当用户修正设计方案、补充技术细节、或对设计决策提出异议时（未使用阶段命令）：
-1. 将用户的修正/补充整合到 `03-technical-design.md` 的对应章节
+1. 将用户的修正/补充整合到 `design.md` 的对应章节
 2. 展示变更摘要
 3. 再次提示：可以继续补充，或通过命令进入下一阶段
 4. **禁止**：不得自动进入下一阶段
 
 **防护措施**
-- 必须先完成 Phase 2
-- P0 需求必须创建 ADR
+- 根据 `flowDepth` 检查前置阶段：
+  - **轻量级**：必须先完成 proposal 阶段
+  - **标准级/完整级**：必须先完成 impact 阶段
+- 涉及架构决策时必须创建 ADR（如技术选型、数据模型设计、集成方案等）
 - 代码示例必须完整可用
-- 技术债务必须明确标注
+- 技术债务必须明确标注（标准级/完整级）

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）是可以的
+- 探索代码库、阅读文件、搜索代码都可以
+- 但不要修改应用代码
+
+**不要伪装理解**
+- 如果不清楚，深入挖掘
+- 承认不确定性
+
+**不要急于求成**
+- 探索是思考时间，不是任务时间
+- 让理解自然浮现
+
+**不要强加结构**
+- 让模式自然涌现
+- 不要强制套用模板
+
+**不要自动捕获**
+- 提议保存洞察，但不要自动执行
+- 让用户决定
+
+**要可视化**
+- 好的图表胜过千言万语
+
+**要探索代码库**
+- 让讨论扎根于现实
+
+**要质疑假设**
+- 包括用户的和你自己的