用途:这是一个针对 TanStack Start + TypeScript Web 应用改动的合并门禁,输出客观的 PASS/FAIL 裁决而非建议性反馈。适用于 Start 的功能、路由或服务端函数即将合并时;由 AI 代理编写代码后需要独立检查时;diff 触及客户端/服务端边界(环境变量、loader、服务端函数、鉴权)时;或按当前 v1 RC API 审计既有代码库时。不适用于非 Start 的 React 应用,或用户想要解释与重构而非裁决的场景。
主要能力:规则绑定 @tanstack/react-start 1.168+(v1 RC)与 TypeScript 5.8–6.x 语义,分为六类:客户端/服务端边界(boundary-)、服务端函数与路由(serverfn-)、鉴权与安全(sec-)、SSR 与数据加载(ssr-)、边界类型安全(types-)、编译器配置(tscfg-)。可识别过时 API,如 .inputValidator()、已移除的 createServerFileRoute。
使用方式:先明确评审目标(diff、文件集或 PR),记录 ref 与路径,始终纳入 tsconfig.json、src/router.tsx、src/start.ts(若存在);读取 references/_sections.md 及 references/ 下全部规则文件;用 references/reviewer-prompt.md 组装完全自包含的评审提示;派发单个盲评 Task 子代理;按失败关闭原则渲染裁决,填 assets/templates/verdict.md。
规则与裁决:每条规则返回 PASS | FAIL | N/A,并须附证据(file:line 或引用,PASS 与 FAIL 均需);FAIL 须给出可落地的修复(具名改动加位置)。整体仅当全部规则 PASS 或 N/A 时为 PASS,任一 FAIL 即失败,不做平均、不按严重度加权、不豁免。若同一规则在目标未变时反复改变裁决,或人工推翻裁决,应视为规则可判定性缺陷,记入 gotchas.md 并锐化规则,而非绕开门禁。参考文件包括 reviewer-prompt.md、verdict.md、_sections.md、metadata.json。安装命令与详细用法资料暂未提供。