Kagan 是一个面向 OpenCode 的插件，其核心目标是把 AI 编码代理的工作转化为看板上的受监督任务。
用途与主要能力：每个任务是一个 OpenCode 会话，运行在隔离的 git worktree 中。任务在看板上按 Backlog → In Progress → Review → Done 流动，每次转换都有闸门：代理运行前进行 intake，用户批准前进行 review，只有用户确认后才执行合并。代理不会操作用户的 checkout，而是在自己的 worktree 中基于 kagan/<slug> 分支工作；reviewer 代理会针对原始任务提交分级发现（ranked findings），在用户对每个发现完成分级并选择是否合并、合并到何处之前，任务不会进入 Done。
使用方式：需要 OpenCode 1.17.13 或更新版本（参见 package.json 中的 engines.opencode）。可全局安装，使 Kagan 在任意项目中可用；也可将本地克隆添加到两个 OpenCode 配置文件中。通过命令面板中的 /kagan、kagan palette 命令或 <leader>k（leader 键默认为 ctrl+x）打开看板。在任意常规 OpenCode 会话中，运行 /kagan-task 可以以对话方式创建看板任务，适合一次性规划多个工单而无需为每个工单打开看板创建对话框。选项可通过 array-of-array 形式传入，或从项目中打开 /kagan-settings，详见配置参考。
更新机制：对于全局 npm 安装，Kagan 会检查 npm 上更新的稳定版本，并在看板页脚显示可用版本。按 u、运行 /kagan-update，或使用命令面板来查看并确认更新；Kagan 随后安装确切的发布版本，并要求重启 OpenCode。本地、文件及开发安装永远不会被自动更新。
文档位于 docs/，并提供 Quickstart。
限制：所需的 OpenCode 最低版本为 1.17.13；本地、文件及开发安装不支持自动更新。
