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

pre-ship-review — скилл для Claude Code: проверка кода перед отправкой

Скилл pre-ship-review проводит структурированную проверку качества кода перед PR, релизом или вехой. Находит ошибки на границах компонентов, где должны совпадать контракты, примеры и тесты.

MIT 120 установок ★ 3 обновлён 2026-10-25

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

Что делает pre-ship-review

Скилл запускает трёхфазный аудит. Фаза 1 — статические анализаторы (Pyright, Vulture, import-linter, deptry, Semgrep, Griffe), работают параллельно и проверяют типы, мёртвый код, границы архитектуры, зависимости, паттерны безопасности, дрейф API. Если инструмента нет — скилл пропускает его без ошибок. Фаза 2 — оркестрирует другие скиллы: code-hardcode-audit (магические числа и утёчки), dead-code-detector (мёртвый код), pr-gfm-validator (ссылки в PR). Дополнительно включает условные проверки — если менялись Python-файлы, запускает impl-standards; если более 500 строк — code-clone-assistant; если плагины — plugin-validator.

Фаза 3 — ручные проверки с помощью Claude: границы архитектуры (нет ли утечек между слоями, нет ли hardcoded списков фич), корректность формул и констант (кросс-ссылка на источники), синхронизация между параметрами в конфигах и реальными аргументами функций, тесты действительно проверяют заявленное, нет неявных зависимостей, нет O(n²) вместо O(n), ошибки дают действенные подсказки, примеры отражают реальное поведение, а не мечты.

Три шаблона: Template A для новых фич (полный цикл), Template B для багфиксов (корневая причина, воспроизведение), Template C для рефакторинга (обновление всех вызывающих, дрейф API). Скилл совершенствуется при использовании — если параметры сбились или нужен workaround, исправь файл сразу.

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

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

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

  • Проверь код перед отправкой: Template A для новой фичи, Template B если это багфикс
  • Запусти phase 1: Pyright, Vulture и остальные анализаторы на изменённых файлах
  • Проверь архитектурные границы: нет ли hardcoded списков фич, нет ли утечек между слоями

Как установить pre-ship-review

1Через Skills CLI (Vercel)

npx skills add terrylica/cc-skills --skill pre-ship-review -a claude-code

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

~/.claude/skills/pre-ship-review/SKILL.md

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

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

Вопросы о pre-ship-review

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

Выполни npx skills add terrylica/cc-skills --skill pre-ship-review -a claude-code, затем открой ~/.claude/skills/pre-ship-review/SKILL.md.

Что делает pre-ship-review?

Запускает трёхфазный аудит кода: статические анализаторы (типы, мёртвый код, архитектура), оркестрирует специализированные скиллы (secrets, дубликаты, валидация PR), затем проводит ручные проверки структурных ошибок и корректности домена.

Какие инструменты нужны для работы скилла?

Скилл использует Bash, Read, Grep, Glob. Опциональные статические анализаторы (Pyright, Vulture, import-linter, deptry, Semgrep, Griffe) устанавливаются через pip или brew; если их нет, скилл пропускает их проверки.

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

SKILL.md · MIT
---
name: pre-ship-review
description: Run a structured quality review before shipping code at any checkpoint such as PRs, releases, or milestones. Use whenever the user says.
allowed-tools: Bash, Read, Grep, Glob
---

# Pre-Ship Review

Structured quality review before shipping code at any checkpoint: PRs, releases, milestones. Catches the failures that occur at **integration boundaries** -- where contracts, examples, constants, and tests must all agree.

> **Core thesis**: AI-generated code excels at isolated components but fails systematically at boundaries between components. This skill systematically checks those boundaries.

> **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

## When to Use This Skill

Use before any significant code shipment:

- **Pull requests** with multiple new modules that wire together
- **Releases** combining work from multiple contributors or branches
- **Milestones** where quality gates must pass before proceeding
- **Any checkpoint** where code with examples, constants across files, or interface extensions needs validation

NOT needed for: single-file cosmetic changes, documentation-only updates, dependency bumps.

---

## TodoWrite Task Templates

**MANDATORY**: Select and load the appropriate template before starting review.

### Template A: New Feature Ship

```
1. Detect changed files and scope (git diff --name-only against base branch)
2. Run Phase 1 - External tool checks (Pyright, Vulture, import-linter, deptry, Semgrep, Griffe)
3. Run Phase 2 - cc-skills orchestration (code-hardcode-audit, dead-code-detector, pr-gfm-validator)
4. Run Phase 2 conditional checks based on file types changed
5. Phase 3 - Verify every function parameter has at least one caller passing it by name
6. Phase 3 - Verify every config/example parameter maps to an actual function kwarg
7. Phase 3 - Check for architecture boundary violations (hardcoded feature lists, cross-layer coupling)
8. Phase 3 - Verify domain constants and formulas are correct (cross-reference cited sources)
9. Phase 3 - Audit test quality - do tests test what they claim (not side effects)?
10. Phase 3 - Check for implicit dependencies between new components
11. Phase 3 - Look for O(n^2) patterns where O(n) suffices
12. Phase 3 - Verify error messages give actionable guidance
13. Phase 3 - Confirm examples reflect actual behavior, not aspirational behavior
14. Compile findings report with severity and suggested fixes
```

### Template B: Bug Fix Ship

```
1. Verify the fix addresses root cause, not symptom
2. Verify the fix does not mask information flow
3. Check that new test reproduces the original bug (fails without fix)
4. Run Phase 1 - External tool checks on changed files
5. Run Phase 2 - cc-skills checks on changed files
6. Verify constants consistency if any values changed
7. Compile findings report
```

### Template C: Refactoring Ship

```
1. Verify all callers updated to match new signatures
2. Run Phase 1 - External tool checks (especially Griffe for API drift)
3. Run Phase 2 - cc-skills checks (especially dead-code-detector)
4. Verify examples/docs updated to match new parameter names
5. Verify no dead imports from removed features
6. Check for introduced cross-boundary coupling
7. Compile findings report
```

---

## Three-Phase Workflow

### Phase 1: External Tool Checks (~15s, parallelizable)

Run static analysis tools on changed files. Skip any tool that is not installed (graceful degradation).

```
Detect scope:
  git diff --name-only $(git merge-base HEAD main)...HEAD

Run in parallel:
  pyright --outputjson <changed_py_files>          # Type contracts
  vulture <changed_py_files> --min-confidence 80   # Dead code / YAGNI
  lint-imports                                      # Architecture boundaries
  deptry .                                          # Dependency hygiene
  semgrep --config .semgrep/ <changed_files>        # Custom pattern rules
  griffe check --against main <package>             # API signature drift
```

**What each tool catches:**

| Tool             | Anti-Pattern                                              | Install                     |
| ---------------- | --------------------------------------------------------- | --------------------------- |
| Pyright (strict) | Interface contracts, return types, cross-file type errors | `pip install pyright`       |
| Vulture          | Dead code, unused constants/imports (YAGNI)               | `pip install vulture`       |
| import-linter    | Architecture boundary violations, forbidden imports       | `pip install import-linter` |
| deptry           | Unused/missing/transitive dependencies                    | `pip install deptry`        |
| Semgrep          | Non-determinism, silent param absorption, banned patterns | `brew install semgrep`      |
| Griffe           | Breaking API changes, signature drift vs base branch      | `pip install griffe`        |

**Graceful degradation**: If a tool is not installed, log a warning and skip it. Never fail the entire review because one optional tool is missing.

For detailed tool procedures, see [Automated Checks Reference](./references/automated-checks.md).
For installation instructions, see [Tool Install Guide](./references/tool-install-guide.md).

### Phase 2: cc-skills Orchestration (~30s, subagent-parallelizable)

Invoke existing cc-skills that complement external tools.

**Always run:**

- **code-hardcode-audit** -- Hardcoded values, magic numbers, leaked secrets
- **dead-code-detector** -- Polyglot dead code detection (Python, TypeScript, Rust)
- **pr-gfm-validator** -- PR description link validity (if creating a PR)

**Run conditionally based on changed file types:**

| Condition                 | Skill to invoke                                     |
| ------------------------- | --------------------------------------------------- |
| Python files changed      | impl-standards (error handling, constants, logging) |
| 500+ lines changed        | code-clone-assistant (duplicate code detection)     |
| Plugin/hook files changed | plugin-validator (structure, silent failures)       |
| Markdown/docs changed     | link-validation (broken links, path policy)         |

### Phase 3: Human Judgment Review (Claude-assisted)

These checks require understanding intent, domain correctness, and architectural fitness. Go through each one manually.

**Check 1: Architecture Boundaries**

- Does new code in a "core" layer reference names from a "plugin" or "capability" layer?
- Are there hardcoded lists of feature/plugin names? (Boundary violation)
- Would adding another instance of this feature type require modifying core code?

**Check 2: Domain Correctness**

- Are mathematical formulas correct? Cross-reference with cited papers.
- Are constants labeled correctly? (e.g., a "daily" constant should use the daily value)
- Do units and time periods match? (annual vs daily rates, quarterly vs monthly lambdas)

**Check 3: Test Quality**

- Does each test exercise the specific function it claims to test?
- Or does it test a side-effect? (Function A tests function B which internally calls A)
- Are edge cases covered? (Empty input, NaN, single element, division by zero)

**Check 4: Dependency Transparency**

- If component A requires component B to run first, is this documented?
- Are ordering requirements explicit in interfaces, not just in examples?

**Check 5: Performance**

- Any nested loops over the same data? (Potential O(n^2))
- Any expanding-window operations that could be rolling or full-sample?
- Any per-element operations that could be vectorized?

**Check 6: Error Message Quality**

- Do errors tell users what to DO, not just what went wrong?
- Do validation errors reference the specific parameter/value that failed?

**Check 7: Example Accuracy**

- Do examples demonstrate features that actually work in the code?
- Are there parameters in examples that get silently absorbed by `**kwargs` or `**_`?

For detailed check procedures, see [Judgment Checks Reference](./references/judgment-checks.md).

---

## Universal Pre-Ship Checklist

```
Phase 1 (Tools):
- [ ] Pyright strict passes on changed files (no type errors)
- [ ] Vulture finds no unused code in new files (or allowlisted)
- [ ] import-linter passes (no architecture boundary violations)
- [ ] deptry passes (no unused/missing dependencies)
- [ ] Semgrep custom rules pass (no non-determinism, no silent param absorption)
- [ ] Griffe shows no unintended API breaking changes vs base branch

Phase 2 (cc-skills):
- [ ] code-hardcode-audit passes (no magic numbers or secrets)
- [ ] dead-code-detector passes (no unused code)
- [ ] PR description links valid (pr-gfm-validator)

Phase 3 (Judgment):
- [ ] No new cross-boundary coupling introduced
- [ ] Domain constants and formulas are mathematically correct
- [ ] Tests actually test what they claim (not side effects)
- [ ] Implicit dependencies between components are documented
- [ ] No O(n^2) where O(n) suffices
- [ ] Error messages give actionable guidance
- [ ] Examples reflect actual behavior, not aspirational behavior
```

---

## Anti-Pattern Catalog

This skill is built on a taxonomy of 9 integration boundary anti-patterns. For the full catalog with examples, detection heuristics, and fix approaches, see [Anti-Pattern Catalog](./references/anti-pattern-catalog.md).

| #   | Anti-Pattern                    | Detection Method                           |
| --- | ------------------------------- | ------------------------------------------ |
| 1   | Interface contract violation    | Pyright + Griffe + manual trace            |
| 2   | Misleading examples             | Semgrep + manual config-to-code comparison |
| 3   | Architecture boundary violation | import-linter + manual review              |
| 4   | Incorrect domain constants      | Semgrep + domain expertise                 |
| 5   | Testing gaps                    | mutmut + manual test audit                 |
| 6   | Non-determinism                 | Semgrep custom rules                       |
| 7   | YAGNI                           | Vulture + dead-code-detector               |
| 8   | Hidden dependencies             | Manual dependency trace                    |
| 9   | Performance anti-patterns       | Manual complexity analysis                 |

---

## Post-Change Checklist

After modifying THIS skill:

- [ ] Anti-pattern catalog reflects real-world findings
- [ ] Tool install guide has current versions and commands
- [ ] TodoWrite templates cover the three ship types
- [ ] Universal checklist is complete and non-redundant
- [ ] All `references/` links resolve correctly
- [ ] Append changes to `references/evolution-log.md`

## Troubleshooting

| Issue                                           | Cause                              | Solution                                                         |
| ----------------------------------------------- | ---------------------------------- | ---------------------------------------------------------------- |
| Tool not found                                  | External tool not installed        | Install per tool-install-guide.md or skip (graceful degradation) |
| Too many Vulture false positives                | Framework entry points look unused | Create allowlist: `vulture --make-whitelist > whitelist.py`      |
| Semgrep too slow                                | Large codebase scan                | Scope to changed files only: `semgrep --include=<changed>`       |
| import-linter has no contracts                  | Project not configured             | Add `[importlinter]` section to `pyproject.toml`                 |
| Griffe reports false breaking changes           | Intentional API change             | Use `griffe check --against main --allow-breaking`               |
| Phase 3 finds nothing but reviewer finds issues | New anti-pattern category          | Add to catalog and evolution-log.md                              |
| cc-skill not triggering                         | Skill not installed in marketplace | Verify with `/plugin list`                                       |

---

## Reference Documentation

For detailed information, see:

- [Automated Checks Reference](./references/automated-checks.md) -- Phase 1 external tool procedures
- [Judgment Checks Reference](./references/judgment-checks.md) -- Phase 3 human-judgment procedures
- [Anti-Pattern Catalog](./references/anti-pattern-catalog.md) -- Full 9-category taxonomy with examples
- [Tool Install Guide](./references/tool-install-guide.md) -- Installation and setup for all external tools
- [Evolution Log](./references/evolution-log.md) -- Change history

## Post-Execution Reflection

After this skill completes, reflect before closing the task:

0. **Locate yourself.** — Find this SKILL.md's canonical path (Glob for this skill's name) before editing. All corrections target THIS file and its sibling references/ — never other documentation.
1. **What failed?** — Fix the instruction that caused it. If it could recur, add it as an anti-pattern.
2. **What worked better than expected?** — Promote it to recommended practice. Document why.
3. **What drifted?** — Any script, reference, or external dependency that no longer matches reality gets fixed now.
4. **Log it.** — Every change gets an evolution-log entry with trigger, fix, and evidence.

Do NOT defer. The next invocation inherits whatever you leave behind.

---

---

© terrylica · MIT · terrylica/cc-skills

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

Все скиллы по теме «Код-ревью и рефакторинг» →
code-review-ai Seth Hobson code-review-ai — плагин для Claude Code с командой /ai-review для многослойной проверки пул-реквестов и агентом-архитектором, который подключается к обсуждению дизайна системы. ★ 126звёзд репо review-and-ship cursor Скилл review-and-ship для Claude Code проверяет изменения перед отправкой: ищет баги, оценивает тесты и соответствие намерению, затем коммитит и открывает PR. CX Codex +1 2 700установок pre-publish-review Morvex885 Скилл pre-publish-review для Claude Code проверяет изменения перед git push, созданием PR или тегом v*. Он запускает отдельные проверки кода, сборки, авторства и безопасности. CX Codex +1 ★ 125звёзд репо ship-ci-review-loop Community Команда ship-ci-review-loop запускает цикл отслеживания CI и комментариев к пулл-реквесту. Она ждёт прохождения тестов, выгружает замечания ревьюеров и заставляет агента закрыть каждую ветку перед слиянием. CX Codex +1 ★ 2 003звёзд репо code-review cloudshipai Скилл code-review проводит аудит кода и pull request на предмет безопасности, производительности и тестов. Пригодится перед слиянием веток и при подготовке релизов. CX Codex +1 1установок ai-review Seth Hobson Команда ai-review для Claude Code проводит ревью кода с помощью статического анализа и ИИ. Она разбирает изменения и ищет уязвимости, проблемы производительности и архитектурные риски. CX Codex +1 ★ 42 780звёзд репо

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

Весь набор →
pypi-doppler Скилл pypi-doppler для Claude Code и пяти других платформ: публикует Python-пакет в PyPI с токеном из Doppler — только с локальной машины. CI/CD намеренно заблокирован: скрипт проверяет окружение и останавливается при обнаружении пайплайна. CX Codex +1 123установок schema-e2e-validation Скилл schema-e2e-validation запускает генерацию и E2E-проверку YAML-схемы через Earthly. Пригодится перед коммитом или для сверки схемы с ClickHouse Cloud. CX Codex +1 123установок plugin-validator Скилл plugin-validator проверяет структуру плагинов перед релизом и находит скрытые ошибки в хуках — команды без обработки исключений, которые молча падают. Нужен перед публикацией в маркетплейс. CX Codex +1 122установок evolutionary-metric-ranking Скилл evolutionary-metric-ranking находит лучшие конфигурации моделей и стратегий через процентильные пороги, пересечение метрик и эволюционный поиск. CX Codex +1 121установок pueue-job-orchestration Скилл pueue-job-orchestration управляет длинными задачами и пакетами команд через очередь pueue с контролем параллелизма и сохранением логов. CX Codex +1 120установок distributed-job-safety Скилл distributed-job-safety для Claude Code находит гонки и сбои в параллельных пайплайнах на pueue, moon и systemd-run. Выявляет риски при одновременной записи файлов и работе с общими ресурсами. CX Codex +1 120установок project-directory-migration Скилл project-directory-migration переносит сессии, историю и контекст Claude Code, когда вы переименовываете или перемещаете папку проекта. Работает в интерактивном режиме с dry-run проверкой и откатом. CX Codex +1 119установок infra-deploy Скилл infra-deploy разворачивает self-hosted Cal.com в GCP Cloud Run с базой Supabase PostgreSQL или поднимает его локально через Docker Compose. CX Codex +1 119установок

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

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