什么是Kanban Workflow Export
Kanban Workflow 是一个专为智能协作助手设计的 TypeScript 核心库，旨在通过标准化的阶段模型统一项目管理平台的工作流。它采用基于 `stage:*` 生命周期的状态机作为唯一权威的状态流转机制，包括 `backlog`、`blocked`、`in-progress` 和 `in-review` 四个核心阶段，而将“完成”或“关闭”等概念交由各平台自行处理。该工具的核心理念是通过适配器模式与主流项目管理平台（如 GitHub、Plane、Linear、Planka）集成，利用其现有的命令行接口（CLI）实现身份验证和数据同步，避免在内部运行交互式 OAuth 流程或持久化敏感信息。所有平台的操作逻辑被集中到共享的 workflow/runbook 中，确保不同系统间的行为一致性。 整个架构遵循端口与适配器原则，核心层完全平台无关，定义了 `WorkItem`、`Project`、`Comment` 等通用实体及事件类型，并通过工作循环（worker loop）驱动状态变更。适配器层则作为“智能包装器”，调用外部 CLI 工具（如 `gh`、`planka-cli`），组合多个调用以实现高级操作，并在缺乏 webhook 支持时通过轮询加快照比对来合成事件流。目前已完成 GitHub 适配器的基础实现，其他平台（如 Plane 和 Linear）正在开发中，依赖 ClawHub 生态中的相关技能包提供认证和 API 封装。
核心功能特点
- 基于统一的 `stage:*` 生命周期模型管理任务状态流转
- 通过 CLI 适配器无缝集成 GitHub、Plane、Linear、Planka 等平台
- 自动轮询与快照比对机制补全缺失的事件通知
- 内置自动化进度更新功能，定时发布任务进展评论
- 提供 CLI 入口点和动词式工作流辅助命令（如 `next`, `start`, `ask`, `complete`）
适用场景
Kanban Workflow 特别适合需要跨多个项目管理平台保持行为一致性的智能代理或自动化工作流场景。例如，一个 AI 协作者可以在本地使用统一的命令行工具 `kanban-workflow` 查看当前任务（`show`），进入开发阶段（`start`），遇到阻塞时标记为 `blocked` 并请求帮助（`ask`），完成后提交评审（`update`），最终由主进程确认完成（`complete`）。每次操作后，系统都会输出引导下一步的提示，形成清晰的‘设置→推进→执行→反馈’闭环。 对于持续集成的开发团队，该工具可通过 `autopilot-tick` 命令定期轮询任务状态，自动触发进度更新评论，确保远程团队成员了解当前工作动态。尤其适用于分布式或异步协作环境，其中人工同步存在延迟。此外，由于其核心逻辑与平台解耦，企业可在保留现有工具链的前提下，逐步引入标准化工作流，降低上下文切换成本，提升自动化效率。