SuperAPI AI 工具集

kanban-worker

智能体与模型

查看项目

更新于 10-16 02:33

技能介绍

用途:本技能面向被 Hermes Kanban 调度器以 --skills kanban-worker 派发的 worker,补充生命周期之外的细节,包括交接格式、重试诊断与边界情况。生命周期六步(orient → work → heartbeat → block/complete)由系统提示中的 KANBAN_GUIDANCE 自动注入。

主要能力与用法: 工作区按类型处理:scratch 为独占临时目录,可自由读写,任务归档后被回收;dir:<path> 为共享持久目录,写入内容会被其他运行读取,路径保证为绝对路径;worktree 为 Git 工作树,若 .git 不存在,先在主仓库执行 git worktree add <path> ${HERMES_KANBAN_BRANCH:-wt/$HERMES_KANBAN_TASK},再进入目录工作并提交。 若设置了 $HERMES_TENANT,读写持久记忆时需以租户为前缀,避免上下文跨租户泄漏。 交接:用 kanban_complete(summary=..., metadata=...) 向下游传递结果,metadata 应结构化便于解析。代码类任务若需人工复核,应先用 kanban_comment 写入变更文件、测试数、diff 路径等,再 kanban_block(reason="review-required: ..."),由复核者执行 hermes kanban unblock <id> 或留言要求修改。仅当任务真正终结时才用 kanban_complete。 交付物:把图表、PDF、表格等绝对路径传给 kanban_complete(artifacts=[...]),通知器会上传为原生附件;仅顶层 artifacts 会被扫描,不要埋在 metadata 里;文件在完成时必须仍存在。 新建卡片:若本次运行通过 kanban_create 创建了任务,需把捕获到的返回 id 传入 created_cards,内核会校验归属,伪造 id 会阻止完成并记录事件。 阻塞与心跳:阻塞原因应一句话点明所需决策,长上下文放评论;心跳应写明进度,如“epoch 12/50, loss 0.31”,任务不足约两分钟可跳过。 重试:若 kanban_show 返回已关闭的 runs,可据 outcome 判断:timed_out 需分块或缩短;crashed 需降低内存;spawn_failed 多为配置问题,应阻塞询问;reclaimed 说明任务可能已被归档。 通知路由:可在 ~/.hermes/config.yaml 配置 notification_sources,['*'] 接受所有 profile,也可限定具体 profile,省略则保持默认隔离。

限制与禁止:不要用 delegate_task 替代 kanban_create;无头运行中不要调用 clarify,应改用评论加阻塞;不要修改 $HERMES_KANBAN_WORKSPACE 之外的文件(除非任务说明要求);不要把后续任务指派给自己;未真正完成不要标记完成。容器化后端中 CLI 可能不可用,应优先使用 kanban_* 工具;CLI 等价命令供人工与脚本使用,如 hermes kanban show <id> --json、hermes kanban complete <id> --summary "..." --metadata '{...}'、hermes kanban block <id> "reason"、hermes kanban create "title" --assignee <profile> [--parent <id>]。