用途:在 template-ts 代码库中执行系统化的预 PR 代码评审,优先识别关键风险,再报告主要与次要问题并给出具体修复建议。
主要能力:按类别检查 tRPC 模式、TanStack Router 与 Query 模式、代码去重(DRY)、代码质量与风格、安全、性能、测试,以及在范围内时检查 Effect 模式。可按需加载 trpc-patterns、tanstack-frontend、effect-ts、scan-effect-solutions 等相关技能。
使用方式:先确定评审范围,优先采用用户明确指定的文件、PR、提交或分支对比;未提供时默认用 git log -5 --oneline 与 git diff HEAD~5..HEAD --stat 推断近期提交。随后按 template-ts 类别清单扫描改动,对不确定的模式仅用 Exa、Context7 等外部查证工具确认;将发现按 Critical、Major、Minor 分级,输出报告,并运行仓库标准质量门禁,如 bun run check,或等价的 lint、typecheck、测试命令。
严重程度:Critical 含安全漏洞、SQL 注入或硬编码密钥、受保护端点缺少认证、公共 API 破坏性变更;Major 含错误的 tRPC v11 模式、N+1 查询、缺少预取导致页面加载慢、手动类型替代 RouterInputs/RouterOutputs、违反 DRY 的重复代码;Minor 含风格不一致、缺少文档、非关键重构机会。
测试期望:行为变更需测试,包括新增或变更业务逻辑、API 契约变更、查询/加载器行为变更、安全或授权逻辑变更、用户可见组件行为变更;仅文档、注释、无逻辑变更的机械重构可豁免,并在报告中说明理由。
限制:该技能针对 template-ts 仓库设计,其他技术栈适用性暂未提供;外部工具查证仅在本地证据不足时使用;价格、平台等未提供。