gsd-review-backlog — скилл для Claude Code: обзор и установка
Скилл gsd-review-backlog для Claude Code разбирает элементы бэклога и предлагает перенести их в активный этап или удалить. Запускается для ревизии фаз 999.x в проекте.
MIT 576 установок ★ 11 761 обновлён 2026-11-16
npx skills add open-gsd/gsd-core --skill gsd-review-backlog -a claude-codeЧто делает gsd-review-backlog
Скилл собирает фазы 999.x из .planning/phases/ и сверяет их с разделом ## Backlog в .planning/ROADMAP.md. Для каждого пункта он показывает описание, дату создания и накопленные материалы из CONTEXT.md и RESEARCH.md, а затем спрашивает, перенести запись, оставить или удалить.
При переносе скилл выбирает следующий номер фазы, перемещает связанные материалы, обновляет дорожную карту и добавляет поле **Depends on:**. Удаление убирает папку фазы и запись из бэклога; после изменений скилл запускает команду фиксации. Для работы нужны файлы планирования проекта и доступный gsd-tools.cjs или проверенный gsd_run; выполнение команд требует Node.js.
Какие задачи решает
- просмотреть фазы
999.xи их материалы - перенести выбранный пункт в активную последовательность фаз
- удалить устаревшую фазу и запись из дорожной карты
- зафиксировать изменения после ревизии бэклога
Примеры запросов агенту
- Просмотри фазы
999.xи предложи, какие перенести в активный этап. - Удали устаревшую запись из бэклога и обнови дорожную карту.
- Перенеси выбранный пункт бэклога в следующую фазу.
Как установить gsd-review-backlog
1Через Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-review-backlog -a claude-code2Вручную: положить файлы
~/.claude/skills/gsd-review-backlog/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gsd-review-backlog/
1Через Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-review-backlog -a codex2Вручную: положить файлы
.agents/skills/gsd-review-backlog/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-review-backlog -a cursor2Вручную: положить файлы
.cursor/skills/gsd-review-backlog/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install open-gsd/gsd-core skills/gsd-review-backlog2Вручную: положить файлы
.github/skills/gsd-review-backlog/SKILL.md1Через Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-review-backlog -a gemini-cli2Командой платформы
gemini skills install https://github.com/open-gsd/gsd-core --path skills/gsd-review-backlogВручную: положить файлы
.devin/skills/gsd-review-backlog/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-review-backlog -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о gsd-review-backlog
Как установить gsd-review-backlog в Claude Code?
Выполни npx skills add open-gsd/gsd-core --skill gsd-review-backlog -a claude-code. Файл скилла находится по пути ~/.claude/skills/gsd-review-backlog/SKILL.md.
Что делает gsd-review-backlog?
Он показывает элементы бэклога 999.x, их описания и накопленные материалы, а затем позволяет перенести пункт в активный этап, оставить его или удалить. После изменений скилл обновляет ROADMAP.md и фиксирует правки.
Что нужно для работы gsd-review-backlog?
В проекте нужны файлы .planning/phases/ и .planning/ROADMAP.md, а также доступный gsd-tools.cjs или проверенный gsd_run. Для выполнения команд требуется Node.js.
Исходный текст
SKILL.md · MIT
---
name: gsd-review-backlog
description: "Review and promote backlog items to active milestone"
allowed-tools:
- Read
- Write
- Bash
- Grep
- AskUserQuestion
---
<objective>
Review all 999.x backlog items and optionally promote them into the active
milestone sequence or remove stale entries.
</objective>
<process>
1. **List backlog items:**
```bash
_BACKLOG=( .planning/phases/999* )
if [ -e "${_BACKLOG[0]}" ]; then ls -d "${_BACKLOG[@]}"; else echo "No backlog items found"; fi
```
2. **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.
3. **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)
4. **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
_GSD_SHIM_NAME="gsd-tools.cjs"; _GSD_RUNTIME_ROOT="${RUNTIME_DIR:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"; GSD_TOOLS="${_GSD_RUNTIME_ROOT}/gsd-core/bin/${_GSD_SHIM_NAME}"; _gsd_at() { for _p; do if [ -f "$_p" ]; then GSD_TOOLS="$_p"; return 0; fi; done; return 1; }; _gsd_id_ok() { case "$("$1" runtime-identity --raw 2>/dev/null || true)" in '{"packageName":"@opengsd/gsd-core"'*'}') return 0;; *) return 1;; esac; }; _gsd_homes() { set -- "${CLAUDE_CONFIG_DIR:-$HOME/.claude}" "${ANTIGRAVITY_CONFIG_DIR:-$HOME/.gemini/antigravity}" "$HOME/.gemini/antigravity-ide" "$HOME/.gemini/antigravity-cli" "${AUGMENT_CONFIG_DIR:-$HOME/.augment}" "${CLINE_CONFIG_DIR:-$HOME/.cline}" "${CODEBUDDY_CONFIG_DIR:-$HOME/.codebuddy}" "${CODEX_HOME:-$HOME/.codex}" "${COPILOT_CONFIG_DIR:-${COPILOT_HOME:-$HOME/.copilot}}" "${CURSOR_CONFIG_DIR:-$HOME/.cursor}" "${HERMES_HOME:-$HOME/.hermes}" "${KILO_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/kilo}" "${KIMI_CONFIG_DIR:-$HOME/.config/agents}" "$HOME/.agents" "${KIMI_CODE_HOME:-$HOME/.kimi-code}" "${OPENCODE_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/opencode}" "${PI_CODING_AGENT_DIR:-$HOME/.pi/agent}" "${QWEN_CONFIG_DIR:-$HOME/.qwen}" "${TRAE_CONFIG_DIR:-$HOME/.trae}" "${WINDSURF_CONFIG_DIR:-$HOME/.codeium/windsurf}" "${ZCODE_CONFIG_DIR:-$HOME/.zcode}" "${GROK_AGENTS_HOME:-$HOME/.agents}"; for _h; do _gsd_at "$_h/gsd-core/bin/${_GSD_SHIM_NAME}" && return 0; done; return 1; }; if _gsd_at "${_GSD_RUNTIME_ROOT}/gsd-core/bin/${_GSD_SHIM_NAME}" "${_GSD_RUNTIME_ROOT}/.claude/gsd-core/bin/${_GSD_SHIM_NAME}" "${_GSD_RUNTIME_ROOT}/.codex/gsd-core/bin/${_GSD_SHIM_NAME}"; then gsd_run() { node "$GSD_TOOLS" "$@"; }; elif _gsd_homes; then gsd_run() { node "$GSD_TOOLS" "$@"; }; elif unset -f gsd_run; _G="$(command -v gsd_run)"; [ -n "$_G" ] && _gsd_id_ok "$_G"; then GSD_TOOLS="$_G"; gsd_run() { "$GSD_TOOLS" "$@"; }; else echo "ERROR: gsd-tools.cjs not found at $GSD_TOOLS and no identity-proving gsd_run is on PATH. Run: npx -y @opengsd/gsd-core@latest --claude --local" >&2; exit 1; fi; GSD_IDENTITY_STATUS=unverified; _gsd_id_ok gsd_run && GSD_IDENTITY_STATUS=ok; export GSD_IDENTITY_STATUS; [ "$GSD_IDENTITY_STATUS" = ok ] || echo "WARNING: \"$GSD_TOOLS\" did not prove it is @opengsd/gsd-core - it is either a different package or an @opengsd/gsd-core older than the runtime-identity verb. See docs/how-to/diagnose-a-foreign-gsd-tools.md" >&2; if [ -n "${CLAUDE_ENV_FILE:-}" ] && [ -n "${GSD_TOOLS:-}" ]; then printf "export PATH='%s':\"\$PATH\"\n" "${GSD_TOOLS%/*}" >> "$CLAUDE_ENV_FILE" 2>/dev/null || true; fi
NEW_NUM=$(gsd_run 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
5. **For items to REMOVE:**
- Delete the phase directory
- Remove the entry from ROADMAP.md `## Backlog` section
6. **Commit changes:**
```bash
gsd_run query commit "docs: review backlog — promoted N, removed M" --files .planning/ROADMAP.md
```
7. **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>
© open-gsd · MIT · open-gsd/gsd-core