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

github-deep-review — скилл для Claude Code

Скилл github-deep-review для глубокого разбора GitHub-проблем и PR. Читает код, ищет корень бага, предлагает лучший фикс и называет, что именно нужно проверить перед слиянием.

MIT 275 установок ★ 7 554 обновлён 2026-10-20

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add steipete/agent-scripts --skill github-deep-review -a claude-code
Открыть на GitHub

Что делает github-deep-review

github-deep-review учит агента анализировать GitHub как автор: сначала код, потом выводы. Вместо общих комментариев скилл требует доказательств — траву из истории коммитов, тесты, CI-логи, поведение на текущем main. Агент вытаскивает контекст автора PR, следит за цепочкой вызовов от точки входа через валидацию и роутинг до границы сохранения данных, проверяет зависимости по их доке, а не по догадкам.

Для каждого багу скилл требует ответить: что ломается, где в коде это происходит, кто и когда это завёл (с проверкой сырых коммитов, не по датам), лучший ли это фикс, нужен ли больший рефакторинг. Для PR — конкретные нарушения по файлам и строкам, список проверенных доказательств, оставшиеся риски. Выход — структурированный отчёт с ссылками на код и коммиты, без фраз вроде «стоит рассмотреть».

Установка требует gh CLI для запроса на GitHub и локального репозитория, если нужен анализ истории. Скилл работает на Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI.

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

  • разобраться, что именно ломается в баге и где в коде это происходит
  • найти настоящую причину бага через историю коммитов, не по догадкам
  • оценить, действительно ли предложенный фикс лучше всех остальных
  • проверить PR на корректность с привязкой к строкам кода
  • выявить, нужен ли больший рефакторинг для устранения класса багов

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

  • Разбери PR #42 в нашем репозитории — что ломается, корень в коде, лучший фикс?
  • Посмотри issue #15 на GitHub, воспроизведи проблему и предложи фикс с тестом
  • Проанализируй этот коммит: кто его завёл, почему это регрессия, как её лучше чинить?

Как установить github-deep-review

1Через Skills CLI (Vercel)

npx skills add steipete/agent-scripts --skill github-deep-review -a claude-code

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

~/.claude/skills/github-deep-review/SKILL.md

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

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

Вопросы о github-deep-review

Как установить github-deep-review в Claude Code?

Выполните npx skills add steipete/agent-scripts --skill github-deep-review -a claude-code. После установки откройте ~/.claude/skills/github-deep-review/SKILL.md для полной документации.

Что делает github-deep-review?

Скилл учит агента разбираться в GitHub-багах и PR как опытный разработчик: читать код по цепочке вызовов, искать настоящую причину ошибки в истории коммитов, оценивать качество фикса и называть оставшиеся риски с конкретными доказательствами.

Какие платформы поддерживает этот скилл?

github-deep-review работает на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Требуется локальный доступ к gh CLI для запросов на GitHub и к репозиторию для анализа истории.

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

SKILL.md · MIT
---
name: github-deep-review
description: "GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first."
---

# GitHub Deep Review

Review like Peter: high-confidence, evidence-first, code-aware, and willing to say "not proven" when the trail is weak. The goal is not a generic summary. The goal is to understand the bug class, find the real cause if possible, decide the best fix after reading enough code, and call out whether a larger refactor would improve the design.

## Start

Use `gh`, not web browsing, for GitHub refs:

```bash
gh issue view <n> --json number,title,state,author,body,comments,labels,updatedAt,url
gh pr view <n> --json number,title,state,author,body,comments,reviews,files,commits,statusCheckRollup,mergeStateStatus,headRefName,headRepositoryOwner,url
gh pr diff <n> --patch
```

For PRs, collect author context by default unless the author is Peter (`steipete` or an obvious Peter-owned account). Use the local workflow in `~/Projects/agent-scripts/skills/github-author-context/SKILL.md` and include a short `Author context:` block near the top of the review when the author is not Peter.
After merge/rejection/close/review, use that same author-context workflow to append a contributor note only when the interaction creates durable future-review signal.

For repo-local review, also inspect:

```bash
git status --short --branch
git fetch origin
git log --oneline --decorate -20
rg "<key symbol/error/config/endpoint>"
```

If the repo has local instructions, issue/PR skills, docs lists, test guidance, or maintainer runbooks, read those before deciding.

## Review Contract

Always answer these, explicitly:

- URL/ref: issue or PR number and affected surface.
- What is the bug or behavior being fixed?
- Can we identify the root cause? If yes, where in code and why. If no, what evidence is missing.
- For regressions, who/what introduced it and when? Include commit/PR provenance when traceable by bounded history; say unknown instead of guessing.
- Is the current/proposed fix the best possible fix after reading adjacent code?
- Would a bigger refactor improve correctness, clarity, or future maintainability?
- What proof exists: tests, live repro, CI checks, docs, dependency docs/source, shipped/current behavior.
- What remains risky or unverified.

## Code Reading Depth

Read past the first touched file. Follow the real call path:

- entrypoint -> validation/parsing -> routing/dispatch -> owner module -> shared helper -> persistence/network/runtime boundary
- config/schema/docs -> runtime usage -> doctor/migration/fix path
- provider/channel/plugin owner code -> generic core seam, only if multiple owners need it
- tests around the touched surface plus adjacent regression tests

When behavior depends on a dependency, read the upstream docs/source/types or current package contract before assuming.

Prefer current source and executable proof over issue comments. Treat stale comments, old CI, and old release behavior as hints until rechecked.

## Provenance

For bug/regression reviews, include a compact `Provenance:` answer when feasible:

- Use `git log -S/-G`, `git blame`, and linked PRs/issues to locate candidates, not prove introduction. Before saying `introduced by`, inspect raw parents with `git --no-replace-objects cat-file -p <sha>` and verify that `git --no-replace-objects diff --no-ext-diff --no-textconv <raw-parent> <sha> -- <path>` changed the implicated behavior, using tests/repro when feasible. A genuine root needs raw-header proof that it has no parents.
- Blame `^sha`, porcelain `boundary`, and shallow/grafted history alone are not introduction proof. `--root` can hide boundary markers; `git show` and `rev-list --parents` can disguise a shallow boundary as a root. An available raw parent permits explicit comparison even at a shallow boundary; missing parents or an unverifiable patch require `unknown` with the gap, not inference from a subject, date, or author.
- Separate code author, introducing PR author, merger, committer, automation trigger, and current PR author. Verify identities and triggers from explicit metadata/events; a role is not proof of causation, and an unverified identity stays unknown.
- Use `made visible by` only for a verified trigger and `carried forward by` only for verified preexisting behavior. Apply the same evidence bar to summaries and owner hints, not just a `Provenance:` field. Include confidence: `clear`, `likely`, or `unknown`.
- For features, docs, and refactors, write `N/A`; for untraceable bugs, report `unknown` with the missing evidence. Missing provenance does not invalidate an independently proven bug.

## Fix Quality Bar

Good fixes usually:

- live at the ownership boundary where the bug belongs
- preserve public/backward-compatible behavior unless the issue is about retiring it
- add a regression test at the smallest meaningful seam
- avoid broad special cases, hidden migrations, semantic sentinels, and provider/channel IDs in generic core
- update docs/changelog when user-visible behavior changes
- fail clearly in runtime paths and repair through doctor/migration paths when that is the established contract

Call out when a fix is only symptom-level. If a slightly larger refactor makes the invariant obvious and reduces future bugs, recommend it. If the refactor widens risk without improving the bug class, say so.

## PR Review Shape

Lead with findings when reviewing a PR. Findings need file/line/symbol references and a concrete failure mode. Avoid vague "consider" comments.

If no blocking issues:

- say no blocking correctness issues found
- list the strongest proof checked
- name residual risk/test gaps
- answer whether the design is the best available shape

Do not approve, comment, close, merge, push, or land unless the user asked for that action.

## Issue Review Shape

For bugs/issues:

1. Reconstruct the reporter's scenario and affected version/surface.
2. Check whether current `main` already fixes it.
3. Reproduce or create a minimal local/live proof when feasible.
4. If clear, identify root cause and proposed fix.
5. If solved on `main`, only comment/close when the user asks; include proof and the canonical commit/PR if known.

If reproduction is not feasible, say exactly what blocks it and what evidence would make the decision reliable.

## Output Template

Use this shape when the user asks "what is this about", "is this the best fix", or "what did we fix":

```text
Ref: #123 / PR #456
Surface: <runtime/CLI/provider/channel/docs>

Bug: <one or two sentences>
Cause: <code path + confidence>
Provenance: <introduced/made visible/carried forward by commit/PR/date, or N/A/unknown>
Best fix: <what should change and why>
Refactor: <yes/no, specific shape>
Proof: <tests/live/CI/source/dependency docs>
Risk: <remaining uncertainty>
```

Keep it concise, but do not skip the cause/fix/refactor/proof decision.

© steipete · MIT · steipete/agent-scripts

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

Все скиллы по теме «Код-ревью и рефакторинг» →
github-review-pr daymade Скилл github-review-pr ревьюит пул-реквесты против живой ветки base: сверяет OID, делает three-way merge и решает, готов ли PR к мёржанию. CX Codex +1 367установок debate-review amElnagdy Скилл debate-review для Claude Code запускает ревью PR, MR или локальных изменений с участием двух моделей. Он собирает замечания и публикует итоговые комментарии либо печатает результат. CX Codex +1 705установок PR Review angular Скилл PR Review для глубокой проверки pull request в репозитории Angular. Включает гайдлайны по совместимости, производительности, качеству кода и коммитов, а также рабочий процесс для локальной или удалённой рецензии. CX Codex +1 532установок pr-review aeonfun Скилл pr-review для Claude Code проверяет открытые PR по одному или собирает сводку для сортировки по риску. Находит проблемы в изменениях и определяет, какие PR разбирать первыми. CX Codex +1 ★ 797звёзд репо github-deep-research bytedance Скилл github-deep-research проводит многораундовое исследование любого GitHub-репозитория и собирает структурированный markdown-отчёт с таймлайном, метриками и диаграммами Mermaid. CX Codex +1 2 900установок github-code-review ruvnet Скилл github-code-review для Claude Code запускает многоагентный ревью pull request на GitHub. Агенты ищут проблемы безопасности, производительности, архитектуры и стиля. CX Codex +1 1 300установок

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

Весь набор →
create-cli Скилл create-cli помогает спроектировать интерфейс консольной утилиты до написания кода: аргументы, флаги, коды возврата и правила вывода по стандартам clig.dev. CX Codex +1 508установок markdown-converter Скилл markdown-converter переводит офисные документы, таблицы, PDF, разметку и медиафайлы в чистый Markdown прямо через uvx без ручной настройки парсеров. CX Codex +1 346установок codex-first Скилл codex-first маршрутизирует разработку между Claude и воркерами Codex. Claude пишет спецификации и проверяет код, а Codex выполняет реализацию и авторевью. CX Codex +1 288установок browser-use Скилл browser-use для Claude Code и Codex — управляет реальным профилем Chrome пользователя с сохранёнными логинами и расширениями. Запускается через плагин Codex, расширение OpenClaw или прямое подключение DevTools. CX Codex +1 278установок native-app-performance Скилл native-app-performance для анализа производительности нативных приложений через xctrace и Time Profiler. Записывает трассы, извлекает горячие места стека и показывает узкие места без открытия Instruments. CX Codex +1 251установок instruments-profiling Скилл instruments-profiling для Claude Code профилирует macOS- и iOS-приложения через Instruments и xctrace, записывает трассы и выгружает стеки. Помогает искать медленные участки. CX Codex +1 242установок ssh-doctor Скилл ssh-doctor диагностирует сбои SSH на macOS: обрывы до авторизации, зависшие сессии sshd и проблемы службы Remote Login. CX Codex +1 239установок domain-dns-ops Скилл domain-dns-ops для Claude Code ведёт операции с доменами, зонами Cloudflare и редиректами. Настраивает новые домены и проверяет DNS и HTTPS. CX Codex +1 192установок

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

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