用途：codex-subagents 将工作卸载到后台线程，使主上下文保持精简，适合并行研究、上下文隔离和长时间运行的任务。不适合快速内联提问或需要当前状态的紧耦合工作。
主要能力：start 启动新线程，支持 --role、--permissions、--prompt、--label、-w；send 在停止的线程上继续；peek 读取最新未读消息；log 查看完整历史；status 查看线程摘要；wait 阻塞直到线程停止；list 列出线程；archive 归档已完成线程；clean 删除旧归档。
使用方式：基本流程为 start → wait/peek 检查结果 → send 追加后续（仅在线程停止后）→ archive/clean 管理生命周期。提示词可用 --prompt "text"、--prompt - 从 stdin 读取多行，或 -f/--prompt-file 指定文件。线程 ID 可作位置参数，如 peek abc123。
关键规则：不能向运行中的线程发送消息，必须先 wait；权限只能使用 read-only 或 workspace-write，不能用 workspace-read。可恢复状态为 completed、failed、stopped、waiting。
限制与注意：-w 会阻塞直到代理运行结束，长任务建议用分离模式配合 wait --follow-last。常见问题包括权限写错导致 profile 不存在、线程仍在运行导致不可恢复、会话错误提示 different controller、线程被归档后消失。详细工作流见 reference/workflow.md。