用途:wiring-audit 是用户触发的审计技能,用于比对项目前端消费面(UI 按钮、组件、hooks、fetch 调用、tRPC 客户端调用、GraphQL 查询、server actions)与后端生产能力(路由处理器、hook 导出、tRPC 路由、GraphQL resolver、导出的异步函数),把每处不匹配报告为按优先级排序、双端带引用的发现。其核心假设是:每个 UI 消费应恰好对应一个后端生产,每个生产都应被某处消费;孤儿、漂移与缺口即失败模式。适用于接线/漂移审计、识别未使用端点或 hooks、验证后端能力是否暴露到 UI、验证 UI 是否接线、前后端契约违规检测、过期标签检测。不适用于描述性架构快照、安全审查、性能审计、测试覆盖率审计。
主要能力与流程:分六阶段。一是范围界定,确定目标(整仓、monorepo 前后端路径对或单一全栈项目),检测技术栈,输出根目录为 docs/audits/<YYYY-MM-DD>/,可复用既有架构分析报告作为先验。二是并行派发两个子代理(general-purpose、sonnet),分别枚举 UI 消费集与后端生产集,均返回 YAML 注册表。三是由编排者做漂移检测:按 (kind, identifier) 建映射、计算集合差(两侧孤儿),对匹配对做形状/方法/鉴权/校验比较,生成候选发现并归类到 8 类。四是按 rubric 分配严重度:broken、drifted、stale、gap,并说明覆盖规则。五是验证每条发现的引用可解析(用 codanna 或 grep + Read),无法解析的丢弃并记入丢弃日志。六是渲染报告。
使用方式与产物:报告写入 docs/audits/<date>/report.md,原始注册表保存为 registries/surfaces.yaml 与 registries/capabilities.yaml;可选生成 wiring.mmd,并运行 bash scripts/render.sh docs/audits/<date>/ 生成 wiring.svg。资源包括 audit-protocol、surface-enumeration、capability-enumeration、drift-detection、finding-categories、react-patterns、report-template 等参考文档,以及 render.sh、verify-findings.sh 脚本。
限制:设计上通用但针对 React 优化,非 React 目标的前端侧信号目录更稀疏,需提前告知用户 UI 侧检测受限。严格引用策略要求每条发现两侧都带 path:line 引用,孤儿发现以 grep 证据替代;验证协议会对每条缺失断言做 grep 检查。已明确说明“与历史对比”属未来 v2 功能。官方资料未提供收费、价格、平台与具体效果信息。