opensource/CLI-Anything
3
0
Fork 0
mirror of https://github.com/HKUDS/CLI-Anything.git synced 2026-08-30 17:34:27 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs: add step budget guidance for subagent builds

Browse Source 
Reasonix does not recognize a `max-iters` frontmatter field — the
subagent step budget is derived from the parent's `agent.max_steps`
config in `reasonix.toml` (default 0 = unlimited; finite values yield
parent/2 with min 5). Since a CLI-Anything build typically needs 25–40
tool-call rounds, add a Step Budget section to SKILL.md and a
Configuration Note to README.md advising users to keep `max_steps = 0`
or set it to 64+ to avoid truncation.
This commit is contained in:
Locodocoww
2026-06-09 19:01:35 +08:00
parent f0560fc736
commit c4d7e78719
2 changed files with 18 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
reasonix-skill/README.md
+9
View File
@@ -24,6 +24,15 @@ cd CLI-Anything\reasonix-skill
Both scripts copy the skill to Reasonix's global skill directory at `~/.reasonix/skills/cli-anything`.
## Configuration Note
A full CLI-Anything build (architecture analysis, 10+ file generation, installation, and multiple test runs) typically requires 25–40 tool-call rounds. Reasonix's subagent step budget is derived from the `agent.max_steps` setting in `reasonix.toml`:
- The default `max_steps = 0` means unlimited, which is recommended for this workflow.
- If you have set `max_steps` to a finite value, the subagent receives half that budget (minimum 5), which may cause a build to be truncated before completion.
To ensure builds complete successfully, set `agent.max_steps = 0` in your `reasonix.toml`, or use a sufficiently high value such as 64 or more.
## Usage
After installation, invoke the skill in any Reasonix session:
reasonix-skill/SKILL.md
+9
View File
@@ -51,6 +51,15 @@ Reasonix agents build harnesses by combining these built-in tools:
**Phase 7 (Packaging)** — Use `write_file` for setup.py, `bash` for `pip install -e .` and `which cli-anything-<software>` verification.
## Step Budget
A full harness build typically requires 25–40 tool-call rounds (architecture inspection, 10+ file writes, installation, and multiple test runs). When invoked via `run_skill`, the subagent inherits a step budget derived from the parent agent's `agent.max_steps` setting in `reasonix.toml`:
- If `max_steps = 0` (the default, meaning unlimited), the subagent also runs with no step cap — this is the recommended configuration for the CLI-Anything workflow.
- If `max_steps` is set to a finite value, the subagent receives half that budget (minimum 5), which may truncate a complex build before completion.
Users who have configured a finite `max_steps` should ensure it is set to 0 or a sufficiently high value (e.g., 64 or more) before running a CLI-Anything build, so the subagent has enough rounds to complete all seven phases.
## Modes
### Build