sub-agent

用途：sub-agent 是 OpenSquilla 中用于“派生子智能体”的通用入口，把自包含的编码或文件编辑任务通过非交互式后台进程委派给 Codex、Claude Code、OpenCode、Pi 等编码助手，适用功能开发、代码评审、重构等场景。\n\n主要能力与用法：OpenSquilla 通过 exec_command 与 process 两类工具工作，不提供 bash 工具，也不应使用旧的 bash 工具调用 DSL。exec_command 接收 command、workdir、timeout、yield_time_ms；长时间运行设 yield_time_ms=0 并保留返回的执行句柄（当前兼容字段为 session_id）。process 接收 action、session_id、data、offset、limit，支持 list、poll、log、write、submit、eof、remove、kill 等动作，用于轮询、查看日志、写入输入或终止后台会话。\n\n各代理的非交互用法：Codex/Pi/OpenCode 用一次性命令模式，如 exec_command(command="codex exec 'Your prompt'")、opencode run、pi -p。Claude Code 应使用 --print --permission-mode bypassPermissions，例如 cd /path/to/project && claude --permission-mode bypassPermissions --print 'Your task'；不建议用 --dangerously-skip-permissions 配合 PTY。Pi 可指定 --provider 和 --model。\n\n调用模式：workdir 明确工作目录，避免代理读取无关文件；长任务用 exec_command(yield_time_ms=0, ...) 后台执行，再用 process(action="wait", session_id=...) 等待，或用 log 查看进度，避免循环 poll 消耗回合与 token。Codex 需在受信任的 git 目录内运行，草稿任务可先 mktemp -d && git init。批量 PR 评审建议克隆到临时目录或用 git worktree，禁止在 OpenSquilla 自身项目、状态目录或运行时状态/工作区目录中操作；也不要在其中启动 Codex 或检出分支。\n\n限制与注意：需按代理选择正确执行模式，尊重用户指定的工具；编排模式下不应自行手写补丁，代理失败或卡住时应重派生或询问用户，不要静默接管，也不要因“慢”而终止会话。启动后应向用户发送简短进度，并在里程碑、提问、出错或完成时更新；长任务可让代理打印明确的完成行便于在日志中观察。\n\n文中未提供的收费、价格、平台与效果信息暂未提供。