plan-writing · muaaz9329 — скилл для Claude Code: планы Cheap Agent
Скилл plan-writing для Claude Code готовит или исправляет план Cheap Agent перед вызовом инструмента делегирования cheapag. Он включается для изменений больше ~20 строк, нескольких файлов или после отклонения плана.
MIT ★ 341 обновлён 2026-11-16
/plugin marketplace add muaaz9329/cheap-ag
/plugin install cheapag@cheap-agentЧто делает plan-writing
Скилл оформляет план в .plan/ так, чтобы Cheap Agent мог выполнить его шаги в изолированной копии репозитория. В каждом шаге задаются файлы, работа и исполняемая проверка; также можно указать зависимости между шагами, сложность и новые пакеты.
Для параллельного выполнения шаги группируют по файлам, а порядок зависимых задают через needs:. Запрос пользователя или текст задачи помещают в общий контекст либо передают через delegate(source=…), чтобы рабочий агент мог сверить план с исходной задачей. Новые пакеты нужно перечислить в deps:: Cheap Agent не устанавливает их сам.
Какие задачи решает
- разбить изменение нескольких файлов на отдельные шаги
- задать файлы и проверку для каждого шага плана
- связать зависимые шаги через
needs: - исправить план, который отклонил cheapag
Примеры запросов агенту
- Составь план в
.plan/для изменения нескольких файлов и добавь проверки к каждому шагу. - Разбей эту задачу больше чем на 20 строк на небольшие шаги для Cheap Agent.
- Исправь план, который отклонил cheapag, и сверь шаги с исходной задачей.
Как установить plan-writing
1Через маркетплейс плагинов
/plugin marketplace add muaaz9329/cheap-ag/plugin install cheapag@cheap-agentКоманда ставит плагин cheapag целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add muaaz9329/cheap-ag --skill plan-writing -a claude-code3Вручную: положить файлы
~/.claude/skills/plan-writing/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/plan-writing/
1Через Skills CLI (Vercel)
npx skills add muaaz9329/cheap-ag --skill plan-writing -a codex2Вручную: положить файлы
.agents/skills/plan-writing/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add muaaz9329/cheap-ag --skill plan-writing -a cursor2Вручную: положить файлы
.cursor/skills/plan-writing/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install muaaz9329/cheap-ag plugin/skills/plan-writing2Вручную: положить файлы
.github/skills/plan-writing/SKILL.md1Через Skills CLI (Vercel)
npx skills add muaaz9329/cheap-ag --skill plan-writing -a gemini-cli2Командой платформы
gemini skills install https://github.com/muaaz9329/cheap-ag --path plugin/skills/plan-writingВручную: положить файлы
.devin/skills/plan-writing/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о plan-writing
Как установить plan-writing в Claude Code?
Добавь маркетплейс командами /plugin marketplace add muaaz9329/cheap-ag и затем установи плагин: /plugin install cheapag@cheap-agent.
Что делает plan-writing?
Скилл создаёт или исправляет файл плана Cheap Agent с шагами, перечнем затрагиваемых файлов и проверками. Он также помогает задать порядок зависимых шагов и параллельные группы.
Что должно быть в каждом шаге плана?
Нужны список файлов в files:, описание работы и исполняемая проверка в done-when:. Новые пакеты указывают в deps:, поскольку Cheap Agent не устанавливает их самостоятельно.
Исходный текст
SKILL.md · MIT
---
name: plan-writing
description: Write or fix a Cheap Agent plan file before calling the cheapag delegate tool. Use when planning a change of more than ~20 lines or several files for the cheap worker, splitting work into steps, or after delegate rejects a plan.
---
# Writing a Cheap Agent plan
The cheap worker sees the whole plan, then implements the steps you name in `delegate`. It works in an isolated copy of the repo and does only what a step says, so each step must stand on its own: exact files, what to build, and a check that proves it works.
Save plans under `.plan/` in the repository, e.g. `.plan/rate-limit.md` (the developer may read, edit or commit them). Pass the path relative to the repository root.
## Grammar
```
# <plan title> ← required, exactly one H1
<shared context, optional, ≤ ~15 lines>
## <id> <short title> ← id = integer or integer+letter (3, 3a; s3, step-3 also work)
files: <path>, <dir/>, ... ← required; scope + overlap key
do: <what to build; continuation lines indented 2+ spaces>
done-when: <condition>; <condition> ← required; `backticked` = executed
dont: <constraint>; <constraint>
needs: <step id>, ...
difficulty: easy | medium | hard ← picks the worker model; wins over delegate's
kind: fix | change ← fix: a bug to reproduce; change: no reproduction expected
model: <model>
deps: <package@range> ← the step needs a new package
```
- Keys are lowercase, at the start of the line, never bullets (`- files:` is wrong). Continuation lines are indented 2+ spaces.
- In `done-when`, every `backticked` fragment is run as a shell command in the worker's copy and must exit 0. Put only commands in backticks; plain text is the worker's responsibility.
- Unknown keys (e.g. `api:`, `example:`) are passed to the worker as hints.
## Rules
- **Size:** one step ≈ under an hour of junior-developer work. Split anything bigger.
- **One change per step:** a do: that lists three or more numbered items is refused at delegate; split it into 3a, 3b, … and order them with needs:.
- **Details as bullets:** write a do: as - bullets or prose; numbered or lettered items count as separate changes, and three or more get the task refused. `do: 1. extract X 2. move Y 3. update the import` is refused; `- extract X`, `- move Y`, `- update the import` is accepted.
- **Checks:** give every step an executable `done-when` (a test command, a type check), not only prose. Name the one test file or test id the step concerns, never the whole suite.
- **Kind:** say `kind: fix` for a bug to reproduce or `kind: change` when no reproduction is expected; otherwise the worker infers it from the step's wording.
- **Source:** put the user's request or the issue verbatim in the shared context, or pass it as `delegate(source=…)` (text or a file path): the worker checks your steps against it and reports where they disagree.
- **Scope:** `files:` lists every file or directory the step may touch, accurately. It also decides which steps can run in parallel.
- **Constraints:** add `dont:` for the mistakes you expect (new dependencies, touching auth, changing public APIs).
- **Grouping:** make independent steps separate comma groups so they run in parallel; use `needs:` when one step must land first.
- **Packages:** declare a new package with `deps:`; the worker cannot install packages itself.
- Share context once at the top (conventions, existing helpers to reuse) instead of repeating it per step.
## Example
```md
# Rate limiting for auth endpoints
Redis is already wired in src/lib/redis.ts. Keep middleware style consistent with src/middleware/*.
## 1 limiter lib
files: src/lib/rateLimit.ts, test/rateLimit.test.ts
do: sliding-window limiter `limit(key, max, windowSec) -> {allowed, retryAfter}` using redis ZSET.
done-when: `npm test -- rateLimit` passes; tests cover allow, block, window expiry
dont: add dependencies
## 2 wire into login
files: src/api/login.ts, src/middleware/, test/login.test.ts
do: 5 req/min per IP on POST /api/login; on block return 429 + Retry-After.
done-when: `npm test -- login` passes; new test: 6th request → 429
dont: touch auth/session logic
needs: 1
## 3 docs
files: docs/api.md
do: document the 429 response and Retry-After.
done-when: section "Rate limits" exists under /api/login
```
## Delegating it
- `steps="3"`: one step, one job. `steps="3-5"`: a range, run in order in one job. `steps="1-2,3"`: comma-separated groups, run in parallel unless their `files:` overlap or `needs:` orders them.
- `delegate(plan=".plan/rate-limit.md", steps="1-2,3")`
- `delegate(plan=".plan/rate-limit.md", steps="2", note="use the existing ipFrom(req) helper")`: a `note` is at most 300 characters, for one-off guidance.
© muaaz9329 · MIT · muaaz9329/cheap-ag
Похожие скиллы
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Сначала — plan-writing от других авторов.