核心定位
Kanban Workflow 是一个面向多平台项目管理（PM）的 TypeScript 技能，作为"阶段驱动型协作代理"的核心工作流引擎。它通过 CLI-first 的适配器架构，将 GitHub Issues、Linear、Plane、Planka 等不同平台抽象为统一的标准阶段模型（backlog/blocked/in-progress/in-review），实现跨平台一致的任务生命周期管理。
核心能力
- 统一阶段语义：强制规范四类标准阶段，消除平台间状态差异
- CLI 适配器模式：复用各平台官方 CLI 的认证体系（
gh、plane、linear等），不自行管理 OAuth 或密钥存储 - 动词化工作流：提供
show/next/start/update/ask/complete/create等标准操作，形成可预期的协作节奏 - 轮询与差异检测：内置
tick()轮询机制，通过快照对比合成事件，弥补部分平台缺乏 Webhook 的缺陷 - 自动化钩子：支持 autopilot 定时轮询、进度自动更新等持续运行能力
显著优点
1. 跨平台一致性：无论底层是 GitHub、Linear 还是 Plane，上层工作流语义完全一致
2. 认证零负担：复用用户已配置的 CLI 认证，无需额外密钥管理（Plane/Linear 仅需可选的环境变量）
3. 可扩展架构：适配器层与核心层分离，新增平台只需实现端口接口
4. 开发友好：TypeScript 实现，提供强类型实体（WorkItem/Project/Comment/Stage）
局限性与风险
| 方面 | 说明 |
|------|------|
| 成熟度 | 核心实现已完成，但 Plane/Linear 适配器标记为"待完善" |
| 认证依赖 | 完全依赖外部 CLI 的会话状态，CLI 未登录时功能失效 |
| 轮询开销 | 部分平台无 Webhook 时需主动轮询，存在 API 调用频率与实时性的权衡 |
| 配置复杂度 | 多平台映射标志较多，首次 setup 需理解阶段映射逻辑 |
| 环境变量 | Plane/Linear 适配器需要 `PLANE_API_KEY`/`LINEAR_API_KEY`，虽可选但功能受限 |
适合人群
- 需要统一管控多平台任务的技术团队（如同时维护 GitHub Issues 和 Linear 的团队）
- 构建自主运行型开发助手的 Agent 开发者
- 偏好CLI 原生工作流、不愿切换浏览器界面的工程师
安全风险说明
- 无自主密钥管理：不存储或处理平台凭证，风险转嫁给外部 CLI
- 环境变量可选性：
PLANE_API_KEY/LINEAR_API_KEY为可选配置，遵循最小权限原则 - 轮询数据暴露：快照 diffing 可能暂存任务数据于本地，需确保运行环境隔离
来源可信度
本技能为 ClawHub 生态内的 TypeScript 实现项目，架构设计合理但部分适配器尚未完全验证，属于早期可用但需谨慎评估的工具。