1. 服务概述一句话简介一个持久化的、跨会话的AI代理任务管理服务器具有完整的任务生命周期管理、丰富的过滤、文档和归档功能支持多代理协作。服务名称Backlog版本号最新版本开发者/提供方backloghq协议类型MCP (Model Context Protocol)2. 核心功能该MCP服务提供以下主要功能模块➕ 创建与导入task_add添加任务支持描述、优先级、截止日期、标签、项目、代理、重复和依赖关系task_log记录已完成的工作task_duplicate复制现有任务支持字段覆盖task_import从JSON数组批量创建任务 查询与发现task_list按状态、项目、优先级、标签、虚拟标签、日期和布尔运算符过滤任务task_count统计匹配的任务数量task_info获取单个任务的完整详细信息task_projects / task_tags列出所有项目或标签 状态与生命周期task_start / task_stop标记任务为活动或暂停task_done完成任务task_modify部分更新匹配任务的字段task_delete软删除可恢复task_purge永久删除已删除的任务task_undo撤销最近的操作 注释与文档task_annotate / task_denotate添加或删除带时间戳的简短注释task_doc_write / task_doc_read / task_doc_delete附加、读取或删除完整的markdown文档规格、设计说明、交接文档 归档task_archive将旧的已完成/已删除任务移动到季度归档段task_archive_list / task_archive_load列出和检查归档任务只读3. 使用场景该服务适合在以下情况下使用持久化任务管理任务在会话之间持久保存一个代理开始的工作可以被另一个代理继续跨会话工作支持长时间运行的项目任务状态跨会话保持多代理协作多个AI代理共享同一任务数据协同完成工作项目隔离每个项目自动获得独立的任务数据存储任务规划分解目标为任务设置依赖关系和优先级工作交接准备会话交接注释进度停止活动任务总结状态4. 接入方式4.1 服务端点该服务支持多种运行模式插件模式作为Claude Code插件运行独立MCP服务器作为独立MCP服务器运行Docker容器容器化部署4.2 认证与权限无需特殊认证但支持以下配置TASKDATA任务数据目录路径BACKLOG_AGENT_ID多写入器支持的代理IDBACKLOG_BACKEND存储后端文件系统或S34.3 数据格式服务使用类型化模式、自动增量ID、虚拟过滤器和blob存储。纯TypeScript实现零原生依赖。4.4 服务器配置插件模式安装/plugin marketplace add backloghq/backlog /plugin install backlogbackloghq-backlog从源码安装git clone https://github.com/backloghq/backlog.git cd backlog npm install npm run build claude --plugin-dir /path/to/backlog独立MCP服务器配置.claude/settings.json{ mcpServers: { backlog: { command: node, args: [/path/to/agent-teams-task-mcp/dist/index.js], env: { TASKDATA: /path/to/task-data } } } }S3后端配置{ mcpServers: { backlog: { command: node, args: [/path/to/backlog/dist/index.js], env: { TASKDATA: my-project/tasks, BACKLOG_BACKEND: s3, BACKLOG_S3_BUCKET: my-team-backlog, BACKLOG_S3_REGION: us-east-1 } } } }5. 接口定义任务管理工具工具名称描述task_list使用过滤语法查询任务返回JSON数组task_count统计匹配过滤器的任务数量task_add创建新的待处理任务task_log直接记录已完成的工作task_modify部分更新匹配任务task_duplicate复制现有任务task_done标记任务为已完成task_delete软删除任务可恢复task_purge永久删除任务task_undo撤销最近的操作任务状态工具工具名称描述task_start标记任务为正在处理task_stop停止处理任务task_info获取单个任务的完整JSON详细信息注释与文档工具工具名称描述task_annotate添加带时间戳的注释task_denotate删除注释task_doc_write附加/替换任务的markdown文档task_doc_read读取任务的markdown文档task_doc_delete删除任务的文档归档工具工具名称描述task_archive将旧任务移动到季度归档段task_archive_list列出可用的归档段task_archive_load加载归档任务只读查询工具工具名称描述task_projects列出项目名称task_tags列出标签task_import从JSON数组批量创建任务6. 快速开始6.1 环境要求Node.js最新LTS版本TypeScript支持可选S3存储需要backloghq/opslog-s36.2 安装步骤# 克隆仓库 git clone https://github.com/backloghq/backlog.git cd backlog # 安装依赖 npm install # 构建 npm run build # 运行测试 npm test6.3 过滤语法示例# 所有待处理任务 status:pending # 后端项目中的bug project:backend bug # 周五之前到期的高优先级任务 priority:H due.before:friday # 过期任务 OVERDUE # 正在处理的任务 ACTIVE # 被依赖阻塞的任务 BLOCKED # 可执行的任务已过计划日期 READY # 分配给explorer代理的任务 agent:explorer # 布尔运算 ( project:web or project:api ) # 子字符串匹配 description.contains:auth7. 注意事项虚拟标签OVERDUE过期任务ACTIVE正在处理的任务BLOCKED被依赖阻塞的任务READY可执行的任务TAGGED有标签的任务ANNOTATED有注释的任务环境变量变量描述TASKDATA任务数据目录路径TASKDATA_ROOT自动派生的每项目任务数据根目录BACKLOG_NAMESPACE显式集合名称BACKLOG_AUTO_NAMESPACE从CWD派生集合名称BACKLOG_AGENT_ID多写入器支持的代理IDBACKLOG_BACKEND存储后端默认文件系统或s3BACKLOG_S3_BUCKETS3桶名称BACKLOG_S3_REGIONAWS区域技能Skills/backlog:tasks显示当前backlog/backlog:plan分解目标为任务/backlog:standup每日站会/backlog:refine整理backlog/backlog:spec编写任务规格文档/backlog:implement执行任务实现/backlog:handoff准备会话交接钩子HooksSessionStart会话开始时显示待处理任务数量TaskCreated同步Claude内置任务到持久化backlogTaskCompleted完成内置任务时标记backlog任务为完成SubagentStart自动分配未分配的待处理任务给生成的代理多写入器支持为每个进程分配唯一的BACKLOG_AGENT_ID使用每代理写入日志避免文件锁每个进程自动调用refresh()获取其他代理的更改最佳实践使用项目隔离保持任务分离使用任务文档附加规格和设计说明定期归档旧任务保持backlog整洁使用虚拟标签快速查找特定状态的任务设置依赖关系管理任务执行顺序
