backlog-manager

待办事项管理器技能

概述

待办事项管理器提供统一界面，用于跨不同任务管理系统跟踪工作项。请根据团队偏好和现有工具选择后端。

支持的后端：

后端	集成方式	适用场景
GitHub	gh CLI	使用 GitHub Issues 的团队
Linear	MCP 服务	使用 Linear 的团队
Beads	bd CLI	依赖感知型工作流、AI Agent

**对于简单的个人项目：**请使用原生 Tasks（TaskCreate、TaskList、TaskUpdate），而非 backlog-manager。

配置

在项目的 .agents.yml 中配置首选后端：

task_management: github  # Options: github, linear, beads

# Workflow labels (for github/linear backends)
workflow_labels:
  - backlog
  - in-progress
  - ready-for-review
  - done

# Beads configuration (when task_management: beads)
# beads_prefix: myapp               # Optional: custom issue prefix

**默认：**如果未找到配置，请使用原生 Tasks（TaskCreate、TaskList、TaskUpdate）进行简单跟踪。

何时使用此技能

在以下情况下创建待办事项：

• 工作需要超过 15-20 分钟
• 需要研究、规划或考虑多种方案
• 依赖于其他工作
• 需要审批或确定优先级
• 属于较大型功能或重构的一部分
• 需要记录的技术债务

在以下情况下应立即处理：

• 问题很简单（< 15 分钟）
• 当前已有完整上下文
• 无需规划
• 用户明确要求立即处理
• 有明显解决方案的简单错误修复

核心概念

状态生命周期

所有后端都遵循以下状态工作流：

pending → ready → complete

状态	含义
pending	开始工作前需要分流处理/审批
ready	已获批准，可以开始实施
complete	工作已完成，验收标准已满足

优先级

优先级	含义
p1	紧急 — 阻碍其他工作或影响用户
p2	重要 — 应尽快完成
p3	有则更好 — 可以暂缓

核心操作

每个后端都实现以下操作：

操作	用途
CREATE	添加新的待办事项
LIST	查询现有事项
UPDATE	修改事项（状态、优先级、详情）
COMPLETE	将事项标记为已完成

后端选择

调用此技能时：

1. 读取配置，从项目 CLAUDE.md 中读取
2. 根据 backend 设置加载相应参考文档：
   • github → references/github-backend.md
   • linear → references/linear-backend.md
   • beads → references/beads-backend.md
3. 遵循后端专属说明执行操作

回退行为

如果配置的后端不可用：

• GitHub 不可用（gh 未通过身份验证）：回退到原生 Tasks
• Linear 不可用（未配置 MCP）：回退到原生 Tasks
• Beads 不可用（未安装或未初始化 bd）：回退到原生 Tasks
• 告知用户发生了回退

与开发工作流的集成

触发条件	流程
代码审查发现的问题	审查 → 创建事项 → 分流处理 → 开展工作
PR 评论	解决 PR 问题 → 为复杂修复创建事项
规划会议	集思广益 → 创建事项 → 确定优先级 → 开展工作
技术债务	记录 → 创建事项 → 安排时间
功能请求	分析 → 创建事项 → 确定优先级

关键区别

待办事项管理器（此技能）：

• 跨会话持久化跟踪
• 提供多个后端选项
• 团队协作
• 项目/冲刺规划

原生 Tasks（TaskCreate、TaskList、TaskUpdate）：

• 基于文件持久化的会话任务跟踪（~/.claude/tasks/）
• 支持依赖关系（blockedBy、blocks）
• 可通过 CLAUDE_CODE_TASK_LIST_ID 环境变量跨会话共享
• 适用于：会话内进度跟踪、子 Agent 协作、简单任务列表
• 与待办事项管理器不同：Tasks 用于临时协作，待办事项用于项目规划