agent-whole-qa

Files (6)

• SKILL.md
• openai.yaml · agents/
• assertions.md · references/
• inventory.md · references/
• report-template.md · references/
• whole-qa.workflow.js · references/

SKILL.md (first lines)

# agent-whole-qa — 全量验收 + 修复闭环编排器

> **与 `qa` agent 的关系**：`qa` 是「单模块测一次」的原子能力；本 skill 是「全模块 × 多轮 + 修复回环」的编排层，**复用 `qa`，不重写测试逻辑**。
> **与 `agent-mvp` 的关系**：`agent-mvp` 每阶段用 `qa` 做增量验收；本 skill 用于 **MVP 收口前的一次性全量清算**。
> **运行中零提问**：ESCALATE、视觉规格错、未收敛都不中途问人，记账后照跑能跑的部分，结尾按 `../cc-code/references/dev-qa-loop.md` §九 的交人报告格式一次交人（本命令只借用该节的挂起与交人报告，不适用单段回环）。
> **主控是编排者，不扮演任何角色**：派哪个 agent 就是哪个角色（权限唯一出处 = `active/Agent.md` §三）。主控的写权限见 `active/Agent.md` §一；清点与汇总记账、`gates.md`、`docs/qa/**`、视觉测试与截图基线全归 qa，修复归 dev。

## ⛔ 六条硬约束（违反任一即本次验收无效）

### 1. 你是编排器，不是执行者
```
❌ 错：agent-whole-qa 自己测、自己修
        → 测的人知道修的人怎么想，修的人知道测的人怎么测 → 互相糊弄
✅ 对：agent-whole-qa 只做 清点 / 分发 / 汇总 / 循环控制

    agent-whole-qa（不碰代码，不碰需求，不碰验收记录）
       ├─ Agent(subagent_type=qa)  ──► 清点 / 测 / 汇总记账（测的时候只拿到断言，不知道谁会修）
       └─ Agent(subagent_type=dev) ──► 修（只拿到 FAIL 清单，不知道怎么测的）
```
主控**绝不**自己写测试、自己改代码。发现自己在写 `expect(...)` 或改 `src/` 就是越界了。

### 2. 分母先锁定，再开测
INVENTORY 阶段的产物落盘后**本轮分母不可变更**。禁止中途以「这个按钮不用测」「这个接口是内部的」为由缩小分母。要改分母，只能作废本轮重新开始。

```
全量分母固定为五个基础分母 + 一个视觉组合子行：
  断言 A / 页面五态 U / 可交互元素 E / 接口 / 视觉 V 行
  └─ 视觉组合子行 = V 行 × 视口集合 × 亮暗        ← 只记组合覆盖，⛔ 不乘进 V 行分母

  视觉分母口径（唯一出处 = skills/cc-code/references/ui-gates.md §8.2）
    全量轮：V0.02 全站 + 每页每适用组 + 全站性能 V0.09
    V0.01（设计数值）只在锁定前复核出，全量轮不出
    ⛔ V 行不按「视口 × 亮暗」乘开；屏宽与亮暗写证据列
```

### 3. 禁止修需求，也禁止动尺子
```
本 skill 及其派生的 dev subagent 对以下文件【只读，绝对禁写】：
    active/prd.md      active/ux.md      active/api.md
    active/design.md   ← 视觉数值（V 段判词的尺子）
    .cc-code/test/visual/**          ← 视觉测试与基线（qa 独占写）
    .cc-code/test/visual/baseline/** ← 截图基线与允许值集合
修不动 → 标记 ESCALATE，进结尾交人报告（§九）
```
> 这是 AI 修 bug 时最常走的偷懒路径：改断言 / 改基线让测试变绿。不用规则堵死，它一定会走。⛔ 主控不代写 `design.md`、不代为更新基线。

### 4. 收敛门控
```
第 N 轮 FAIL 数 必须 < 第 N-1 轮 FAIL 数
  ├─ 不递减        → 停止，报告「未收敛」，出交人报告（§九）
  ├─ 出现新增 FAIL → 停止（修 A 坏 B），报告震荡点，建议回滚本轮
  └─ 最多 3 轮
```

### 5. 回归门（每轮必跑）
```
每轮修完，重跑范围 = 本轮 FAIL 项  +  affected 算出的真实影响面
                                    ↑ 缺这半段就会「越修越坏」而毫不知情

  ⭐0.10.0：影响面从「同模块已 PASS 项」升级为 codegraph affected 算出的
  传递闭包 —— 同模块是人凭直觉画的圈，affected 是沿 import 图算出的事实，
  跨模块的隐式依赖只有后者抓得到。

  codegraph affected <本轮修改的源文件...>
    非 .spec/.test 命名的测试补跑 --filter "<project.md §六 登记的 glob>"
    返回空 → 报一行「未匹配到测试，本轮用全量」+ 自查三点：
             ① 测试代码是否被 .gitignore 屏蔽（被 ignore 则不进索引）
             ② 测试是否 import 被测源码（纯 HTTP 型无 import 边，追不到）
             ③ 命名是否需 --filter
    CLI 未装 → 静默退回「同模块已 PASS 项」，不报
```

**视觉回归的追加规则**（阈值与基线纪律唯一出处 = `skills/cc-code/references/ui-gates.md` §五、§七）：

```
视觉项重跑 ──► 只比 project.md §六 登记的基线目录，按登记容差判
              整页像素差 >1% / 组件局部 >0.5% → 判回归（本项 FAIL）
              颜色每通道 ±2；圆角 / 阴影 / 间距 ±0.5px；字号 ±0.5px

失败轮 ──► ⛔ 禁止冻结基线、⛔ 禁止更新基线、⛔ 禁止改阈值
           本轮范围内的新页 / 改版页差异 → 只列候选，标「主人未目视」
           本轮范围外的差异 → 判回归，⛔ 不得当成「顺手更新基线」

未冻结基线 / 无基线的新页 ──► VH-09.07 标 UNVERIFIABLE、不进分母；只列候选
```

### 6. 禁止静默截断
未测的元素/接口/断言，必须逐条列入 `SKIPPED` 并给原因。同构重复元素若做了组内抽样，必须写明「同构组 N 个，实测 M 个」—— **报告里出现「全部覆盖」而分母被悄悄缩小，是最严重的失职**。视觉组的未测项同样逐条列原因（组不适用不等于不用记）。

## 👁 视觉判定的唯一口径（第四层）

```
 视觉层（第四层）判词怎么来
   ├─ 机器检查 ── Playwright 测试 / axe / 截图比对 / Lighthouse 命令行
   │     └─► VH（阻断）/ VM（次要）──► gates.md §2.4 V 段 ──► 唯一判词来源
   ├─ 视觉模型看图（qa 的多模态能力）──► 只作 VS 线索 ──► 合集板
   │     └─► ⛔ 不写 VH / VM、⛔ 不阻断、⛔ 不进分母
   └─ 无基线 / 无门命令 / 无驱动工具 ──► 标 UNVERIFIABLE，记进交人报告（§九），⛔ 不静默通过
```
> 规则号（`VH` / `VM` / `VS`）、组码、阈值、允许值集合、基线纪律的唯一出处 = `skills/cc-code/references/ui-gates.md`；本 skill 只编排，⛔ 不复述规则内容。

---

## 生命周期总览

```
┌ ⓿ PREFLIGHT 前置检查 ─────────────────────────────────────────────┐
│   .cc-code/ 存在 · prd.md 有模块清单与验收断言 · 应用能起来          │
│   视觉门：status.md「风格：」= 已锁（或「无前端」）                   │
│   project.md §六 有视觉门命令 / 测试位置 / 基线目录 / 视口 / 亮暗     │
│   组件陈列页存在且未上线 · 可用浏览器工具恰好一套（browserTool）      │
└───────────────────────┬────────────────────────────────────────────┘
                        ▼
┌ ❶ INVENTORY 清点（派 qa 做，只做一次，落盘即锁死分母）────────────┐
│   路由发现 → 页面 P[]                                            │
│   ux.md 各页元素清单(<页章号>.4) ∪ DOM snapshot → E[] ⭐并集,差集必报 │
│   接口发现 → 接口 A[]                                            │
│   prd.md §1.5 主表 → 断言 ASSERT[]                               │
│   ux.md 各页五态矩阵（<页章号>.3）→ 五态判定项 USTATE[]             │

From weiyi88/cc-code, MIT.

More from weiyi88/cc-code