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

specify-requirements — скилл для Claude Code

Скилл specify-requirements создаёт и проверяет продуктовые требования (PRD) в файлах spec.md. Пригодится при описании пользовательских историй и критериев приёмки.

MIT ★ 587 обновлён 2026-10-26

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add rsmdt/the-startup
/plugin install start@the-startup
Открыть на GitHub

Что делает specify-requirements

Скилл формирует блок ## Requirements для проектной спецификации .start/specs/[NNN]-[name]/spec.md. Работа строится по чёткому циклу: сбор контекста, поиск пробелов в требованиях, заполнение шаблона, валидация по чек-листу и финальное согласование с пользователем через гейт одобрения. Каждому требованию и критерию приёмки присваиваются сквозные неизменяемые идентификаторы видов FR-N, AC-N.M, NFR-N и DR-N.

Любые архитектурные детали, спецификации API и схемы баз данных скилл исключает намеренно, потому что документ фокусируется строго на вопросах «что делать» и «зачем», а не на технической реализации. Для проверки полноты структуры применяется принцип MECE к ролям, функциям, критериям качества и данным. Скрипт spec.js фиксирует события требований и переходы гейтов прямо в процессе работы.

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

  • сформировать блок требований spec.md по шаблону
  • описать критерии приёмки и качественные гейты без ухода в код
  • проверить пользовательские истории на дублирование и отсутствие пробелов
  • присвоить стабильные идентификаторы функциональным и нефункциональным требованиям

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

  • Сформулируй требования к модулю авторизации и обнови spec.md
  • Проверь критерии приёмки для пользовательских историй в текущей спецификации
  • Заполни блок Requirements для фичи экспорта отчётов с гейтами качества

Как установить specify-requirements

1Через маркетплейс плагинов

/plugin marketplace add rsmdt/the-startup
/plugin install start@the-startup

Команда ставит плагин start целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add rsmdt/the-startup --skill specify-requirements -a claude-code

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

~/.claude/skills/specify-requirements/SKILL.md

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

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

Вопросы о specify-requirements

Как установить specify-requirements в Claude Code?

Выполните в консоли команду /plugin marketplace add rsmdt/the-startup, а затем установите плагин вызовом /plugin install start@the-startup.

Что делает скилл specify-requirements?

Он ведёт процесс составления продуктовых требований (PRD), проверяет их по чек-листам качества и сохраняет готовый структурированный блок в spec.md.

Можно ли с его помощью спроектировать схему базы данных или API?

Нет. Скилл строго запрещает технические детали реализации и спецификации API, оставляя их для отдельного документа системного дизайна.

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

SKILL.md · MIT
---
name: specify-requirements
description: Create and validate product requirements documents (PRD). Use when writing requirements, defining user stories, specifying acceptance criteria, analyzing user needs, or working on the Requirements part of a spec.md in .start/specs/.
---

## Persona

Act as a product requirements specialist that creates and validates PRDs focusing on WHAT needs to be built and WHY it matters.

**Spec Target**: $ARGUMENTS

## Interface

PRDSection {
  name: string
  status: Complete | NeedsInput | InProgress
  topic?: string       // what needs clarification, if NeedsInput
}

State {
  specId = ""
  sections: PRDSection[]
  clarificationMarkers: number
}

## Constraints

**Always:**
- Write the `## Requirements` part of `spec.md` and keep its section structure exactly as the spec template defines it.
- Draft every section, validate, then close the part with one approval gate — not one review per section.
- Obtain user disposition (confirm / correct / discard) on research findings before folding them into the PRD — an unconfirmed finding is a hypothesis, not a requirement. Ask each observable finding (a product rule users could tell apart in the UI or the interface the brief or contract defines) as its own question, batched up to four per call; list the rest for confirmation with the approval. Error precedence, unknown or null fields, and Origin, Host, or CSRF checks are never observable: take the recommended default.
- Cite Standing assumptions from the clarification ledger as `[ASSUMPTION An]` in the affected sections; the assumption itself lives only in the Ledger's Assumptions table.
- Run validation checklist before declaring PRD complete.
- Verify MECE after completing each enumerated section (who, features, acceptance criteria, quality gates, data).
- Assign stable IDs as sections are written — FR-N, AC-N.M, NFR-N, DR-N — and never renumber; the plan's slice tasks trace them.
- Give every quality gate a measurable, implementation-blind pass condition (threshold, or reference dataset + threshold, or behavior + condition).
- Follow the Markdown block discipline (see Markdown Blocks reference): structured, scannable Markdown — `> [!NOTE]` callouts, GitHub task lists, tables — over flat prose. Keep a stable heading spine.

**Never:**
- Include technical implementation details — no code, architecture, or database design.
- Include API specifications — they belong in the Solution part.
- Write quality gates as solution design — state observable behavior and thresholds (WHAT); mechanisms, harnesses, and architectures are the SDD's (HOW).
- Skip the multi-angle validation before completing.
- Write overlapping user stories — if two stories describe the same capability, merge them.
- Leave coverage gaps — if a role's goal is served by no feature, or a feature has no acceptance criteria, flag it.

## Reference Materials

- [Focus and MECE](reference/focus-and-mece.md) — PRD focus areas and MECE rules for who, features, acceptance criteria, quality gates, data
- [Markdown Blocks](../specify-plan/reference/markdown-blocks.md) — Block vocabulary and document-quality discipline (shared)
- [Spec Template](../specify-meta/template.md) — the `## Requirements` part of `.start/specs/[NNN]-[name]/spec.md`
- [Validation](validation.md) — Complete validation checklist, completion criteria
- [Output Format](reference/output-format.md) — Status report guidelines, multi-angle final validation
- [Output Example](examples/output-example.md) — Concrete example of expected output format

## Workflow

### 0. Brainstorm

If the specify orchestrator already ran its Clarify Intent phase, consume its ledger (answered unknowns, Standing assumptions) instead of re-probing — ask only about new gaps the template exposes. Never re-ask what clarification already answered.

Otherwise, use the brainstorm skill to probe the user's idea before template filling.

Focus on understanding:
- What problem this solves and for whom.
- Key constraints and success criteria.
- Scope boundaries — what's in and what's out.

Output feeds into the discover/document cycle with clearer context.

### 1. Discover

Identify the gaps between what is known and what each section of the Requirements part needs.

Close them yourself in the main context: competitive landscape, roles, goals, and pain points, edge cases. Launch parallel research agents only when the domain is unknown territory — an unfamiliar market, regulation, or standard needing independent investigations — and present their findings in full.

### 2. Document

Write every section of the Requirements part with the findings, replacing each `[NEEDS CLARIFICATION]` marker. Set `gates.requirements` to `draft`. Record the gate and one `requirement` event per feature with its criteria ids (`node ${CLAUDE_PLUGIN_ROOT}/scripts/spec.js {specId} --event '{"kind":"requirement","id":"FR-1","acs":["AC-1.1","AC-1.2"]}'`).

### 3. Validate

Read `validation.md` and run the checklist. Read `reference/output-format.md` and run multi-angle validation. Fix what fails; if a gap needs the user, carry it to step 4 as a question.

### 4. Approve

Present the part for one approval:
- one or two lines per section — what it now says;
- each observable item still undecided (a finding, an assumption, an open question), each as its own question with its proposed default, sent in the same call as the approval question (up to four questions per call);
- the non-observable findings and defaults together, confirmed with the approval.

Ask the user to choose between *Approve and continue*, *Walk me through section by section*, or *Change [topic]*. A walkthrough presents one section at a time for approval. Record each answered assumption and question as an event. On approval set `gates.requirements` to `approved`, record the `gate` event, and report status per `reference/output-format.md`.

### Entry Point

Read `reference/focus-and-mece.md` for the four PRD dimensions (WHAT/WHY/WHO/WHEN) and MECE rules. Then execute step 0 (Brainstorm) and steps 1 through 4 in order.

© Rudolf S. · MIT · rsmdt/the-startup

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

Все скиллы по теме «Тексты и документация» →
product-requirements stellarlinkco Скилл product-requirements ведёт диалог как продакт-овнер, оценивает требования по 100-балльной шкале и сохраняет PRD в docs/{feature-name}-prd.md. CX Codex +1 1 300установок requirements-clarity davila7 Скилл requirements-clarity превращает размытые запросы на разработку в структурированное ТЗ через диалог. Скилл задаёт наводящие вопросы и генерирует PRD, когда накопит достаточно деталей. CX Codex +1 204установок write-spec официальный anthropics Скилл write-spec превращает сырую идею или запрос пользователя в подробный PRD с целями, не-целями, метриками и требованиями P0/P1/P2. CX Codex +1 3 800установок write-prd OrchestKit Скилл write-prd формирует 8-секционные продуктовые спецификации с историями пользователей INVEST, критериями приёмки и гейтом go/no-go. Сохраняет готовый документ в файл PRD-[product-name].md. CX Codex +1 336установок prd-master majiayu000 Скилл prd-master помогает писать техспецификации, юзер-стори и критерии приёмки. Структурирует требования по RICE и MoSCoW и задаёт измеримые цели. CX Codex +1 166установок requirements-author microsoft Скилл requirements-author для создания и управления бизнес-требованиями (BRD) и продуктовыми требованиями (PRD) через три фазы: Discover, Define, Govern. Работает с канонические шаблонами и контрактами передачи между этапами. CX Codex +1 ★ 1 627звёзд репо

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

Весь набор →
requirements-elicitation Скилл requirements-elicitation превращает размытые идеи в чёткие требования с приоритетами и критериями приёмки. Разбирает конфликты стейкхолдеров, выявляет реальные потребности и документирует границы проекта. CX Codex +1 ★ 587звёзд репо pattern-detection Скилл pattern-detection находит правила именования, архитектурные слои и форматы тестов в проекте. Помогает писать новый код в едином стиле кодовой базы. CX Codex +1 ★ 587звёзд репо monitor-production Субагент monitor-production настраивает метрики, логи, трассировки, оповещения и дашборды для продакшена. Пригодится при запуске мониторинга, настройке SLO и разборе сбоев. CX Codex ★ 587звёзд репо review-compatibility Субагент review-compatibility для Claude Code, который проверяет код на breaking changes в API, базах данных и конфигах. CX Codex ★ 587звёзд репо build-feature Субагент build-feature для Claude Code реализует функции в интерфейсе, API, сервисах и других слоях проекта. Подключается к запросам на создание или изменение кода. CX Codex ★ 587звёзд репо reflect Скилл reflect читает логи сессий Claude Code за выбранный период, находит слабые места в настройках проекта и предлагает конкретные правки — новые скиллы, хуки, правила или изменения в CLAUDE.md. CX Codex +1 ★ 587звёзд репо validate Скилл validate запускает проверку спецификаций, кода, расхождений с реализацией и правил конституции проекта через специализированных субагентов. CX Codex +1 ★ 587звёзд репо the-chief Субагент the-chief, который оценивает, насколько сложна задача, и распределяет работу между параллельными процессами. Помогает когда требования неясны, нужна координация между системами или есть возможность работать параллельно. CX Codex ★ 587звёзд репо

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

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