К основному содержанию
скилл CX Codex

issue-progress-tracking — скилл для Claude Code: обзор и установка

Скилл issue-progress-tracking регламентирует ведение задач на GitHub через утилиту gh CLI: переводит статусы, создаёт ветки под задачу, фиксирует прогресс и привязывает pull request.

MIT 221 установок ★ 305 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add yonatangross/orchestkit --skill issue-progress-tracking -a claude-code
Открыть на GitHub

Что делает issue-progress-tracking

Скилл задаёт строгий сценарий работы с задачами GitHub через утилиту gh и Bash. При старте агент выставляет метку status:in-progress, снимает status:todo, оставляет комментарий о начале работы и создаёт ветку формата issue/<номер>-описание от основной ветки. В процессе работы формируются атомарные коммиты с обязательной ссылкой на номер тикета в виде type(#N): описание.

При завершении работы скилл собирает pull request с ключевым словом Closes #N и переключает задачу на status:in-review. Закрывать issue напрямую через gh issue close по правилам запрещено: тикет закрывается только слиянием PR.

Скилл помечен флагами user-invocable: false и disable-model-invocation: true. Человек не может вызвать его отдельной слэш-командой, а модель не подтягивает его сама. Агент считывает файл сценария напрямую при выполнении родительских задач OrchestKit.

Какие задачи решает

  • переводить issue в статус status:in-progress и создавать ветку задачи
  • оформлять атомарные коммиты с привязкой номера issue
  • публиковать промежуточные отчёты о ходе работы в комментариях задачи
  • создавать pull request с директивой Closes #N и обновлять метки

Примеры запросов агенту

  • Начни работу над задачей #42 и заведи под неё отдельную ветку
  • Опубликуй комментарий о текущем прогрессе в задаче #15
  • Создай pull request для задачи #108 и переведи её на ревью

Как установить issue-progress-tracking

1Через Skills CLI (Vercel)

npx skills add yonatangross/orchestkit --skill issue-progress-tracking -a claude-code

2Вручную: положить файлы

~/.claude/skills/issue-progress-tracking/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/issue-progress-tracking/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об issue-progress-tracking

Как установить issue-progress-tracking в Claude Code?

Выполните команду npx skills add yonatangross/orchestkit --skill issue-progress-tracking -a claude-code. Файл сценария сохранится по пути ~/.claude/skills/issue-progress-tracking/SKILL.md.

Что делает скилл issue-progress-tracking?

Он управляет жизненным циклом GitHub issue с помощью gh CLI. Скилл автоматизирует разметку тегами status:in-progress и status:in-review, создание ветки issue/<N>-описание, оформление коммитов и создание PR.

Можно ли вызвать этот скилл напрямую через команду?

Нет, у него установлены параметры user-invocable: false и disable-model-invocation: true. Скилл не запускается через команду вроде /ork: и читается агентом напрямую из файла при выполнении составных рабочих процессов.

Исходный текст

SKILL.md · MIT
---
name: issue-progress-tracking
license: MIT
compatibility: "Claude Code 2.1.277+."
description: "GitHub issue workflow ceremony using gh CLI — labels issues as in-progress, creates feature branches (issue/N-description), commits with issue references, posts progress comments, and links PRs with Closes #N. Keeps issues in sync with development work. Use when starting work on an issue, tracking progress, or completing work with a PR."
context: inherit
user-invocable: false
disable-model-invocation: true
allowed-tools: "Bash"
effort: low
model: haiku
metadata:
  category: workflow-automation
  version: "1.0.0"
  author: "OrchestKit"
  complexity: "low"
  tags: "git, github, issues, tracking, workflow"
---

# Issue Progress Tracking

Ceremony guide for tracking GitHub issue progress via `gh` CLI. Ensures issues stay updated as work progresses from start to PR.

## Invocation

This skill is `user-invocable: false` and `disable-model-invocation: true`:
there is no `/ork:` form and the model cannot auto-select it (#3313). An agent
loads it explicitly by Reading this file's path:

```text
${CLAUDE_PLUGIN_ROOT}/skills/issue-progress-tracking/SKILL.md
```

---

## Phase 1: Start Work

Label the issue and create a feature branch:

```bash
# Move issue to in-progress
gh issue edit $ARGUMENTS[0] --add-label "status:in-progress" --remove-label "status:todo"
gh issue comment $ARGUMENTS[0] --body "Starting work on this issue."

# Create feature branch
git checkout -b issue/$ARGUMENTS[0]-brief-description
```

**Rules:**
- Always branch from the default branch (main/dev)
- Branch name format: `issue/<number>-<brief-description>`
- Never work directly on main/dev

---

## Phase 2: During Work — Small Commits

Commit after each logical step, not at the end. Every commit references the issue:

```bash
# Each commit references the issue number
git commit -m "feat(#$ARGUMENTS[0]): add user model

Co-Authored-By: Claude <[email protected]>"
```

**Rules:**
- One logical change per commit (atomic)
- Reference issue in every commit: `type(#N): description`
- Commit early and often — don't accumulate a massive diff

---

## Phase 3: Report Progress (Long Implementations)

For multi-step work, post progress updates:

```bash
gh issue comment $ARGUMENTS[0] --body "Progress update:
- Completed: database schema, API endpoints
- In progress: frontend components
- Remaining: tests, documentation"
```

**When to post updates:**
- After completing a major milestone
- When blocked or changing approach
- Before stepping away from a long task

---

## Phase 4: Complete Work

Create the PR and update labels:

```bash
# Create PR that closes the issue
gh pr create \
  --title "feat(#$ARGUMENTS[0]): brief description" \
  --body "Closes #$ARGUMENTS[0]

## Changes
- Change 1
- Change 2

## Test Plan
- [ ] Unit tests pass
- [ ] Manual verification"

# Update issue status
gh issue edit $ARGUMENTS[0] --add-label "status:in-review" --remove-label "status:in-progress"
```

---

## Rules Quick Reference

| Rule | Impact | What It Covers |
|------|--------|----------------|
| [Start Work Ceremony](rules/start-work-ceremony.md) | HIGH | Branch creation, label updates, initial comment |
| [Small Commits](rules/small-commits.md) | HIGH | Atomic commits referencing issues |

**Total: 2 rules across 2 categories**

---

## Key Decisions

| Decision | Choice | Rationale |
|----------|--------|-----------|
| Label prefix | `status:` | Consistent with GitHub conventions |
| Branch format | `issue/<N>-desc` | Links branch to issue automatically |
| Commit reference | `type(#N):` | Conventional commits + issue linking |
| Progress comments | Manual | Keeps humans in the loop |

---

## Common Mistakes

1. **Starting work without labeling** — team loses visibility into who is working on what
2. **Giant commits at the end** — makes review harder and history useless for bisect
3. **Forgetting to link PR to issue** — issue stays open after merge
4. **Not updating labels on PR creation** — issue shows "in-progress" during review
5. **Closing issues manually with `gh issue close`** — issues are closed ONLY by merging a PR with `Closes #N` in the body. During work, comment progress with `gh issue comment`; never close directly.

---

## Related Skills

- `ork:commit` — Commit with conventional format
- `ork:fix-issue` — Full issue resolution workflow
- `ork:implement` — Feature implementation with parallel agents
- `ork:create-pr` — Create pull requests

© OrchestKit · MIT · yonatangross/orchestkit

Похожие скиллы

Все скиллы по теме «Git и GitHub» →
antfu-issue-triage Anthony Fu Скилл antfu-issue-triage для Claude Code анализирует открытые issues и pull request в репозитории GitHub. Находит дубликаты, спам и закрытые баги, формируя таблицу действий перед отправкой правок. CX Codex +1 413установок create-scrap-issue dyoshikawa Скилл create-scrap-issue собирает заметки и наблюдения в один GitHub issue с контекстом, деталями и следующими шагами. Подходит для сохранения находок на потом. CX Codex +1 ★ 1 636звёзд репо resolve-issue sentimony Скилл resolve-issue для Claude Code и Codex ведёт задачу из GitHub через весь цикл разработки от анализа до приёмки. Запускается по номеру или ссылке на задачу для пошагового контроля или в режиме --auto. CX Codex +1 1 200установок github-issue-creator alex-ilgayev Скилл github-issue-creator для Claude Code создаёт задачи GitHub для MCPSpy. Он включается по просьбе оформить запрос на функцию, баг или технический долг. CX Codex +1 1установок bug-issue ThinkFlowLab Скилл bug-issue для Claude Code воспроизводит ошибки проекта и создаёт отчёты в GitHub Issues. Включается при запросе расследования бага с публикацией задачи. CX Codex +1 ★ 413звёзд репо issue-create modelcontextprotocol Скилл issue-create для Claude Code и Codex. Создаёт issue в репозитории: проверяет дубли по всем состояниям, ставит метки и milestone, создаёт карточку на доске с приоритетом. CX Codex +1 ★ 92 149звёзд репо

Из того же набора86

Весь набор →
doctor Скилл doctor проверяет состояние компонентов OrchestKit, манифестов, хуков, субагентов и серверов MCP. Находит сбои конфигурации и подсказывает способы исправления перед релизом. CX Codex +1 227установок storybook-testing Скилл storybook-testing для Claude Code помогает настраивать тестирование компонентов в Storybook 10. Он подключается при написании историй, настройке визуальных проверок и переносе проекта со Storybook 9. CX Codex +1 224установок explore Скилл explore для Claude Code запускает 3–5 агентов, чтобы исследовать структуру кода, потоки данных, архитектурные паттерны и здоровье проекта. Разбирает незнакомую кодовую базу и её архитектуру. CX Codex +1 224установок errors Скилл errors разбирает ошибки сессий Claude Code, группирует их по типам и ищет повторяющиеся случаи. Он подключается к задаче после сбоя команды, сети или инструмента. CX Codex +1 223установок release-management Скилл release-management выпускает релизы на GitHub через gh release: подбирает версию по semver и собирает заметки из смёрдженных PR. Пригодится при тегировании и публикации changelog. CX Codex +1 220установок llm-integration Скилл llm-integration для Claude Code содержит 20 правил для интеграции LLM: строгий вызов функций, SSE-стриминг, запуск в Ollama и дообучение LoRA. CX Codex +1 218установок fix-issue Скилл fix-issue разбирает GitHub issue, ищет корневую причину, вносит исправление с тестами и создаёт PR со ссылкой на issue. CX Codex +1 217установок review-pr Скилл review-pr для Claude Code проверяет pull request, ветку или диапазон diff с помощью параллельных агентов. Перед слиянием он выдаёт вердикт approve или request-changes. CX Codex +1 217установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой