devbooks-test-owner

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. 阶段 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. 读取设计文档：

   # 读取 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 基线：

   # 只跑新写的测试（增量）
   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	发现测试本身有问题	修复测试后重新验证

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

## 完成状态

**阶段**：阶段 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	需要新的配置参数