# Devbooks Test Owner

> devbooks-test-owner：以 Test Owner 角色把设计/规格转成可执行验收测试与追溯文档（verification.md），强调与实现（Coder）独立对话、先跑出 Red 基线。用户说"写测试/验收测试/追溯矩阵/verification.md/Red-Green/contract tests/fitness tests"，或在 DevBooks apply 阶段以 test owner 执行时使用。

- Skill: `majiayu000/devbooks-test-owner` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/devbooks-test-owner`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/devbooks-test-owner/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/devbooks-test-owner

---


# DevBooks：测试负责人（Test Owner）

## 渐进披露
### 基础层（必读）
目标：明确本 Skill 的核心产出与使用范围。
输入：用户目标、现有文档、变更包上下文或项目路径。
输出：可执行产物、下一步指引或记录路径。
边界：不替代其他角色职责，可编写/修改 tests/ 与 verification.md，不修改实现代码。
证据：引用产出物路径或执行记录。

### 进阶层（可选）
适用：需要细化策略、边界或风险提示时补充。

### 扩展层（可选）
适用：需要与外部系统或可选工具协同时补充。

## 推荐 MCP 能力类型
- 代码检索（code-search）
- 引用追踪（reference-tracking）
- 影响分析（impact-analysis）

## 快速开始

我的职责：
1. **阶段 1（Red 基线）**：编写测试 → 产出失败证据
2. **阶段 2（Green 验证）**：审计证据 → 勾选 AC 矩阵

## 双阶段职责

| 阶段 | 触发时机 | 核心职责 | 测试运行方式 | 产出 |
|------|----------|----------|--------------|------|
| **阶段 1：Red 基线** | design.md 完成后 | 编写测试、产出失败证据 | 运行本次新增/变更的验收锚点 | verification.md（含追溯矩阵）、Red 基线 |
| **阶段 2：Green 验证** | Coder 完成后 | 审计 Green 证据、更新追溯矩阵勾选 | 默认不重跑；必要时抽样重跑 | 追溯矩阵更新、Green 证据引用 |

## 角色隔离（强制）

- Test Owner 与 Coder 必须独立对话/独立实例。
- 本 Skill 只产出 tests/ 与 verification.md，不修改实现代码。

---

## 前置：配置发现

- `<truth-root>`：当前真理目录根
- `<change-root>`：变更包目录根

执行前**必须**按以下顺序查找配置（找到后停止）：
1. `.devbooks/config.yaml`（如存在）→ 解析并使用其中的映射
2. `dev-playbooks/project.md`（如存在）→ Dev-Playbooks 协议，使用默认映射
3. `project.md`（如存在）→ template 协议，使用默认映射
4. 若仍无法确定 → **停止并询问用户**

**关键约束**：
- 如果配置中指定了 `agents_doc`（规则文档），**必须先阅读该文档**再执行任何操作
- 禁止猜测目录根

## 产物落点

- 测试计划与追溯：`<change-root>/<change-id>/verification.md`
- 测试代码：按仓库惯例（例如 `tests/**`）
- Red 基线证据：`<change-root>/<change-id>/evidence/red-baseline/`
- Green 证据：`<change-root>/<change-id>/evidence/green-final/`

---

## 📚 参考文档

### 必读（立即阅读）

1. **AI行为规范**：`~/.claude/skills/_shared/references/AI行为规范.md`
   - 可验证性守门、结构质量守门、完整性守门
   - 所有 skills 的基础规则

2. **绝对禁令与规则**：`references/绝对禁令与规则.md`
   - 禁止空壳测试、禁止演示模式、禁止测试与 AC 脱钩
   - AC 覆盖矩阵复选框权限
   - 测试隔离与稳定性要求

3. **测试代码提示词**：`references/测试代码提示词.md`
   - 完整的测试编写指南
   - 严格按此提示词执行

### 阶段 1 必读（编写测试时）

4. **测试驱动方法论**：`references/测试驱动.md`
   - TDD 完整方法论
   - Red-Green-Refactor 循环
   - 何时阅读：需要理解 TDD 原则时

5. **测试分层策略**：`references/测试分层策略.md`
   - 单元/集成/E2E 测试分层
   - 测试金字塔原则
   - 何时阅读：规划测试类型分布时

6. **测试分层与运行策略**：`references/测试分层与运行策略.md`
   - @smoke/@critical/@full 标签详解
   - 各阶段测试运行策略
   - 异步与同步的边界
   - 何时阅读：需要理解测试运行策略时

7. **解依赖技术速查表**：`references/解依赖技术速查表.md`
   - Mock/Stub/Fake 技术
   - 依赖注入模式
   - 何时阅读：需要隔离外部依赖时

8. **异步系统测试策略**：`references/异步系统测试策略.md`
   - 异步代码测试技巧
   - 事件驱动系统测试
   - 何时阅读：测试异步功能时

9. **ication 模板与结构**：`references/verification模板与结构.md`
   - verification.md 完整模板
   - Status 字段权限
   - AC 覆盖矩阵结构
   - 何时阅读：创建 verification.md 时

10. **变更验证与追溯模板**：`references/变更验证与追溯模板.md`
    - 追溯矩阵模板
    - 边界条件检查清单
    - 何时阅读：需要完整模板参考时

### 阶段 2 必读（证据审计时）

11. **阶段 2 证据审计清单**：`references/阶段2证据审计清单.md`
    - 完整的证据审计步骤
    - 何时抽样重跑
    - 如何勾选 AC 矩阵
    - 何时阅读：进入阶段 2 时立即阅读

---

## 核心流程

### 阶段 1：Red 基线（编写测试）

1. **读取设计文档**：
   ```bash
   # 读取 design.md 和 AC
   cat <change-root>/<change-id>/design.md
   ```

2. **创建 verification.md**：
   - 使用 `references/verification模板与结构.md- 建立 AC 覆盖矩阵
   - 设置 Status = `Draft`

3. **编写测试**：
   - 严格遵守 `references/绝对禁令与规则.md`
   - 参考 `references/测试代码提示词.md`
   - 每个 AC 至少一个测试

4. **运行测试产出 Red 基线**：
   ```bash
   # 只跑新写的测试（增量）
   npm test -- --grep "AC-001|AC-002"

   # 保存失败证据
   npm test 2>&1 | tee <change-root>/<change-id>/evidence/red-baseline/test-$(date +%Y%m%d-%H%M%S).log
   ```

5. **更新 verification.md**：
   - 设置 Status = `Ready`
   - 记录 Red 基线证据路径

6. **检查偏离**：
   - 如发现设计缺口，记录到 `deviation-log.md`
   - 参考 `~/.claude/skills/_shared/references/偏离检测与路由协议.md`

### 阶段 2：Green 验证（审计证据）

**完整步骤详见**：`references/阶段2证据审计清单.md`

简要流程：
1. 检查 `@full` 测试已通过
2. 审计 `evidence/green-final/` 目录
3. 验证 commit hash 一致性
4. 审计测试日志
5. 验证 AC 覆盖
6. 可选抽样重跑
7. 勾选 AC 矩阵
8. 设置 Status = `Verified`

---

## 输出管理

防止大量输出污染 context：

| 场景 | 处理方式 |
|------|----------|
| 测试输出 > 50 行 | 只保留首尾各 10 行 + 失败摘要 |
| Red 基线日志 | 落盘到 `evidence/red-baseline/`，对话中只引用路径 |
| Green 证据日志 | 落盘到 `evidence/green-final/`，对话中只引用路径 |
| 大量测试用例列表 | 用表格摘要，不要逐条贴出 |

---

## 上下文感知

本 Skill 在执行前自动检测上下文，确保角色隔离和前置条件满足。

检测规则参考：`~/.claude/skills/_shared/上下文检测模板.md`

### 本 Skill 支持的模式

| 模式 | 触发条件 | 行为 |
|------|----------|------|
| **首次编写** | `verification.md` 不存在 | 创建完整验收测试套件 |
| **补充测试** | `verification.md` 存在但有 `[TODO]` | 补充缺失的测试用例 |
| **Red 基线验证** | 测试存在，需要确认 Red 状态 | 运行测试并记录失败日志 |
| **证据审计** | 用户说"验证/打勾"且 Green 证据已产出 | 审计证据并勾选 AC 矩阵 |

---

## 完成状态与下一步路由

### 阶段 1 完成状态

| 状态码 | 状态 | 判定条件 | 下一步 |
|:------:|------|----------|--------|
| ✅ | PHASE1_COMPLETED | Red 基线产出，无偏离 | 交接给 Coder（新对话/独立实例） |
| ⚠️ | PHASE1_COMPLETED_WITH_DEVIATION | Red 基线产出，deviation-log 有未回写记录 | `devbooks-design-doc` |
| ❌ | BLOCKED | 需要外部输入/决策 | 记录断点，等待用户 |
| 💥 | FAILED | 测试框架问题等 | 修复后重试 |

### 阶段 2 完成状态

| 状态码 | 状态 | 判定条件 | 下一步 |
|:------:|------|----------|--------|
| ✅ | PHASE2_VERIFIED | 证据审计通过，AC 矩阵已打勾 | `devbooks-reviewer` |
| ⏳ | PHASE2_WAITING | 全量测试仍在运行或 Green 证据未完备 | 等待 CI 完成 |
| ❌ | PHASE2_FAILED | 全量测试未通过或 Green 证据存在失败 | 通知 Coder 修复 |
| 🔄 | PHASE2_HANDOFF | 发现测试本身有问题 | 修复测试后重新验证 |

### 路由输出模板（必须使用）

```markdown
## 完成状态

**阶段**：阶段 1（Red 基线）/ 阶段 2（Green 验证）

**状态**：✅ PHASE1_COMPLETED / ✅ PHASE2_VERIFIED / ...

**Red 基线**：已产出 / 未完成（仅阶段 1）

**全量测试（如 CI）**：已通过 / 运行中 / 失败（仅阶段 2）

**证据审计**：已完成 / 待审计（仅阶段 2）

**AC 矩阵**：已打勾 N/M / 未打勾（仅阶段 2）

**偏离记录**：有 N 条待回写 / 无

## 下一步

**推荐**：`devbooks-coder`（新对话/独立实例）/ `devbooks-xxx skill`

**原因**：[具体原因]
```

---

## 偏离检测与落盘

**参考**：`~/.claude/skills/_shared/references/偏离检测与路由协议.md`

在编写测试过程中，**必须立即**将以下情况写入 `deviation-log.md`：

| 情况 | 类型 | 示例 |
|------|------|------|
| 发现 design.md 未覆盖的边界情况 | DESIGN_GAP | 并发写入场景 |
| 发现需要额外的约束 | CONSTRAINT_CHANGE | 需要添加参数校验 |
| 发现接口需要调整 | API_CHANGE | 需要增加返回字段 |
| 发现配置项需要变更 | CONSTRAINT_CHANGE | 需要新的配置参数 |