Claude Code 子 Agent：把代码检查拆成只读任务

什么时候用

• 你需要独立调查某个模块，只返回问题和依据，再由主会话决定是否改代码。[1]

什么时候不用

• 任务很小、主会话已有完整上下文，或者你要求子 Agent 自动修复但只给它读取工具。[1]

独立上下文需要明确任务

官方文档说明子 Agent 使用自己的上下文窗口，主会话接收它的结果。不要假设它知道主会话讨论过的全部决定。将模块路径、检查问题和返回要求写在委派任务里；对遗漏背景的报告先补上下文，不直接按结论修改。[1]

写一个项目级检查文件

---
name: inspection-notes
description: Inspect a specified module and report evidence-backed findings without editing files.
tools: Read, Grep, Glob
---

Inspect only the module named in the task.
For each finding, return a file path, the observed behavior,
why it matters, and a suggested follow-up check.
Do not claim a command was executed unless it actually was.

[1]

tools 明确列出 Read、Grep、Glob，示例没有暴露编辑和 Bash 工具。前半段是配置，后半段是工作说明，两者作用不同。用户级定义可放 ~/.claude/agents/；是否对团队共享，取决于你选择的作用域。[1]

交付格式要能复查

• 任务示例：检查 src/queue/ 的重试处理，只报告可能重复执行的路径，给文件位置和需要补充的测试。
• 要求区分观察、推断、待检查，不让无法执行命令的子 Agent 声称测试通过。
• 收到结果后由主会话核对文件和任务边界，再决定补测试、改实现或不采纳。

[1]

核验与适用边界

本页已核对官方文件位置、frontmatter 示例与工具配置说明；示例文件仅检查了结构，没有启动子 Agent、读取实际项目或执行测试。工具列表限制暴露的能力，但文件读取范围和组织权限仍需核对当前会话设置。任务需要代码执行时，应重新设计任务与权限，而不是把执行结果补写进报告。[1]