gsd-review-backlog

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

<objective> Review all 999.x backlog items and optionally promote them into the active milestone sequence or remove stale entries. </objective> <process>

List backlog items:

bash

_BACKLOG=( .planning/phases/999* )
if [ -e "${_BACKLOG[0]}" ]; then ls -d "${_BACKLOG[@]}"; else echo "No backlog items found"; fi

Read ROADMAP.md and extract all 999.x phase entries:
bash
```
cat .planning/ROADMAP.md
```
Show each backlog item with its description, any accumulated context (CONTEXT.md, RESEARCH.md), and creation date.
Present the list to the user via AskUserQuestion:
- For each backlog item, show: phase number, description, accumulated artifacts
- Options per item: Promote (move to active), Keep (leave in backlog), Remove (delete)
For items to PROMOTE:
- Find the next sequential phase number in the active milestone
- Rename the directory from
```
999.x-slug
```
  to
```
{new_num}-slug
```
  :
  bash
```
NEW_NUM=$(gsd-tools query phase.add "${DESCRIPTION}" --raw)
```
- Move accumulated artifacts to the new phase directory
- Update ROADMAP.md: move the entry from
```
## Backlog
```
  section to the active phase list
- Remove
```
(BACKLOG)
```
  marker
- Add appropriate
```
**Depends on:**
```
  field
For items to REMOVE:
- Delete the phase directory
- Remove the entry from ROADMAP.md
```
## Backlog
```
  section

Commit changes:

bash

gsd-tools query commit "docs: review backlog — promoted N, removed M" --files .planning/ROADMAP.md

Report summary:

## 📋 Backlog Review Complete

Promoted: {list of promoted items with new phase numbers}
Kept: {list of items remaining in backlog}
Removed: {list of deleted items}

</process>

<objective> 评审所有999.x版本的待办事项，可选择将其推进至活跃里程碑序列，或移除过时条目。 </objective> <process>

列出待办事项:

bash

_BACKLOG=( .planning/phases/999* )
if [ -e "${_BACKLOG[0]}" ]; then ls -d "${_BACKLOG[@]}"; else echo "No backlog items found"; fi

读取ROADMAP.md并提取所有999.x阶段条目:
bash
```
cat .planning/ROADMAP.md
```
展示每个待办事项的描述、累积的相关上下文（CONTEXT.md、RESEARCH.md）以及创建日期。
通过AskUserQuestion向用户展示列表:
- 针对每个待办事项，展示：阶段编号、描述、累积的相关文档
- 每个条目可选操作：推进（移至活跃里程碑）、保留（留在待办列表）、移除（删除）
对于需推进的条目:
- 查找活跃里程碑中的下一个连续阶段编号
- 将目录从
```
999.x-slug
```
  重命名为
```
{new_num}-slug
```
  :
  bash
```
NEW_NUM=$(gsd-tools query phase.add "${DESCRIPTION}" --raw)
```
- 将累积的相关文档移至新的阶段目录
- 更新ROADMAP.md：将条目从
```
## Backlog
```
  部分移至活跃阶段列表
- 移除
```
(BACKLOG)
```
  标记
- 添加合适的
```
**Depends on:**
```
  字段
对于需移除的条目:
- 删除阶段目录
- 从ROADMAP.md的
```
## Backlog
```
  部分移除对应条目

提交变更:

bash

gsd-tools query commit "docs: review backlog — promoted N, removed M" --files .planning/ROADMAP.md

生成总结报告:

## 📋 待办事项评审完成

已推进：{带新阶段编号的已推进条目列表}
已保留：{待办列表中剩余的条目列表}
已移除：{已删除的条目列表}

</process>