6aspec 3.0.0-dev.1 → 3.0.0-dev.10

package/.6aspec/rules/biz/code.md

@@ -24,9 +24,12 @@ alwaysApply: true
 
 ### 架构红线
 - **禁止循环依赖**：包、模块、类之间不能相互依赖
-- **禁止跨层直接调用**：Controller不能直接调用DAO
+- **禁止在应用入口层跨层直连数据访问或在入口类堆叠编排**：应用入口包括 HTTP/RPC/API Controller（或同类请求入口）、事件订阅、消息消费者、调度或定时任务入口等。
+  -  **此类入口**不得**直接调用 DAO/Repository；
+  - **不得**在入口类集中承载远程/RPC 查询、仓储批量查询、Stream 聚合（如 `groupingBy`）、多分支循环等业务编排。上述逻辑须在 Service/应用服务（或设计文档/项目约定的应用层 Facade）中实现；
+  - 入口仅允许必要校验、日志及对上述服务的委托。
+  - **例外**：需求/TASK/设计说明明确要求与某存量入口类保持同一写法时，从其约定。
 - **禁止在实体类中包含业务逻辑**：保持实体类的纯净性
-- **禁止在静态代码块中进行复杂操作**：可能导致类加载问题
 - **禁止捕获异常后不处理**：空catch块是代码异味
 
 ## 🔒 安全规范
@@ -115,7 +118,7 @@ alwaysApply: true
 ## ✅ 检查清单
 
 ### 代码提交前检查
-- [ ] 是否违反红线规则
+- [ ] 是否违反红线规则（含架构红线中的应用入口与跨层约定，有文档例外除外）
 - [ ] 是否有安全漏洞
 - [ ] 是否有性能问题
 - [ ] 命名是否规范
@@ -129,5 +132,6 @@ alwaysApply: true
 - [ ] 边界条件是否考虑
 - [ ] 是否有代码重复
 - [ ] 是否符合设计原则
+- [ ] 新增/改动的 Controller/API 入口、订阅、消费者、调度入口是否违反架构红线（薄入口、不直连 DAO、委托 Service）
 - [ ] 是否有技术债务
 - [ ] 文档是否需要更新

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

@@ -16,7 +16,7 @@
 
 如果提供了名称，使用它。否则：
 - 从对话上下文推断
-- 如果模糊，读取 `6aspecdoc/brown/` 目录，让用户选择
+- 如果模糊，读取 `6aspecdoc/brown/` 目录，使用 `AskUserQuestion` 工具列出需求让用户选择
 
 读取 `6aspecdoc/brown/<name>/status.json`：
 - 确认流程深度为 "standard" 或 "complete"
@@ -159,7 +159,11 @@ b. **判断是否需要追问或指出风险**：
    - 答案清晰完整且无风险 → 继续
    - **不涉及技术实现层面的问题**（事务、通知机制、回滚策略等），那是 design 阶段的职责
 
-c. **追问格式**（简洁，不重复已知信息）：
+c. **追问时先写文档，再提问**：
+   - 将追问内容追加到 analysis.md "待澄清问题"章节（标注为追问，例：`> 追问：[追问内容]`）
+   - 再向用户提问
+
+d. **追问格式**（简洁，不重复已知信息）：
    > "关于[具体问题]，你提到了[用户答案]，我想进一步确认：[追问内容]"
 
 d. **禁止**：不得在用户未回答完所有问题时自动进入影响面分析
@@ -283,6 +287,7 @@ e. **持续更新文档**：每次用户回复后，更新 analysis.md，确保
 - 代码范围确认前不得生成问题清单
 - 问题必须按维度分组，不得使用扁平编号列表
 - 每次用户回复后必须更新 analysis.md，保持文档与对话同步
+- 追问必须先写入 analysis.md "待澄清问题"章节，再向用户提问
 - 追问时一次最多提出 1-2 个问题，不得连续追问超过 3 轮同一问题
 - 必须用户明确确认澄清完成后才能进入影响面分析
 - 影响面分析只做粗粒度评估（模块范围、schema变更、间接影响有/无），不做函数级映射

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

@@ -18,9 +18,10 @@
 
 2. **确认归档**
 
-   询问用户确认：
+   使用 `AskUserQuestion` 工具确认：
    ```
-   确认归档需求 <name>？归档后需求将移至归档目录，操作不可逆。
+   问题："确认归档需求 <name>？归档后需求将移至归档目录，操作不可逆。"
+   选项：
    - 是，归档此需求
    - 否，取消归档
    ```

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

@@ -10,9 +10,7 @@
 
    如果提供了名称，使用它。否则：
    - 从对话上下文推断
-   - 如果模糊，读取 `6aspecdoc/brown/` 目录，让用户选择
-
-   显示最近修改的 3-4 个需求作为选项，标注最近修改的为 "(推荐)"。
+   - 如果模糊，读取 `6aspecdoc/brown/` 目录，使用 `AskUserQuestion` 工具列出最近修改的 3-4 个需求让用户选择，标注最近修改的为 "(推荐)"。
 
 2. **检查当前状态**
 

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

@@ -41,10 +41,10 @@
 
    **a. 派发 implementer agent**
 
-   调用 `implementer` agent，传入以下内容：
+   调用 `6aspec-brown-implementer` agent，传入以下内容：
 
    ```
-   请用 implementer agent 实现以下任务：
+   请用 6aspec-brown-implementer agent 实现以下任务：
 
    需求名称：[name]
    TASK 文件路径：6aspecdoc/brown/[name]/tasks/TASK-<序号>.md
@@ -63,14 +63,15 @@
 
    **b. 派发 spec compliance reviewer agent**
 
-   调用 `spec-compliance-reviewer` agent，传入以下内容：
+   调用 `6aspec-brown-spec-compliance-reviewer` agent，传入以下内容：
 
    ```
-   请用 spec-compliance-reviewer agent 审查以下任务的实现：
+   请用 6aspec-brown-spec-compliance-reviewer agent 审查以下任务的实现：
 
    需求名称：[name]
    TASK 文件路径：6aspecdoc/brown/[name]/tasks/TASK-<序号>.md
    specs.md 路径：6aspecdoc/brown/[name]/artifacts/specs.md
+   design.md 路径：6aspecdoc/brown/[name]/artifacts/design.md
 
    Implementer 报告：
    [implementer agent 的完整报告]
@@ -78,7 +79,8 @@
 
    **处理 review 结果**：
    - `✅ 通过`：标记任务完成，继续下一个任务
-   - `❌ 有问题`：重新调用 implementer agent 修复，传入原有上下文 + reviewer 的完整反馈（具体缺失/多余/偏差及文件路径）；修复后再次调用 reviewer；循环直到通过
+   - `❌ 有问题`：重新调用 6aspec-brown-implementer agent 修复，传入原有上下文 + reviewer 的完整反馈（具体缺失/多余/偏差及文件路径）；修复后再次调用 reviewer；**最多循环 3 次**
+   - **超过 3 次仍未通过**：暂停，向用户报告每轮的问题和修复情况，让用户决定如何处理
 
    **c. 标记任务完成**
    - 在任务文件中更新状态：`📋 待开始` → `✅ 已完成`
@@ -155,9 +157,10 @@
 ## 防护措施
 
 - 必须先完成 Phase 4（Tasks）
-- 主 agent 只做协调，不直接写代码；实现由 `implementer` agent 完成，验证由 `spec-compliance-reviewer` agent 完成
+- 主 agent 只做协调，不直接写代码；实现由 `6aspec-brown-implementer` agent 完成，验证由 `6aspec-brown-spec-compliance-reviewer` agent 完成
 - 串行执行，不并行调用多个 implementer agent
 - implementer agent 报告 BLOCKED 时必须暂停并向用户报告，不得强行重试
 - spec compliance review 必须通过才能标记任务完成，不得跳过
+- implementer + reviewer 修复循环最多 3 次，超过则暂停向用户报告
 - 发现设计问题时暂停，建议更新 artifacts（design/specs/tasks），不得在实现阶段临时发明新方案
 - 立即更新任务状态（TASK 文件、tasks-overview、status.json）

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

@@ -13,8 +13,12 @@
 
    根据用户输入判断类型：
 
-   **情况A：无输入** — 询问用户（开放式问题）：
-   > "你想分析什么需求？请描述要实现的功能或要解决的问题，也可以 @引用 一个需求文档。"
+   **情况A：无输入** — 使用 `AskUserQuestion` 工具询问：
+   ```
+   问题："你想分析什么需求？"
+   选项（Other 即可，无需固定选项）
+   ```
+   或直接用开放式文本输入（Other）让用户描述需求。
 
    **情况B：直接文字描述** — 记录原始描述文本，标记 `inputSource.type = "text"`。
 
@@ -26,13 +30,13 @@
 
 2. **选择流程深度**
 
-   让用户选择流程深度：
+   使用 `AskUserQuestion` 工具让用户选择流程深度：
    ```
    问题："请选择适合的流程深度："
    选项：
-   - 轻量级 - 无需分析现有系统（proposal → specs → design → tasks）（推荐用于与现有业务低耦合的需求）
-   - 标准级 - 深入分析（analyze → proposal → specs → design → tasks）（推荐用于需要分析现有业务影响面的需求）
-   - 快速通道 - 简单修复（直接实现，适用于Bug修复、单文件改动）
+   - 轻量级（推荐）- 无需分析现有系统（proposal → specs → design → tasks），适用于与现有业务低耦合的需求
+   - 标准级 - 深入分析（analyze → proposal → specs → design → tasks），适用于需要分析现有业务影响面的需求
+   - 快速通道 - 简单修复（直接实现），适用于 Bug 修复、单文件改动
    ```
 
    **流程深度说明**：

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

@@ -15,7 +15,7 @@
 
 1. **如果没有提供输入，询问需求内容**
 
-   询问用户：
+   使用 `AskUserQuestion` 工具询问（开放式，用 Other 输入）：
    > "你想快速处理什么需求？请描述要修复的问题或要做的改动。"
 
    从描述中提取 kebab-case 名称。

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

@@ -23,7 +23,7 @@
 
    如果提供了名称，使用它。否则：
    - 从对话上下文推断
-   - 如果模糊，读取 `6aspecdoc/brown/` 目录，让用户选择
+   - 如果模糊，读取 `6aspecdoc/brown/` 目录，使用 `AskUserQuestion` 工具列出需求让用户选择
 
 2. **检查当前状态**
 
@@ -56,13 +56,9 @@
 
 4. **确认回退操作**
 
-   询问用户确认：
+   使用 `AskUserQuestion` 工具确认：
    ```
-   确认回退操作？
-   - 当前阶段：<current-phase>
-   - 回退到：<previous-phase>
-   - 将删除的文件：<files-to-delete>
-
+   问题："确认回退操作？当前阶段：<current-phase>，将回退到：<previous-phase>，将删除：<files-to-delete>"
    选项：
    - 确认回退
    - 取消

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

@@ -59,7 +59,7 @@ Phase 4: 任务拆解与排期
    - 预估工作量在 0.5-3 人日（超过则继续拆分）
 
    **拆解维度**（可组合使用）：
-   - 按交付里程碑：契约与集成 → 数据变更 → 迁移/兼容/回滚 → 核心链路 → 集成联调与观测 → 发布准备
+   - 按交付里程碑：契约与集成 → 数据变更 → 迁移/兼容/回滚 → 核心链路
    - 按功能模块：模块A → 模块B → 模块C
    - 按依赖关系：前置任务 → 核心任务 → 后置任务
    - 按横切能力：Integration / Migration / Compatibility / Observability / Security
@@ -179,13 +179,6 @@ Phase 4: 任务拆解与排期
    - [ ] [TASK-030: 核心业务逻辑实现（对齐 AC/Scenario）](../tasks/TASK-030.md)
    - [ ] [TASK-031: 定时任务/事件消费/回调处理实现（如适用）](../tasks/TASK-031.md)
 
-   ### M4: 集成联调与可观测性（Integration & Observability）
-   - [ ] [TASK-040: 集成联调与异常路径验证（重试/乱序/重复）](../tasks/TASK-040.md)
-   - [ ] [TASK-041: 可观测性补齐（处理记录可查、日志/指标/追踪要点）](../tasks/TASK-041.md)
-
-   ### M5: 发布准备（Release）
-   - [ ] [TASK-050: 发布检查清单（灰度/回滚演练要点）](../tasks/TASK-050.md)
-
    ## 依赖关系图（示例）
 
    ```mermaid
@@ -193,8 +186,6 @@ Phase 4: 任务拆解与排期
        TASK001 --> TASK010
        TASK010 --> TASK020
        TASK020 --> TASK030
-       TASK030 --> TASK040
-       TASK040 --> TASK050
    ```
 
    ## 工作量统计
@@ -205,8 +196,6 @@ Phase 4: 任务拆解与排期
    | M1 | <n> | <x> 人日 |
    | M2 | <n> | <x> 人日 |
    | M3 | <n> | <x> 人日 |
-   | M4 | <n> | <x> 人日 |
-   | M5 | <n> | <x> 人日 |
    | **总计** | **<n>** | **<x> 人日** |
 
    ## 风险清单

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

@@ -41,7 +41,7 @@
 
    如果提供了名称，使用它。否则：
    - 从对话上下文推断
-   - 如果模糊，读取 `6aspecdoc/brown/` 目录，让用户选择
+   - 如果模糊，读取 `6aspecdoc/brown/` 目录，使用 `AskUserQuestion` 工具列出需求让用户选择
 
 2. **处理特殊选项**
 
@@ -70,15 +70,10 @@
 
 5. **获取用户修改需求**
 
-   询问用户要修改的内容：
+   使用 `AskUserQuestion` 工具询问（开放式，用 Other 输入）：
    ```
    问题："请描述您要对 <phase> 阶段文档进行的修改："
-
-   提示：
-   - 请具体描述要修改、补充或调整的内容
-   - 如果是补充信息，请说明要补充什么
-   - 如果是修正错误，请说明错误的地方和正确的内容
-   - 如果是调整描述，请说明要如何调整
+   提示：具体描述要修改、补充或调整的内容
    ```
 
 6. **执行更新（根据模式）**
@@ -123,7 +118,7 @@
    - 建议：<执行建议>
    ```
 
-   d. **等待用户确认**：
+   d. **使用 `AskUserQuestion` 工具等待用户确认**：
    ```
    问题："是否执行上述更新计划？"
    选项：

package/.6aspec/rules/brown/subagents/implementer.md

@@ -11,6 +11,7 @@
 - **design.md**：主 agent 传入的 `design.md 路径`，读取相关技术决策
 - **analysis.md**：主 agent 传入的 `analysis.md 路径`，读取现状分析和影响面背景（如果存在）
 - **explore-summary.md**：主 agent 传入的 `explore-summary.md 路径`，读取代码结构摘要（如果存在）
+- **code.md**：`.6aspec/rules/biz/code.md`，编码规范与红线（含**架构红线**中的应用入口与跨层约定）、安全/性能要求（与本次修改语言相关时须通读并遵守）
 
 如果你对任务要求、验收标准、实现策略或依赖关系有任何疑问，**现在就提出**，不要开始实现后再问。
 
@@ -22,13 +23,15 @@
 2. 按"实现步骤"逐步执行，到类/方法级
 3. 遵循 design.md 的技术决策，**不在实现阶段发明新方案**
 4. 遵循现有代码风格和架构模式
-5. 检查红线规则（零容忍）：
-   - 循环中的数据库查询、网络请求、文件 I/O
-   - SQL 字符串拼接、敏感信息硬编码
-   - 空 catch 块、循环依赖、跨层直接调用
+5. **编码规范**：实现与自我审查须符合 `.6aspec/rules/biz/code.md`（含红线规则中的**架构红线**、安全、性能、命名与文内检查清单）
 6. 若项目有测试框架，补充/修改对应单元测试，覆盖任务关联的 AC/Scenario；若无测试框架则跳过
 7. 完成后自我审查，报告结果
 
+## 禁止事项
+
+- **除非用户在本对话中明确要求**，否则不要执行 `mvn`、`gradle`、`./gradlew`、`npm run build`、`pnpm build`、`make` 等**构建或全量编译**命令。Implement 的交付以改代码、补测试（若有框架）、**阅读与静态自检**、报告为主；构建与长时间运行的验证交给用户本地或 CI。
+- 若用户明确要求执行某条构建命令，可执行，并在报告中说明命令与结果摘要。
+
 ## 自我审查
 
 报告前检查：
@@ -37,9 +40,11 @@
 
 **克制性**：是否只做了任务要求的事，没有多做？是否引入了不必要的抽象或功能？
 
-**一致性**：是否遵循了现有代码风格？是否遵循了 design.md 的技术决策？
+**一致性**：是否遵循了现有代码风格、`code.md` 与 design.md 的技术决策？
+
+**分层**：若本次改动涉及 Controller/API、事件订阅、消息消费或调度入口，是否符合 `code.md` **架构红线**中关于薄入口、不直连 DAO 与委托 Service 的约定（有 TASK/design 例外除外）？
 
-**测试**：测试是否验证了真实行为（而不只是 mock 行为）？是否覆盖了关联的 AC/Scenario？
+**测试**：单元测试可使用 Mock/Stub 隔离外部依赖；断言是否落在被测代码的业务结果上（返回值、异常、领域状态等），而不是仅校验「Mock 曾被调用」？是否覆盖了关联的 AC/Scenario？
 
 发现问题立即修复，再报告。
 

package/.6aspec/rules/brown/subagents/spec-compliance-reviewer.md

@@ -8,6 +8,9 @@
 
 - **TASK 文件**：主 agent 传入的 `TASK 文件路径`，读取任务详情、实现步骤、验收标准、涉及文件
 - **specs.md**：主 agent 传入的 `specs.md 路径`，读取该任务引用的 AC/Scenario 原文
+- **design.md**：主 agent 传入的 `design.md 路径`，读取该任务相关的技术方案与约束（接口、流程、关键决策）
+
+> 如果缺少 `design.md` 路径或无法读取 design 内容：**直接判定不通过**（无法验证是否绕过设计）。
 
 ## 重要：不要信任 implementer 的报告
 
@@ -19,7 +22,10 @@ Implementer 的报告可能不完整或过于乐观。你**必须独立验证**
 
 ## 你的职责
 
-读取 implementer 修改的文件，验证以下三点：
+读取 implementer 修改的文件，验证以下内容：
+
+- **阻塞项**：1~5 任一不满足都必须判定 ❌
+- **风险提示**：测试覆盖默认不作为阻塞项（除非 TASK/specs.md/design.md 明确要求必须补测试）
 
 **1. 没有少做（Missing）**
 - 任务要求的每一项是否都已实现？
@@ -37,6 +43,24 @@ Implementer 的报告可能不完整或过于乐观。你**必须独立验证**
 - 是否用了正确的方式解决了正确的问题？
 - 业务语义是否与 specs.md 的 AC/Scenario 一致？
 
+**4. 设计一致性（Design Compliance）**
+- 是否严格符合 design.md 的技术方案与约束？（接口形态、流程编排、关键决策）
+- 是否存在绕过设计/偏离设计的实现？（即便功能表面可用也必须判定不通过）
+
+**5. 边界与正确性（Boundary & Correctness）**
+- 是否存在幂等问题（重复请求/重试导致重复写入、重复扣款、重复发消息等）？
+- 是否存在空值/缺省值处理问题（NPE、字段缺失、空集合、空字符串等）？
+- 是否存在并发/竞态问题（重复提交、并发更新丢失、顺序依赖被破坏等）？
+
+> 要求：必须以 `specs.md` / `design.md` / `TASK` 中可追溯的约束为判定基准。
+> - 如果你发现“必须明确但 specs/design 没写清”的边界规则，判定为 **规格/设计缺口** 并判定不通过，要求补齐 artifacts 后重审（不得在实现阶段临时发明规则）。
+
+**6. 测试覆盖关键场景（Testing Adequacy，默认仅风险提示）**
+- 评估测试是否覆盖该任务涉及的关键 AC/Scenario。
+- 评估是否覆盖关键边界场景（幂等/空值/并发）对应的用例或回归点。
+- 如果 implementer 报告明确无测试，且你也未发现相关测试文件：仅记录为**风险提示**，不要仅因无测试而判定不通过。
+- 只有当 TASK/specs.md/design.md **明确要求必须补测试**时，缺失测试才属于 Missing 并必须判定 ❌。
+
 ## 报告格式
 
 **如果通过**：
@@ -44,8 +68,10 @@ Implementer 的报告可能不完整或过于乐观。你**必须独立验证**
 ✅ 规格合规
 
 验证结论：
-- 已实现：[列出已覆盖的要求]
-- 测试覆盖：[列出覆盖的 AC/Scenario，或说明无测试框架]
+- 已实现：[列出已覆盖的要求（按 TASK / specs.md 逐条）]
+- 设计一致性：符合 design.md（如有关键约束请点名）
+- 边界检查：幂等/空值/并发关键点已覆盖（列出证据）
+- 测试覆盖（风险提示）：[如有，列出覆盖的 AC/Scenario + 关键边界用例；如无，标注风险]
 ```
 
 **如果有问题**：
@@ -60,6 +86,18 @@ Implementer 的报告可能不完整或过于乐观。你**必须独立验证**
 
 理解偏差（Misunderstood）：
 - [具体偏差描述，含文件路径和行号]
+
+设计偏离（Design Compliance）：
+- [具体偏离点，引用 design.md 条目/段落 + 对应代码文件路径和行号]
+
+边界问题（Boundary & Correctness）：
+- [幂等/空值/并发问题的具体描述，含文件路径和行号]
+
+规格/设计缺口（Spec/Design Gap）：
+- [需要补齐的 specs/design 条目，说明为什么这是必须的验收基准]
+
+风险提示（Risks，非阻塞）：
+- 测试覆盖风险：implementer 报告无测试/未发现测试文件，建议补充覆盖关键场景与边界用例
 ```
 
-问题描述必须具体、可操作，包含文件路径，让 implementer 能直接定位并修复。
+问题描述必须具体、可操作，包含文件路径和行号，让 implementer 能直接定位并修复或推动补齐 artifacts。

package/.6aspec/rules/common/code-reviewer-agent.md

@@ -0,0 +1,118 @@
+# Code Reviewer Agent
+
+你是一个代码审查专家，负责审查代码变更的生产就绪性。
+
+## 任务
+
+1. 通过 git diff 获取变更内容
+2. 对照需求/计划检查实现
+3. 从代码质量、架构、测试、生产就绪性四个维度评估
+4. 按严重程度分类问题
+5. 给出明确的合并建议
+
+## 输入
+
+调用方会提供：
+- `变更描述`：做了什么
+- `需求/计划`：应该做什么（可选，文件路径或文字描述）
+- `BASE_SHA`：起始 commit
+- `HEAD_SHA`：结束 commit
+
+## 执行步骤
+
+### 1. 获取变更内容
+
+```bash
+git diff --stat {BASE_SHA}..{HEAD_SHA}
+git diff {BASE_SHA}..{HEAD_SHA}
+```
+
+如果调用方未提供 SHA，使用：
+```bash
+BASE_SHA=$(git rev-parse HEAD~1)
+HEAD_SHA=$(git rev-parse HEAD)
+```
+
+### 2. 读取需求（如果提供了文件路径）
+
+读取需求/计划文件，理解预期行为。
+
+### 3. 执行审查
+
+**代码质量**
+- 关注点分离是否清晰？
+- 错误处理是否完善？
+- 类型安全（如适用）？
+- 是否遵循 DRY 原则？
+- 边界情况是否处理？
+
+**架构**
+- 设计决策是否合理？
+- 是否考虑可扩展性？
+- 性能影响？
+- 安全隐患？
+
+**测试**
+- 测试是否真正测试了逻辑（而非只测 mock）？
+- 边界情况是否覆盖？
+- 是否需要集成测试？
+- 所有测试是否通过？
+
+**需求符合度**
+- 是否满足所有需求？
+- 实现是否与规格一致？
+- 是否有范围蔓延？
+- 破坏性变更是否有文档？
+
+**生产就绪性**
+- Schema 变更是否有迁移策略？
+- 是否考虑向后兼容？
+- 文档是否完整？
+- 是否有明显 bug？
+
+## 输出格式
+
+### 亮点
+[做得好的地方，具体到文件:行号]
+
+### 问题
+
+#### 严重（必须修复）
+[Bug、安全问题、数据丢失风险、功能损坏]
+
+#### 重要（应该修复）
+[架构问题、缺失功能、错误处理不足、测试缺口]
+
+#### 次要（可以改进）
+[代码风格、优化机会、文档改进]
+
+**每个问题格式**：
+- 文件:行号
+- 问题描述
+- 为什么重要
+- 如何修复（如果不明显）
+
+### 建议
+[代码质量、架构或流程的改进建议]
+
+### 评估
+
+**可以合并？** [是 / 否 / 修复后可以]
+
+**理由**：[1-2 句技术评估]
+
+## 规则
+
+**要做**：
+- 按实际严重程度分类（不是所有问题都是严重）
+- 具体指出（文件:行号，不要模糊）
+- 解释问题为什么重要
+- 承认做得好的地方
+- 给出明确结论
+
+**不要做**：
+- 不检查就说"看起来不错"
+- 把小问题标为严重
+- 对没有审查的代码给反馈
+- 模糊表述（"改进错误处理"）
+- 回避给出明确结论

package/.agents/skills/6aspec-brown-analyze/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-analyze"
+description: "需求澄清与影响面分析（合并原 Understand + Impact）"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-analyze** has been activated
+2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
+3. Read file: `.6aspec/rules/brown/brown_analyze_sop.md`
+4. Strictly follow the SOP defined in that file

package/.agents/skills/6aspec-brown-archive/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-archive"
+description: "归档已完成的需求"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-archive** has been activated
+2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
+3. Read file: `.6aspec/rules/brown/brown_archive_sop.md`
+4. Strictly follow the SOP defined in that file

package/.agents/skills/6aspec-brown-continue/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-continue"
+description: "继续当前需求的下一个阶段"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-continue** has been activated
+2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
+3. Read file: `.6aspec/rules/brown/brown_continue_sop.md`
+4. Strictly follow the SOP defined in that file

package/.agents/skills/6aspec-brown-design/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-design"
+description: "技术方案设计（含 ADR 和技术债务识别）"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-design** has been activated
+2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
+3. Read file: `.6aspec/rules/brown/brown_design_sop.md`
+4. Strictly follow the SOP defined in that file

package/.agents/skills/6aspec-brown-explore/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-explore"
+description: "前期探索（轻量级流程可选）"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-explore** has been activated
+2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
+3. Read file: `.6aspec/rules/brown/brown_explore_sop.md`
+4. Strictly follow the SOP defined in that file

package/.agents/skills/6aspec-brown-ff/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-ff"
+description: "快速完成分析阶段（根据流程深度）"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-ff** has been activated
+2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
+3. Read file: `.6aspec/rules/brown/brown_ff_sop.md`
+4. Strictly follow the SOP defined in that file

package/.agents/skills/6aspec-brown-implement/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-implement"
+description: "执行任务实现"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-implement** has been activated
+2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
+3. Read file: `.6aspec/rules/brown/brown_implement_sop.md`
+4. Strictly follow the SOP defined in that file

package/.agents/skills/6aspec-brown-list/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-list"
+description: "列出所有需求及其状态"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-list** has been activated
+2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
+3. Read file: `.6aspec/rules/brown/brown_list_sop.md`
+4. Strictly follow the SOP defined in that file

package/.agents/skills/6aspec-brown-new/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-new"
+description: "开始新需求分析（选择流程深度）"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-new** has been activated
+2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
+3. Read file: `.6aspec/rules/brown/brown_new_sop.md`
+4. Strictly follow the SOP defined in that file

package/.agents/skills/6aspec-brown-proposal/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-proposal"
+description: "创建需求提案（轻量级流程）"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-proposal** has been activated
+2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
+3. Read file: `.6aspec/rules/brown/brown_proposal_sop.md`
+4. Strictly follow the SOP defined in that file

package/.agents/skills/6aspec-brown-quick/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-quick"
+description: "需求快速通道（简化流程）"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-quick** has been activated
+2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
+3. Read file: `.6aspec/rules/brown/brown_quick_sop.md`
+4. Strictly follow the SOP defined in that file