Kanban Workflow 是一个专为智能代理协作者设计的 TypeScript 核心库，旨在为项目管理平台提供一个统一、可复用的工作流引擎。它采用基于阶段的 `stage:*` 生命周期模型作为唯一标准状态机，确保跨平台行为的一致性。该工具通过 CLI 认证适配器与主流项目管理平台（如 GitHub、Planka、Plane、Linear）集成，完全依赖各平台官方 CLI 工具（如 `gh`、`planka-cli`、`plane-cli`、`linear-cli`）进行身份验证和会话管理，无需直接处理 HTTP 认证逻辑。这种设计使得不同平台的实现可以共享核心逻辑，显著提升了开发效率和协作一致性。 整个系统遵循端口与适配器架构，将平台无关的核心逻辑与平台特定的适配层分离。核心部分定义了标准化的实体（如 `WorkItem`、`Project`、`Comment`、`Stage`）和事件（如 `WorkItemCreated`、`StageChanged`），并内置一个基于阶段的工作流引擎，支持澄清模板和自动化规则。适配器则作为“智能包装器”，调用现有 CLI 命令来执行操作，并通过轮询加快照差分的方式合成事件，以应对某些平台缺乏 webhook 或特定事件类型的情况。目前核心已实现 TypeScript 版本，并计划逐步完善各平台的适配器功能。 该工具不仅提供强大的后端能力，还注重用户体验。其命令行接口（CLI）在每次操作后都会输出 `What next?` 提示，引导用户按照标准的 `setup` → `next` → `start` → (`ask` | `update`) → `complete` → `next` 流程推进任务。特别地，在执行实际开发工作时，建议在一个子代理中运行，完成后通过 `ask` 或 `update` 命令向主流程汇报进展。此外，对于处于 `in-progress` 阶段的任务，系统还支持自动每5分钟发布一次进度更新评论，便于团队保持同步。
核心功能特点
- 基于 `stage:*` 生命周期的标准化状态机，确保跨平台行为一致
- 通过 CLI 认证适配器集成主流项目管理平台，无需直接处理 HTTP 认证
- 提供 `tick()` 轮询、事件归一化、快照差分等核心能力
- 内置工作流引擎和澄清模板，支持自动化规则与进度更新
- CLI 交互友好，每次操作后输出 `What next?` 引导下一步行动
- 支持自动进度更新评论，提升团队协作透明度
适用场景
Kanban Workflow 特别适合需要高度结构化、自动化项目管理流程的智能代理或开发团队。例如，在一个使用 GitHub Issues 的团队中，开发者可以通过 `kanban-workflow setup –adapter github` 快速配置项目，然后使用 `next` 查看待办事项，`start` 标记当前任务为进行中，并在子代理中完成编码工作。完成后，通过 `ask` 或 `update` 命令将变更推送到主工作流，系统会自动将其移动到 `in-review` 阶段，等待审查。整个过程无需手动切换上下文，极大提升了开发效率。 对于使用 Plane 或 Linear 等现代敏捷工具的组织，Kanban Workflow 同样表现出色。假设一个产品团队正在使用 Linear 管理用户故事，他们可以利用 `plane-cli` 或 `linear-cli` 的输出，通过适配器将自定义字段、状态流转映射到统一的 `stage:in-progress` 等标准阶段。当任务进入开发阶段时，系统可自动触发每5分钟的进度评论，让产品经理和 QA 人员实时了解进展，减少沟通成本。这种机制尤其适用于远程或分布式团队，确保信息透明且可追溯。 此外，该工具的设计理念也适用于需要构建自定义代理工作流的场景。无论是用于自动化测试、CI/CD 流水线中的问题跟踪，还是作为 AI 助手的底层调度系统，Kanban Workflow 提供的标准化事件模型和适配器架构都能帮助开发者快速搭建出健壮、可扩展的项目管理协作者。其模块化设计允许团队根据自身平台偏好灵活选择适配器，同时保证核心业务逻辑的统一维护。