什么是Agkan
agkan 是一个基于 SQLite 的命令行任务管理工具，专为与 AI 代理协作而设计。它通过简洁的 CLI 接口提供完整的任务生命周期管理，支持从创意收集到最终交付的全流程跟踪。与传统看板工具不同，agkan 强调结构化工作流和机器可读性，特别适合在自动化工作流或 AI 辅助开发场景中使用。其核心优势在于标准化的状态流转机制，包含七个明确阶段：从 `icebox`（创意池）开始，经过 `backlog`（待办）、`ready`（准备中）、`in_progress`（进行中），进入 `review`（评审）、`done`（已完成），最终可归档至 `closed`（关闭）。这种清晰的状态定义有助于团队建立一致的工作节奏，并支持跨代理的任务交接。 该工具采用本地数据库存储，确保数据隐私且无需依赖网络服务。所有操作均通过命令行完成，便于集成到脚本、CI/CD 流水线或其他自动化系统中。agkan 特别注重元数据扩展能力，允许用户为任务添加自定义键值对，例如优先级、负责人、截止日期等。其中内置的优先级系统支持 critical/high/medium/low 四个等级，并建议在规划阶段设定，供后续执行代理参考。此外，标签系统也遵循预定义的优先级顺序（如 bug > security > improvement > test 等），确保分类一致性。 为了提升与外部系统的兼容性，agkan 全面支持 JSON 输出格式。无论是获取任务列表、查看详情还是统计数量，均可通过 `–json` 参数获得结构化数据，方便结合 jq 等工具进行进一步处理。同时，它也提供了丰富的查询选项，包括按状态过滤、按标签筛选、查看依赖树、生成层级视图等。对于复杂项目，还可以利用父子任务关系构建任务树，并通过阻塞关系（blocking relationships）显式表达任务间的先后依赖。这些特性共同构成了一个轻量级但功能完备的个人及团队协作平台。
核心功能特点
- 七状态工作流管理：从 icebox 到 closed 的完整任务生命周期跟踪
- 原生支持父子任务与阻塞关系，可构建复杂依赖结构
- 内置优先级系统与标准化标签体系，便于智能调度
- 全量 JSON 输出接口，易于与 AI 代理及其他工具集成
- 基于 SQLite 的本地存储，无服务器依赖且数据安全
- 灵活的查询与过滤选项，支持树状视图、依赖树和排序
适用场景
agkan 特别适合需要高度自动化或 AI 协同的工作环境。例如，在一个由多个 AI 代理组成的开发团队中，主规划代理可将任务推送到 `ready` 状态并设置优先级，执行代理则根据优先级自动选择下一个任务进行处理。当某个子任务完成时，系统可通过阻塞关系自动解锁后续任务，无需人工干预。这种模式在持续集成环境中尤为有效，开发者可在 PR 合并后自动触发测试任务创建，并在所有前置条件满足后启动部署流程。 对于个人知识工作者而言，agkan 提供了一种比传统待办清单更强大的组织方式。研究人员可以使用 `icebox` 收集灵感点子，定期评审后将可行的想法转为 `backlog` 并细化成具体任务。程序员在处理大型项目时，可通过父子任务拆分复杂功能模块，并利用标签标记技术栈（如 frontend、api）或问题类型（如 bug、refactor）。结合 `–tree` 视图，用户可以一目了然地掌握整个项目的进展脉络。 在远程协作或多设备同步场景中，agkan 的本地数据库模型也具备独特优势。团队成员只需共享 `.agkan.yml` 配置文件即可统一数据库路径，避免云服务的权限或延迟问题。配合 Git 版本控制，甚至可以将任务历史纳入代码仓库审计范围，实现真正的可追溯性。无论是小型创业团队还是个人开发者，都能借助 agkan 建立起高效、透明且可扩展的任务管理体系。