sub-agent

name	sub-agent
description	Delegate a self-contained task to a sub-Agent (Codex, Claude Code, or Pi via background process). The original use case was coding tasks — building features, reviewing PRs, refactoring — but the skill is the generic "spawn a sub-Agent with full tool surface" slot used by meta-skill DAG steps for any LLM-driven sub-task (policy review, trace parsing, report synthesis, document generation). Renamed from ``coding-agent`` to reflect actual usage; the wrapped CLIs (codex / claude / pi) still bias toward coding workloads. Use when: (1) building/creating new features or apps, (2) reviewing PRs (spawn in temp dir), (3) refactoring large codebases, (4) iterative tasks that need file exploration, (5) meta-skill steps requiring full tool/LLM agency. NOT for: simple one-liner fixes (just edit), reading code (use read tool), thread-bound ACP harness requests in chat (for example spawn/run Codex or Claude Code in a Discord thread; use sessions_spawn with runtime:"acp"), or any work in ~/clawd workspace (never spawn agents here). Prefer non-interactive CLI modes such as codex exec, claude --print, opencode run, or pi -p.
description_zh	将一个自包含任务委派给子代理（Codex、Claude Code或后台运行的Pi）。最初用于编码任务（构建功能、审查PR、重构），但本技能是meta-skill DAG步骤用于任何LLM驱动子任务（策略审查、跟踪解析、报告综合、文档生成）的通用'启动带完整工具面的子代理'插槽，由 coding-agent 更名以反映实际用途。适用于：构建新功能/应用、审查PR（在临时目录中启动）、重构大型代码库、需文件探索的迭代任务、需完整工具/LLM能力的meta-skill步骤。不适用于：简单一行修复、读代码、聊天中线程绑定的ACP请求，或在~/clawd工作区内的任何工作。优先使用非交互CLI模式，如 codex exec、claude --print、opencode run 或 pi -p。
provenance	{"origin":"openclaw-derived","license":"MIT","upstream_url":"https://github.com/openclaw/openclaw","maintained_by":"OpenSquilla"}
metadata	{"opensquilla":{"requires_tools":["background_process","exec_command","process"]},"openclaw":{"emoji":"🧩","requires":{"anyBins":"[Truncated]"},"install":["[Truncated]","[Truncated]"]}}

Sub-Agent (opensquilla process tools)

Generic "spawn a sub-Agent" entry point for delegating self-contained tasks to Codex / Claude Code / OpenCode / Pi via background process. Wrapping CLIs are coding-oriented, but the skill itself is used as the generic sub-Agent slot by meta-skill DAGs for any LLM-driven sub-task (file edits, document generation, policy review, etc.).

Use opensquilla's exec_command, background_process, and process tools for coding agent work. OpenSquilla does not expose a bash tool; do not use the legacy bash tool-call DSL.

Non-Interactive CLI Mode

OpenSquilla's process tools do not expose a pty parameter. Prefer non-interactive command modes that run and exit cleanly:

# ✅ Correct for Codex/Pi/OpenCode
exec_command(command="codex exec 'Your prompt'")

For Claude Code (claude CLI), use --print --permission-mode bypassPermissions instead. --dangerously-skip-permissions with PTY can exit after the confirmation dialog. --print mode keeps full tool access and avoids interactive confirmation:

# ✅ Correct for Claude Code (no PTY needed)
cd /path/to/project && claude --permission-mode bypassPermissions --print 'Your task'

# For background execution: use background_process

# ❌ Wrong for Claude Code
exec_command(command="claude --dangerously-skip-permissions 'task'")

OpenSquilla Tool Parameters

Tool	Key parameters	Description
exec_command	command, workdir, timeout	Run a foreground shell command.
background_process	command, workdir, timeout	Start a long-running command and return .