Instead of writing code tool-by-tool (filling your context window with file
contents), delegate to a purpose-built coding agent that runs in its own
process. It has its own tools, validates its output with AST parsing, and
comes back with structured results. Your context stays clean.
reading, editing, and bash execution in its own process. You only see
the final result.
(and optional Bandit security scans). If code has errors, the agent retries
automatically — no manual back-and-forth.
The agent stops when it hits the cap — no surprise bills.
open-source models. Switch with one flag.
Use this skill when the user asks to:
Do NOT use for: reading files, explaining code, or answering questions. Use
your own tools for those — they don't need a sub-agent.
python3 {SKILL_DIR}/scripts/agenter_cli.py \
--prompt "<the coding task>" \
--cwd "<workspace directory>" \
--backend "anthropic-sdk" \
--max-cost-usd 2.0 \
--max-iterations 5 \
--sandbox
| Flag | Required | Default | Description |
|---|---|---|---|
| ------ | ---------- | --------- | ------------- |
--prompt | Yes | — | The coding task. Be specific about what to build. |
--cwd | Yes | — | Working directory. Use the current workspace or a subdirectory. |
--backend | No | anthropic-sdk | Runtime: anthropic-sdk, claude-code, codex, or openhands. |
--model | No | auto | Model override (e.g., claude-sonnet-4-20250514, gpt-5.4). |
--max-cost-usd | No | unlimited | Maximum spend in USD. |
--max-tokens | No | unlimited | Maximum total tokens (input + output). |
--max-time-seconds | No | unlimited | Maximum wall clock time. |
--max-iterations | No | 5 | Max validation/retry iterations. |
--allowed-write-paths | No | all in cwd | Glob patterns for allowed writes (e.g., ".py" ".ts"). |
--sandbox / --no-sandbox | No | --sandbox | Sandboxed execution (recommended). |
--stream | No | off | Emit NDJSON progress events for real-time updates. |
Set budget limits based on task complexity. Always tell the user the estimated cost.
| Task type | Suggested --max-cost-usd | Suggested --max-iterations |
|---|---|---|
| ----------- | --------------------------- | ------------------------------ |
| Simple script / single file | 0.50 | 3 |
| Small app / multiple files | 2.00 | 5 |
| Complex refactoring / full project | 5.00 | 7 |
Default to anthropic-sdk unless the user asks for a specific backend. Check
{SKILL_DIR}/references/backends.md if the user asks about backend differences.
ANTHROPIC_API_KEY or AWS Bedrock.OPENAI_API_KEY.--no-sandbox.The script outputs JSON to stdout:
{
"status": "completed",
"summary": "Created main.py with FastAPI app and test_main.py",
"files_modified": ["main.py", "test_main.py"],
"files": {"main.py": "...", "test_main.py": "..."},
"iterations": 2,
"total_tokens": 15000,
"total_cost_usd": 0.045,
"total_duration_seconds": 12.3
}
| Status | Meaning | What to do |
|---|---|---|
| -------- | --------- | ------------ |
completed | Task succeeded, files written to disk. | Report summary and files to user. |
completed_with_limit_exceeded | Task succeeded but used more resources than configured. | Report success + warn about cost. |
budget_exceeded | Stopped because budget ran out before completion. | Tell user, ask if they want to retry with higher budget. |
refused | The model refused the request (safety/policy). | Report refusal reason to user. |
failed | Unrecoverable error. | Report error, suggest checking logs. |
status field.completed: the files are already written to disk in --cwd. Use read toinspect them if the user wants to review.
failed or budget_exceeded: report the issue and ask how to proceed.共 1 个版本