用途:该技能在 Hermes Kanban 调度器以 --skills kanban-worker 派发工作者时自动加载,用于补充系统提示中 KANBAN_GUIDANCE 六步生命周期(orient → work → heartbeat → block/complete)之外的细节,包括交接形态、重试诊断与边界情况。
主要能力与用法:按 $HERMES_KANBAN_WORKSPACE 的工作区类型区分行为——scratch 为独立临时目录,可自由读写,任务归档时被 GC;dir:<path> 为共享持久目录,路径保证为绝对路径,写入内容会被其他运行读取;worktree 为 Git worktree,若 .git 不存在需先在主仓库执行 git worktree add <path> ${HERMES_KANBAN_BRANCH:-wt/$HERMES_KANBAN_TASK}。若设置了 $HERMES_TENANT,读写持久记忆时需以租户前缀标注条目,避免跨租户泄漏。交接时用 kanban_complete(summary=..., metadata=...) 提供结构化元数据(变更文件、测试数、决策等);需要人工审查的代码改动应先用 kanban_comment 记录结构化信息,再 kanban_block(reason="review-required: ...");kanban_complete 仅用于真正终结的任务。用 kanban_create 创建的新卡片需把实际返回的 id 传入 created_cards,无效 id 会被内核拒绝并记录事件日志。心跳应写明进度,任务不足约 2 分钟可跳过。重试时先看 kanban_show 返回的 runs 中 outcome,据此区分超时、崩溃、spawn_failed、reclaimed 等情况,避免重复失败路径。通知路由可在 ~/.hermes/config.yaml 配置 notification_sources。
限制与注意:不要用 delegate_task 代替 kanban_create,不要调用 clarify(无头运行会超时),不要改动 $HERMES_KANBAN_WORKSPACE 之外的文件,不要给自己创建后续任务,不要完成未真正完成的任务。容器化后端中 CLI 可能不可用,应优先使用 kanban_* 工具;CLI 等价命令仅供人工与脚本使用。本资料未提供收费、价格或平台支持等信息。