claudia

Claudia 是面向 AI 代理的任务管理系统，通过 CLI 和 MCP 服务器接口，让 Claude 等 AI 助手能够自主管理复杂工作。

用途

AI 代理在执行复杂、多步骤任务时，需要跟踪进度、协调多个代理、跨会话记忆上下文、验证验收标准，并将工作组织到冲刺和项目层级中。Claudia 为这些需求提供结构化任务跟踪。

主要能力

• 层级任务：支持父子任务结构
• 依赖关系：任务之间可定义依赖，并识别就绪任务
• 冲刺管理：将工作组织到冲刺中
• 验收标准验证：任务完成前可逐条验证验收标准
• 多代理协调：支持多个 AI 代理同时在同一项目上工作，提供乐观锁机制
• 上下文存储：每个任务最多 64KB 的 JSON 存储，用于跨会话记忆
• MCP 服务器：与 Claude Code 等工具集成
• 仪表板：提供看板（支持拖拽列）和冲刺卡片视图，可按项目过滤，可归档已完成任务

使用方式

1. 运行需要 Bun 运行时（v1.0+）。
2. 可构建独立二进制文件。
3. 启动 MCP 服务器供 Claude Code 使用：在项目根目录的 .mcp.json 中添加配置，或开发模式下无需构建直接运行。添加配置后重启 Claude Code 以连接。
4. 启动仪表板后，在浏览器打开 http://localhost:3333 查看看板与冲刺视图。
5. 代理可使用 MCP 工具进行任务操作，推荐模式：task_ready（列出依赖已满足的任务）、task_claim（原子性保留任务）、task_transition（移至 in_progress）、task_context_merge（保存进度）、task_transition（移至 completed）；失败时使用 task_release 让其他代理重试。

任务状态

有效状态转换： pending → in_progress、blocked、archived in_progress → pending、verification、completed、blocked、archived verification → in_progress、completed、blocked、archived blocked → pending、in_progress、archived completed → in_progress、archived archived →（终态） 若任务未定义验收标准，可跳过验证。

MCP 工具参考

• 创建并启动任务（单次操作，自动为当前代理声明）
• 完成任务（可选摘要）
• 获取当前代理的工作区上下文（包含已声明任务）
• 将任务转移给其他代理
• 释放任务回 pending 并说明原因
• 列出所有依赖未满足的任务
• 列出所有依赖已满足、可开始的任务
• 覆盖任务上下文（最大 64KB）
• 深度合并到现有上下文
• 将某条验收标准标记为已验证
• 获取任务的验证进度
• 列出所有项目

适用场景

• 多步骤复杂任务的进度跟踪
• 多代理协作同一项目
• 需要跨会话记忆上下文的 AI 工作流
• 需要验收标准验证的任务
• 需要将工作组织到冲刺和项目层级的场景

限制

• 需要 Bun 运行时（v1.0+）
• 任务上下文上限为 64KB
• 许可协议为 GPLv3
• 官网：https://claudiacli.com/