Sub-Agents 用于将外部 CLI AI 作为拥有独立上下文的隔离子智能体来执行任务。支持的 CLI 包括 codex、claude、cursor-agent、glm、kimi、grok、antigravity、gemini、opencode、command-code。
主要能力：从用户请求中提取参数（--agent、--prompt、--cwd、--cli、--timeout），发现并选择可用的 agent 定义，执行后处理 JSON 响应。
使用方式：先列出可用 agent：{SKILL_DIR}/scripts/run_subagent.py --list；再执行：{SKILL_DIR}/scripts/run_subagent.py --agent <name> --prompt "<task>" --cwd <absolute-path>。用户指定后端时追加 --cli <backend>，指定超时时追加 --timeout <毫秒>（默认 600000）。
Agent 定义放在 .agents/ 目录，或由环境变量 $SUB_AGENTS_DIR 指定。定义文件为 .md，frontmatter 支持 run-agent（指定执行 CLI）、model（可选）、effort（可选，cursor-agent 与 gemini 不支持）、permission（read-only、safe-edit 默认、yolo）。
响应按 status 处理：success 直接使用 result；partial 为超时但有输出；error 需检查 error 与 exit_code（124 超时、127 CLI 未找到、1 一般错误）。首次执行前需申请提升权限并设置工具超时；Codex CLI 的权限问题参见 references/codex.md。若因缺少 run-agent 失败，可用 --cli 指定当前客户端后端重试。
限制：需外部 CLI 与相应权限；未指定 run-agent 或 --cli 会报错；具体收费、价格与效果资料未提供。