词元之母TOK.MOM - 平台充值汇率 1:1 即 1 人民币充值到账 1 美元，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
"Kanban Worker — Hermes Kanban worker 的陷阱、示例与边界情况"
Kanban Worker
KANBAN_GUIDANCE（来自 agent/prompt_builder.py）；当你需要深入了解特定场景时，加载此 skill 即可。Skill 元数据
| 来源 | 内置（默认安装） |
| 路径 | skills/devops/kanban-worker |
| 版本 | 2.0.0 |
| 平台 | linux, macos, windows |
| 标签 | kanban, multi-agent, collaboration, workflow, pitfalls |
| 相关 skill | kanban-orchestrator |
参考：完整 SKILL.md
信息
Kanban Worker — 陷阱与示例
你看到此 skill，是因为 Hermes Kanban 调度器以 --skills kanban-worker参数将你作为 worker 派生——它会为每个被派发的 worker 自动加载。生命周期（6 个步骤：orient → work → heartbeat → block/complete）也存在于自动注入到你系统 prompt 中的KANBAN_GUIDANCE块里。此 skill 是更深层的细节：良好的交接形式、重试诊断、边界情况。
工作区处理
$HERMES_KANBAN_WORKSPACE 内部的行为方式：| 类型 | 含义 | 操作方式 |
|---|---|---|
scratch | 全新的临时目录，仅供你使用 | 自由读写；任务归档后会被 GC 回收。 |
dir:<path> | 共享的持久化目录 | 其他运行实例会读取你写入的内容。将其视为长期状态。路径保证为绝对路径（内核拒绝相对路径）。 |
worktree | 位于已解析路径的 Git worktree | 若 .git 不存在，先从主仓库执行 git worktree add <path> <branch>，然后 cd 进去正常工作。在此提交工作。 |
租户隔离
$HERMES_TENANT 已设置，则该任务属于某个租户命名空间。在读写持久化内存时，请为内存条目添加租户前缀，以防上下文跨租户泄漏：business-a: Acme is our biggest customerAcme is our biggest customer良好的 summary + metadata 形式
kanban_complete(summary=..., metadata=...) 的交接方式是下游 worker 读取你工作成果的途径。以下是有效的模式：reason 前加 review-required: 前缀，以便仪表板将该行标记为待审查。先将结构化元数据（变更文件、测试计数、diff/PR url）写入 comment，因为 kanban_block 只携带人类可读的原因——comment 是持久化注释的渠道。审查者可执行 hermes kanban unblock <id> 批准（这会携带 comment 线程重新派生你以处理后续事项），或通过另一条 comment 要求修改。kanban_complete——例如单行拼写修复、无功能影响的文档变更，或产出物本身即为成果的研究任务。metadata 的结构设计为下游解析器（审查者、聚合器、调度器）无需重新阅读你的文字描述即可直接使用。认领你实际创建的卡片
kanban_create），请在 kanban_complete 的 created_cards 中传入这些 id。内核会验证每个 id 是否存在且由你的 profile 创建；任何幻构的 id 都会导致完成操作被阻断，并附带错误列表说明问题所在，且被拒绝的尝试会永久记录在任务的事件日志中。只列出你从成功的 kanban_create 返回值中捕获的 id——绝不凭空捏造 id，绝不粘贴来自早期运行的 id，绝不认领其他 worker 创建的卡片。kanban_create 调用失败（异常、tool_error），则卡片未被创建——不要为其包含幻构 id。重试创建，或省略该 id 并在 summary 中说明失败情况。散文扫描阶段也会捕获你自由格式 summary 中无法解析的 t_<hex> 引用；这些不会阻断完成操作，但会在仪表板的任务上显示为建议性警告。能快速得到回应的 block 原因
"stuck" — 人类没有任何上下文。值得发送的 heartbeat
"epoch 12/50, loss 0.31"、"scanned 1.2M/2.4M rows"、"uploaded 47/120 videos"。"still working"、空 notes、亚秒级间隔。最多每隔几分钟发送一次；对于约 2 分钟以内的任务可完全跳过。重试场景
kanban_show 返回的 runs: [...] 中包含一个或多个已关闭的运行，说明你是一次重试。先前运行的 outcome / summary / error 会告诉你哪里出了问题。不要重复那条路径。典型的重试诊断：outcome: "timed_out" — 上次尝试达到了 max_runtime_seconds。你可能需要将工作分块或缩短。outcome: "crashed" — OOM 或段错误。减少内存占用。outcome: "spawn_failed" + error: "..." — 通常是 profile 配置问题（缺少凭证、错误的 PATH）。通过 kanban_block 询问人类，而不是盲目重试。outcome: "reclaimed" + summary: "task archived..." — 操作员在上次运行期间将任务归档；你可能根本不应该在运行，请仔细检查状态。outcome: "blocked" — 上次尝试被阻断；解除阻断的 comment 现在应该已在线程中。禁止事项
delegate_task 替代 kanban_create。delegate_task 用于你的运行内部的短期推理子任务；kanban_create 用于跨 agent 的、超出单次 API 循环的交接。$HERMES_KANBAN_WORKSPACE 之外的文件，除非任务正文明确要求。陷阱
kanban_show。若其报告 blocked 或 archived，请停止——你不应该在运行。dir: 和 worktree 工作区可能包含来自先前运行的文件。阅读 comment 线程——它通常会解释你为何再次运行以及工作区处于何种状态。kanban_* 工具可在所有终端后端（Docker、Modal、SSH）上工作。从你的终端工具执行 hermes kanban <verb> 在容器化后端中会失败，因为 CLI 未安装在那里。如有疑问，使用工具。CLI 回退（用于脚本）
kanban_show ↔ hermes kanban show <id> --jsonkanban_complete ↔ hermes kanban complete <id> --summary "..." --metadata '{...}'kanban_block ↔ hermes kanban block <id> "reason"kanban_create ↔ hermes kanban create "title" --assignee <profile> [--parent <id>]修改于 2026-05-31 00:25:01