普通子 Agent
这个主题对应 runAgent() 启动的普通子 Agent。
它和主线程最大的区别是：
- 有自己的角色 prompt
- 会做上下文裁剪
- 默认更强调隔离和受控工具面
1. 结构模板
1.1 system
system = [
{{AGENT_DEFINITION_SYSTEM_PROMPT_OR_DEFAULT_AGENT_PROMPT}},
{{SUBAGENT_NOTES_BLOCK}},
{{ENVIRONMENT_DETAILS_BLOCK}},
{{APPENDED_SUBAGENT_SYSTEM_CONTEXT}}
]
1.2 messages
messages = [
{{PREPENDED_SUBAGENT_USER_CONTEXT_META_MESSAGE}},
{{FORKED_PARENT_CONTEXT_MESSAGES?}},
{{SUBAGENT_PROMPT_MESSAGES}},
{{HOOK_ADDITIONAL_CONTEXT_ATTACHMENT?}},
{{PRELOADED_SKILL_MESSAGES?}}
]
1.3 典型裁剪
resolvedUserContext =
{{BASE_USER_CONTEXT}}
- {{CLAUDE_MD?}}
resolvedSystemContext =
{{BASE_SYSTEM_CONTEXT}}
- {{GIT_STATUS?}}
Explore、Plan 这类只读型 Agent 往往会裁掉：
claudeMdgitStatus
2. 半实化示例
2.1 system
You are an agent for Claude Code.
Given the caller's task, use the tools available to complete it fully.
Notes:
- Agent threads always have their cwd reset between bash calls.
- Use absolute file paths.
- Do not use a colon before tool calls.
# Environment
Working directory: {{SUBAGENT_CWD}}
Is directory a git repo: true
Platform: darwin
Shell: zsh
如果这是一个更强角色化的 Agent，前面可能会变成：
You are the Explore agent.
Your job is to quickly inspect the repository, find relevant files, and return a concise explanation to the caller.
2.2 被裁剪后的上下文
userContext:
currentDate: 2026-04-02
{{claudeMd 被省略}}
systemContext:
{{gitStatus 被省略}}
2.3 messages
<system-reminder>
# currentDate
Today's date is 2026-04-02.
</system-reminder>
请在这个仓库里定位主流程入口，说明 QueryEngine、query、context 之间的关系，只返回结构化结论。
3. 关键观察
3.1 它不是主线程完整复制
普通子 Agent 拿到的是：
- 更短的角色 prompt
- 更聚焦的任务消息
- 被裁剪过的上下文
3.2 工具面会按 AgentDefinition 裁剪
它不是“主线程有什么工具我就全继承”，而是一个角色定义下的受控能力面。
3.3 父上下文是选择性继承
只有对子任务有帮助的父消息、上下文和工具结果才会被带进去。
4. 一页总结
普通子 Agent 的 prompt 可以理解成：
一个更短、更角色化、更隔离的主线程派生视图。
5. 对照源码
src/tools/AgentTool/runAgent.tssrc/constants/prompts.tssrc/utils/api.ts
