用途:Backlog.md 是 CLI 项目管理工具,用 Markdown 文件跟踪任务、文档和决策,所有操作通过 backlog CLI 命令完成。核心原则:不要直接编辑任务文件,始终使用 CLI。
主要能力:创建、编辑、查看、搜索任务;管理状态(To Do、In Progress、Done、Blocked)、负责人、标签、优先级;维护验收标准(添加、勾选、取消勾选、删除);记录实现计划与笔记;设置任务依赖、草稿、子任务;归档、降级、提升任务;查看任务历史与差异;创建文档与架构决策记录;终端看板、浏览器界面、导出看板快照与报告。
常用命令:backlog task list --plain;backlog task 42 --plain;backlog task create "标题" -d "描述" --ac "验收标准";backlog task edit 42 -s "In Progress" -a @me;backlog search "关键词" --plain;backlog board;backlog browser;backlog report --output report.md;backlog doc create "标题";backlog decision create "标题"。
使用方式:列表与查看建议加 --plain 便于 AI 处理;开始任务时先设状态为 In Progress 并分配给自己,再阅读需求、写实现计划;随进度勾选验收标准;多行输入用 $'...\n...' 或 printf;多个验收标准用多个 --check-ac 标志,不用逗号或范围。
适用场景:个人或团队用命令行管理开发任务、缺陷修复、冲刺规划,并与 Git 工作流配合。
限制:资料未提供安装方式、平台支持、收费与价格信息;部分命令标注“if supported”,实际可用性暂未提供。