backlog-manager

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Backlog Manager Skill

Overview

概述

The backlog manager provides a unified interface for tracking work items across different task management systems. Choose your backend based on team preferences and existing tooling.

Supported Backends:

Backend	Integration	Best For
GitHub	`gh` CLI	Teams using GitHub Issues
Linear	MCP server	Teams using Linear
Beads	`bd` CLI	Dependency-aware workflows, AI agents

For simple/solo projects: Use native Tasks (

TaskCreate

TaskList

TaskUpdate

) instead of backlog-manager.

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

支持的后端：

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

对于简单/个人项目： 请使用原生Tasks（

TaskCreate

、

TaskList

、

TaskUpdate

）而非待办事项管理器。

Configuration

配置

Configure your preferred backend in your project's

.agents.yml

yaml

task_management: github  # Options: github, linear, beads

在项目的

.agents.yml

文件中配置你偏好的后端：

yaml

task_management: github  # 可选值: github, linear, beads

Workflow labels (for github/linear backends)

工作流标签（适用于github/linear后端）

workflow_labels:

backlog
in-progress
ready-for-review
done

workflow_labels:

backlog
in-progress
ready-for-review
done

Beads configuration (when task_management: beads)

Beads配置（当task_management设为beads时）

beads_prefix: myapp # Optional: custom issue prefix

beads_prefix: myapp # 可选：自定义事项前缀


**Default:** If no configuration is found, use native Tasks (`TaskCreate`, `TaskList`, `TaskUpdate`) for simple tracking.


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

When to Use This Skill

何时使用此Skill

Create a backlog item when:

Work requires more than 15-20 minutes
Needs research, planning, or multiple approaches considered
Has dependencies on other work
Requires approval or prioritization
Part of larger feature or refactor
Technical debt needing documentation

Act immediately instead when:

Issue is trivial (< 15 minutes)
Complete context available now
No planning needed
User explicitly requests immediate action
Simple bug fix with obvious solution

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

工作需要15-20分钟以上的时间
需要调研、规划或考虑多种实现方案
与其他工作存在依赖关系
需要审批或优先级排序
属于大型功能或重构的一部分
需要记录的技术债务

在以下情况直接处理：

问题非常简单（耗时<15分钟）
当前具备完整上下文
无需规划
用户明确要求立即处理
解决方案明确的简单Bug修复

Core Concepts

核心概念

Status Lifecycle

状态生命周期

All backends follow this status workflow:

pending → ready → complete

Status	Meaning
pending	Needs triage/approval before work begins
ready	Approved and ready for implementation
complete	Work finished, acceptance criteria met

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

pending → ready → complete

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

Priority Levels

优先级等级

Priority	Meaning
p1	Critical - blocks other work or users
p2	Important - should be done soon
p3	Nice-to-have - can wait

优先级	含义
p1	关键级别 - 阻塞其他工作或用户使用
p2	重要级别 - 应尽快处理
p3	锦上添花 - 可延后处理

Core Operations

核心操作

Each backend implements these operations:

Operation	Purpose
CREATE	Add new backlog item
LIST	Query existing items
UPDATE	Modify item (status, priority, details)
COMPLETE	Mark item as done

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

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

Backend Selection

后端选择

When this skill is invoked:

Read configuration from project CLAUDE.md

Load appropriate reference based on

backend

setting:

```
github
```
→
```
references/github-backend.md
```
```
linear
```
→
```
references/linear-backend.md
```
```
beads
```
→
```
references/beads-backend.md
```

Follow backend-specific instructions for operations

调用此Skill时：

读取配置 从项目的CLAUDE.md文件

加载对应参考文档 根据

backend

设置：

```
github
```
→
```
references/github-backend.md
```
```
linear
```
→
```
references/linear-backend.md
```
```
beads
```
→
```
references/beads-backend.md
```

遵循后端特定操作说明 执行操作

Fallback Behavior

回退行为

If the configured backend is unavailable:

GitHub unavailable (gh not authenticated): Fall back to native Tasks
Linear unavailable (MCP not configured): Fall back to native Tasks
Beads unavailable (bd not installed or not initialized): Fall back to native Tasks
Warn user about the fallback

如果配置的后端不可用：

GitHub不可用（gh未认证）：回退到原生Tasks
Linear不可用（MCP未配置）：回退到原生Tasks
Beads不可用（bd未安装或未初始化）：回退到原生Tasks
向用户发出警告 说明回退情况

Integration with Development Workflows

与开发工作流的集成

Trigger	Flow
Code review findings	Review → Create items → Triage → Work
PR comments	Resolve PR → Create items for complex fixes
Planning sessions	Brainstorm → Create items → Prioritize → Work
Technical debt	Document → Create item → Schedule
Feature requests	Analyze → Create item → Prioritize

触发条件	流程
代码评审发现	评审 → 创建事项 → 分类处理 → 执行
PR评论	解决PR问题 → 为复杂修复创建事项
规划会议	头脑风暴 → 创建事项 → 优先级排序 → 执行
技术债务	记录 → 创建事项 → 安排时间
功能请求	分析 → 创建事项 → 优先级排序

Key Distinctions

关键区别

Backlog manager (this skill):

Persisted tracking across sessions
Multiple backend options
Team collaboration
Project/sprint planning

Native Tasks (TaskCreate, TaskList, TaskUpdate):

Session task tracking with file persistence (
```
~/.claude/tasks/
```
)
Supports dependencies (
```
blockedBy
```
,
```
blocks
```
)
Can be shared across sessions via
```
CLAUDE_CODE_TASK_LIST_ID
```
env var
Use for: in-session progress tracking, subagent coordination, simple task lists
Different from backlog manager: Tasks are ephemeral coordination, backlog is project planning

待办事项管理器（本Skill）：

跨会话持久化跟踪
多后端选项
团队协作
项目/迭代规划

原生Tasks（TaskCreate、TaskList、TaskUpdate）：

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