mcpField
A
ak-plan

ak-plan

github.com/saltboAgent 工作流493133 次安装7 周前更新
代码仓库

关于 ak-plan

ak-plan 是将已批准的工作拆分为 Agent Kanban Board 和 Task，并分配 Agent、跟进执行与审核的技能。它按可独立审核的边界组织工作，并明确依赖关系和验收条件。

主要功能

  1. 01检查现有 Board、仓库和 Task
  2. 02规划架构、职责边界与依赖
  3. 03预览完整计划并征求确认
  4. 04创建 Board、仓库和已分配的 Task
  5. 05跟进进度并审核提交成果

适用场景

  1. 01将项目需求拆分为可审核的 Task
  2. 02协调存在依赖及可并行的工作
  3. 03跟踪结果并报告阻塞因素

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/saltbo/agent-kanban --skill ak-plan

安装后在 Claude Code 中输入/ak-plan确认已加载。

附带文件agents/openai.yaml

详细介绍

AK Plan

创建前规划

在拆分工作前，阅读仓库和现有的 AK 资源：

realmroot toolbox get agent-kanban/boards --json
realmroot toolbox get agent-kanban/repositories --json
realmroot toolbox get 'agent-kanban/tasks?boardId=<board-id>' --json

确定架构方向、共享契约、职责边界和依赖关系图。按可独立审查的行为或模块边界拆分工作，而非按时间顺序或职位拆分。避免设置最后一个包揽所有工作的 QA Task；每个 Task 都应负责自己的实现和验证。

向用户展示完整的 Board/Task 预览，并在创建前获得确认。预览应包含每个 Task 的目标、负责人、仓库、依赖项和验收检查。

创建资源

仅在 Board 或 Repository 尚不存在时创建：

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

选择一个报告 schedulable: true 的可用 Agent：

realmroot toolbox get 'agent-kanban/agents?schedulable=true' --json

将所选 Agent 的 subject 用作 assignedTo。如果没有合适的 Agent，且调用方有权创建 Agent，则通过 agent-kanban/agents 创建。

对于每个已批准的工作项，先创建一个未分配的 Task，再更新其 assignedTo 字段：

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 会生成所需的幂等键，并在本次调用发生暂时性重试时重复使用该键。只有在使用之前调用中已知的键进行恢复，且该调用的结果仍不明确时，才应显式提供 Idempotency-Key。

在 dependsOn 中填写实际的前置依赖。涉及重叠文件或契约的 Task 应合并或排序；只有相互独立的 Task 才应并行执行。

执行与审查

创建后，除非用户要求停止，否则继续执行，直到每个 Task 都进入终态。使用带有续传游标的有界等待：

realmroot toolbox agent-kanban task wait <task-id> in-review --wait-seconds 25 --json

当 Task 进入 in-review 时，先验证提交的工作，然后重新读取 Task，再作出审查决定：

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

如果验收证据或实现不充分，则拒绝，并等待 Task 再次进入 in-review。只有在已证明达到所请求的结果后，才能完成。如果经过验证的审查者与 Task 的 assignedTo 相同，则不要尝试作出任何一种审查决定；必须由另一位获授权的主体进行审查。

当前置 Task 完成后，重新评估其依赖 Task。 报告最终的 Task 状态、审查结果和未解决的外部阻塞项。

评论

支持 Markdown