核心功能
Kanban Workflow 是一个基于 TypeScript 的阶段化智能协作者（agentic co-worker）核心框架，专为项目管理工作流设计。它通过 CLI 认证适配器（非直接 HTTP 认证）统一对接四大主流平台：GitHub（gh CLI）、Plane（ClawHub skill）、Linear（ClawHub skill）、Planka（planka-cli），实现看板状态的标准化管理。
显著优点
1. 安全架构优先：强制 CLI 级认证继承，避免直接处理 API 密钥，降低凭证泄露面；适配器层与核心层分离，平台逻辑可插拔。
2. 标准化状态机：定义 backlog → blocked → in-progress → in-review 四阶段 canonical 模型，跨平台行为一致性。
3. 开发者体验：kanban-workflow <verb> CLI 提供「What next」智能引导，降低认知负荷；自动进度更新（每 5 分钟评论）减少人工同步。
4. 事件驱动设计：基于轮询+快照 diff 合成事件，兼容无 Webhook 场景，适配企业内网限制。
潜在局限
- 依赖外部 CLI：需预装
gh、planka-cli或 ClawHub skills，环境准备成本较高。 - 阶段模型刚性：仅支持四阶段，复杂工作流（如多评审阶段、归档状态）需额外映射。
- 轮询开销：无原生 Webhook 时依赖定时轮询，高频场景可能触发 API 限流。
- Plane/Linear 适配器未完成：当前处于实现中状态，生产可用性待验证。
适合人群
- 需要跨平台统一看板语义的 DevOps/Platform 团队
- 偏好CLI 优先、GitOps 友好工作流的技术组织
- 希望将 PM 操作嵌入 CI/CD 或本地脚本的自动化工程师
常规风险
| 风险类别 | 说明 | 缓解建议 |
|---------|------|---------|
| 凭证继承 | 依赖 CLI 会话状态，令牌过期可能导致静默失败 | 在 CI 中显式刷新 CLI 认证 |
| 状态漂移 | 轮询延迟导致阶段视图与实际不一致 | 缩短 `tick()` 间隔或启用Webhook |
| 适配器成熟度 | Plane/Linear 适配器尚未完整 | 生产环境优先使用 GitHub 适配器 |
| 并发冲突 | 多 agent 同时操作同一工作项 | 在核心层实现乐观锁或串行化队列 |