自定义 agent 不认时内嵌人设

一条环境踩坑经验。.claude/agents/*.md 里定义的固定 subagent，在部分会话（如 SDK 环境）里不被 Agent 工具识别。

现象与对策

• 现象：调用自定义 subagent 报 “Agent type not found”。
• 别做：反复重试同一个 agent type（不会好）。
• 改做：改用 general-purpose，并把目标 agent 的完整人设提示词逐字内嵌进每次调用 prompt 的开头——效果等价。
• 如实说明这是替代方案（而非那个具名 agent 本身）。

为什么记下来

自定义 agent 的可用性依赖运行环境，不是稳定保证。内嵌人设是一个可靠的降级路径，避免在“agent 不认”上反复浪费尝试。