用途:在把任务标记为“完成”、把 ADR 从 in_progress 移到 completed、或声称“功能可用”之前,验证代码不仅存在,而且已接入系统并真正运行。核心公式为 COMPLETE = CREATION + CONNECTION + VERIFICATION,缺任一阶段即视为未完成。
主要能力:三阶段验证。创建阶段确认文件、测试、类型检查、lint 通过;连接阶段用 grep 确认模块被生产代码导入、函数有调用点、组件已注册(LangGraph 节点、CLI 命令、DI 容器、API 路由);验证阶段触发真实入口,检查日志、数据库或状态变化,确认行为正确。另提供四问测试:如何触发、什么把它接入系统、什么证据证明它运行、什么表明它工作正确。
使用方式:先运行质量门禁,如 uv run mypy src/、uv run ruff check .、uv run pytest tests/unit/ --no-cov -v;再用 grep 检查导入与调用点,例如 grep -r "from.*your_module import|import.your_module" src/ --include=".py" | grep -v test;随后触发入口并查日志,如 uv run temet-run -a talky -p "test command"、curl -X POST http://localhost:8000/api/endpoint -d '{"test": "data"}'。若存在 ./scripts/verify_integration.sh 可运行。
适用场景:新建 Python 模块、类或函数后;实现 LangGraph 节点、CLI 命令、API 端点后;排查“测试通过但功能不运行”“代码存在却无反应”“功能以前可用”等问题时。
限制:需要能读取源码、使用 grep 与 Bash,并了解项目入口与模块结构;工作目录应为项目根,源码在 src/、测试在 tests/。资料未提供具体安装命令、收费或平台信息。