name: testability-refactoring-workflow
description: Systematically refactor complex C/C++ projects to improve testability. Use when asked to refactor legacy code, establish test baselines, analyze project structure, improve code testability, add unit tests to existing codebase, or when working with complex C/C++ projects that lack proper test coverage. This workflow guides through baseline setup, project analysis, prioritization, and iterative refactoring phases.
compatibility: Designed for Claude Code. Requires C/C++ development environment with build tools (gcc, g++, cmake, make), testing frameworks (Google Test), and static analysis tools (clang-tidy, cppcheck).

可测试性重构工作流 - Agent 入口

读取指令：这是 Agent 执行可测试性重构的总入口。根据当前工程状态，选择对应路径执行。

快速决策树

按以下顺序回答问题，根据第一个"否"的回答选择对应阶段：

决策规则：从 Q1 开始，遇到第一个"否"即进入对应阶段；全部为"是"则进入 Phase 04。

判断依据

Q1: 如何判断"门禁基线已建立"？

检查以下条件是否全部满足：

• [ ] 存在可执行的构建命令，且能稳定编译核心 target
• [ ] 存在 tests/ 目录结构
• [ ] 存在一键测试脚本（如 ./tools/test.sh）
• [ ] 测试运行器能执行并返回 0

全部满足 → 基线已建立
任一不满足 → 需执行 Phase 01

Q2: 如何判断"工程分析已完成"？

检查以下文档是否存在且内容完整：

• [ ] docs/architecture/module_map.md 存在且覆盖主要模块
• [ ] 每个模块有职责、边界、依赖类型描述
• [ ] 编译体系已文档化

全部满足 → 分析已完成
任一不满足 → 需执行 Phase 02

Q3: 如何判断"优先级队列已建立"？

检查以下条件：

• [ ] docs/testing/backlog.md 存在
• [ ] 包含至少 10 个可执行切片
• [ ] 每个条目有 S1-S4 评估和 L1-L3 策略

全部满足 → 队列已建立
任一不满足 → 需执行 Phase 03

核心文档索引

定义文档（按需查阅）

阶段文档（按序执行）

技能文档（按需加载）

注意：不要预先阅读所有 Skill 文档，仅在阶段文档指示时加载对应 Skill。

模板文档

决策文档

执行原则

1. 最小上下文原则：仅加载当前步骤需要的文档
2. 验收驱动：每个 Skill 执行完必须验证验收标准
3. 状态持久化：完成阶段/Skill 后更新相关状态文档
4. 失败快速回滚：门禁失败时立即进入对应处理流程

立即开始

请根据上方决策树判断当前工程状态，然后进入对应阶段文档开始执行。