cline-kanban - SKILL.md Agent Skill

name: cline-kanban description: "Use when managing tasks on a Cline Kanban board via CLI, creating or updating or linking or starting tasks, configuring auto-review, integrating agent hooks with kanban runtime, checking kanban configuration or local data storage, or when the user mentions 'kanban task', 'kanban hooks', 'kanban board', 'task dependency', 'auto-review', 'cline kanban', 'kanban config'."

语言规则

Task prompt 和描述默认使用中文，方便人类审查者直接阅读。代码、命令、技术术语保持英文。

概述

Cline Kanban（github.com/cline/kanban）：为 coding agent 设计的本地编排看板 CLI。

包名 kanban（kanban -v 查看版本），runtime 默认监听 127.0.0.1:3484（端口可自动调整）
所有 task 命令输出 JSON；错误时 JSON + exitCode 1
Task ID 格式：5 位短字符串（截取自 UUID）

命令速查表

命令	用途
`kanban`	启动 runtime 服务（含 Web UI）
`kanban task create`	创建新任务（进入 backlog 顶部）
`kanban task update`	更新任务字段
`kanban task start`	启动任务（创建 worktree + agent session）
`kanban task list`	列出任务（默认排除 trash）
`kanban task trash`	移入 trash（可恢复，解锁依赖）
`kanban task delete`	永久删除（不可恢复）
`kanban task link`	建立依赖（A 等待 B）
`kanban task unlink`	删除依赖
`kanban hooks notify`	向 runtime 发送事件（best-effort）
`kanban hooks ingest`	向 runtime 发送事件（失败报错）
`kanban hooks gemini-hook`	Gemini agent 专用 hook 包装器
`kanban hooks codex-wrapper`	Codex agent 专用包装器

Codex Agent 注意事项

Codex 的完成检测与其他 agent 不同——它依赖进程退出而非 session log 事件。使用要点：

必须开 auto-review：--auto-review-enabled true --auto-review-mode commit
只给实施型 task：纯分析/review 工作会卡住（Codex 完成后不退出进程）
不要用 plan mode：--start-in-plan-mode 与 Codex 不兼容
不要 kill 进程：会触发 auto-restart 而非完成；用 kanban task trash 代替

任务生命周期

create (→ backlog 顶部)
  → start (→ in_progress + worktree + session)
  → agent 工作
  → hooks notify --event to_review (→ review)
  → auto-review 或手动审查
  → trash（保留 patch，依赖解锁）
  → 可选 delete（永久删除）

共享选项

所有 task 子命令支持 --project-path <path>，默认当前工作目录。

详细参考

文档	内容
任务管理	create/update/start/list/trash/delete 详细参数与行为
依赖管理	link/unlink、方向语义、自动重定向规则
Hooks 集成	事件类型、ingest/notify、payload 格式、Gemini/Codex 适配
配置与存储	全局/项目配置、数据目录结构、环境变量
实战指南	端到端工作流、常见操作、错误处理、坑点清单
网络行为与遥测	外部请求、Sentry、自动更新、隐私控制