用途
Code Investigator 用于系统化地调查代码库：先发现项目全部功能，再通过并行子代理分析问题、风险和死代码，最后生成一份按优先级排序的行动报告。
主要能力
工具把调查过程分为三个阶段。
第一阶段：功能发现
使用 Task 工具（subagent_type=Explore）梳理整个项目，包括：
- 识别项目类型（框架、语言、架构模式）
- 列出所有功能/模块及其文件位置
- 梳理依赖（package.json、requirements.txt、go.mod 等）
- 识别入口点、路由、API 端点
- 记录配置文件、环境设置、CI/CD
输出结构化的功能清单表格（#、Feature/Module、Files、Description），并在进入第二阶段前向用户展示该清单。
第二阶段：并行调查
在单条消息中启动多个 Task 子代理并发调查，每个子代理聚焦一个领域。必需子代理包括：
- 安全审计（tech-lead）：漏洞、注入风险、认证缺口、密钥暴露
- 死代码检测（Explore）：未使用的导出、不可达代码、孤立文件、未使用依赖
- 架构审查（tech-lead）：模式违规、循环依赖、耦合问题、缺失抽象
- 错误与边缘情况分析（Explore）：缺失错误处理、未处理的 Promise、竞态条件
- 依赖审计（Bash）：npm audit、过时包、许可证问题、重复依赖
- 测试覆盖分析（Explore）：缺失测试、未测试的关键路径、测试质量
可选子代理（按项目类型）：性能分析（Web 应用、含数据库查询的 API）、TypeScript 严格性（有 any 用法的 TS 项目）、API 契约检查（REST/GraphQL 项目）、可访问性审计（前端项目）。
每个子代理提示必须包含：第一阶段的功能清单、references/investigation-areas.md 中对应的检查项、对每条发现评级（CRITICAL/HIGH/MEDIUM/LOW）的指示、为每条发现提供文件路径与行号的指示。
第三阶段：报告汇总
收集所有子代理结果，汇编为一份按优先级排序的报告。报告结构包括：执行摘要；严重发现、高优先级、中优先级、低优先级/改进四张表格（含 #、发现、类别、File:Line、影响、建议）；死代码与冗余表；缺失功能表；依赖健康表（包、当前、最新、风险、动作）；以及指标汇总（发现总数及各级数量、死代码项、缺失功能、脆弱依赖数）。
排序规则
- CRITICAL：安全漏洞、数据丢失风险、生产环境崩溃
- HIGH：可能影响用户的缺陷、缺失认证检查、关键路径中未处理的错误
- MEDIUM：代码异味、轻微安全问题、性能顾虑、缺失测试
- LOW：风格问题、小的重构机会、锦上添花的改进
关键准则
- 绝不猜测——报告发现前必须先阅读实际代码验证
- 每条发现都包含文件路径与行号
- 区分已确认问题与潜在顾虑
- 不把风格偏好当作问题，除非它引发真实问题
- 对相关发现进行分组，避免重复报告
- 若某子代理在其领域未发现问题，将其作为积极信号报告
适用场景
适合需要对现有代码库开展全面审查、识别安全与架构风险、清理死代码、评估依赖健康度和测试覆盖的工程团队。
限制
资料中未提供关于运行环境、具体命令、费用或平台支持的进一步信息。