investigate 是面向 Codex 的仓库技能，核心用途是做只读、可追溯的代码调查：回答“X 如何工作”“逻辑在哪里”“Z 会发生什么”“为什么 A 表现如 B”等问题，让后续决策或修复建立在已验证的流程之上而非假设。
主要能力与流程：Phase 0 先对范围分类（quick / deep / debug / recommendation / explain），再按 发现（Entities > Commands > Events > Controllers 等优先级搜索）→ 图谱扩展（主代理必须对 2-3 个关键文件自行运行 code_graph 命令）→ 知识图谱（逐文件记录用途、符号、依赖）→ 流程映射（入口到出口及副作用）→ 分析（业务规则、校验、授权、错误路径）→ 综合 → 呈现 的顺序执行。deep 范围会把分析写入 .ai/workspace/analysis/[feature]-investigation.md；--mode=explain 的产物是单向开发者叙述，并写入被 git 忽略的 tmp/understand/{branch}.md。
必要用法：技能通过 $investigate 调用；图谱步骤使用类似 python .claude/scripts/code_graph connections <key_file> --json、query callers_of <FunctionName> --json、query importers_of <file_path> --json 的命令，且只有主代理能用图谱；若前置有 $scout，可复用其编号文件列表并优先处理 HIGH PRIORITY 文件。
限制：整个过程严格只读，绝不修改代码；每条结论都要有 file:line 证据，未验证内容必须标注 inferred；建议任何代码改动会触发完整验证链。执行前需建立任务跟踪并与进度同步；步骤不得跳过、重排或合并；如某步骤或工具在当前环境无法运行，应停止并询问用户。涉及项目上下文时，需先读取 docs/project-config.json、docs-index-reference.md 与 lessons.md，缺失或过时时按路由先运行 $project-init 或相应的窄化初始化技能。