cli-for-agents
/cli-for-agents
Doradza w projektowaniu i przeglądzie CLI dla agentów kodujących: sterowanie flagami, bezpieczeństwo w potokach i idempotencja, bez uruchamiania i profilowania narzędzia.
- Autor
- OutlineDriven ↗
- Repozytorium
- outline-driven-development ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 28.09.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 2
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 28.09.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
Co robi i kiedy
Doradza w projektowaniu i przeglądzie CLI dla agentów kodujących: sterowanie flagami, bezpieczeństwo w potokach i idempotencja, bez uruchamiania i profilowania narzędzia.
Oryginalny opis (EN)
Use when asked to build or review a CLI intended for coding agents and return flag-driven, pipeline-safe, idempotent design advice. Not for running or profiling a CLI: use control-cli.
Jak działa
- Contract
- Inputs
- Procedure
- Failure and recovery
- Output
Podgląd SKILL.md
--- name: cli-for-agents description: 'Use when asked to build or review a CLI intended for coding agents and return flag-driven, pipeline-safe, idempotent design advice. Not for running or profiling a CLI: use control-cli.' --- # CLI for agents ## Contract | Field | Bound contract | |---|---| | Trigger | Human asks to build or review a CLI intended for coding agents | | Authority | Read-only. No file, VCS, credential, paid, published, deployed, or remote mutation. Advice or review only. | | Side effect | Chat output only: design advice or review findings. | | Done | A report returned that prescribes flag-driven, pipeline-safe, idempotent CLI design. | ## Inputs - A CLI to review, or a build request describing the CLI's purpose and target agent runtime. Either is sufficient; both may be supplied. - Optional: existing command surface, flag set, exit-code map, or invocation examples. When absent, state the assumption and review against the design rules below. ## Procedure 1. Bound scope: confirm whether this is a build (propose a design) or a review (judge an existing CLI). Do not mutate the CLI or any file; produce advice only. Done when: build or review intent is confirmed and stated in the report. 2. Enumerate the command surface the agent will invoke: subcommands, flags, positional args, stdin, stdout, stderr, and exit codes. Done when: the full surface is listed or the missing surface is named. 3. Check flag-driven control: every behavioral switch is a flag or subcommand, not an interactive prompt that blocks on a TTY. Flag names are stable, long-form, and discoverable via `--help`. Reject hidden modes toggled only by interactive input. Done when: every switch is a flag or subcommand, or each violation is recorded. 4. Check pipeline safety: output meant for machine consumption goes to stdout as plain, parseable text; human diagnostics go to stderr. The CLI never hangs waiting on a TTY when stdin is not a terminal. Exit codes are explicit and documented: 0 success, non-zero for distinct failure classes. Done when: stdout/stderr split and exit-code map are verified, or violations are recorded. 5. Check idempotence: re-running the same invocation with the same inputs produces the same result and side effects, or fails loudly with a non-zero exit when the operation is not safely repeatable. Done when: each state-changing command declares idempotence or names what makes a repeat unsafe. 6. Check agent ergonomics: deterministic output ordering, no color or progress decoration on stdout unless explicitly flagged on, machine-readable `--json` or equivalent where the agent parses output, and a single canonical invocation form per action. Done when: all four ergonomics rules pass or each violation is recorded. 7. For a build request, propose the command surface, flag set, exit-code map, and stdout/stderr contract that satisfy rules 3-6. For a review, record each violation against the rule it breaks and prescribe the fix. Done when: the proposed surface or the per-violation fix list is complete. 8. Stop at the report. Do not edit the CLI, run it, or widen scope into implementation, testing, or packaging. Done when: the report is returned and no file was mutated. ## Failure and recovery - Ambiguous build-vs-review intent: ask once for the missing input; if unresolved, default to review when a CLI is supplied and build when only a purpose is supplied, and state the assumption in the report. - Missing command surface for a review: state that the surface could not be enumerated and limit findings to the rules checkable from what was supplied; do not invent a surface. - Contradictory requirements (e.g., a required interactive prompt): report the contradiction and the rule it violates; do not silently relax a rule to make the CLI pass. - No partial mutation: this skill never changes files, so there is no rollback. A blocked review returns the findings gathered so far plus the named blocker, never a clean bill of health. ## Output Chat report: command surface → per-rule verdicts (flag-driven, pipeline-safe, idempotent, ergonomic) → prescribed fixes or proposed surface, flag set, exit-code map, stdout/stderr contract. Chat output only.
Pliki w paczce (2)
- SKILL.md 4 KB
- agents/openai.yaml 1 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · OutlineDriven/outline-driven-development | 100 | Apache-2.0 |
| heyAyushh/stacc | 100 | MIT |
| pproenca/dot-skills | 100 | MIT |
| v1truv1us/ai-eng-system | 100 | MIT |
| v1truv1us/ai-eng-system | 100 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki 6917c0965288 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 90control-cli
Odtwarza, profiluje i weryfikuje zachowanie CLI i TUI, tworząc deterministyczny zapis sesji lub dowód profilu ze sprzątaniem sesji. - 100cli-design
Projektuje i audytuje CLI przyjazne dla agentów AI według kryteriów z CLI cf od Cloudflare: nowe CLI, zmiany poleceń i flag oraz ocena istniejących narzędzi. - 100control-cli
Buduje lokalny harness do sterowania, inspekcji i profilowania interaktywnego CLI lub TUI, do sprawdzania UX, regresji startu, zawieszeń i przepływów promptów. - 100cli-review-runner
Uruchamia zestaw testów czarnoskrzynkowych na wskazanym CLI i raportuje zaliczenie lub niezaliczenie każdej z 45 reguł katalogu cli-for-agents, oceniając jego przydatność dla agentów. - 100agents-md
Tworzy i utrzymuje zwięzłe pliki AGENTS.md i CLAUDE.md, dokumentuje konwencje repozytorium dla agentów kodujących i trzyma instrukcje na minimalnym poziomie. - 96tm-cli
Używa wyłącznie narzędzia tm-cli, czyli interfejsu wiersza poleceń Telemetry Machine.