Devbooks Test Owner

DevBooks：测试负责人（Test Owner）

渐进披露

基础层（必读）

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

进阶层（可选）

适用：需要细化策略、边界或风险提示时补充。

扩展层（可选）

适用：需要与外部系统或可选工具协同时补充。

推荐 MCP 能力类型

• 代码检索（code-search）
• 引用追踪（reference-tracking）
• 影响分析（impact-analysis）

快速开始

我的职责：

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

双阶段职责

角色隔离（强制）

• 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：

上下文感知

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

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

本 Skill 支持的模式

完成状态与下一步路由

阶段 1 完成状态

阶段 2 完成状态

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

## 完成状态

**阶段**：阶段 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：

Converted and distributed by TomeVault — claim your Tome and manage your conversions.