Backlog.md

一个基于Markdown和Git的本地优先任务管理与看板工具,专为AI时代代码审查设计。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Backlog.md。
它的用途是:一个基于Markdown和Git的本地优先任务管理与看板工具,专为AI时代代码审查设计。
完整的 Skill 内容见:https://321skill.com/skills/backlog-md/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请使用Backlog.md为‘添加用户登录功能’这个需求创建任务分解。” AI会运行`backlog new`命令,生成包含详细描述、验收标准和里程碑的Markdown任务文件。然后你可以运行`backlog board`在终端查看看板,或在`backlog browser`的Web界面中拖拽任务状态,并与AI协作逐步完成每个原子任务。

介绍

Backlog.md旨在解决AI智能体时代,开发者面临的代码审查注意力瓶颈问题。当AI能在短时间内生成海量代码时,人类开发者难以进行有效的逐行审查。该工具将AI驱动的开发流程结构化,通过三个关键审查节点(需求规格、实施计划、最终代码)来管理任务,确保每个环节都在人类可控的范围内。

它本质上是一个零配置的CLI工具,能将任何包含Markdown文件的文件夹转变为一个自包含的项目看板。你只需在项目根目录运行backlog.md相关命令,即可在终端或本地浏览器中可视化和管理任务。所有任务都以纯Markdown文件形式存储在你的代码仓库中,与Git工作流无缝集成。

它非常适合与AI编程助手(如Claude Code、Cursor等)协作的开发者、独立开发者或小型团队。尤其适用于那些希望将AI生成的庞大工作分解为可管理、可审查的原子任务,并保留完整决策记录的项目。

与Jira、Trello或GitHub Projects等传统项目管理工具不同,Backlog.md是本地优先Markdown原生的。它没有外部服务器、账户或订阅费,所有数据都作为普通文件存在于你的代码库中,实现了项目管理的“基础设施即代码”,并且其设计哲学完全围绕前置审查控制AI工作流展开,而非简单的任务跟踪。

核心特点

核心区别在于其`AI工作流审查`的专精设计,强制将AI开发过程分解为“审规格->审计划->审代码”三步,从源头控制质量;同时,它采用`纯Markdown文件存储任务`,实现了项目管理的“基础设施即代码”,所有历史记录永久保存在Git中,无需依赖任何外部SaaS服务。

注意事项

不适合需要复杂权限管理、精细时间跟踪或大规模团队协同的企业级项目管理场景。

常见问题

Backlog.md 和 GitHub Issues/Projects 有什么区别?

Backlog.md是本地优先、文件驱动的,任务就是仓库里的.md文件,不依赖GitHub平台,且专门为结构化AI协作和前置审查而设计。

需要联网或注册账号吗?

完全不需要。它是一个本地CLI工具,无服务器、无账号、无遥测数据,所有数据都在你的本地Git仓库里。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/backlog-md/raw/index.md 读取 Backlog.md 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。