code-validation 是 auldsyababua/instructor-workflow 下的一个自动化代码验证技能，用于 diff 审查、变更卫生检查和红旗检测。适用场景包括：Action Agent 完成实现后、批准合并前、审查 diff 红旗时，以及最终验证阶段。
它先运行确定性脚本做快速检查，再进行 LLM 启发式评估。脚本位于 scripts/diff_analyzer.py 和 scripts/static_analyzer.py，扫描类别涵盖测试禁用、密钥泄露、路径可移植性、危险安全标志、大量删除、依赖变更等。
常用命令示例： python scripts/diff_analyzer.py --base main --format json python scripts/diff_analyzer.py --range HEAD~5..HEAD --format json python scripts/static_analyzer.py src/app.py src/utils.py --format json python scripts/static_analyzer.py ./src --exclude node_modules .git --format json
脚本输出 JSON，包含 commit_range、files_scanned、files_changed、total_findings、findings_by_severity、findings 与 summary。每条 finding 含 category、severity、file、line、pattern、context、message。严重级别分 CRITICAL、HIGH、MEDIUM、LOW：密钥、文档中的用户特定路径属 CRITICAL，须立即阻止合并；测试禁用、安全标志、代码中的用户特定路径属 HIGH，须修复。
LLM 启发式审查覆盖脚本无法检测的语义问题，包括测试断言弱化、过宽 try/catch 是否合理、范围蔓延与合法重构的区分、架构一致性（对照 ADR 和 .project-context.md）。之后生成验证报告，给出 APPROVED、CHANGES REQUIRED 或 BLOCKED 结论及带 file:line 的待办项。
限制：脚本是确定性文本/模式匹配，无法判断语义；上下文相关判断依赖 LLM 人工评审；存在 CRITICAL 或多项 HIGH 时应阻止合并，修复后需重新验证。文档中未提供价格、平台要求或安装步骤。