/start-issue
Start working on a GitHub issue by creating git worktree with proper branch naming
From dev-toolsnpx claudepluginhub dapi/claude-code-marketplace<issue-url>Start Issue
Начни работу над GitHub issue.
Входные данные
- ISSUE_URL: $ARGUMENTS (ссылка на GitHub issue)
Формат имени ветки
<тип>/<номер-задачи>-<описание>
Типы веток
| Тип | Когда использовать |
|---|---|
feature | Новая функциональность |
fix | Исправление бага |
chore | Рефакторинг, зависимости, CI, документация |
Определение типа
-
По labels issue:
bug,fix→fixenhancement,feature→featurechore,refactor,docs,ci,dependencies→chore
-
Если labels нет — определи по заголовку/описанию issue
Формирование описания (slug)
- Lowercase
- Пробелы и спецсимволы → дефисы
- Множественные дефисы → один дефис
- Максимум 50 символов
- Убрать дефис в конце
Примеры:
feature/123-add-user-authenticationfix/456-null-pointer-in-parserchore/789-update-eslint-config
Шаги выполнения
-
Прочитай GitHub issue по ISSUE_URL:
- Номер issue
- Заголовок
- Labels (для определения типа)
- Описание (если нужно для понимания типа)
-
Проверь лейбл
progress:Если issue уже имеет лейбл
progress:- Сообщи пользователю:
⚠️ Issue уже имеет лейбл 'progress' — возможно, над ней уже ведётся работа. - Спроси: продолжить или отменить?
- Если пользователь отменяет — заверши выполнение команды
- Сообщи пользователю:
-
Сформируй имя ветки по шаблону
<тип>/<номер>-<slug> -
Создай git worktree от текущей ветки:
Сформируй переменные:
BRANCH_NAME— имя ветки из шага 3 (напримерfix/123-some-bug)WORKTREE_NAME— имя директории: замени/на-(напримерfix-123-some-bug)WORKTREE_PATH— полный путь:~/worktrees/<WORKTREE_NAME>
Выполни команды последовательно:
mkdir -p ~/worktreesgit worktree add -b "<BRANCH_NAME>" "<WORKTREE_PATH>" HEAD -
Перейди в созданный каталог:
cd <WORKTREE_PATH>С этого момента
WORKTREE_PATH— текущий рабочий каталог (CWD). Вся дальнейшая работа должна проводиться в этом каталоге. -
Создай init.sh (если не существует):
Если файл
init.shне существует в каталоге, скопируй шаблон:cp <plugin-path>/templates/init.sh ./init.shГде
<plugin-path>— путь к плагину dev-tools. -
Выполни init.sh:
./init.sh -
Отметь issue лейблом
progress:Добавь лейбл
progressк issue:gh issue edit <ISSUE_NUMBER> --add-label "progress"Если лейбл не существует в репозитории, сначала создай его:
gh label create "progress" --color "1D76DB" --description "In progress" -
Выведи результат:
✅ Worktree создан: <WORKTREE_PATH> 📋 Issue: <ISSUE_URL> 🌿 Ветка: <BRANCH_NAME> -
Приступи к реализации:
Перейди в рабочий каталог и сделай его текущим (CWD):
cd <WORKTREE_PATH>
Убедись что ты находишься в <WORKTREE_PATH> — это твой рабочий каталог для всей дальнейшей работы. Изучи issue и начни реализацию задачи.
Завершение задачи
Когда считаешь задачу завершённой, выполни следующие шаги:
11. Commit, Push и создание PR
Используй skill commit-commands:commit-push-pr для:
- Коммита всех изменений
- Push в remote
- Создания Pull Request
/commit-commands:commit-push-pr
⚠️ ВАЖНО: Формат коммитов и PR должен содержать номер issue!
Формат commit message:
<тип>: <описание> (#<номер-issue>)
[опционально: детали изменений]
Refs #<номер-issue>
Примеры:
feat: add user authentication (#123)fix: resolve null pointer in parser (#456)chore: update eslint config (#789)
Формат PR:
- Title:
<тип>: <краткое описание> (#<номер-issue>) - Body: Обязательно включи
Closes #<номер-issue>для автоматического закрытия issue при merge
12. Параллельный запуск Code Review агентов
После создания PR ОБЯЗАТЕЛЬНО запусти review процесс используя ОБА подхода параллельно:
Вариант A — Skill для комплексного PR review:
/pr-review-toolkit:review-pr
Вариант B — Task tool с параллельными агентами: Запусти следующие агенты одновременно через Task tool:
pr-review-toolkit:code-reviewer— проверка кода на соответствие стандартамpr-review-toolkit:pr-test-analyzer— анализ покрытия тестамиpr-review-toolkit:silent-failure-hunter— поиск скрытых ошибокpr-review-toolkit:comment-analyzer— проверка комментариев
Пример запуска параллельных агентов:
[Task tool: subagent_type="pr-review-toolkit:code-reviewer", prompt="Review PR for code quality"]
[Task tool: subagent_type="pr-review-toolkit:pr-test-analyzer", prompt="Analyze test coverage"]
[Task tool: subagent_type="pr-review-toolkit:silent-failure-hunter", prompt="Hunt for silent failures"]
[Task tool: subagent_type="pr-review-toolkit:comment-analyzer", prompt="Review code comments"]
13. Исправление найденных проблем
Если review агенты нашли проблемы:
- Исправь найденные критические и важные issues
- Сделай дополнительный commit с фиксами
- Push изменения
- Перезапусти review (повтори шаг 12)
Повторяй цикл fix → commit → push → review пока все критические проблемы не будут устранены.
14. Финализация
После успешного прохождения review:
- Убедись что все CI checks прошли
- PR готов к merge
Вывод:
✅ Задача завершена!
📋 Issue: <ISSUE_URL>
🔀 PR: <PR_URL>
✔️ Review: passed