backlog-md

面向 Agent 的 Backlog.md 任务跟踪

通过 Backlog.md CLI 优化 Agent 工作流的任务跟踪系统。

三种主要用例

1. 实施者：功能开发期间暂缓处理问题

记录实施期间发现的 P2-P4 问题。对于暂缓处理的审查发现，使用标签 remediation。

• 创建时附带计划：创建问题时，你掌握实施背景
• 指定优先级：参见优先级指南
• 添加类型标签（必需）+ 应用标签（可选）

2. 审查者：审计发现

根据安全审查／审计创建结构化问题。关联依赖项并指定里程碑。

• 创建时附带计划：根据审计背景创建问题
• 按需关联依赖项
• 指定优先级：不确定时询问用户（标签 priority-review）
• 设置里程碑

3. 执行者：执行已分配的任务

完整阅读任务，了解所有字段，并遵循验收标准和完成定义。

• 领取任务：backlog task edit 42 -s "In Progress" -a @myself
• 阅读所有内容：所有字段、附加文件／URL、关联文档
• 按步骤完成：验收标准 → 实施备注 → 最终摘要 → 完成定义 → 完成

绝对规则

1. 写入操作只能使用 CLI。只能使用 backlog task edit 和 backlog task create。绝不直接编辑文件。
2. 读取时始终使用 --plain 标志：backlog task 42 --plain、backlog task list --plain
3. 必须添加类型标签（bug|feature|documentation|refactor|remediation），且只能有一个值
4. 应用标签为可选项，可以添加多个：synapse-pingora、signal-horizon-ui、signal-horizon-api 等
5. 允许添加自定义标签，以满足 Agent 使用需求（priority-review、performance、security 等）

实施计划：何时需要

场景	是否包含计划？	原因
暂缓处理的审查问题	✅ 是	你现在掌握审计／审查背景
报告发现的问题	❌ 否	实施者开始处理时会制定计划
明确要求规划工作	✅ 是（详细计划）	根据指示必须执行
常规任务工作	领取后、编码前	创建时不要添加，开始后再添加

除非收到明确指示，否则绝不更新现有计划。

优先级系统（详情请参阅 references/priority-labels.md）

• P0：严重问题、重大故障
• P1：影响用户的实际 Bug
• P2：Bug、边缘情况
• P3：锦上添花的改进、我们想要的功能
• P4：待办事项、未来想法

不确定是否属于 P0-P1？添加标签 priority-review，由用户决定。

任务完成检查清单

1. 状态：设为“In Progress”并分配给自己
2. 阅读：所有字段和附加文档
3. 计划：添加实施计划（如果不是从审查中暂缓的任务）
4. 工作：实施代码，并在完成每项验收标准时将其标记完成
5. 备注：随进展追加备注
6. 摘要：添加最终摘要（PR 风格）
7. 完成定义：勾选所有完成定义项
8. 完成：将状态设为“Done”

必备命令

# Create issue (required: title, type label, priority)
backlog task create "Title" -d "Description" -l bug -p 2 --ac "AC 1"

# Work a task
backlog task edit 42 -s "In Progress" -a @myself
backlog task 42 --plain              # Read everything
backlog task edit 42 --check-ac 1    # Mark AC complete
backlog task edit 42 --append-notes "Progress here"
backlog task edit 42 --final-summary "PR description"
backlog task edit 42 -s Done

# Search and filter
backlog task list -s "To Do" --plain
backlog search "topic" --plain

完整命令参考请参阅 references/cli-reference.md。 优先级和标签指南请参阅 references/priority-labels.md。 详细的问题创建模式请参阅 references/issue-creation-guide.md。