anyone-can-architect 0.2.0 → 0.4.0

package/zh-CN/dist/grok/aca-review/SKILL.md

@@ -1,14 +1,14 @@
 ---
 name: aca-review
-description: 审查当前范围的设计文档或代码实现，判定通过、需要调整或未完成，不修改受审文档与代码
+description: 审查当前范围的设计文档或代码结构，判定通过、需要调整或未完成，不修改受审文档与代码
 ---
 <!-- AUTO-GENERATED from SKILL.md.tmpl — do not edit directly -->
 <!-- Regenerate: bash scripts/build-skills.sh --host grok -->
 
 # aca-review
 
-审查当前范围的设计文档或代码实现，判定通过、需要调整或未完成
-不修改设计文档、项目源码与测试代码
+审查当前范围的设计文档或代码结构，判定通过、需要调整或未完成
+不修改设计文档、项目源码与测试代码，不运行受审代码与测试
 发布前的仓库整体审计由 `/aca-repo-audit` 执行
 
 ## 1 原则
@@ -17,11 +17,11 @@ description: 审查当前范围的设计文档或代码实现，判定通过、
 
 1. **依据驱动**
    以已确认的需求与适用规则审查设计
-   以已确认的设计审查实现
+   以已确认的设计审查代码的模块化与整体结构
 2. **独立判断**
-   各审查任务独立形成结论
+   按审查维度独立形成结论
 3. **证据判定**
-   以逐项核验结果与证据判定问题及审查结论
+   以代码结构与文档事实判定问题及审查结论
 4. **范围约束**
    审查结论仅覆盖本次范围
 
@@ -36,7 +36,7 @@ description: 审查当前范围的设计文档或代码实现，判定通过、
 - 先交代整体，再展开细节，参见[金字塔原理](~/.grok/skills/aca/SSOT.md#2-文档结构)
 - 表达判断时，先给结论，再给依据
 - 不增加信息的标题层级应当合并
-- 有时序或优先级的条目用编号列表，每项有多个属性时属性缩进在该项下
+- 有时序或优先级的条目用编号列表，包含子项时每步以加粗短语开头表达目的，具体操作与条件分支缩进在该步下
 - 表格只用于多行同构、每行有两个以上属性、行之间没有先后关系的内容
 - 列表项直接写完整的句子
 - 一个条目有分支时，将分支缩进列在该条目下
@@ -55,6 +55,8 @@ description: 审查当前范围的设计文档或代码实现，判定通过、
 - 删除不增加信息、也不帮助理解的内容
 - 一行一句，每句只表达一个事实
 - 操作步骤直接写动作
+- 能用具体做法完整表达的约束，直接写做法
+- 无法用具体做法完整表达的禁止事项仍须保留
 - 有先后关系的动作分项写
 - 执行者、操作对象与指代必须明确
 - 上下文已经明确的执行者、操作对象与指代不重复说明
@@ -81,12 +83,12 @@ description: 审查当前范围的设计文档或代码实现，判定通过、
 ```mermaid
 flowchart TD
     Start([接收审查请求]) --> Scope["确认审查范围与执行模型 · §3"]
-    Scope --> Check["判断审查类型并执行对应检查 · §4"]
-    Check --> Audit["按所选审查类型编排并执行独立审查 · §5"]
-    Audit --> Verify["复核与汇总 · §6"]
-    Verify --> Issues{"存在已确认的必须调整项 · §7"}
-    Issues -- 是，需要调整 --> Report(["输出结果与下一步 · §8"])
-    Issues -- 否 --> Complete{"通过条件全部满足 · §7"}
+    Scope --> Check["判断审查类型并准备依据 · §4"]
+    Check --> Audit["按审查类型执行独立审查 · §5"]
+    Audit --> Verify["复核与判定 · §6"]
+    Verify --> Issues{"存在已确认的必须调整项 · §6.2"}
+    Issues -- 是，需要调整 --> Report(["输出结果与下一步 · §7"])
+    Issues -- 否 --> Complete{"通过条件全部满足 · §6.2"}
     Complete -- 是，通过 --> Report
     Complete -- 否，未完成 --> Report
 ```
@@ -95,81 +97,72 @@ flowchart TD
 
 ### 3.1 对象、范围与前提
 
-1. 开发者已指定审查对象与范围时，优先按其指定执行
-   开发者未指定时，沿用调用方已明确的审查对象与范围
-2. 对象或范围未明确时，结合当前工作区改动与近期相关提交确定
-   读取近期相关提交的说明与 diff，了解改动意图与内容
-3. 仍无法确定审查对象或范围时，请开发者明确
-4. 记录审查对象、范围与比较基线
-   注明本次受审提交及纳入审查的未提交改动
-5. 运行 `bash ~/.grok/skills/aca/bin/aca-repo-type-check` 检查工程类型
-   工程类型缺失或无效时，将类型规则核对列为未完成，并建议运行 `/aca-init`
-   工程类型尚未支持时，将类型规则核对列为未完成，并注明缺少对应规则
-6. 输入未包含设计文档位置时，从根 README 的文档入口定位
-   无法定位审查依据或受审文件时，请开发者提供位置
-   位置明确前，将依赖这些内容的检查列为未完成
-
-7. 读取通用审查依据
-   读取本次已确认的问题、目标与改动范围
-   工程类型有效且已支持时，读取对应的 Repo Type 规则
-   读取 `CONTEXT.md`，核对本次审查涉及的业务概念与定义
-   读取本次范围的设计文档，并沿引用补齐理解与核验所需的文档
+1. **确认审查对象与范围**
+   - 开发者已指定审查对象与范围：优先按其指定执行
+   - 开发者未指定：沿用调用方已明确的审查对象与范围
+   - 对象或范围仍未明确：结合当前工作区改动与近期相关提交确定，读取近期相关提交的说明与 diff
+   - 仍无法确定审查对象或范围：请开发者明确
+2. **记录比较基线**
+   - 记录审查对象、范围与比较基线
+   - 注明本次受审提交及纳入审查的未提交改动
+3. **检查工程类型**
+   - 运行 `bash ~/.grok/skills/aca/bin/aca-repo-type-check` 检查工程类型
+   - 工程类型缺失或无效：将类型规则核对列为未完成，并建议运行 `/aca-init`
+   - 工程类型尚未支持：将类型规则核对列为未完成，并注明缺少对应规则
+4. **定位并读取通用审查依据**
+   - 输入未包含设计文档位置时，从根 README 的文档入口定位；无法定位时请开发者提供位置，位置明确前将依赖这些内容的检查列为未完成
+   - 读取本次已确认的问题、目标与改动范围
+   - 工程类型有效且已支持时，读取对应的 Repo Type 规则
+   - 读取 `CONTEXT.md`，核对本次审查涉及的业务概念与定义
+   - 读取本次范围的设计文档，并沿引用补齐理解与核验所需的文档
 
 ### 3.2 Agent 与模型选择
 
-1. 扫描当前 AI Agent 环境及本机已有的其他 AI Agent 环境
-   记录各环境的 Agent 工具种类与实际模型标识，与主 agent 比较
-   通过现有工具入口、配置与模型列表，核对调用方式及可用状态
-   已安装或存在配置不能单独证明可调用
-   无法核实的信息注明未知
-2. 根据扫描结果提出执行组合
-   优先使用可调用的旗舰模型，依据当前可核实的信息判断旗舰定位
-   优先选择 Agent 环境与模型均不同于主 agent 的组合
-   不固定品牌、型号或尝试顺序
-   没有其他适合且可调用的候选时，提出使用本模型的方案
-3. 展示候选的 Agent、模型、可用状态、调用方式及与主 agent 的差异
-   说明推荐依据与可选的备选组合，请开发者确认
-   开发者确认后，再执行审查
-   已确认的选择与可用条件未变化时，沿用已有确认
-4. 将确认的执行组合用于[任务编排](#53-模型与任务编排)
-   所选组合无法调用时，使用已确认的备选
-   无已确认的备选时，报告变化并请开发者确认新的组合
-   在报告中注明实际选择、回落及原因
+1. **优先复用已确认模型**
+   - 开发者已指定 Agent 环境或模型：按指定执行
+   - 已有确认过的审查模型，且可用条件未变化：默认直接复用上次确认的 Agent 环境与模型，跳过环境扫描与确认
+2. **首次审查扫描并确认模型**
+   - 首次执行审查且未指定模型时，扫描当前及本机已有的其他 AI Agent 环境与可调用模型
+   - 优先推荐不同于主 agent 的可调用旗舰模型；没有其他适合且可调用的候选时，提出使用本模型的方案
+   - 展示候选的 Agent 环境、模型、可用状态与推荐依据，请开发者确认后再执行审查，后续审查默认复用该确认结果
+3. **处理执行回落**
+   - 将确认或复用的执行组合用于[任务编排与执行](#53-任务编排与执行)
+   - 所选组合无法调用时，使用已确认的备选；无已确认备选时，报告变化并请开发者确认新的组合
+   - 在[审查报告](#71-审查报告)中注明实际执行的 Agent 环境、模型、复用情况及回落原因
 
 ## 4 读取依据与执行检查
 
 ```mermaid
 flowchart TD
-    Kind["判断审查类型 · §4.1"] -- 设计审查 --> Design["设计审查 · §4.2"]
-    Kind -- 实现审查 --> Implementation["实现审查 · §4.3"]
-    Design --> Results["处理检查结果 · §4.4"]
-    Implementation --> Results
+    Kind["判断审查类型 · §4.1"] -- 设计审查 --> Design["设计审查准备与机械检查 · §4.2"]
+    Kind -- 实现审查 --> Implementation["实现审查依据准备 · §4.3"]
+    Design --> Next(["进入独立审查 · §5"])
+    Implementation --> Next
 ```
 
 ### 4.1 判断审查类型
 
-1. 开发者已指定审查类型时，优先按其指定执行
-   开发者未指定时，沿用调用方已明确的审查类型
-2. 审查类型未明确时，根据受审对象与实际改动判断
-   - 设计文档：执行设计审查
-   - 代码、测试或运行配置：执行实现审查
-   - 同时涉及设计与实现：分别执行两类审查
-3. 仍无法确定审查类型时，请开发者明确
+1. **确定本次审查类型**
+   - 开发者已指定审查类型：优先按其指定执行
+   - 开发者未指定：沿用调用方已明确的审查类型
+   - 审查类型未明确：根据受审对象与实际改动判断（设计文档执行设计审查，代码执行实现审查，同时涉及两者时分别执行两类审查）
+   - 仍无法确定审查类型：请开发者明确
 
-选择两类审查时，两条检查分支均执行
+选择两类审查时，两条分支均执行
 
 ### 4.2 设计审查
 
-1. 读取本次范围对应的文档组、Doc Design 与实际采用的 Pattern
-   提取其中适用的检查条件，作为逐项核验的依据
-2. 根据本次审查范围确定机械检查的目标路径
-   行文检查覆盖本次受审的全部文档，包括纳入审查范围的项目级记录
-   文档图检查选择包含本次受审文档、且具有 README 入口的文档树
-   Context 的机械检查用于核对结构与格式，内容按对应 Doc Design 的检查条件核验
-3. 执行或复用机械检查
-   本会话已有相同范围的机械检查结果，且相关文件、检查规则与工具均未变化时，可复用
-   复用时，在报告中注明原检查结果及本次满足的复用条件
-   不满足复用条件时，将以下命令中的占位路径替换为第 2 步确定的实际路径并执行
+设计审查默认用于跨模块范围的设计变更（涉及多个模块、项目级架构、模块划分或跨模块接口与协作契约），或开发者显式指定的设计审查
+
+1. **提取适用检查条件**
+   - 读取本次范围对应的文档组、Doc Design 与实际采用的 Pattern
+   - 提取其中适用的检查条件，作为设计审查的核验依据
+2. **复用或执行机械检查**
+   - 本会话已有相同范围的机械检查结果，且相关文件、检查规则与工具均未变化时，直接复用并在报告中注明原结果及复用依据
+   - 不满足复用条件时，将以下命令中的占位路径替换为本次受审文档的实际路径并执行
+     - 行文检查覆盖本次受审的全部文档，包括纳入审查范围的项目级记录
+     - 文档图检查选择包含本次受审文档、且具有 README 入口的文档树
+     - Context 的机械检查用于核对结构与格式
 
    ```bash
    bash ~/.grok/skills/aca/bin/aca-doc-graph-check <文档目录>
@@ -177,111 +170,94 @@ flowchart TD
    bash ~/.grok/skills/aca/bin/aca-prose-check <本次受审的全部文档路径>
    ```
 
-### 4.3 实现审查
-
-1. 读取本次范围对应的已确认设计、测试设计与仓库实现约定
-2. 按已确定的比较基线读取本次 diff 与改动文件
-   读取受影响的调用方与依赖代码
-   读取改动所在函数、类及相关调用链，理解其执行上下文
-3. 将实现与测试分别对应到设计约定和测试场景
-4. 根据本次改动的影响范围，执行或复用设计与仓库约定要求的测试、构建及静态检查
-   设计要求通过实际运行核验的行为，按对应测试用例执行验证
-   已有验证结果对应相同受审内容，且测试用例、夹具、配置与依赖环境均未变化时，可复用
-   复用时，在报告中注明原验证结果及本次满足的复用条件
-   验证证据不足或不满足复用条件时，执行对应检查
-   按测试设计使用隔离的验证环境
-   验证过程中不修改提交记录
-
-### 4.4 处理检查结果
-
-两类审查的工具检查均按本节处理
+3. **处理机械检查结果**
 
 | 检查情况 | 处理 |
 | --- | --- |
-| 通过 | 记录结果与验证依据 |
+| 通过或满足复用条件 | 记录结果与验证或复用依据 |
 | 返回失败 | 核对诊断，将已确认的问题列为必须调整 |
 | 无法运行或诊断无法核实 | 对应检查或问题核验列为未完成，注明原因 |
 
+### 4.3 实现审查
+
+1. **读取结构设计与组织约定**
+   - 读取本次范围对应的架构设计、模块边界、接口定义、内部组成与仓库代码组织约定
+2. **读取受审代码的整体结构**
+   - 按已确定的比较基线读取本次改动涉及的目录与文件分布、模块依赖、函数与类定义及跨模块组装接线
+3. **明确审查边界**
+   - 实现审查默认用于跨模块范围或改变了模块整体代码结构的变更（仅模块内部且未改变整体代码结构的改动不用执行实现审查，直接进入 `/aca-test`）
+   - 实现审查只检查整体结构（模块结构、整体代码分布、函数构造），不检查具体的代码细节与实现逻辑
+   - 实现审查不直接运行代码、测试或构建，运行验证在审查通过后由 `/aca-test` 执行
+
 ## 5 审查编排与执行
 
 ### 5.1 设计审查维度
 
-1. **产品视角**
+设计审查作为一个整体审查任务，围绕以下四项核对受审设计文档
+
+1. **需求与范围承接**
    核对设计是否完整承接本次已确认的问题、目标与范围
-2. **设计视角**
-   核对职责与边界的划分是否符合业务分工
-   核对协作与处理机制能否实现已确认的业务目标
-   涉及用户交互时，核对用户能否按设计流程完成目标
-   核对各交互状态及成功、失败路径是否提供明确的反馈与操作指引
-3. **实现视角**
-   核对模块依赖与接口约定是否足以指导模块协作
-   核对数据、状态变化、错误处理与边界行为是否足以指导具体实现
+2. **职责边界与协作机制**
+   核对职责与边界划分、模块依赖与接口约定是否符合业务分工并足以指导模块协作
+   核对协作与处理机制、数据与状态变化、错误处理与边界行为是否足以指导具体实现
+   涉及用户交互时，核对交互流程、各交互状态及成功与失败路径是否提供明确的反馈与操作指引
+   核对设计是否存在会导致业务行为不同的歧义，以及实施前是否仍需补充设计决定
+3. **验证设计完备性**
    核对测试设计是否明确夹具、场景、执行方式与预期结果
    核对测试结果能否判定对应验收条件是否满足
-   核对设计是否存在会导致业务行为不同的歧义
-   核对实施前是否仍需补充设计决定
-4. **整体视角**
+4. **关联一致性与表达规范**
    核对文档入口与引用能否准确定位本次设计及其依赖
    核对相关文档之间是否存在设计遗漏、约定冲突、重复定义或术语不一致
+   核对适用文档组、Doc Design 与 Pattern 的检查条件是否满足
 
 ### 5.2 实现审查维度
 
-以已确认的设计文档为依据，逐项核对以下内容
-
-1. **结构设定**
-   核对模块与文件划分、职责归属、接口定义及依赖关系是否符合设计
-2. **具体逻辑实现**
-   核对输入输出与处理流程是否符合设计
-   核对数据与状态变化、错误处理及边界行为是否符合设计
-   核对黑盒与白盒测试中的夹具、场景及预期结果是否符合对应测试设计
-   核对测试断言能否识别实际行为与预期结果的偏差
-3. **整体结构实现**
-   核对模块间的组装、调用链与协作方式是否符合整体架构设计
-   核对集成后的行为是否符合设计中的跨模块流程与验收条件
-
-### 5.3 模型与任务编排
-
-1. 按所选审查类型创建独立审查任务
-   设计审查为每个视角分别分配独立子 agent
-   实现审查为结构设定、具体逻辑实现与整体结构实现分别分配独立子 agent
-   各子 agent 独立形成结论，不预先读取其他子 agent 的审查结果
-2. 按[Agent 与模型选择](#32-agent-与模型选择)中已确认的组合安排执行
-   使用本模型时，各审查任务仍独立执行
-3. 为各子 agent 提供任务上下文
-   - 负责的审查项及分配的适用检查条件
+实现审查作为一个整体审查任务，以已确认的设计文档为依据，只检查代码的模块化与整体结构，不检查具体的代码细节与实现逻辑
+
+1. **模块结构**
+   核对模块与子模块划分、职责归属、接口边界、依赖关系及跨模块组装接线是否符合设计
+2. **整体代码分布**
+   核对目录与文件组织是否符合设计，各文件职责是否单一、归属是否清晰，是否存在职责混杂或跨层耦合
+3. **函数构造**
+   核对函数与类的职责切分、签名设计、粒度及抽象层次是否清晰合理
+
+### 5.3 任务编排与执行
+
+1. **按审查类型派发独立审查任务**
+   - 仅执行设计审查或仅执行实现审查时，创建 1 个独立子 agent 任务完成该维度的全部核对项
+   - 同时执行设计审查与实现审查时，为设计审查与实现审查分别创建 1 个独立子 agent 任务
+   - 各审查任务按[Agent 与模型选择](#32-agent-与模型选择)安排执行，独立形成结论
+2. **提供任务上下文**
+   - 负责的审查类型、对应核对项与适用检查条件
    - 审查对象、范围与比较基线，以及受审提交和纳入审查的未提交改动
    - 受审内容的位置及对应设计依据
-   - 第四章已有检查结果与证据，以及执行或复用依据
-   - 实现审查所需的 diff、改动文件、受影响的调用与依赖代码、仓库实现约定
-
-### 5.4 执行审查
-
-1. 各子 agent 逐项核验所分配的检查条件
-   检查条件不适用于本次范围时，记录不适用及其依据
-2. 每项检查记录核验结果、对应文件位置与判断依据
-3. 每条问题按[审查报告](#81-审查报告)中的问题格式记录位置、问题、影响与调整建议
-4. 将完整检查记录、问题清单及未完成项返回主 agent
-
-## 6 复核与汇总
-
-1. 主 agent 读取各子 agent 的检查记录
-   核对工具检查与验证证据是否对应本次受审内容
-2. 逐条核对问题涉及的文件与证据，确认成立后纳入报告
-   已证伪的问题排除
-   证据不足的问题列为未完成核验
-   主 agent 可补充自行发现的问题，经同样的证据核验后纳入报告
-   合并重复问题，保留发生位置、证据与影响
-3. 汇总各审查项的检查记录，逐项核对检查条件的适用性与核验结果
-   子 agent 未覆盖分配的范围、遗漏检查或缺少核验依据时，补充分派对应检查
-   主 agent 复核补充结果
-   仍无法完成的审查项或检查，列为未完成并注明原因
-4. 汇总已确认的问题与检查完成情况，作为结论判定的依据
-
-## 7 判定结论
+   - 设计审查所需的第四章机械检查结果与证据
+   - 实现审查所需的目录与文件结构、改动文件、模块依赖与仓库代码组织约定
+3. **执行问题导向审查**
+   - 子 agent 逐项核验所负责维度的核对项与适用检查条件
+   - 发现问题时，按[审查报告](#71-审查报告)中的问题格式记录文件位置、问题、影响与调整建议
+   - 存在无法完成的检查项时，记录未完成项及原因
+   - 通过项与不适用项不逐条输出留痕明细，将发现的问题清单、未完成项与审查结论返回主 agent
+
+## 6 复核与判定
+
+### 6.1 复核与归并
+
+1. **复核问题证据**
+   - 主 agent 逐条核对子 agent 返回的问题涉及的文件与证据，确认成立后纳入报告
+   - 已证伪的问题排除，证据不足的问题列为未完成核验
+   - 主 agent 可补充自行发现的问题，经同样的证据核验后纳入报告
+   - 合并重复问题，保留发生位置、证据与影响
+2. **核对审查覆盖**
+   - 确认所选审查维度及其核对项均已完成核验
+   - 子 agent 未覆盖分配的范围或遗漏核对项时，补查对应内容并复核结果
+   - 仍无法完成的审查维度或检查，列为未完成并注明原因
+
+### 6.2 判定结论
 
 | 结论 | 条件 |
 | --- | --- |
-| 通过 | 所选审查任务全部完成、适用检查条件全部核验通过、适用工具检查通过、无必须调整项 |
+| 通过 | 所选审查任务全部完成、适用检查条件全部核验通过、适用机械检查通过、无必须调整项 |
 | 需要调整 | 存在已确认的必须调整项 |
 | 未完成 | 未满足通过条件，且无已确认的必须调整项 |
 
@@ -289,9 +265,9 @@ flowchart TD
 可选优化不影响通过
 受审内容发生变化后，重新审查受影响范围，并更新对应结论
 
-## 8 输出结果与下一步
+## 7 输出结果与下一步
 
-### 8.1 审查报告
+### 7.1 审查报告
 
 在当前对话中按以下模板输出审查结果，不写入项目文件
 
@@ -300,12 +276,13 @@ flowchart TD
 
 | 项目 | 结果 |
 | --- | --- |
-| 对象 | <设计文档 / 代码实现 / 两者> |
+| 对象 | <设计文档 / 代码结构 / 两者> |
 | 范围 | <受审模块、文件或改动范围> |
 | 基线 | <比较基线、受审提交及未提交改动> |
+| 执行模型 | <实际执行的 Agent 环境、模型、复用情况及回落原因> |
 | 结论依据 | <满足通过条件的情况，或阻止通过的问题与未完成检查> |
 | 必须调整 | <问题数量与主要影响 / 无> |
-| 工具检查 | <测试、构建或机械检查的通过、失败及未完成情况> |
+| 工具检查 | <设计审查机械检查的通过、复用、失败及未完成情况 / 实现审查不适用> |
 | 未完成 | <本次范围内未完成的审查任务、检查及原因 / 无> |
 | 下一步 | <一个立即可执行的动作> |
 
@@ -313,39 +290,26 @@ flowchart TD
 
 - <文档章节链接 / 代码文件链接与行号>
   - 问题：<实际内容、违反的设计约定或检查条件及具体偏差>
-  - 影响：<对设计理解、实施或运行行为的影响，以及适用的发生条件>
+  - 影响：<对设计理解、实施或代码结构维护的影响，以及适用的发生条件>
   - 调整：<需要修正或确认的内容，以及修正后应满足的约定或检查条件>
 
 ## 可选优化
 
 - <不影响审查通过的改善建议、对应位置与预期收益>
-
-## 检查范围
-
-- 阅读：<本次实际读取的文件>
-- 检查条件：<条件及来源、逐项核验结果、不适用依据与未完成原因>
-- 工具：<实际执行的命令与结果，或复用的原结果及复用依据>
-
-| 审查项 | Agent 环境 | 模型 | 完成状态 | 说明 |
-| --- | --- | --- | --- | --- |
-| <设计审查视角 / 实现审查项> | <实际 Agent 环境> | <实际模型及可核实的版本> | <已完成 / 未完成> | <回落或未完成原因 / 无> |
 ```
 
-设计审查列出产品、设计、实现与整体四个视角
-实现审查列出结构设定、具体逻辑实现与整体结构实现三项
-
-### 8.2 后续动作
+### 7.2 后续动作
 
 按审查结论与本轮进度选择下一步
 
 | 结论 | 情况 | 下一步 |
 | --- | --- | --- |
-| 未完成 | 输入、验证环境或核验条件缺失 | 报告恢复条件，补齐后通过 `/aca-review` 继续本次审查 |
-| 需要调整 | 实现问题 | `/aca-implement` 修复并验证 |
+| 未完成 | 输入或核验条件缺失 | 报告恢复条件，补齐后通过 `/aca-review` 继续本次审查 |
 | 需要调整 | 设计方案仍需论证或决定 | `/aca-specify` 补充或修订方案 |
 | 需要调整 | 方案已明确，仅需修订设计文档 | `/aca-design` 修订文档 |
-| 通过 | 仅设计审查通过，且本轮需要实施 | `/aca-implement` |
-| 通过 | 实现审查通过，尚有本轮实施任务 | `/aca-implement` 继续实施 |
-| 通过 | 本轮工作全部完成，且所需审查均通过 | 按已确认的版本推进安排衔接 `/aca-release` |
+| 需要调整 | 代码结构问题 | `/aca-implement` 调整代码结构 |
+| 通过 | 设计审查通过，本轮需要实施代码 | `/aca-implement` |
+| 通过 | 设计审查通过，本轮仅改设计文档 | 按已确认的版本推进安排衔接 `/aca-release` |
+| 通过 | 实现审查通过 | `/aca-test` 执行当前范围的测试验证 |
 
-设计或实现修正后，通过 `/aca-review` 复审受影响范围
+设计或代码结构修正后，通过 `/aca-review` 复审受影响范围

package/zh-CN/dist/grok/aca-test/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: aca-test
+description: 根据当前实现或改动影响范围选取并运行最小化测试，只测不改
+---
+<!-- AUTO-GENERATED from SKILL.md.tmpl — do not edit directly -->
+<!-- Regenerate: bash scripts/build-skills.sh --host grok -->
+
+# aca-test
+
+根据当前实现范围或改动突破的设计边界，选取并运行对应的最小化测试
+只执行测试与验证，不修改设计文档、生产代码或测试代码
+
+## 1 原则
+
+1. **影响定界**
+   以本次实现或改动的契约边界与依赖关系确定最小化测试范围
+2. **只测不改**
+   只运行测试并核实结果，不修改设计文档、生产代码或测试代码
+3. **证据绑定**
+   测试结果绑定被测提交、测试范围与实际执行的命令，供后续环节直接复用
+
+## 2 执行流程
+
+```mermaid
+flowchart TD
+    Start([接收测试请求]) --> Scope["确定测试范围 · §3"]
+    Scope --> Reuse{"满足结果复用条件？ · §3"}
+    Reuse -- 是 --> Report(["输出结果与下一步 · §5"])
+    Reuse -- 否 --> Ready{"测试环境与前置条件就绪？ · §3"}
+    Ready -- 否 --> Report
+    Ready -- 是 --> Run["运行测试与异常复核 · §4"]
+    Run --> Report
+```
+
+## 3 确定测试范围
+
+1. **确定被测对象与改动范围**
+   - 开发者或上游调用方已明确本次待测范围：直接沿用该范围
+   - 未明确范围：读取当前工作区改动与近期提交，对照设计文档定位改动所属的模块、命令或事件
+   - 记录本次被测提交及纳入验证的未提交改动
+2. **按变更突破的设计边界选取最小化测试集**
+   - 仅实现或修改模块、命令或事件内部，模块 `interface`、命令路由与事件调度契约未变化：只选取该单元自身的白盒与黑盒测试
+   - 修改模块 `interface`、命令路由、事件调度或跨单元协作：选取本单元测试、调用该契约的模块或命令与事件测试，以及项目级 `testcase` 中设计依据关联该单元的黑盒测试
+   - 修改公共基础、全局配置、数据迁移、构建或部署等跨模块共享底座：选取受影响的全量测试与对应环境验证
+   - 仓库 `release` 文档对当前验证另有规定时，一并纳入
+3. **核对复用条件与执行环境**
+   - 已有测试结果覆盖本次选定范围，且被测内容、测试代码、夹具、配置与依赖环境均未变化：直接复用并记录依据，进入[输出结果与下一步](#5-输出结果与下一步)
+   - 需要执行测试：按测试设计核对所需环境、夹具及真实依赖或测试替身的就绪状态
+   - 环境或依赖未就绪：记录缺失条件，按[输出结果与下一步](#5-输出结果与下一步)报告未完成
+
+## 4 运行与复核
+
+1. **控制并发与资源隔离**
+   - 按测试设计建立夹具与隔离环境
+   - 涉及容器、数据库、真实平台或模型评测等共享或重型资源时，限制并发度并隔离资源，避免并行争用导致超时
+2. **执行选定测试**
+   - 运行[确定测试范围](#3-确定测试范围)选定的测试用例及必要的构建或静态检查
+   - 执行完成后，按夹具规定清理本次产生的测试数据与临时资源
+   - 验证过程中不修改设计文档、生产代码、测试代码或提交记录
+3. **复核失败并区分原因**
+   - 全部通过：记录执行命令、通过用例数与耗时
+   - 出现失败：对照已确认的设计，核对失败日志、测试用例、夹具与实现
+   - 疑似宿主高负载或资源争用导致超时：在低并发隔离条件下单独重跑失败项核实
+   - 单独重跑稳定通过且确认为环境负载所致：记录初跑异常、重跑命令与通过结果
+   - 实现偏离设计：报告实现问题，指出失败用例与对应实现位置
+   - 用例预期过时或测试、夹具本身错误：报告测试问题，指出对应设计依据与错误位置
+   - 设计缺失或契约冲突：将对应验证列为未完成，交由 `/aca-specify` 或 `/aca-design` 补齐
+   - 环境故障或诊断无法核实：将对应验证列为未完成并记录原因
+
+## 5 输出结果与下一步
+
+### 5.1 判定结论
+
+| 结论 | 条件 |
+| --- | --- |
+| 通过 | 本次选定范围的测试与必需检查全部通过（含复用或超时复核通过），无失败项与未完成项 |
+| 失败 | 存在已确认的代码或测试失败项 |
+| 未完成 | 设计缺失、契约冲突、环境缺失、无法执行或诊断无法核实，且无已确认的失败项 |
+
+同时存在已确认的失败项与未完成项时，结论为失败，并列出未完成项
+
+### 5.2 测试报告
+
+在当前对话中按以下模板输出测试结果
+
+```markdown
+# 🧪 Test：<通过 / 失败 / 未完成>
+
+| 项目 | 结果 |
+| --- | --- |
+| 范围 | <本次被测单元或改动范围> |
+| 基线 | <被测提交及纳入验证的未提交改动> |
+| 选取依据 | <沿用上游范围 / 契约未变的单元内测试 / 契约变化的依赖链测试 / 全局底座全量测试> |
+| 执行命令 | <实际运行的测试与检查命令，或复用依据> |
+| 结果 | <通过数、失败数与耗时> |
+| 异常复核 | <超时单独重跑核实结果 / 无> |
+| 失败项 | <失败用例、原因与对应位置 / 无> |
+| 未完成 | <未执行的验证、原因与恢复条件 / 无> |
+| 下一步 | <一个立即可执行的动作> |
+```
+
+### 5.3 后续动作
+
+按测试结论与本轮进度选择下一步
+
+| 结论 | 情况 | 下一步 |
+| --- | --- | --- |
+| 未完成 | 测试环境、夹具或外部依赖缺失 | 补齐环境条件后通过 `/aca-test` 重新验证 |
+| 失败 | 代码或测试实现问题 | `/aca-implement` 修复（未改变代码结构时直接通过 `/aca-test` 重新验证，改变代码结构时经 `/aca-review` 审查后再运行 `/aca-test`） |
+| 未完成 | 设计缺失或契约冲突 | `/aca-specify` 或 `/aca-design` 修正设计 |
+| 通过 | 本轮尚有待实施的后续任务 | `/aca-implement` 继续实施下一范围 |
+| 通过 | 本轮实施范围全部验证通过 | 按版本推进安排衔接 `/aca-release` 或结束本次任务 |

package/zh-CN/dist/grok/aca-walkthrough/SKILL.md

@@ -33,7 +33,7 @@ description: 用业务语言导读设计文档，逐单元确认设计决定，
 - 先交代整体，再展开细节，参见[金字塔原理](~/.grok/skills/aca/SSOT.md#2-文档结构)
 - 表达判断时，先给结论，再给依据
 - 不增加信息的标题层级应当合并
-- 有时序或优先级的条目用编号列表，每项有多个属性时属性缩进在该项下
+- 有时序或优先级的条目用编号列表，包含子项时每步以加粗短语开头表达目的，具体操作与条件分支缩进在该步下
 - 表格只用于多行同构、每行有两个以上属性、行之间没有先后关系的内容
 - 列表项直接写完整的句子
 - 一个条目有分支时，将分支缩进列在该条目下
@@ -52,6 +52,8 @@ description: 用业务语言导读设计文档，逐单元确认设计决定，
 - 删除不增加信息、也不帮助理解的内容
 - 一行一句，每句只表达一个事实
 - 操作步骤直接写动作
+- 能用具体做法完整表达的约束，直接写做法
+- 无法用具体做法完整表达的禁止事项仍须保留
 - 有先后关系的动作分项写
 - 执行者、操作对象与指代必须明确
 - 上下文已经明确的执行者、操作对象与指代不重复说明
@@ -99,7 +101,7 @@ flowchart TD
    仍无法定位时，请开发者指定文档位置
    读取 `~/.grok/skills/aca/doc-design/repo-types/{repo-type}.md`
    读取 `CONTEXT.md` 与当前范围的设计文档
-   读取对应的文档组、文档设计与实际采用的 pattern
+   读取对应的文档组与文档设计，按需读取相关 pattern
 4. 安排导读顺序
    按类型规则的治理顺序安排导读
    文档组内部按对应文档组规定的顺序安排
@@ -153,14 +155,15 @@ flowchart TD
 
 ### 4.2 讨论与核对
 
-1. 先用业务语言说明当前单元要解决的问题与需求
-   再说明设计如何满足这些需求
-   涉及业务概念时，链接项目 `CONTEXT.md` 中的对应词条
-   说明概念的含义及其在当前设计中的作用
-2. 核对当前单元的设计
-   逐项核对文档组、文档设计与实际采用的 pattern 中适用于当前单元的检查条件
-   导读文档整体结构时，对照对应 Doc Design 讨论章节划分、内容归属与展开顺序
-   明确需要合并、拆分或重排的内容
+1. **用业务语言导读当前单元**
+   - 先说明当前单元要解决的问题与需求，再说明设计如何满足这些需求
+   - 涉及业务概念：链接项目 `CONTEXT.md` 中的对应词条，说明概念的含义及其在当前设计中的作用
+2. **核对组织与表达方式**
+   - 导读文档整体结构：对照对应文档设计说明章节划分、内容归属与展开顺序，提出需要合并、拆分或重排的内容
+   - 导读 Chapter 或 Section：对照对应文档设计的表达要求与 `~/.grok/skills/aca/doc-design/patterns/` 的适用场景，向开发者说明当前表达方式是否适合该内容，不默认沿用已有代码、表格或图
+   - 现有表达方式不合适：先向开发者提出替换、拆分或组合后的表达方式并读取所选 pattern，不顺着原有表达局部修补
+3. **逐项核对检查条件**
+   - 逐项核对文档组、文档设计与所选 pattern 中适用于当前单元的检查条件
 
    | 检查项 | 关注内容 |
    | --- | --- |
@@ -168,14 +171,14 @@ flowchart TD
    | 完整性 | 职责、行为、边界与异常处理的遗漏 |
    | 歧义与实现唯一性 | 多种合理解读、符合描述但行为不同的实现、尚未明确的设计决定 |
    | 冗余 | 重复维护、不增加信息的内容 |
-   | 表达 | 行文公理、对应文档设计与术语一致性 |
+   | 表达 | 表达方式选择与适配性、行文公理、对应文档设计与术语一致性 |
 
 ### 4.3 确认、修订与检查
 
-1. 请开发者确认当前单元的设计决定
+1. 请开发者确认当前单元的设计决定与表达方式调整
    开发者不理解或有异议时，澄清含义与依据
    尚未确认时，按[讨论与核对](#42-讨论与核对)继续讨论当前单元
-2. 存在已确认的调整时，按对应文档设计当场修订
+2. 存在已确认的调整时，按对应文档设计与所选 pattern 当场修订
    涉及章节调整时，同步更新受影响的引用与关联设计
 3. 修订后，重新执行受影响的检查条件与机械检查
    报告修正内容与检查结果
@@ -244,4 +247,5 @@ flowchart TD
 | --- | --- | --- |
 | 未完成 | 尚有未导读单元或缺少核验条件 | 补齐条件后，通过 `/aca-walkthrough` 继续本次导读 |
 | 未完成 | 设计方案在本轮无法确定 | `/aca-specify` 论证方案 |
-| 完成 | 当前范围导读完成 | 按已确认的安排，通过 `/aca-review` 审查设计 |
+| 完成 | 当前范围导读完成，且本轮设计涉及跨模块范围 | 通过 `/aca-review` 审查设计 |
+| 完成 | 当前范围导读完成，且本轮设计不涉及跨模块范围 | 直接进入后续流程（需要实施代码时进入 `/aca-implement`，仅改设计文档时衔接 `/aca-release`） |