用途:在构建基础设施时,验证它是否真正连接到系统并被实际使用,避免“写了代码但从未被调用”的死代码。核心理念是:基础设施不是代码写完就算完成,而是接入系统并投入使用才算完成。
主要能力与检查方法:
- 追踪执行路径,从用户意图一路跟到实际代码执行,例如用 grep -r "claude -p" src/ 和 grep -r "Task(" src/ 验证 Task 工具是否正确触发。
- 检查钩子是否注册,而不只是实现,例如 ls -la .claude/hooks/my-hook.sh 确认文件存在,再用 grep "my-hook" .claude/settings.json 确认已注册。
- 验证数据库连接,确保使用正确的后端,例如 grep -r "postgresql://" src/ 与 grep -r "sqlite:" src/,若架构要求 PostgreSQL 则不应出现 SQLite。
- 端到端测试,运行功能并确认基础设施被调用,例如添加调试日志 echo "DEBUG: DAG spawn invoked" >> /tmp/debug.log,触发 uv run python -m my_feature,再 cat /tmp/debug.log 验证。
- 搜索孤立实现,例如用 ast-grep --pattern 'async function $NAME() { $$$ }' 找出定义但从未被调用的函数。
完成前检查清单:已从入口点追踪到基础设施的执行路径;已确认钩子在 .claude/settings.json 中注册;已确认使用正确的数据库或后端;已运行端到端测试证明基础设施被调用;已搜索死代码或并行实现;已核对配置文件与实现一致。
应避免:未测试执行路径就标记“完成”;仅因代码存在就假设已接入;构建并行系统(如 Task 工具与 claude -p spawn 并存);使用错误后端(架构要求 PostgreSQL 却用 SQLite);跳过端到端测试(“能编译”不等于“能运行”)。
适用场景:构建或审查基础设施、钩子、任务图、数据库接入等需要确认真正生效的工程环节。限制:资料未提供具体安装方式、平台支持、收费信息或更多使用步骤。