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

first-principles-review · sno-ai — скилл для Claude Code

Скилл first-principles-review для Claude Code проверяет продуктовые идеи, PRD и архитектуру от первых принципов. Он запускается только по прямому запросу с названием скилла и создаёт локальный отчёт с передачей для написания PRD.

Apache-2.0 ★ 869 обновлён 2026-11-16

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

Что делает first-principles-review

Скилл исследует исходные материалы, проверяет предпосылки и сравнивает варианты решения до того, как предложение превратится в требования или код. Он сохраняет проверку в отдельный Markdown-отчёт и добавляет структурированный блок для передачи автору PRD. Сам PRD скилл не редактирует и не запускает другой скилл автоматически.

Для проверки запускаются два скрипта из scripts: validate-report.py и extract-prd-handoff.py. Оба требуют python3. Нужны доступ к оболочке и чтение и запись файлов; входной файл скилл не меняет. Имя отчёта по умолчанию — reports/<input-stem>-first-principles-review.md; если такой файл уже есть, выбирается другое имя. Скилл работает только после явного вызова или упоминания в запросе.

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

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

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

  • Проведи $first-principles-review для идеи из proposal.md и создай отчёт.
  • Запусти /first-principles-review для архитектуры в design.md; сравни её с текущим решением.
  • Выполни first-principles-review для PRD и подготовь передачу автору требований.

Как установить first-principles-review

1Через Skills CLI (Vercel)

npx skills add sno-ai/sno-station-skills --skill first-principles-review -a claude-code

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

~/.claude/skills/first-principles-review/SKILL.md

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

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

Вопросы о first-principles-review

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

Выполни npx skills add sno-ai/sno-station-skills --skill first-principles-review -a claude-code. Файл скилла появится по пути ~/.claude/skills/first-principles-review/SKILL.md.

Что делает first-principles-review?

Он исследует идею, PRD или архитектуру, проверяет предпосылки и сравнивает варианты. Результат — отдельный Markdown-отчёт с блоком передачи для автора PRD.

Нужен ли Python для работы first-principles-review?

Да. Скрипты проверки отчёта и извлечения блока передачи требуют python3.

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

SKILL.md · Apache-2.0
---
name: first-principles-review
description: "MANUAL-ONLY: challenge a product idea, design, PRD, or architecture from first principles. Use only when the user names this skill. Research first, then write a local review and PRD handoff."
requires:
  programs: []
  harness:
    - {slot: 4.shell, need: required}
    - {slot: 4.file-read-write, need: required}
---

# First-Principles Reviewer

Run before a proposal hardens into requirements or source code. The owner is whoever owns the
work and decides what it should be; often that is the user. A PRD is a product requirements
document. Judge the problem framing,
constraints, and solution shape. Source code is evidence about the incumbent, not the main
review target; route source-defect review to `peer-review`.

## Invocation Gate

Proceed only when the human explicitly invokes this skill (`$first-principles-review` or
`/first-principles-review`) or names it in the current request. Do not infer invocation from the presence of a PRD or design.

## Workflow

1. **Freeze the boundary.** Identify the input, record its hash when it is a file, choose a
   local report path, and do not modify the reviewed input. Use
   `reports/<input-stem>-first-principles-review.md` unless the human names another path.
   Use a distinct report filename when the default already exists. If a named input is
   missing or unreadable, locate the canonical artifact, repair access within authority,
   and continue the review. Work on independent evidence meanwhile; ask only for an
   input that only the owner can supply. Never invent the missing artifact or claim
   a completed review without reading it.
2. **Research before challenging.** Read the relevant product intent, prior decisions,
   incumbent behavior, immediate code/design dependencies, and current external solutions.
   Record every source and every material gap. When current external facts matter, browse.
   Stop when another source cannot change a premise state, the disposition, or the next
   evidence-producing action. Record that stopping boundary.
3. **Re-derive the outcome.** State what the user or system must achieve without borrowing
   the proposed implementation.
4. **Classify constraints.** Mark each claim as `hard constraint`, `owner preference`, or
   `inherited assumption`. Cite evidence. A physical, legal, published-contract, measured
   economic, or explicit owner limit may be hard; familiarity is not.
5. **Challenge premises.** Build a ledger of load-bearing premises. Mark each
   `evidence-backed`, `unproven`, `inherited`, or `falsified`. Apply removal, inversion,
   substitution, do-nothing, and incumbent comparison where they can change the decision.
   A settled owner decision stays settled unless a specific new fact changes its basis. Name
   that fact before challenging the ruling; never relabel the ruling as inherited.
6. **Construct real alternatives.** Consider eliminating the need, reusing an incumbent or
   native capability, making the smallest viable change, and redesigning from true
   constraints. Include only materially distinct candidates. Do not force novelty or a
   candidate count.
7. **Choose a disposition.** Use exactly one: `PROCEED`, `REFRAME`, `SIMPLIFY`, `REPLACE`,
   `SPLIT`, `TEST-FIRST`, or `STOP`. For `SPLIT`, record at least two independently
   buildable outcomes inside the single handoff object. `PROCEED` means evidence is strong
   enough to enter PRD authoring, not to skip implementation or production verification.
   Use `TEST-FIRST` only when a missing fact could change the problem framing or selected
   direction before PRD authoring. Repeated benchmarks and rollout checks belong in acceptance
   implications or falsifiers and do not by themselves block `PROCEED`.
8. **Recommend one direction.** Compare the current proposal and surviving alternatives on
   outcome fit, complexity, failure surface, reversibility, time to evidence, and migration
   cost. Name observable evidence that would overturn the recommendation.
9. **Write and validate the report.** Follow `references/report-contract.md`, including its
   embedded JSON handoff. Run:

   ```bash
   python3 <skill-dir>/scripts/validate-report.py <report.md>
   python3 <skill-dir>/scripts/extract-prd-handoff.py <report.md> > <handoff.json>
   ```

   `<skill-dir>` is the folder that contains this SKILL.md. Both scripts need `python3`.

10. **Ask only after the report exists.** Keep questions out of the report. If a genuine
    owner decision survives research, ask one decision at a time in chat. Otherwise hand the
    report and extracted block to whoever writes the PRD (a PRD-writing skill, if one is installed).

## Judgment Rules

- By default this review is one pass (a project may choose otherwise): do not rerun it to confirm
  edits, and do not turn its output into a new review target. Whoever acts on the report records
  how each recommendation was handled, proves fixes deterministically, and continues.
- The report is the record of the review. Do not prewrite or self-author a `PROCEED` result
  before this workflow has inspected the evidence.
- Verified fact, inference, and unknown are different claims. Label them separately.
- A recommendation without falsifiers is advocacy, not review.
- No research or no challenged premise is an instrument failure, not a clean result.
- `PROCEED` means the proposal survived meaningful challenge; it does not mean exhaustive
  proof or production readiness.
- Preserve rejected alternatives and why they lost so the PRD author does not re-derive them.
- When existing source is supplied, use it to establish incumbent behavior, constraints, and
  coupling. Route source defects to `peer-review`.
- The report is bounded and non-exhaustive. Say so explicitly.

## Output

Create one independent local Markdown report. Report the exact path. Do not edit a target PRD
or automatically invoke a PRD skill. The embedded handoff is the downstream contract; prose
remains the human record.

© sno-ai · Apache-2.0 · sno-ai/sno-station-skills

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

Все скиллы по теме «Дизайн» →

Сначала — first-principles-review от других авторов.

first-principles-review GanyuanRan Скилл first-principles-review для Claude Code проверяет решение по первому принципу и бритве Оккама до фиксации направления. Обычные багфиксы пропускает. CX Codex +1 ★ 1 450звёзд репо thinking-first-principles tjboudreaux Скилл thinking-first-principles для Claude Code отделяет реальные ограничения от привычек и перестраивает решение с нуля. Запускается, если задачу останавливает «так не делается» без доказательств. CX Codex +1 844установок principle-redesign-from-first-principles backnotprop Скилл principle-redesign-from-first-principles для Claude Code и Codex: перестраивает дизайн под новое требование так, будто оно было с самого начала. Затрагивает несколько файлов и связей. CX Codex +1 10 200установок first-principles-thinking VoltAgent Community Разбирает проблему до базовых фактов и отсекает привычные допущения по пяти шагам. Применяет метод first-principles thinking, когда старые решения не работают или нужно спроектировать продукт с нуля. CX Codex ★ 26 718звёзд репо first-principles Lex Christopherson Команда first-principles разбирает задачу до фундаментальных фактов, отсекает привычные допущения и заново выстраивает логику решения. CX Codex +1 ★ 1 988звёзд репо design-principles gotalab Правило design-principles задаёт требования к архитектуре, типам, документации и Mermaid-диаграммам. Оно пригодится при подготовке design.md и проверке границ компонентов. CX Codex +1 ★ 3 774звёзд репо spec-driven-development addyosmani Скилл spec-driven-development для Claude Code готовит спецификацию до начала разработки. Он включается, когда нужно разобрать расплывчатые требования, спланировать функцию или оформить изменения к уже выпущенной спецификации. CX Codex +1 81 900установок

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

Весь набор →
rust-coder Скилл rust-coder для Claude Code помогает писать и менять код на Rust с учётом устройства репозитория. Включается для новых функций, рефакторинга и миграций, в том числе при крупных изменениях .rs и Cargo.toml. CX Codex +1 ★ 869звёзд репо python-coder Скилл python-coder для Claude Code помогает писать и перерабатывать production-код на Python, включая FastAPI и Pydantic. Подключается к задачам с асинхронным кодом и миграциями. CX Codex +1 ★ 869звёзд репо owner-intent-audit Скилл owner-intent-audit для Claude Code сверяет планы, тесты и код с намерением владельца проекта. Запускается перед одобрением или слиянием изменений. CX Codex +1 ★ 869звёзд репо less-is-more Скилл less-is-more для Claude Code помогает писать меньше кода и находить лишнее в готовых изменениях. Включается при разработке, исправлении, рефакторинге и ревью кода. CX Codex +1 ★ 869звёзд репо e2e-red-triage Скилл e2e-red-triage для Claude Code классифицирует неожиданный сбой E2E-теста как дефект продукта или проблему окружения. Загружайте его вручную, когда запускатель тестов назвал конкретный сбой. CX Codex +1 ★ 869звёзд репо e2e-environment-preflight Скилл e2e-environment-preflight для Claude Code проверяет внешние зависимости перед сквозным тестированием. Он запускается только по прямому запросу или по указанным сценариям работы с планом и тестами. CX Codex +1 ★ 869звёзд репо charter Помогает написать, изменить или проверить charter — документ с результатом работы, границами задачи и проверками. Запускается, когда перед передачей работы исполнителю нужен письменный план. CX Codex +1 ★ 869звёзд репо agentic-walkthrough Скилл agentic-walkthrough для Claude Code проверяет, что успешный запуск действительно изменил данные или вызвал нужное действие. Он проходит путь от точки входа до результата и ищет наблюдаемый след каждого шага. CX Codex +1 ★ 869звёзд репо

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

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