К основному содержанию
скилл CX Codex

plan-writing · muaaz9329 — скилл для Claude Code: планы Cheap Agent

Скилл plan-writing для Claude Code готовит или исправляет план Cheap Agent перед вызовом инструмента делегирования cheapag. Он включается для изменений больше ~20 строк, нескольких файлов или после отклонения плана.

MIT ★ 341 обновлён 2026-11-16

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add muaaz9329/cheap-ag
/plugin install cheapag@cheap-agent
Открыть на GitHub

Что делает 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-code

3Вручную: положить файлы

~/.claude/skills/plan-writing/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/plan-writing/

По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.

plan-writing davila7 Скилл plan-writing разбивает работу на короткие задачи с критериями проверки. Пригодится при добавлении фичи, рефакторинге или любой многошаговой работе. CX Codex +1 188установок writing-skills Jesse Vincent Скилл writing-skills для Claude Code и Codex, который обучает агента создавать, редактировать и проверять скиллы по циклу TDD. Перед написанием скилла агент сначала фиксирует, как нарушает правило без него. CX Codex +1 217 894установок technical-writing riekelt Скилл technical-writing для Claude Code задаёт правила структуры, проверки фактов и стиля технических документов. Помогает писать README, спецификации, отчёты и планы. CX Codex +1 27 800установок writing-runbooks riekelt Скилл writing-runbooks для написания ранбуков, инструкций по установке и миграции, где читатель выполняет шаги под давлением времени. CX Codex +1 26 700установок changelog-writing Samuel Berthe Скилл changelog-writing превращает коммиты, пул-реквесты и тикеты в релиз-ноты, которые читают: что вышло, что это значит на практике и что ломается. CX Codex +1 13 400установок om-spec-writing open-mercato Скилл om-spec-writing помогает писать и проверять спецификации фич: от каркаса и открытых вопросов до архитектурного разбора и плана реализации. CX Codex +1 3 900установок jupyter-notebook-writing zc277584121 Скилл jupyter-notebook-writing для Claude Code редактирует Jupyter-ноутбуки через Markdown вместо JSON. Файл .md конвертируется в .ipynb через jupyter-switch. CX Codex +1 3 900установок

Из того же набора8

cheapag Плагин cheapag для Claude Code перепоручает написание кода дешёвым моделям, оставляя планирование и ревью основной модели. Экономит токены на рутинных задачах через внешний MCP-сервер. ★ 341звёзд репо clean Скилл clean для Claude Code удаляет старые worktree Cheap Agent и журналы заданий. Флаг --all очищает всё, что не выполняется сейчас. CX Codex +1 ★ 341звёзд репо status Скилл status для Claude Code показывает состояние задач Cheap Agent в репозитории. Он выводит список запущенных работ, недавние результаты, статус согласия и лимиты расходов. CX Codex +1 ★ 341звёзд репо hook Скилл hook для Claude Code включает и выключает защиту правок в репозитории. Защита перенаправляет крупные изменения и третью правку одного файла за ход агенту-делегату. CX Codex +1 ★ 341звёзд репо allow Скилл allow для Claude Code управляет согласием на передачу кода во внешние модели Cheap Agent. Он запускается для настройки области доступа и параметров обработки данных в репозитории. CX Codex +1 ★ 341звёзд репо provider Скилл provider для Claude Code переключает воркера на настроенного провайдера и переносит согласие репозитория. Ключ при этом не запрашивается. CX Codex +1 ★ 341звёзд репо model Скилл model для Claude Code настраивает основную и запасную языковые модели воркера. Запускает пошаговый выбор вариантов через CLI-утилиту cheap-agent. CX Codex +1 ★ 341звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой