Backlog.md

社区

基于 Markdown 的任务管理与看板可视化，适用于任何 Git 仓库

分类: 开发工具第 12 / 438
Stars: ★ 7.0k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js · Bun · 预编译二进制
凭据: 无需凭据
许可证: MIT
最近提交: 4 天前
工具数: 2

72FMRS · B

Backlog.md 是一个以 Markdown 为中心的任务管理器，专为 AI 代理协作而设计。它提供结构化的工作流，包括任务分解、计划审批和代码审查。支持终端和 Web UI。MCP 集成适用于多种客户端，并支持基于根目录的项目切换。潜在风险包括配置复杂性和对 Git 操作的依赖，但整体上提供了静态类型检查之外的轻量级、本地优先的替代方案。

最强项 · 文档质量 17/20 最弱项 · 可靠性 11/20

可靠性

11/20

安全与权限

14/20

维护活跃度

17/20

文档质量

17/20

安装易用性

13/20

查看各项评分依据

可靠性 11/20: 该项目是一个成熟的CLI工具，其README详细描述了MCP服务器的启动方式（`backlog mcp start`）以及如何通过客户端命令进行连接。尽管存在显式的服务器启动命令，但未提供独立的server manifest文件，且仓库中没有独立的MCP服务器测试或显式的CI验证MCP握手。主要可靠性证据来自CLI的成熟度和广泛使用（自述为dogfooded），但静态审查无法确认MCP初始化和工具列表的实际行为。因此根据静态校准规则，奖励不超过12，并因缺乏专门针对MCP路径的测试和CI证据而扣分。
安全与权限 14/20: 该工具默认本地优先，无遥测，数据仅存储在本地文件中。MCP服务器通过`backlog mcp start`启动，并支持`BACKLOG_CWD`和`--cwd`来固定项目。文档强调了远程Git操作是可选的，并且服务器仅在客户端MCP根目录下操作。未发现敏感凭证处理或网络外发。但权限和确认机制在MCP服务器中未明确记录，重命名或删除等危险操作可能需要显式确认，但文档未明确提及。因此未触发红线，但缺少明确的权限和确认声明，给予14分。
维护活跃度 17/20: 仓库非常活跃，拥有6414颗星，37个未解决问题，未归档。README展示了频繁的版本更新（如v1.40），并提及多项进展。MIT许可证明确。持续维护的证据包括发布历史、社区工具（VS Code扩展）和公开演讲。未发现安全问题响应渠道，但整体维护良好，给予17分。
文档质量 17/20: 文档非常全面，包括完整的CLI参考、高级配置指南、故障排除（如Apple Silicon问题）以及详细的MCP客户端配置示例（包括Claude Code、Codex、Gemini CLI等）。还包含工作流程指南。但缺少关于MCP工具参数、限制和成本的详细文档，且安装README未提供所有平台的详细步骤。总体上提供了分层文档和足够的示例，但存在一些隐藏假设（如需要先初始化项目），因此扣分至17分。
安装易用性 13/20: 安装简单：`npm i -g backlog.md`或`npx backlog.md`。提供了多种平台（macOS、Linux、Windows）的安装方法，包括Homebrew和Nix。MCP设置需要先运行`backlog init`，然后配置客户端，文档提供了每种客户端的明确命令。但手动配置需要设置环境变量或参数，且文档未提供故障排除步骤。由于静态审查缺乏执行证据，根据规则评分上限为15分，并因依赖外部运行时（Node/Bun）而复杂性增加，给予13分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件

适合谁

希望与 AI 编码助手协作，并希望在每个阶段保持人类监督的开发者
需要轻量级、基于文件的、本地优先的任务管理解决方案的团队
希望通过明确的接受标准和完成定义来提高 AI 输出质量的项目

不适合谁

需要集中式、基于服务器的任务管理，具备用户角色和权限的团队
需要复杂工作流自动化或与本机工具深度集成的用户
需要实时多人同步的项目

所需权限

读写项目仓库中的 Markdown 任务文件
读取和修改本地文件系统（任务、配置）
可选：执行 Git 操作（自动提交、远程操作）
在指定的 MCP 根目录或 BACKLOG_CWD 中运行

风险与副作用

如果直接编辑任务文件，可能会出现字段类型或元数据不一致
可能需要 Git 操作才能实现某些功能；非 Git 项目受限于本地操作
如果项目未初始化，服务器可能会提供 init-required 资源，直到初始化完成
跨分支准确性可能有限，具体取决于配置

安装接入

准备工作

运行环境：Node.js · Bun · 预编译二进制

其他可选配置项（1 个）

BACKLOG_CWD 可选可选。将 MCP 服务器固定到某个项目的绝对路径，阻止工作区跟随；也可改用 --cwd 参数。

全局安装：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

.mcp.json

{
  "mcpServers": {
    "backlog": {
      "command": "backlog",
      "args": [
        "mcp",
        "start"
      ],
      "env": {
        "BACKLOG_CWD": "/absolute/path/to/your/project"
      }
    }
  }
}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "backlog": {
      "command": "backlog",
      "args": [
        "mcp",
        "start"
      ],
      "env": {
        "BACKLOG_CWD": "/absolute/path/to/your/project"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add backlog -e BACKLOG_CWD=/absolute/path/to/your/project -- backlog mcp start

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端中运行 /mcp 命令确认 backlog 服务器已连接；未找到已初始化项目时服务器会返回 backlog://init-required，提示需要先运行 backlog init。

常见排障

如果收到 "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 助手这样说：

把我想加的搜索功能拆分成几个带验收标准的小任务并创建到 Backlog 中
查看 BACK-10 任务的详细内容和验收标准
把任务 BACK-3 的状态改为 Done 并添加一条评论
列出当前所有处于 To Do 状态的任务

工具能力 2

mcp 只读

启动 MCP 服务器，提供 Backlog.md 工作流指令和任务管理能力。

start 只读

启动 MCP 服务器，提供 Backlog.md 工作流指令和任务管理能力。

使用场景

管理 AI 代理驱动的软件开发项目，遵循规范驱动的开发流程

将大型功能分解为小的、可审查的任务，每个任务对应一个 PR

在编码前审查任务描述、验收标准和实现计划

跟踪项目里程碑和依赖关系

在终端或浏览器中可视化任务进度（看板）

在无需 Git 的情况下管理个人项目

支持客户端

Claude Code

Codex

Gemini CLI

Kiro

Cursor

依据项目文档列出，未经本站实测。

详细介绍

Backlog.md 将任何文件夹变成一个自包含的项目看板，由纯 Markdown 文件和零配置 CLI 驱动。在设计上专为 AI 代理协作优化，提供任务描述、验收标准、里程碑、实现计划等结构，让 AI 代理编写代码，而人类在之前、期间和之后审查任务。它支持终端看板、网页 UI、模糊搜索、本地优先存储，并可作为 MCP 服务器接入 Claude Code、Codex、Gemini CLI 等工具。