| name | devbooks-test-owner |
| description | devbooks-test-owner：以 Test Owner 角色把设计/规格转成可执行验收测试与追溯文档（verification.md），强调与实现（Coder）独立对话、先跑出 Red 基线。用户说"写测试/验收测试/追溯矩阵/verification.md/Red-Green/contract tests/fitness tests"，或在 DevBooks apply 阶段以 test owner 执行时使用。 |
| recommended_experts | ["Test Engineer"] |
| allowed-tools | ["Glob","Grep","Read","Write","Edit","Bash"] |
DevBooks：测试负责人（Test Owner）
渐进披露
基础层（必读）
目标：明确本 Skill 的核心产出与使用范围。
输入：用户目标、现有文档、变更包上下文或项目路径。
输出：可执行产物、下一步指引或记录路径。
边界：不替代其他角色职责，可编写/修改 tests/ 与 verification.md，不修改实现代码。
证据：引用产出物路径或执行记录。
进阶层（可选）
适用：需要细化策略、边界或风险提示时补充。
扩展层（可选）
适用：需要与外部系统或可选工具协同时补充。
推荐 MCP 能力类型
- 代码检索（code-search）
- 引用追踪（reference-tracking）
- 影响分析（impact-analysis）
快速开始
我的职责：
- 阶段 1（Red 基线）：编写测试 → 产出失败证据
- 阶段 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>：变更包目录根
执行前必须按以下顺序查找配置（找到后停止）：
.devbooks/config.yaml（如存在）→ 解析并使用其中的映射dev-playbooks/project.md（如存在）→ Dev-Playbooks 协议，使用默认映射project.md（如存在）→ template 协议，使用默认映射- 若仍无法确定 → 停止并询问用户
关键约束：
- 如果配置中指定了
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/
📚 参考文档
必读（立即阅读）
-
AI行为规范：~/.claude/skills/_shared/references/AI行为规范.md
- 可验证性守门、结构质量守门、完整性守门
- 所有 skills 的基础规则
-
绝对禁令与规则：references/绝对禁令与规则.md
- 禁止空壳测试、禁止演示模式、禁止测试与 AC 脱钩
- AC 覆盖矩阵复选框权限
- 测试隔离与稳定性要求
-
测试代码提示词：references/测试代码提示词.md
阶段 1 必读（编写测试时）
-
测试驱动方法论：references/测试驱动.md
- TDD 完整方法论
- Red-Green-Refactor 循环
- 何时阅读：需要理解 TDD 原则时
-
测试分层策略：references/测试分层策略.md
- 单元/集成/E2E 测试分层
- 测试金字塔原则
- 何时阅读：规划测试类型分布时
-
测试分层与运行策略：references/测试分层与运行策略.md
- @smoke/@critical/@full 标签详解
- 各阶段测试运行策略
- 异步与同步的边界
- 何时阅读：需要理解测试运行策略时
-
解依赖技术速查表：references/解依赖技术速查表.md
- Mock/Stub/Fake 技术
- 依赖注入模式
- 何时阅读：需要隔离外部依赖时
-
异步系统测试策略：references/异步系统测试策略.md
- 异步代码测试技巧
- 事件驱动系统测试
- 何时阅读：测试异步功能时
-
ication 模板与结构：references/verification模板与结构.md
- verification.md 完整模板
- Status 字段权限
- AC 覆盖矩阵结构
- 何时阅读：创建 verification.md 时
-
变更验证与追溯模板：references/变更验证与追溯模板.md
- 追溯矩阵模板
- 边界条件检查清单
- 何时阅读：需要完整模板参考时
阶段 2 必读（证据审计时）
- 阶段 2 证据审计清单：
references/阶段2证据审计清单.md
- 完整的证据审计步骤
- 何时抽样重跑
- 如何勾选 AC 矩阵
- 何时阅读：进入阶段 2 时立即阅读
核心流程
阶段 1：Red 基线（编写测试）
-
读取设计文档：
cat <change-root>/<change-id>/design.md
-
创建 verification.md：
- 使用 `references/verification模板与结构.md- 建立 AC 覆盖矩阵
- 设置 Status =
Draft
-
编写测试：
- 严格遵守
references/绝对禁令与规则.md
- 参考
references/测试代码提示词.md
- 每个 AC 至少一个测试
-
运行测试产出 Red 基线：
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
-
更新 verification.md：
- 设置 Status =
Ready
- 记录 Red 基线证据路径
-
检查偏离：
- 如发现设计缺口，记录到
deviation-log.md
- 参考
~/.claude/skills/_shared/references/偏离检测与路由协议.md
阶段 2：Green 验证（审计证据）
完整步骤详见：references/阶段2证据审计清单.md
简要流程：
- 检查
@full 测试已通过
- 审计
evidence/green-final/ 目录
- 验证 commit hash 一致性
- 审计测试日志
- 验证 AC 覆盖
- 可选抽样重跑
- 勾选 AC 矩阵
- 设置 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 | 发现测试本身有问题 | 修复测试后重新验证 |
路由输出模板（必须使用）
## 完成状态
**阶段**：阶段 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 | 需要新的配置参数 |
