Everything Claude Code TypeScript Reviewer Agent 是一款面向 TypeScript/JavaScript 代码的专业审查代理，专注于类型安全、异步正确性、Node/Web 安全与惯用模式。它能自动识别变更范围、执行严格的类型与安全检查，并输出结构化审查结论，是生产级 AI 编程流程中不可或缺的质量门控工具。本文将详解其使用场景、能力边界、触发机制、与其他 Agent 的协作方式，并通过完整对话示例说明如何高效集成到开发流程中。

Everything Claude Code TypeScript Reviewer Agent：类型安全、async 正确性与 Node/Web 安全惯用法审查

在现代 TypeScript/JavaScript 项目中，单靠 LLM 问答往往难以保证类型安全、异步正确性与安全惯用法的系统性落地。Everything Claude Code TypeScript Reviewer Agent（以下简称 typescript-reviewer）正是为此而生：它是 ECC 插件体系下专为 TypeScript/JavaScript 生态打造的专业代码审查代理，内置业界一线的安全、类型、异步与风格审查标准，能自动适配 PR、分支、Staged 变更等多种工作流场景，成为生产级开发流程的质量守门人。

1. 解决什么问题：为什么要用专门的 TypeScript Reviewer Agent？

直接让 Claude 或其他 AI 助手“帮忙看看代码”时，常见痛点有：

• 上下文不精准：AI 不总能自动聚焦于本次变更的核心代码，容易遗漏关键 diff 或误判审查范围。
• 审查标准不统一：每次提问的标准随人随意，难以保证安全、类型、异步等高优先级问题始终被系统性检查。
• 无法自动适配 CI/PR 流程：普通对话无法感知 PR 状态、分支合并情况、CI 检查等真实工程环境约束。
• 输出不结构化：AI 回答往往是“建议”或“感受”，缺乏明确的阻断/警告/通过结论，难以自动化集成。

而 typescript-reviewer 作为 ECC Agent，具备以下独特优势：

• 自动识别变更范围：能根据 PR、分支、staged 文件、单次 commit 等多种上下文自动定位需要审查的 TypeScript/JavaScript 代码。
• 执行严格的类型与安全检查：内置 TypeScript 检查、ESLint、常见安全风险（如 XSS、SQL 注入、原型污染、硬编码密钥等）与异步错误（如未捕获 promise、async/forEach 混用等）专项清单。
• 输出结构化结论：根据 CRITICAL/HIGH/MEDIUM 问题分级，明确给出“Approve/Warning/Block”判定，方便自动化流转。
• 与其他 Agent 协作：可与 code-reviewer、security-reviewer、tdd-guide 等协同，覆盖从功能正确性到安全、测试、架构的全流程质量门控。

如需了解 ECC Agent 的整体体系与理念，推荐阅读 Everything Claude Code 完全指南。

2. 具体能力：typescript-reviewer 能做什么、不能做什么？

能做什么

1. 变更感知与范围识别

   • 自动检测当前 PR、分支、staged 文件或最近 commit 的 TypeScript/JavaScript 变更。
   • 支持本地和远程（如 GitHub PR）多种上下文，无需手动指定文件列表。

2. 类型与静态检查

   • 自动运行 npm run typecheck（如有定义），否则智能选择覆盖变更文件的 tsconfig 执行 tsc --noEmit -p ...。
   • 检查类型安全、any 滥用、类型断言、非空断言、松散配置等问题。

3. Lint 与风格审查

   • 自动运行 eslint . --ext .ts,.tsx,.js,.jsx，发现风格、命名、惯用法等问题。

4. 安全与异步专项检查

   • 检查 XSS、SQL 注入、原型污染、硬编码密钥、未捕获 promise、async/forEach、同步 IO 等高危模式。
   • Node/Web 安全与输入校验、环境变量访问等关键点专项审查。

5. React/Next.js 相关审查

   • 针对 useEffect 依赖、state 变异、key 使用、服务端/客户端边界等常见问题给出建议。

6. 输出结构化审查结论

   • 按 CRITICAL/HIGH/MEDIUM 分级输出，遇到严重问题自动阻断并说明原因，无问题时自动通过。

不能做什么

• 不自动重写或修复代码：typescript-reviewer 只报告问题，不会直接修改或重构代码。
• 不覆盖非 TypeScript/JavaScript 文件：仅审查 .ts, .tsx, .js, .jsx 相关变更。
• 不替代安全审查或测试：虽然覆盖大量安全与类型风险，但建议与 security-reviewer、tdd-guide 等协同使用，形成闭环。

3. 触发方式：自动激活 vs 手动调用

typescript-reviewer 支持多种触发模式：

• 自动触发：当检测到 TypeScript/JavaScript 相关变更（如 PR 创建、commit、staged 文件准备提交）时，Agent 会自动介入并执行审查。
• 手动调用：开发者可在任意时刻通过命令或交互明确指定“对当前变更/PR/文件运行 typescript-reviewer”，适用于需要临时复查或多次迭代的场景。

自动与手动模式可无缝切换，保证无论在 CI、PR 还是本地开发流程中都能覆盖所有关键代码变更。

4. 协作模式：与其他 Agent 的常见组合

typescript-reviewer 通常与以下 Agent 协同工作，形成全流程质量保障：

• code-reviewer：聚焦整体代码质量、可维护性与风格，typescript-reviewer 专注类型/安全/异步专项，两者互补。
• security-reviewer：对敏感变更、依赖升级、API 设计等场景进行深度安全审查，联动 typescript-reviewer 保证无死角。
• tdd-guide：强制测试先行，配合 typescript-reviewer 保证类型与测试覆盖率双达标。
• build-error-resolver：如遇类型或构建错误，先用 build-error-resolver 修复，再用 typescript-reviewer 复审。

通过 Hooks 自动化体系，可实现如“PR 创建/更新自动触发 typescript-reviewer + security-reviewer + tdd-guide 并行审查”的高效工作流。

5. 实际使用示例：完整对话流程

假设你在一个 TypeScript 项目开发新功能并准备提交 PR，以下是典型的 typescript-reviewer 工作流示例：

场景一：本地 staged 文件审查

1. 你本地完成开发，已 git add 相关文件，准备 commit。
2. 运行 ECC 工具或命令行触发：

ecc agent typescript-reviewer

3. Agent 自动检测变更范围，执行如下步骤：

• 检查 staged 文件的 diff，定位涉及的 .ts/.tsx/.js/.jsx 变更。
• 自动运行 npm run typecheck（如有），否则智能选择 tsconfig 执行类型检查。
• 执行 eslint 检查。
• 聚焦变更文件，结合上下文执行专项安全/异步/惯用法审查。
• 输出结构化报告：

=== TypeScript Reviewer Report ===

Approval: BLOCK

Findings:
- CRITICAL: Detected possible XSS in src/components/Editor.tsx line 42: user input assigned to dangerouslySetInnerHTML without sanitization.
- HIGH: Unhandled promise in src/utils/api.ts line 18: async function called without await or .catch().
- HIGH: Usage of 'any' in src/types/index.ts line 9 without justification.

Action Required:
- Sanitize all user input before assigning to innerHTML/dangerouslySetInnerHTML.
- Ensure all async calls are awaited and errors handled.
- Replace 'any' with a precise type or justify its usage.

Please fix the above issues before merging.

场景二：PR 自动审查

1. 你推送 PR 至远程仓库，CI/CD 或 ECC Hook 自动触发 typescript-reviewer。
2. Agent 自动感知 PR 基准分支、合并状态、CI 检查结果，优先检查是否有未通过的必需检查或合并冲突。
3. 若 PR 可合并且检查通过，则自动聚焦 diff，执行类型、安全、异步等专项审查，输出结构化结论。
4. 若发现 CRITICAL/HIGH 问题，自动阻断并在 PR 评论区输出详细报告。

6. 进阶用法与最佳实践

• 与 Rules/Skills 体系结合：可结合 coding-standards、frontend-patterns、backend-patterns 等 ECC 规则库，实现更细粒度的风格与架构一致性保障。
• 集成自动化 Hook：借助 Everything Claude Code Hooks 实战，可实现 PR、push、merge 等关键节点的自动审查，提升团队协作效率。
• 多 Agent 并行审查：对于复杂变更，可并行触发 typescript-reviewer、security-reviewer、tdd-guide 等，形成多维度的质量护栏。

FAQ

Q: 为什么不能直接在 Claude 聊天窗口粘贴代码让其帮忙审查？ A: 直接对话无法自动识别变更范围、缺少结构化结论、容易遗漏安全/类型/异步等高优先级问题，且难以自动集成到 CI/PR 流程。typescript-reviewer 作为专用 Agent 能系统性、标准化地输出可用结论。

Q: typescript-reviewer 会自动修复代码吗？ A: 不会。它只负责发现和报告问题，不做自动重构或修复。修复建议可结合 code-reviewer、build-error-resolver 等 Agent 获取。

Q: 如果项目不是 TypeScript，而是 JavaScript，也能用吗？ A: 可以。typescript-reviewer 同样支持 JavaScript（.js/.jsx）项目，只是类型检查步骤会自动跳过，聚焦安全、异步和惯用法等专项审查。

Q: 审查结论能自动阻断 PR 合并吗？ A: 只要集成到 CI/CD 或 PR Hook，typescript-reviewer 的 BLOCK 结论即可作为自动阻断条件，保障生产环境安全。

---

通过系统性引入 Everything Claude Code TypeScript Reviewer Agent，你将获得超越传统 AI 问答的专业代码审查能力，为团队代码质量与安全性保驾护航。