核心定位
Kanban Workflow 是一个面向 Agentic 协同的 TypeScript 工作流引擎，将 "PM 平台适配器 + 标准化阶段模型" 封装为可复用的 stage:* 生命周期。它不直接管理 OAuth 或密钥，而是复用各平台既有 CLI（gh、plane、linear 等）的认证体系，降低集成成本。
显著优点
1. 统一阶段语义：强制收敛到 backlog/blocked/in-progress/in-review 四阶段，消除跨平台概念漂移；适配器负责将 GitHub Labels、Linear Workflow States、Plane 状态字段映射到标准模型。
2. CLI-first 架构：通过外部 CLI 而非 SDK 接入，天然继承宿主环境的认证会话（gh auth、PLANE_API_KEY 等），无需在技能内存储敏感令牌。
3. Verb-driven 交互：setup → next → start → ask/update → complete 的引导式命令流，配合 What next: 提示，降低人机/机机协作的认知负荷。
4. 可编排的自动化：内置 autopilot-tick 轮询与 runProgressAutoUpdates() 进度推送，支持 OpenClaw Cron 托管，适合长时运行的 Agent 值守场景。
潜在局限
- 适配器成熟度不均：Plane/Linear 适配器仍在开发中（文档明确标注 "Finish and validate"），实际可用性依赖 ClawHub 技能
plane和linear的维护状态。 - 隐式依赖外部 CLI：若宿主环境未预装
gh/plane/jq等，命令直接失败；容器化场景需额外维护 CLI 镜像层。 - 无原生 Secret 管理：虽降低攻击面，但也意味着无法自助轮换密钥，完全依赖外部 CLI 的配置生命周期。
- 阶段模型刚性：四阶段不覆盖 "Done/Closed"，完成态的处理逻辑由平台自行解释，可能导致跨平台报表口径不一致。
适合人群
- 已在使用 GitHub/Linear/Plane/Planka 且希望用统一 CLI 界面编排任务的小型技术团队；
- 构建内部 "AI 协作者"（Agentic Coworker）的开发者，需要标准化任务拉取与状态汇报接口；
- 愿意接受 "CLI 作为信任边界" 的安全模型、不追求零信任 Secret 托管的场景。
常规风险
| 维度 | 说明 |
|------|------|
| **认证泄漏** | 依赖的 `plane`/`linear` 技能若将 API Key 以明文 env 注入，存在进程/日志泄露风险 |
| **轮询压力** | `autopilot-tick` 默认 5 分钟周期，高并发项目可能触发平台 Rate Limit |
| **状态竞态** | 多 Agent 同时 `start` 同一任务时，依赖平台端的乐观锁/冲突检测，技能层无分布式锁 |
| **供应链** | `npm ci` 安装依赖与 ClawHub 技能 `plane`/`linear` 的脚本更新需同步审计 |