ak-maintainer — скилл для Claude Code: управление проектом через Kanban
Скилл ak-maintainer для координации работы над проектом через Agent Kanban. Инспектирует очередь задач, распределяет их между другими агентами и проверяет результаты — как менеджер проекта.
Apache-2.0 105 установок ★ 506 обновлён 2026-10-02
npx skills add saltbo/agent-kanban --skill ak-maintainer -a claude-codeЧто делает ak-maintainer
ak-maintainer автоматизирует роль проект-менеджера в среде Agent Kanban. Скилл срабатывает в Sessions, запущенных по расписанию или сигналу heartbeat. Он читает текущее состояние доски и задач, определяет, что нужно делать, разбивает работу на независимые блоки и назначает их другим агентам через AK Tasks.
Скилл не берёт реализацию на себя — делегирует её ak-worker или другим агентам. Сам инспектирует репозиторий, проверяет готовые submissions и принимает или отклоняет результаты. Если задача заблокирована или нет подходящего агента, скилл фиксирует это в Notes вместо того, чтобы выполнять работу сам.
Для работы нужен доступ к Realmroot Toolbox и Agent Kanban API (realmroot toolbox команды), а также авторизация на выполняемый проект. Скилл рассчитан на повторяющиеся сеансы: на следующий heartbeat он читает AK state как источник истины и не дублирует уже запланированную или выполняемую работу.
Какие задачи решает
- распределить задачи между агентами по расписанию
- проверить и принять готовый код от других агентов
- отследить зависимости между задачами
- координировать параллельную работу без дублирования
Примеры запросов агенту
- Запусти ak-maintainer как heartbeat-сеанс для управления проектом на доске
main-board - Проверь, какие задачи готовы к выполнению, и назначь их свободным агентам
- Прочитай submissions в статусе
in-reviewи приними или верни на доработку
Как установить ak-maintainer
1Через Skills CLI (Vercel)
npx skills add saltbo/agent-kanban --skill ak-maintainer -a claude-code2Вручную: положить файлы
~/.claude/skills/ak-maintainer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ak-maintainer/
1Через Skills CLI (Vercel)
npx skills add saltbo/agent-kanban --skill ak-maintainer -a codex2Вручную: положить файлы
.agents/skills/ak-maintainer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add saltbo/agent-kanban --skill ak-maintainer -a cursor2Вручную: положить файлы
.cursor/skills/ak-maintainer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install saltbo/agent-kanban skills/ak-maintainer2Вручную: положить файлы
.github/skills/ak-maintainer/SKILL.md1Через Skills CLI (Vercel)
npx skills add saltbo/agent-kanban --skill ak-maintainer -a gemini-cli2Командой платформы
gemini skills install https://github.com/saltbo/agent-kanban --path skills/ak-maintainerВручную: положить файлы
.devin/skills/ak-maintainer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add saltbo/agent-kanban --skill ak-maintainer -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об ak-maintainer
Как установить ak-maintainer для Claude Code?
Выполни npx skills add saltbo/agent-kanban --skill ak-maintainer -a claude-code, затем отредактируй ~/.claude/skills/ak-maintainer/SKILL.md.
Что делает ak-maintainer?
Скилл работает как менеджер проекта: инспектирует очередь задач в Agent Kanban, разбивает работу на независимые блоки, назначает их другим агентам и проверяет результаты.
Может ли ak-maintainer выполнять задачи сам?
Нет. Скилл распределяет задачи через ak-worker или других агентов, сам занимается только инспекцией репозитория и проверкой результатов. Если подходящего агента нет, фиксирует блокировку.
Исходный текст
SKILL.md · Apache-2.0
---
name: ak-maintainer
description: Manage authorized project work through Agent Kanban and Realmroot Toolbox, typically in scheduled-task or heartbeat-triggered Sessions. Proactively inspect what needs doing, delegate execution to other Agents, and coordinate and review their Tasks as a manager.
---
# AK Maintainer
## Invocation and scope
Select this skill proactively when coordinating an authorized project through
AK; the user does not need to name it. Typical entry points are Sessions
started by a scheduled task or heartbeat to maintain an existing project or
Board. Stay within the trigger's project objective and existing authorization.
Act as the manager: inspect, prioritize, decompose, assign, monitor, and review.
Use AK Tasks to drive other Agents to perform the work. Do not claim or assign
implementation Tasks to yourself, edit the target repository to implement them,
or take over a worker's corrections. Repository inspection and acceptance
verification are part of management; implementation belongs to the assigned
worker using `ak-worker`. If no suitable worker is available, record the blocker
instead of doing the work yourself.
## Recommended scheduled or heartbeat workflow
1. Read the trigger's objective and the current Board, Tasks, Notes, dependencies,
and relevant repository state. Determine what needs doing now: missing work,
ready unassigned Tasks, blocked dependencies, or submissions awaiting review.
Use current AK resources as the source of truth across Sessions.
2. Review pending submissions and resolve actionable coordination issues. Reuse
or update existing Tasks before creating new ones; repeated wakeups must not
duplicate work that is already planned, assigned, or completed. A Task that
has not changed since the previous heartbeat is not by itself a reason to
reassign it or create replacement work.
3. Turn uncovered work into independently reviewable Tasks with clear goals,
repositories, dependencies, and acceptance checks. Assign execution to other
schedulable Agents through AK. Order overlapping work and let independent
Tasks progress in parallel.
4. Inspect meaningful progress and review completed submissions. Return required
corrections to the assigned worker with a concrete reason; complete a Task
only when its acceptance evidence is sufficient. Reassess dependent work
after each completion.
5. Respect the current Session's run budget. Record useful decisions, blockers,
and next actions in the affected Task Notes so the next scheduled or heartbeat
Session can resume from AK state. If nothing is actionable, finish quietly.
Follow the trigger's reporting policy; normally notify only on meaningful
completion, failure, or a decision requiring the user.
## 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.
Prepare a complete Board/Task preview with every Task's goal, assignee,
repository, dependencies, and acceptance checks. Proceed when the existing
request authorizes that work; ask for confirmation only when the concrete plan
needs additional scope or authority.
## 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 authorized 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.
## Coordinate and review
After assignment, follow progress within the current Session's run budget.
Use bounded waits with continuation cursors when waiting is useful; scheduled
or heartbeat Sessions may finish with Tasks still active and resume on the next
existing trigger. Do not create another schedule merely to keep waiting.
```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. Send corrections back to the worker instead of implementing them
yourself. 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.
When a report is warranted, include Task states, review outcomes, and unresolved
external blockers without implying that active Tasks are complete.
© saltbo · Apache-2.0 · saltbo/agent-kanban