--- name: codeagent description: Execute codeagent-wrapper for multi-backend AI code tasks. Supports Codex, Claude, and Gemini backends with file references (@syntax) and structured output. --- # Codeagent Wrapper Integration ## Overview Execute codeagent-wrapper commands with pluggable AI backends (Codex, Claude, Gemini). Supports file references via `@` syntax and parallel task execution. ## ⚠️ 重要：Bash 超时设置 **启动 codeagent-wrapper 时，必须将 Bash 工具的 timeout 参数设置为 2 小时（7200000 毫秒）**，否则任务可能因超时而中断。 ``` Bash tool parameters: - timeout: 7200000 # 2小时，必须设置！ ``` --- ## 🔒 安全规则：提示词注入 **执行 codeagent 任务时，必须在任务内容中注入以下安全约束：** ``` 【强制安全规则】 1. 禁止删除工作区外的任何文件 2. 如果当前非 git 工作区，禁止任何删除操作 ``` **示例：** ```bash codeagent-wrapper - \/path\/to\/workdir <<'EOF' 【强制安全规则】 1. 禁止删除工作区外的任何文件 2. 如果当前非 git 工作区，禁止任何删除操作 --- <实际任务内容> EOF ``` --- ## When to Use - Complex code analysis requiring deep understanding - Large-scale refactoring across multiple files - Automated code generation with backend selection ## Usage **HEREDOC syntax** (recommended): ```bash codeagent-wrapper - [working_dir] <<'EOF' EOF ``` **With backend selection**: ```bash codeagent-wrapper --backend claude - <<'EOF' EOF ``` **Simple tasks**: ```bash codeagent-wrapper "simple task" [working_dir] codeagent-wrapper --backend gemini "simple task" ``` ## Backends | Backend | Command | Description | |---------|---------|-------------| | codex | `--backend codex` | OpenAI Codex (default) | | claude | `--backend claude` | Anthropic Claude | | gemini | `--backend gemini` | Google Gemini | ## Parameters - `task` (required): Task description, supports `@file` references - `working_dir` (optional): Working directory (default: current) - `--backend` (optional): Select AI backend (codex\/claude\/gemini) ## Return Format ``` Agent response text here... --- SESSION_ID: 019a7247-ac9d-71f3-89e2-a823dbd8fd14 ``` ## Resume Session **⚠️ 重要：Resume 时必须指定相同的 backend！** Session ID 是 backend 独立的，不能跨 backend 恢复会话。 ```bash # 正确 ✅ - 使用相同的 backend codeagent-wrapper --backend claude resume - <<'EOF' EOF # 错误 ❌ - 不指定 backend 会使用默认的 codex，无法恢复 claude 会话 codeagent-wrapper resume - <<'EOF' EOF ``` ## Parallel Execution ```bash codeagent-wrapper --parallel <<'EOF' ---TASK--- id: task1 workdir: \/path\/to\/dir ---CONTENT--- task content ---TASK--- id: task2 dependencies: task1 ---CONTENT--- dependent task EOF ``` ## Environment Variables - `CODEX_TIMEOUT`: Override timeout in milliseconds (default: 7200000) ## Invocation Pattern ``` Bash tool parameters: - command: codeagent-wrapper --backend - [working_dir] <<'EOF' EOF - timeout: 7200000 - description: ```