ak-plan — скилл для Claude Code: план и управление проектами
Скилл ak-plan для Claude Code разбивает большой проект на управляемые задачи и запускает их выполнение через Agent Kanban. Координирует работу агента по доске задач.
Apache-2.0 139 установок ★ 506 обновлён 2026-10-02
npx skills add saltbo/agent-kanban --skill ak-plan -a claude-codeЧто делает ak-plan
ak-plan читает существующие доски и репозитории Agent Kanban, затем разбивает проект на независимые задачи с чёткими границами владения и зависимостями между ними. Вместо последовательных шагов скилл разделяет работу по модулям или поведению — так задачи можно выполнять параллельно и легче проверять отдельно.
После одобрения плана скилл создаёт задачи в Kanban, назначает их доступным агентам (которые отмечены как schedulable: true) и отслеживает их статус. Когда задача попадает на проверку, скилл проверяет результат и либо одобряет, либо просит переделать с описанием, что не сходится.
Для работы нужны утилиты realmroot toolbox и доступ к Agent Kanban API. Скилл не создаёт новые ресурсы, если они уже существуют — сначала проверяет, что есть.
Какие задачи решает
- разбить крупный проект на независимые задачи
- назначить задачи разным агентам и отследить их выполнение
- проверить результаты и вернуть на доработку при необходимости
- управлять зависимостями между задачами и избежать параллельной работы на одних файлах
Примеры запросов агенту
- Спланируй и создай доску задач для проекта: нужно собрать API, написать тесты и документацию
- Создай задачи через ak-plan для интеграции с Stripe, включая проверку платежей
- Выполни проект через Agent Kanban: распредели работу, дождись результатов и проверь каждую задачу
Как установить ak-plan
1Через Skills CLI (Vercel)
npx skills add saltbo/agent-kanban --skill ak-plan -a claude-code2Вручную: положить файлы
~/.claude/skills/ak-plan/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ak-plan/
1Через Skills CLI (Vercel)
npx skills add saltbo/agent-kanban --skill ak-plan -a codex2Вручную: положить файлы
.agents/skills/ak-plan/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add saltbo/agent-kanban --skill ak-plan -a cursor2Вручную: положить файлы
.cursor/skills/ak-plan/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install saltbo/agent-kanban skills/ak-plan2Вручную: положить файлы
.github/skills/ak-plan/SKILL.md1Через Skills CLI (Vercel)
npx skills add saltbo/agent-kanban --skill ak-plan -a gemini-cli2Командой платформы
gemini skills install https://github.com/saltbo/agent-kanban --path skills/ak-planВручную: положить файлы
.devin/skills/ak-plan/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add saltbo/agent-kanban --skill ak-plan -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об ak-plan
Как установить ak-plan в Claude Code?
Запустите команду npx skills add saltbo/agent-kanban --skill ak-plan -a claude-code, затем найдите файл ~/.claude/skills/ak-plan/SKILL.md для проверки.
Что делает ak-plan?
Скилл помогает агенту спланировать проект, разбить его на задачи с правильными зависимостями, создать доску в Agent Kanban и следить за выполнением каждой задачи от начала до проверки.
Какие инструменты нужны для работы ak-plan?
Нужны realmroot toolbox для работы с Agent Kanban API и доступ к доскам и репозиториям в самом Kanban. Скилл проверяет доступных агентов перед тем, как назначать им задачи.
Исходный текст
SKILL.md · Apache-2.0
---
name: ak-plan
description: Plan and execute a multi-Task project through Agent Kanban resources and Realmroot Toolbox. Use only when the user explicitly asks for AK Plan, an Agent Kanban project plan, or execution of a project through an AK board.
---
# AK Plan
## Plan before creating
Read the repository and existing AK resources before decomposition:
```bash
realmroot toolbox get agent-kanban/boards --json
realmroot toolbox get agent-kanban/repositories --json
realmroot toolbox get 'agent-kanban/tasks?boardId=<board-id>' --json
```
Define the architecture direction, shared contracts, ownership boundaries, and
dependency graph. Split work by independently reviewable behavior or module
boundary, not by chronological steps or job titles. Avoid a final catch-all QA
Task; each Task owns its implementation and proof.
Show the user the complete Board/Task preview and get confirmation before any
creation. Include every Task's goal, assignee, repository, dependencies, and
acceptance checks.
## Create resources
Create a Board or Repository only when it does not already exist:
```bash
realmroot toolbox post agent-kanban/boards --content-type application/json @board.json --json
realmroot toolbox post agent-kanban/repositories --content-type application/json @repository.json --json
```
Select an available Agent that reports `schedulable: true`:
```bash
realmroot toolbox get 'agent-kanban/agents?schedulable=true' --json
```
Use the selected Agent's `subject` as `assignedTo`. If no suitable
Agent exists and the caller is authorized to provision one, create it through
`agent-kanban/agents`.
For each approved work item, create an unassigned Task, then patch its
`assignedTo` field:
```bash
realmroot toolbox post agent-kanban/tasks --content-type application/json @task.json --json
realmroot toolbox patch agent-kanban/tasks/<task-id> \
--content-type application/merge-patch+json \
'{"assignedTo":"<realmroot-agent-actor-id>"}' --json
```
Realmroot Toolbox generates the required idempotency key and
reuses it across transient retries of this invocation. Supply an explicit
`Idempotency-Key` only when recovering with the known key from an earlier
invocation whose outcome remained unknown.
Encode real prerequisites in `dependsOn`. Tasks with overlapping files or
contracts should be combined or ordered; only independent Tasks should run in
parallel.
## Execute and review
After creation, continue until every Task is terminal unless the user asks to
stop. Use bounded waits with continuation cursors:
```bash
realmroot toolbox agent-kanban task wait <task-id> in-review --wait-seconds 25 --json
```
When the Task reaches `in-review`, verify the submitted work, then reread the
Task before making the review decision:
```bash
realmroot toolbox get agent-kanban/tasks/<task-id> --include --json
realmroot toolbox patch agent-kanban/tasks/<task-id> \
--content-type application/merge-patch+json \
'{"status":"in-progress","statusReason":"Describe the required correction"}' --json
realmroot toolbox patch agent-kanban/tasks/<task-id> \
--content-type application/merge-patch+json \
'{"status":"done"}' --json
```
Reject when acceptance evidence or implementation is insufficient, then wait
for a new `in-review` Task state. Complete only after the requested outcome is
proven. If the verified reviewer actor equals the Task's
`assignedTo`, do not attempt either decision; another authorized principal
must review.
When one prerequisite completes, reassess its dependent Tasks.
Report the final Task states, review outcomes, and unresolved external blockers.
© saltbo · Apache-2.0 · saltbo/agent-kanban