subAgent
核心定位
使用这个 Skill 时，主 agent 负责理解用户目标、选择子agent档位、启动子agent、等待结果、汇总结论。
子agent默认只读，不直接修改代码。代码修改、最终决策、是否继续执行，都由主 agent 负责。
子agent允许执行读取和检查类命令来完成分析，例如查看 diff、搜索代码、读取文件、做语法检查或运行不会修改项目状态的验证命令。不要把只读理解成不能执行命令。
档位映射
- 用户没有指定档位时，默认使用
subagent-low。 - 用户说“低级子agent”“低级”“默认”“快速查”“找路径”“找入口”“查调用链”时，使用
subagent-low。 - 用户说“中级子agent”“中级”“闭环检测”“复查改动”“检查兼容”“检查返回结构”时，使用
subagent-medium。 - 用户说“高级子agent”“高级”“安全审计”“高风险”“复杂兼容”“深度检查”时，使用
subagent-high。
模型对应
- 低级：
gpt-5.6-luna，reasoning_effort=medium。 - 中级：
gpt-5.6-terra，reasoning_effort=high。 - 高级：
gpt-5.6-luna，reasoning_effort=high。
启动执行规则
平台预设的 subagent-low、subagent-medium、subagent-high 角色可能绑定旧模型，不能作为模型选择依据。
- 启动三档子 agent 时，必须使用
agent_type=default，并显式传入本 skill 定义的model和reasoning_effort。 - 禁止仅因角色名为
subagent-low、subagent-medium、subagent-high就假定实际模型正确。 - 启动后，主 agent 必须在首条进度消息中说明实际使用的模型与思考档位。
默认使用场景
1. 探索路径
用户要改动、分析、检查某个功能，但希望先减少主 agent 上下文时：
- 启动低级子agent。
- 让子agent只读查找项目路径、入口文件、调用链、相关配置、返回结构。
- 等待子agent完成。
- 主 agent 用简短结论告诉用户：应该改哪里、为什么、风险点是什么。
- 未经用户明确要求，不开始编码。
2. 闭环检测
用户说改完了、检查刚才改动、闭环检测、复查时：
- 启动中级子agent。
- 让子agent通过读取文件和执行读命令检查当前 diff、调用点、返回结构、旧逻辑兼容、可能漏测点。
- 子agent能自行执行读命令时先自行验证；需要修改状态、安装依赖、迁移数据库等操作时，只能建议主 agent 或用户确认后执行。
- 输出问题优先，不要只输出“没问题”。
3. 制定计划
用户要先制定执行计划时：
- 启动低级子agent做只读探索。
- 主 agent 根据探索结果制定计划。
- 计划必须包含：改动文件、改动原因、兼容点、验证方式。
- 不直接编码，除非用户明确说开始实现。
并发规则
- 用户说“并发 n 个agent”时，按用户列出的任务点拆分为 n 个子agent。
- 用户只说“并发”，但没有给数量时，默认最多 3 个。
- 用户给的任务点多于并发数时，优先把相近任务合并，避免过度拆分。
- 并发子agent都默认只读。
- 等待所有子agent完成后，主 agent 汇总为一份结果。
模型切换规则
- 用户口述“用低级”时，使用
default + gpt-5.6-luna + medium。 - 用户口述“用中级”时，使用
default + gpt-5.6-terra + high。 - 用户口述“用高级”时，使用
default + gpt-5.6-luna + high。 - 用户说“思考低一点”“快一点”时，使用
default + gpt-5.6-luna + medium。 - 用户说“稳一点”“中等思考”时，使用
default + gpt-5.6-terra + high。 - 用户说“深度一点”“高思考”“审计”时，使用
default + gpt-5.6-luna + high。
子agent输出要求
要求每个子agent只返回压缩结论，不返回大量搜索过程。
固定输出结构：
- 结论
- 关键文件
- 入口函数或触发点
- 调用链
- 证据
- 风险或不确定点
中级和高级子agent可以把“问题/风险”放在结论后面，但外层仍要保留上面的统一骨架，方便主 agent 并发汇总。
主 agent 汇总要求
主 agent 汇总时必须：
- 用中文。
- 先给结论。
- 保留关键文件和证据。
- 明确哪些是已确认，哪些是不确定。
- 如果下一步要改代码，先说明设计思路，再编码。
- 不把子agent的大量过程日志带回主上下文。
安全边界
- 子agent默认不改文件。
- 子agent可以执行读取和检查类命令，但不能执行会修改文件、依赖、数据库、Git 状态或线上状态的命令。
- 多个子agent不要同时写代码。
- 如果用户明确要求子agent实现代码，主 agent 应优先接管实现，或者先说明并发写代码的冲突风险。
- 涉及线上、数据库、删除、迁移、批量替换等高风险操作时，先只读分析并给计划。