适合谁
- 希望与 AI 编码助手协作，并希望在每个阶段保持人类监督的开发者
- 需要轻量级、基于文件的、本地优先的任务管理解决方案的团队
- 希望通过明确的接受标准和完成定义来提高 AI 输出质量的项目
B
72FMRS · B
Backlog.md 是一个以 Markdown 为中心的任务管理器，专为 AI 代理协作而设计。它提供结构化的工作流，包括任务分解、计划审批和代码审查。支持终端和 Web UI。MCP 集成适用于多种客户端，并支持基于根目录的项目切换。潜在风险包括配置复杂性和对 Git 操作的依赖，但整体上提供了静态类型检查之外的轻量级、本地优先的替代方案。
Backlog.md 将任何文件夹变成一个自包含的项目看板，由纯 Markdown 文件和零配置 CLI 驱动。在设计上专为 AI 代理协作优化，提供任务描述、验收标准、里程碑、实现计划等结构，让 AI 代理编写代码，而人类在之前、期间和之后审查任务。它支持终端看板、网页 UI、模糊搜索、本地优先存储，并可作为 MCP 服务器接入 Claude Code、Codex、Gemini CLI 等工具。
工具能力
mcp
启动 MCP 服务器，提供 Backlog.md 工作流指令和任务管理能力。
start
启动 MCP 服务器，提供 Backlog.md 工作流指令和任务管理能力。
安装接入
全局安装：npm i -g backlog.md
在任意 Git 仓库中初始化：backlog init "My Project"
或者以 --no-git 初始化，用于非代码项目
选择 MCP 连接器选项，自动配置 Claude Code、Codex、Gemini CLI、Kiro 或 Cursor
或者手动添加 MCP 服务器配置（见 install_config）
可选：在 CLAUDE.md 或 AGENTS.md 中添加指引，让代理读取 backlog://workflow/overview
claude_desktop_config.json
{
"mcpServers": {
"backlog": {
"command": "backlog",
"args": [
"mcp",
"start"
],
"env": {
"BACKLOG_CWD": "/absolute/path/to/your/project"
}
}
}
}
选型与风险
不适合谁
- 需要集中式、基于服务器的任务管理，具备用户角色和权限的团队
- 需要复杂工作流自动化或与本机工具深度集成的用户
- 需要实时多人同步的项目
所需权限
- 读写项目仓库中的 Markdown 任务文件
- 读取和修改本地文件系统（任务、配置）
- 可选：执行 Git 操作（自动提交、远程操作）
- 在指定的 MCP 根目录或 BACKLOG_CWD 中运行
风险与副作用
- 如果直接编辑任务文件，可能会出现字段类型或元数据不一致
- 可能需要 Git 操作才能实现某些功能；非 Git 项目受限于本地操作
- 如果项目未初始化，服务器可能会提供 init-required 资源，直到初始化完成
- 跨分支准确性可能有限，具体取决于配置
常见排障
- 如果收到 "illegal hardware instruction" 或二进制包未安装，请确保在 Apple Silicon 上使用原生架构重新安装（例如，arch -arm64 npm i -g backlog.md）
- 验证 MCP 服务器是否已连接：在您的 AI 工具中使用 /mcp 命令
- 运行 backlog config 检查配置，并确保项目已初始化
- 如果 MCP 服务器未找到项目，请设置 BACKLOG_CWD 或使用 --cwd 参数
- 查看 CLI 参考和高级配置文档（CLI-INSTRUCTIONS.md, ADVANCED-CONFIG.md）
使用场景
管理 AI 代理驱动的软件开发项目，遵循规范驱动的开发流程
将大型功能分解为小的、可审查的任务，每个任务对应一个 PR
在编码前审查任务描述、验收标准和实现计划
跟踪项目里程碑和依赖关系
在终端或浏览器中可视化任务进度（看板）
在无需 Git 的情况下管理个人项目
支持客户端
Claude Code完整支持
Codex完整支持
Gemini CLI完整支持
Kiro完整支持
Cursor完整支持