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

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

@@ -2,9 +2,15 @@
 
 执行任务实现。
 
+> **阶段定位**：Implement 的目标是按 Tasks 阶段拆解的 `TASK-*.md` 逐个交付实现结果，并保持“变更最小化、可验证、可追溯”。
+> - 默认执行策略：**里程碑优先 + 依赖优先**（优先完成更早里程碑中依赖已满足的任务）。
+> - 关键承接：Tasks 中定义的「契约/数据库变更/迁移兼容回滚」等交付物，必须在 Implement 阶段逐项落地并验收。
+
 **输入**：`/6aspec:brown:implement` 后可选需求名称。
 
-**步骤**
+---
+
+## 步骤
 
 1. **选择需求并检查状态**
 
@@ -14,52 +20,106 @@
 
 2. **读取上下文文件**
 
-   读取以下文档：
-   - `6aspecdoc/brown/<name>/artifacts/01-understanding.md`
-   - `6aspecdoc/brown/<name>/artifacts/02-impact-analysis.md`
-   - `6aspecdoc/brown/<name>/artifacts/03-technical-design.md`
-   - `6aspecdoc/brown/<name>/artifacts/04-tasks-overview.md`
+   根据 `flowDepth` 读取以下文档：
+
+   **轻量级流程**：
+   - `6aspecdoc/brown/<name>/artifacts/proposal.md`
+   - `6aspecdoc/brown/<name>/artifacts/specs.md`
+   - `6aspecdoc/brown/<name>/artifacts/design.md`
+   - `6aspecdoc/brown/<name>/artifacts/tasks-overview.md`
+   - `6aspecdoc/brown/<name>/tasks/TASK-*.md`
+   - `6aspecdoc/brown/<name>/explore-summary.md`（如果存在）
+
+   **标准级/完整级流程**：
+   - `6aspecdoc/brown/<name>/artifacts/proposal.md`
+   - `6aspecdoc/brown/<name>/artifacts/understanding.md`
+   - `6aspecdoc/brown/<name>/artifacts/impact-analysis.md`
+   - `6aspecdoc/brown/<name>/artifacts/specs.md`
+   - `6aspecdoc/brown/<name>/artifacts/design.md`
+   - `6aspecdoc/brown/<name>/artifacts/tasks-overview.md`
    - `6aspecdoc/brown/<name>/tasks/TASK-*.md`
 
-3. **显示当前进度**
+3. **显示当前进度（含里程碑）**
 
    显示：
-   - 总任务数
-   - 已完成任务数
-   - 待完成任务数
-   - 下一个待执行的任务
+   - 总任务数 / 已完成任务数 / 待完成任务数
+   - 各里程碑完成度（M0~Mn：已完成/总数）
+   - 下一个可执行任务（里程碑最早且依赖满足）
 
 4. **执行任务（循环直到完成或阻塞）**
 
    对每个待完成的任务：
 
-   a. **显示正在执行的任务**
+   a. **选择下一个任务（里程碑优先 + 依赖优先）**
+   - 优先选择最早里程碑中仍未完成的任务
+   - 若任务在 `TASK-*.md` 的“前置依赖”中列出依赖任务，则必须依赖全部完成后才能开始
+   - 若最早里程碑任务均被阻塞（依赖未满足/信息不清晰/环境问题），则暂停并报告阻塞原因
+
+   b. **显示正在执行的任务**
    ```
-   ## 执行任务 3/8: TASK-003-domain-service-logic
+   ## 执行任务 <i>/<N>: TASK-<序号>-<slug>
 
-   **任务描述**: 实现领域服务业务逻辑
-   **预估工时**: 2人日
+   **所属里程碑**: <M0/M1/...>
+   **任务描述**: <任务描述>
+   **预估工时**: <X人日>
    ```
 
-   b. **读取任务详情**
+   c. **读取任务详情**
    - 读取 `6aspecdoc/brown/<name>/tasks/TASK-<序号>.md`
-   - 理解任务目标、输入、输出、详细步骤
+   - 理解任务目标、输入、输出、详细步骤、验收标准
 
-   c. **执行代码变更**
-   - 根据任务步骤进行代码修改
+   d. **执行代码/脚本变更**
+   - 根据任务步骤进行实现与修改
    - 保持变更最小化和聚焦
-   - 遵循技术方案设计
-
-   d. **标记任务完成**
+   - 遵循 `design.md` 的技术决策与边界（不要在 Implement 阶段临时发明新方案）
+
+   e. **质量控制检查**
+
+   **必须严格遵循代码规范**：`.6aspec/rules/biz/code.md`，并使用其中的“检查清单”章节进行自我验证。
+
+   **重点关注以下红线规则（零容忍）：**
+   - [ ] 循环中的数据库查询、网络请求、文件 I/O 操作
+   - [ ] SQL 字符串拼接、敏感信息硬编码、弱加密算法使用
+   - [ ] 循环依赖、跨层直接调用、空 catch 块
+
+   **棕地需求特别检查：**
+   - [ ] 修改是否符合现有代码风格和架构模式
+   - [ ] 是否引入了新的技术债务
+   - [ ] 是否影响了现有功能的稳定性
+   - [ ] 是否遵循了设计文档中的技术决策
+
+   **技术检查：**
+   - [ ] 运行相关测试确保无回归
+   - [ ] 检查代码编译和语法错误
+   - [ ] 验证修改范围最小化
+
+   f. **任务交付物核对（对齐新版 TASK 模板）**
+
+   根据任务文件中的栏目，逐项确认交付物已落地：
+   - 若包含“契约与接口出入参（如适用）”：
+     - [ ] 已明确字段清单与口径/必填性/兼容策略
+     - [ ] 已明确错误语义与幂等语义，并在实现/测试中覆盖
+   - 若包含“数据库变更（如适用）”：
+     - [ ] 已提供可执行的变更脚本与回滚要点（或回滚脚本）
+     - [ ] 已提供关键校验点（校验 SQL 或等价验证手段）
+   - 若包含“迁移 / 兼容 / 回滚（如适用）”：
+     - [ ] 已覆盖迁移/回填步骤与边界条件
+     - [ ] 已覆盖兼容策略（行为/数据/集成）与灰度/开关验证点
+     - [ ] 已明确回滚影响与限制，并准备验证方式
+   - 若任务标注 Observability：
+     - [ ] 处理记录可追踪（触发来源/处理结果/关键时间点可查）
+
+   g. **标记任务完成**
    - 在任务文件中更新状态：`📋 待开始` → `✅ 已完成`
-   - 在 `04-tasks-overview.md` 中更新任务状态：`- [ ]` → `- [x]`
+   - 在 `tasks-overview.md` 中更新任务状态：`- [ ]` → `- [x]`
+     - 注意：`tasks-overview.md` 中任务通常为链接形式（如 `[TASK-001...](../tasks/TASK-001.md)`），**只修改勾选，不要破坏链接结构**。
    - 更新 `status.json` 中的任务计数
 
-   e. **继续下一个任务**
+   h. **继续下一个任务**
 
    **暂停条件**：
-   - 任务不清晰 → 询问澄清
-   - 实现发现设计问题 → 建议更新 artifacts
+   - 任务不清晰 → 暂停并询问澄清
+   - 实现发现设计问题 → 暂停并建议更新 artifacts（design/specs/tasks）
    - 遇到错误或阻塞 → 报告并等待指导
    - 用户中断
 
@@ -69,25 +129,27 @@
    ```
    ## 实现完成：<name>
 
-   **进度**: 5/7 阶段完成
-   **任务完成**: 8/8 (100%)
+   **任务完成**: <N>/<N> (100%)
 
    ### 本次完成的任务
-   - [x] TASK-001: 数据库字段配置
-   - [x] TASK-002: 实体类字段添加
-   - [x] TASK-003: 领域服务逻辑实现
-   ...
+   - [x] TASK-001: ...
+   - [x] TASK-002: ...
+   - ...
 
    ### 下一步
-   所有任务已完成！运行 `/6aspec:brown:verify` 进行验证。
+   - 轻量级/标准级流程:
+     - 运行 `/6aspec:brown:verify` 进行质量检查（可选）
+     - 运行 `/6aspec:brown:archive` 归档此需求
+
+   - 完整级流程:
+     - 运行 `/6aspec:brown:continue` 继续下一阶段（verify）
    ```
 
    **如果暂停**：
    ```
    ## 实现暂停：<name>
 
-   **进度**: 5/7 阶段完成
-   **任务完成**: 4/8 (50%)
+   **任务完成**: <完成数>/<总数> (<百分比>)
 
    ### 暂停原因
    <描述遇到的问题>
@@ -102,32 +164,54 @@
 
 6. **更新状态**
 
-   如果全部完成，更新 `status.json`：
+   如果全部完成，根据流程深度更新 `status.json`：
+
+   **轻量级/标准级流程**：
+   ```json
+   {
+     "status": "completed",
+     "phases": {
+       "implement": "done"
+     },
+     "tasks": {
+       "total": <N>,
+       "completed": <N>,
+       "pending": 0
+     }
+   }
+   ```
+
+   **完整级流程**：
    ```json
    {
      "status": "verify_pending",
      "phases": {
-       ...
        "implement": "done",
        "verify": "pending"
      },
      "tasks": {
-       "total": 8,
-       "completed": 8,
+       "total": <N>,
+       "completed": <N>,
        "pending": 0
      }
    }
    ```
 
-**输出**
+---
+
+## 输出
 
 根据执行情况显示相应的输出（见步骤 5）。
 
-**防护措施**
-- 必须先完成 Phase 4
+---
+
+## 防护措施
+
+- 必须先完成 Phase 4（Tasks）
 - 必须读取上下文文件再开始实现
+- 默认执行策略：里程碑优先 + 依赖优先；如发现阻塞必须暂停并报告
 - 如果任务模糊，暂停并询问
 - 如果实现发现设计问题，暂停并建议更新 artifacts
 - 保持代码变更最小化和聚焦
-- 立即更新任务状态
+- 立即更新任务状态（TASK 文件、tasks-overview、status.json）
 - 遇到错误时暂停并报告

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

@@ -30,24 +30,24 @@
 
 ### 进行中 (2)
 
-| 需求 | 优先级 | 当前阶段 | 进度 | 最后修改 |
-|------|--------|----------|------|----------|
-| add-user-auth | P0 | Phase 3: 技术方案设计 | 3/7 | 2小时前 |
-| fix-login-bug | P1 | Phase 2: 影响面分析 | 2/7 | 1天前 |
+| 需求 | 当前阶段 | 进度 | 最后修改 |
+|------|----------|------|----------|
+| add-user-auth | Phase 3: 技术方案设计 | 3/7 | 2小时前 |
+| fix-login-bug | Phase 2: 影响面分析 | 2/7 | 1天前 |
 
 ### 已完成 (1)
 
-| 需求 | 优先级 | 完成时间 | 任务完成率 |
-|------|--------|----------|-----------|
-| add-export-feature | P1 | 3天前 | 8/8 (100%) |
+| 需求 | 完成时间 | 任务完成率 |
+|------|----------|-----------|
+| add-export-feature | 3天前 | 8/8 (100%) |
 
 ### 已归档 (3)
 
-| 需求 | 优先级 | 归档时间 |
-|------|--------|----------|
-| refactor-api | P0 | 1周前 |
-| update-ui | P1 | 2周前 |
-| fix-typo | P2 | 1个月前 |
+| 需求 | 归档时间 |
+|------|----------|
+| refactor-api | 1周前 |
+| update-ui | 2周前 |
+| fix-typo | 1个月前 |
 
 ### 统计
 

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

@@ -30,29 +30,30 @@
    ```
    问题："请选择适合的流程深度："
    选项：
-   - 轻量级 - 快速迭代（proposal → design → tasks）（推荐用于需求明确的变更）
-   - 标准级 - 深入分析（understand → specs → impact → design → tasks）（推荐用于复杂业务变更）
-   - 完整级 - 全生命周期（understand → specs → impact → design → tasks → verify → review）（推荐用于关键变更）
+   - 轻量级 - 无需分析现有系统（proposal → specs → design → tasks）（推荐用于与现有业务低耦合的需求）
+   - 标准级 - 深入分析（understand → impact → proposal → specs → design → tasks）（推荐用于需要分析现有业务影响面的需求）
+   - 完整级 - 全生命周期（proposal → understand → specs → impact → design → tasks → verify → review）（推荐用于关键变更）
    - 快速通道 - 简单修复（直接实现，适用于Bug修复、单文件改动）
    ```
 
    **流程深度说明**：
 
    **轻量级（Lightweight）**：
-   - 阶段：proposal → design → tasks → implement
-   - 产出：proposal.md, design.md, tasks.md
-   - 适用：需求明确、快速迭代、小范围变更
-   - 示例：新增简单功能、UI调整、配置变更
+   - 阶段：proposal → specs → design → tasks
+   - 产出：proposal.md, specs.md, design.md, tasks-overview.md
+   - 适用：与现有业务低耦合，无需深入分析现有系统（但可参考现有实现模式）
+   - 典型场景：新增独立业务模块/包/Maven模块、新增简单功能、UI调整、配置变更
+   - 注意：业务本身可以有一定复杂度，关键是不需要分析现有业务的影响面
 
    **标准级（Standard）**：
-   - 阶段：understand → specs → impact → design → tasks → implement
-   - 产出：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）**：
-   - 阶段：understand → specs → impact → design → tasks → implement → verify → review
-   - 产出：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
    - 适用：关键变更、需要完整追踪和评估
    - 示例：核心业务逻辑变更、重要功能重构
 
@@ -73,8 +74,39 @@
    mkdir -p "6aspecdoc/brown/<name>/tasks"
    ```
 
+   创建原始需求文件 `6aspecdoc/brown/<name>/artifacts/original-requirement.md`：
+
+   **情况A：直接文字描述（inputSource.type = "text"）**：
+   ```markdown
+   # 原始需求
+
+   <用户输入的原始需求描述，原文记录，不做加工>
+
+   ---
+
+   > **需求来源**: text
+   > **创建时间**: <timestamp>
+   ```
+
+   **情况B：文件引用（inputSource.type = "file"）**：
+   ```markdown
+   # 原始需求
+
+   > **需求来源文件**: `<文件路径>`
+   >
+   > 完整需求内容请参考上述文件。
+
+   ---
+
+   > **需求来源**: file
+   > **来源文件**: <文件路径>
+   > **创建时间**: <timestamp>
+   ```
+
    创建状态文件 `6aspecdoc/brown/<name>/status.json`：
 
+   **注意**：所有时间戳必须使用东八区（北京时间）格式：`yyyy-MM-dd HH:mm:ss`（例如：`2026-02-20 12:36:23`）
+
    **轻量级**：
    ```json
    {
@@ -89,6 +121,7 @@
      },
      "phases": {
        "proposal": "pending",
+       "specs": "blocked",
        "design": "blocked",
        "tasks": "blocked",
        "implement": "blocked"
@@ -111,8 +144,9 @@
      },
      "phases": {
        "understand": "pending",
-       "specs": "blocked",
        "impact": "blocked",
+       "proposal": "blocked",
+       "specs": "blocked",
        "design": "blocked",
        "tasks": "blocked",
        "implement": "blocked"
@@ -135,8 +169,9 @@
      },
      "phases": {
        "understand": "pending",
-       "specs": "blocked",
        "impact": "blocked",
+       "proposal": "blocked",
+       "specs": "blocked",
        "design": "blocked",
        "tasks": "blocked",
        "implement": "blocked",
@@ -159,25 +194,14 @@
 
    ## 原始需求
 
-   <!-- 根据输入类型选择以下其一 -->
+   详见：[artifacts/original-requirement.md](artifacts/original-requirement.md)
 
-   <!-- 情况A：直接文字描述（inputSource.type = "text"） -->
-   <用户输入的原始需求描述，原文记录，不做加工>
-
-   <!-- 情况B：文件引用（inputSource.type = "file"） -->
-   > **需求来源文件**：`<文件路径>`
-   >
-   > 完整需求内容请参考上述文件。
+   ## 当前阶段
 
-   ## 快速导航
+   <当前阶段名称>
 
-   **需求详情**：
-   - 轻量级流程：[proposal.md](artifacts/proposal.md) - 需求提案（Why、What、Impact）
-   - 标准级/完整级流程：[understanding.md](artifacts/understanding.md) - 需求理解与现状分析
+   ## 下一步操作
 
-   **当前阶段**：<当前阶段名称>
-
-   **下一步操作**：
    - 运行 `/6aspec:brown:<next-command>` 继续下一阶段
    - 或运行 `/6aspec:brown:continue` 自动进入下一阶段
 
@@ -187,23 +211,25 @@
 
    **轻量级流程（4阶段）**：
    - [ ] Proposal - 需求提案
+   - [ ] Specs - 需求规格定义
    - [ ] Design - 技术方案设计
    - [ ] Tasks - 任务拆解
-   - [ ] Implement - 执行实现
 
-   **标准级流程（5阶段）**：
+   **标准级流程（6阶段）**：
    - [ ] Understand - 需求理解与现状分析
    - [ ] Impact - 影响面分析
+   - [ ] Proposal - 需求提案
+   - [ ] Specs - 需求规格定义
    - [ ] Design - 技术方案设计
    - [ ] Tasks - 任务拆解
-   - [ ] Implement - 执行实现
 
-   **完整级流程（7阶段）**：
+   **完整级流程（8阶段）**：
    - [ ] Understand - 需求理解与现状分析
    - [ ] Impact - 影响面分析
+   - [ ] Proposal - 需求提案
+   - [ ] Specs - 需求规格定义
    - [ ] Design - 技术方案设计
    - [ ] Tasks - 任务拆解
-   - [ ] Implement - 执行实现
    - [ ] Verify - 验证实现
    - [ ] Review - 实施后评估
 
@@ -243,9 +269,8 @@
 
 ### 下一步
 - 轻量级: 运行 `/6aspec:brown:proposal` 创建需求提案
-- 标准级/完整级: 运行 `/6aspec:brown:understand` 开始需求理解与现状分析
+- 标准级/完整级: 运行 `/6aspec:brown:understand` 进行需求理解与现状分析
 - 快速通道: 运行 `/6aspec:brown:quick` 直接实现
-- 或运行 `/6aspec:brown:ff` 快速完成分析阶段
 - 或运行 `/6aspec:brown:continue` 自动进入下一阶段
 ```
 
@@ -254,4 +279,4 @@
 - 不要超出初始化范围
 - 如果名称无效（非 kebab-case），要求提供有效名称
 - 如果同名需求已存在，建议使用 `/6aspec:brown:continue` 或选择新名称
-- 必须让用户选择流程深度
+- 必须让用户选择流程深度