如何为 LingCode 编写子代理？

每个子代理对应一个 Markdown 文件

子代理文件存放在 .claude/agents/<name>.md（项目级）或 ~/.claude/agents/<name>.md（用户级）。每个文件是带有 YAML frontmatter 的 Markdown：

---
name: code-reviewer
description: Use this for in-depth code review of staged or unstaged changes. Invoke when the user says "review this," "look over this diff," or before they push.
tools: [Read, Grep, Glob, Bash]
---

# Code reviewer

You are a senior code reviewer. Read the staged diff with `git diff --staged`,
and the unstaged diff with `git diff`. For each meaningful change:

- Note what was changed and whether it accomplishes the stated goal.
- Flag bugs, race conditions, and security issues.
- Flag missing tests for non-trivial logic.
- Flag style violations only if egregious.

Do NOT propose fixes — that's the main agent's job. Report findings only.

frontmatter 包含三个有意义的字段：name（调用时使用）、description（用于路由决策），以及可选的 tools（限定工具白名单）。

描述即路由逻辑

当主代理决定是否要委派时，它会读取所有可用子代理的描述，并选择描述与当前情境最匹配的那个。描述模糊（"帮助处理代码"）的会被忽略；描述具体（"用于对已暂存或未暂存的变更进行代码审查"）的会被选中。

描述应采用"在 [任务] 时使用"或"当用户 [说/想/需要] [某事] 时调用"的形式。想象未来的你冷读这段描述——你能知道什么时候该派发吗？

子代理应只做它该做的事

默认情况下，子代理可以使用主代理能用的任何工具。通过 frontmatter 中的 tools 字段将其限制为完成任务所需的最小工具集：

• 代码审查子代理需要 Read、Grep、Glob，以及用于 git 命令的 Bash——但不应拥有 Edit、Write 或任何破坏性工具。它只审查，不修复。
• 调研子代理需要读取类工具和 WebFetch。明确不应拥有 Edit 或 Write。
• 测试编写子代理需要 Read、Grep、Edit、Write、Bash。完整的编辑工具集，但通过系统提示将其范围限定在测试文件内。

工具列表是策略，不是偏好。缺少 Edit 的子代理就真的无法编辑，无论模型"想"做什么。这正是代码审查子代理所需要的：即便模型想"顺手修一下这个小问题"，它也做不到。

主代理委派的两种方式

子代理有两种调用方式：

• 隐式：主代理判断当前情境，发现匹配的子代理描述，无需指示便自行委派。这是描述清晰的子代理最常见的触发方式。你会看到它以名为"Agent"的工具调用形式出现，参数中包含子代理的名称。
• 显式：你说"用 code-reviewer 子代理审查这个 diff"。主代理按指示派发。当你知道该用哪个子代理且不想把路由交给模型自行判断时，这种方式很有用。

无论哪种方式，子代理都会获得全新的上下文窗口，完成任务，返回摘要，然后消失。主对话继续，只有摘要进入其上下文。

三个警示信号

• 任务是对话性的。来回互动的对话不适合子代理——它们只返回一次摘要，而不是持续聊天。如果需要迭代，让主代理处理。
• 结果就是全部过程产物。子代理只返回摘要；详细的中间工作会丢失。如果你需要看代理实际的 diff 探索过程，子代理会把它藏起来。改在主上下文中运行。
• 任务只需一行操作。"格式化这个文件"不需要子代理。启动子代理的开销比任务本身还大。子代理应留给真正需要独立上下文窗口的工作。

三种定制工具，三种不同用途

• 技能（Skill）——教代理如何做某件事。主代理读取技能并在当前上下文中应用。没有隔离。
• 子代理（Subagent）——将任务委派给拥有独立上下文的全新代理。有隔离。只返回摘要。
• 斜线命令（Slash command）——用户手动输入的快捷方式，触发已知的提示模板。提供便利，但没有隔离。

经验法则：想要隔离，写子代理。想要在同一上下文中改变行为，写技能。想要快速触发，写斜线命令。