Backlog.md
用 Markdown 任务和看板让人机协作的 Git 项目可审阅、可追踪。
按维度查看评分与理由
证据显示：工具是本地优先，无遥测，但权限方面未明确最小权限原则；用户确认机制存在（如审批检查点），但未系统化；数据流透明度有限，未详细说明数据流向；敏感数据处理未明确；依赖安全未审计；外部影响（如Git操作）有配置选项但默认可能自动提交；回滚机制未明确；来源归属有作者信息但未验证。扣分原因：缺乏明确的权限最小化、数据流透明度和敏感数据处理的详细说明。
证据显示：测试覆盖广泛，包括单元测试和集成测试，但未提供测试结果；依赖可用性未明确，但提供了多种安装方式；失败消息有具体示例（如错误提示）。扣分原因：依赖可用性未验证，失败消息虽具体但未全面覆盖。
证据显示：明确面向AI代理和人类用户，场景清晰；能力边界有描述（如CLI、Web、MCP）；触发精度高（如任务ID、命令）；环境适配良好（跨平台）。扣分原因：能力边界描述虽好但未完全覆盖所有场景。
证据显示：信息架构清晰（README、CLI参考、配置文档）；安装说明详细；命名稳定（backlog命令）；示例和FAQ丰富；已知限制有提及（如Apple Silicon问题）；许可证明确（MIT）；版本和变更日志未明确；维护责任有作者信息但未验证。扣分原因：版本和变更日志缺失，维护责任未验证。
证据显示：输出可用性高（JSON、Markdown）；边际价值高（解决AI时代代码审查瓶颈）；成本效益合理（免费开源）。扣分原因：无。
证据显示：声明有部分可追溯（如功能列表），但缺乏独立验证；跨来源佐证有限（如社区工具）；事实和推断分离不明确。扣分原因：声明缺乏独立验证，跨来源佐证不足。
- 发布者身份未验证，需谨慎对待。
- 依赖安全未审计，建议检查依赖漏洞。
- 自动提交等外部操作需确认默认配置。
- 版本和变更日志缺失，影响可追溯性。
这个 Agent 能做什么，适合哪些场景？
Backlog.md 是面向 Git 项目的 Markdown 原生任务管理器和终端看板工具。它把任务保存为项目内的 Markdown 文件，并通过命令行、终端 Kanban 看板、本地 Web 界面和可选 MCP 服务管理这些文件。其推荐的 AI 协作流程把工作拆分为任务规格、实施计划和代码审查三个检查点，强调一个任务对应一个会话和一个 PR。`backlog browser` 启动的 Web 界面仅监听本机 127.0.0.1，支持拖拽看板、任务编辑和实时同步至 Markdown 文件。它也可用作不依赖 AI 的本地任务管理器，并支持 `--no-git` 初始化。
运行 backlog init "项目名" 在仓库中建立 backlog，并可通过 backlog init "项目名" --no-git 建立仅文件系统项目。任务可用 backlog task create 创建、用 backlog task edit 补充描述、验收标准、评论和完成定义，并用 backlog task list、backlog search 和 backlog board 查询或展示。backlog board export 生成可分享的 Markdown 报告，带 --json 的 task list、task view、task <id> 和 search 输出稳定的机器可读 JSON。backlog browser 提供本地 Kanban 页面；backlog mcp start 则把工作流说明和项目操作暴露给已配置的 MCP 客户端。
- 使用 Codex 在 Git 仓库中开发功能的工程师，希望先审阅任务验收标准和实施计划，再让代理编码。
- 维护多人仓库的技术负责人，需要把每个小任务、依赖和里程碑作为可提交到 Git 的长期记录。
- 不使用 AI 的个人开发者，想在终端通过
backlog task create、backlog search和backlog board管理项目工作。 - 希望在本机浏览器里拖拽任务、编辑验收清单，同时让改动同步回 Markdown 文件的项目团队。
- 需要从脚本读取任务状态或搜索结果的集成开发者，可使用已文档化的
--json读命令。
这个 Agent 有哪些优点和局限？
- 任务是仓库内的普通 Markdown 文件，能与代码一起保留、审阅和提交，而非锁定在托管项目管理服务中。
- 将规格、实施计划和代码审查拆为三个明确检查点，适合在代理产出代码前控制范围和方向。
- 同时提供 CLI、终端 Kanban、可导出的 Markdown 看板和本机 Web UI，且这些界面同步同一批任务文件。
- 支持 Claude Code、Codex、Gemini CLI、Kiro 及兼容 MCP 或 CLI 的助手，并允许选择 CLI 指令或 MCP 连接方式。
- 高质量使用依赖把工作拆成可在单次会话完成的小任务，并由人类在三个检查点进行审阅。
- Web UI 仅监听 127.0.0.1，不能直接供局域网或 VPN 上的其他设备访问。
- MCP 集成需要为客户端配置服务器；手动配置时还需要在代理说明文件中加入读取工作流资源的提示。
- 无 Git 初始化会自动关闭跨分支检查、远程操作和自动提交，因此这些 Git 相关能力在文件系统模式不可用。
如何安装或部署这个 Agent？
无需账号或凭据即可本地使用。安装任选其一：
npm i -g backlog.md
bun add -g backlog.md
brew install backlog-md或运行 nix run github:MrLesk/Backlog.md -- --version。随后在 Git 仓库中执行 backlog init "My Awesome Project"；非 Git 项目执行 backlog init "Personal Planning" --no-git。
如何使用这个 Agent？
初始化后，AI 协作可先运行 backlog instructions overview，让代理将需求拆分为带描述和验收标准的小任务；实施前要求它把计划写入指定任务并等待审阅。日常手动操作可执行：
backlog task create "Render markdown as kanban"
backlog task edit BACK-1 -d "Detailed context" --ac "Clear acceptance criteria"
backlog board需要本地网页界面时运行 backlog browser。如偏好 MCP，可为 Codex 执行 codex mcp add backlog -- backlog mcp start，或为 Claude Code 执行 claude mcp add backlog --scope user -- backlog mcp start。
常见问题
它是否必须连接 AI 助手？
Git 是必需的吗？
backlog init ... --no-git 可建立仅文件系统项目；该模式会关闭跨分支检查、远程操作和自动提交。本地 Web 页面会暴露到公司网络吗？
backlog browser 的服务器监听 127.0.0.1，README 明确说明它无法从 LAN 或 VPN 上的其他设备访问。如何让 Codex 或 Claude Code 使用它？
codex mcp add backlog -- backlog mcp start，Claude Code 使用 claude mcp add backlog --scope user -- backlog mcp start。