用途:在将 ADR 移入 3_completed/、标记集成任务完成、宣称功能“完成”或为集成改动创建 PR 之前,强制验证组件确实被系统接入,而非只是被创建。核心原则为 CCV:COMPLETE = CREATION + CONNECTION + VERIFICATION,缺少任一阶段即不算完成。
主要能力:检测孤儿代码(存在但从未被导入);验证调用点(函数/类是否真的被调用);针对 LangGraph 节点、依赖注入服务、CLI 命令等做上下文相关集成检查;要求提供运行时证据(集成测试输出、执行日志、状态字段填充)。
使用方式:运行 ./scripts/verify_integration.sh 做孤儿检测;用 grep 检查导入与调用点,例如 grep -r "from.module_name import|import.module_name" src/ --include=".py" | grep -v test,以及 grep -r "function_name|ClassName" src/ --include=".py" | grep -v "^def |^class " | grep -v test;对 LangGraph 节点、DI 服务、CLI 命令分别执行资料中给出的 grep 检查;最后用四问测试确认触发入口、连接方式、运行证明与结果证明,并填写集成验证报告模板。
适用场景:集成类开发任务收尾、功能完成声明、PR 提交前的质量门禁。
限制:资料未提供脚本的具体实现、安装方式、支持语言范围与平台信息;示例命令以 Python 项目为主,其他技术栈需自行调整。无法回答四问或缺少运行时证据时,应判定为 BLOCKED。