ak-plan

GitHub

基于Agent看板规划并执行多任务项目,涵盖资源创建、任务分配、依赖管理及自动化执行与审查流程。

skills/ak-plan/SKILL.md saltbo/agent-kanban

Trigger Scenarios

用户明确要求使用AK Plan 需要规划或执行通过Agent看板进行的多任务项目

Install

npx skills add saltbo/agent-kanban --skill ak-plan -g -y
More Options

Use without installing

npx skills use saltbo/agent-kanban@ak-plan

指定 Agent (Claude Code)

npx skills add saltbo/agent-kanban --skill ak-plan -a claude-code -g -y

安装 repo 全部 skill

npx skills add saltbo/agent-kanban --all -g -y

预览 repo 内 skill

npx skills add saltbo/agent-kanban --list

SKILL.md

Frontmatter
{
    "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:

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:

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:

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:

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:

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:

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.

Version History

  • 7fea6dc Current 2026-09-22 10:24

    新增对可调度Agent的发现逻辑,支持在指定Agent不可用时授权创建新Agent,并优化了幂等键处理机制。

  • 448506c 2026-09-09 04:43

    重构任务资源操作:发布 OpenAPI 契约,用 PATCH 替代生命周期路由,移除遗留端点及 Claim 删除逻辑,引入 CAS 机制与分页优化。

  • 8944f97 2026-09-03 06:06

    重构为 v2 架构,替换旧版 CLI 和运行时,对齐 Toolbox 幂等性契约,强化边界清理。

  • a26bef6 2026-08-19 21:23

    优化未人工干预阶段的执行契约,细化审查所有权处理逻辑,提升长流程执行的稳定性与自动化程度。

  • 1d2146d 2026-07-24 20:44

Same Skill Collection

skills/agent-kanban/SKILL.md
skills/ak-maintainer/SKILL.md
skills/ak-task/SKILL.md
skills/ak-worker/SKILL.md

Metadata

Files
0
Version
7fea6dc
Hash
a754782f
Indexed
2026-07-24 20:44

Accueil - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-17 13:09
浙ICP备14020137号-1