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

ak-maintainer — скилл для Claude Code: управление проектом через Kanban

Скилл ak-maintainer для координации работы над проектом через Agent Kanban. Инспектирует очередь задач, распределяет их между другими агентами и проверяет результаты — как менеджер проекта.

Apache-2.0 105 установок ★ 506 обновлён 2026-10-02

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add saltbo/agent-kanban --skill ak-maintainer -a claude-code
Открыть на GitHub

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

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

~/.claude/skills/ak-maintainer/SKILL.md

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

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

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
deliver-launch-checklist product-on-purpose Скилл deliver-launch-checklist для Claude Code собирает межфункциональный чек-лист перед выпуском. Он подключается к планированию крупного или межкомандного запуска. CX Codex +1 878установок event-planning-timeline Samuel Berthe Скилл event-planning-timeline для Claude Code строит обратный план подготовки технического события: параллельные треки, зависимости между ними и точки перепланирования. Запускается от зафиксированной даты открытия дверей. CX Codex +1 6 600установок Rillsoft Project rillsoft Встроенный в Rillsoft Project 10, открывает AI-ассистенту доступ к расписанию, ролям, людям, машинам и материалам многопроектного плана. CX Codex +1 gao-schedule jgsystemsconsulting Скилл gao-schedule для Claude Code помогает строить и проверять интегрированный график программы. Используйте его для оценки критического пути, рисков сроков и контроля базового плана. CX Codex +1 ★ 93звёзд репо look-ahead-scheduler datadrivenconstruction Скилл look-ahead-scheduler генерирует скользящие графики работ на 2, 3 или 6 недель вперёд с анализом ограничений и распределением бригад. Помогает выявить проблемы расписания за несколько недель до их наступления. CX Codex +1 123установок maintainer-decline posit-dev Скилл maintainer-decline помогает авторам открытых библиотек вежливо закрывать чужие issue и отклонять pull request. Разъясняет технические причины отказа и подсказывает альтернативы. CX Codex +1 484установок

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

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

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