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

project-min-evaluation — скилл для Claude Code: проверки перед

Заставляет агента прогнать линтер, типы и тесты проекта, прежде чем объявить работу готовой. Полезен, когда не хочется ловить поломки после коммита.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add C3SC0-V4113/Scaffold --skill project-min-evaluation -a claude-code
Открыть на GitHub

Что делает project-min-evaluation

Скилл включается на словах «готово», «завершил», «перед коммитом», «проверь качество». Агент читает package.json и локфайлы, определяет менеджер пакетов и запускает только те скрипты, которые реально объявлены в scripts. Порядок жёсткий: lint, typecheck, format:check, test, doctor, check. Скрипт test:e2e трогает лишь тогда, когда менялось поведение сквозных сценариев.

Менеджер не зашит в скилл. Есть поле packageManager — берётся названный там; иначе смотрят на pnpm-lock.yaml, bun.lock или bun.lockb, а при package-lock.json и полном отсутствии сигналов остаётся npm. На первом падении выполнение останавливается: сначала починка, потом повтор с упавшего шага. Пропустить красную проверку, чтобы дойти до следующей, нельзя.

В отчёте каждый скрипт помечается как пройденный, упавший или не определённый. Для сбоя приводятся точная команда, текст ошибки и та часть, что осталась непроверенной. Если в проекте нет, скажем, typecheck, скилл сообщит об отсутствии ожидаемого скрипта и не станет придумывать команду. Это и есть главный смысл: молчание агента о непройденной проверке — повод переспросить.

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

  • прогнать линтер и типы перед коммитом
  • остановиться на первой упавшей проверке и не идти дальше
  • определить менеджер пакетов по локфайлам проекта
  • отчитаться, какие скрипты не объявлены в package.json
  • не объявлять задачу готовой при красных тестах

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

  • прогони минимальные проверки проекта перед коммитом
  • готово, проверь качество по скриптам из package.json
  • запусти lint, typecheck и test, начни с упавшего

Как установить project-min-evaluation

1Через Skills CLI (Vercel)

npx skills add C3SC0-V4113/Scaffold --skill project-min-evaluation -a claude-code

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

~/.claude/skills/project-min-evaluation/SKILL.md

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

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

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

Похожие

verification-loop affaan-m Прогоняет работу сессии по шести фазам — сборка, типы, линт, тесты с покрытием, поиск секретов, разбор диффа — и выдаёт отчёт PASS/FAIL. CX Codex +1 5 000установок fix-merge-conflicts cursor Разрешает конфликты слияния в ветке, проверяет сборку и тесты перед завершением работы. Нужен, когда конфликтов несколько и их надо разобрать без рефакторинга. CX Codex +1 2 700установок grinding-until-pass spencerpauly Скилл заставляет агента крутить цикл «правка → запуск → проверка» до тех пор, пока тесты не пройдут, сборка не соберётся или линтер не замолчит. CX Codex +1 548установок scaffold-dotnet-test-project dotnet Создаёт или чинит тестовый проект .NET: находит, почему CI не видит тесты, и прописывает проект в нужный solution-файл. CX Codex +1 2 600установок husky davila7 Прогоняет линтер, сборку, типы и тесты по шагам и правит ошибки, пока репозиторий не станет рабочим. Полезно перед коммитом. 282установок qa-project-context kindlmann Сканирует репозиторий и создаёт файл .agents/qa-project-context.md со стеком, тестами и рисками. Пригодится при настройке тестирования перед запуском других QA-скиллов. CX Codex +1 1 400установок

Рядом в теме «Настройка агента: память, контекст, субагенты»

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Вопросы о project-min-evaluation

Как установить project-min-evaluation в Claude?

Выполните npx skills add C3SC0-V4113/Scaffold --skill project-min-evaluation -a claude-code. Файл скилла окажется в ~/.claude/skills/project-min-evaluation/SKILL.md.

Что делает project-min-evaluation?

Перед отчётом о завершённой работе запускает скрипты качества из package.json в заданном порядке и останавливается на первой ошибке.

Какие скрипты он запускает?

lint, typecheck, format:check, test, doctor и check — если они объявлены. test:e2e только при изменениях в сквозных сценариях.

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

SKILL.md · Apache-2.0
---
name: project-min-evaluation
description: "Trigger: done, complete, finish, before commit, quality check, verify. Run the project's own minimum quality scripts before claiming work is complete."
license: Apache-2.0
metadata:
  author: purrfold
  version: "1.0"
---

# Project Minimum Evaluation

## Activation Contract

Load this skill before reporting implementation work as complete, before committing, or when asked to verify quality.

## Hard Rules

1. Detect the package manager from the project; never hardcode a runner.
2. Run only scripts defined in `package.json` `scripts`; report expected scripts that are missing instead of inventing commands.
3. Run from the repository root, in the order below, and do not skip a failing step to reach a later one.
4. Never claim completion while a check fails or was not run.

## Decision Gates

| Project signal | Runner |
| --- | --- |
| `packageManager` field in `package.json` | use the manager it names |
| `pnpm-lock.yaml` | `pnpm run <script>` |
| `bun.lock` or `bun.lockb` | `bun run <script>` |
| `package-lock.json`, or no other signal | `npm run <script>` |

| Script | Run when |
| --- | --- |
| `lint` | always, if defined |
| `typecheck` | always, if defined |
| `format:check` | always, if defined |
| `test` | always, if defined |
| `doctor` | always, if defined |
| `check` | always, if defined (aggregate gate) |
| `test:e2e` | only when end-to-end behavior changed |

## Execution Steps

1. Read `package.json` and the lockfiles to choose the runner.
2. Collect the scripts from the table that exist in `scripts`.
3. Run each existing script in table order with the chosen runner.
4. Stop at the first failure, fix it, and rerun from that script.

## Output Contract

Report each script as passed, failed, or not defined. For a failure or a check that cannot run, give the exact command, the exact error, and the unverified scope.

## References

- [references/script-discovery.md](references/script-discovery.md) — detection edge cases.

© purrfold · Apache-2.0 · C3SC0-V4113/Scaffold

Смотрите также

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

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