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

specify-meta — скилл для Claude Code: спецификации и установка

Скилл specify-meta для Claude Code создаёт каталоги спецификаций и ведёт их через этапы требований, решений и плана. Отслеживает согласования и решения по задаче.

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

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

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

Для новой спецификации скилл создаёт каталог с автоматически назначенным ID, файл spec.md по шаблону и папку .tracker/. Для существующей читает статус и предлагает продолжение с учётом утверждённых этапов. Спецификация описывает целевое состояние, а реализация выполняется отдельно через /implement.

Этапы требований, решения и плана закрываются собственными согласованиями. Статусы хранятся в gates в заголовке spec.md, а решения и предположения — в разделе Ledger. Скилл фиксирует изменения и события в журнале; панель прогресса читает именно его. Для операций с каталогами используется node ${CLAUDE_PLUGIN_ROOT}/scripts/spec.js.

Перед переходом на следующий этап нужно подтвердить шаги с пользователем. Если у спецификации нет spec.md, скилл продолжает работу с файлами старого формата: README.md, requirements.md, solution.md и plan.md.

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

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

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

  • Создай спецификацию для новой функции импорта CSV.
  • Покажи статус спецификации 003 и предложи следующий этап.
  • Зафиксируй решение использовать очередь заданий для обработки импорта.

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

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-meta -a claude-code

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

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

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

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

Вопросы о specify-meta

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

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

Что делает specify-meta?

Скилл создаёт и ведёт каталоги спецификаций, отслеживает согласование этапов и записывает решения. Для операций с каталогами он использует node ${CLAUDE_PLUGIN_ROOT}/scripts/spec.js.

Как specify-meta записывает статус этапов?

Статусы этапов хранятся в gates в заголовке spec.md, а изменения фиксируются в журнале событий. Перед переходом на следующий этап скилл просит подтвердить шаги.

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

SKILL.md · MIT
---
name: specify-meta
user-invocable: false
description: Scaffold, status-check, and manage specification directories. Use when creating a new spec, reading spec status, transitioning between phases, or logging decisions on a spec in .start/specs/.
---

## Persona

Act as a specification workflow orchestrator that manages specification directories and tracks user decisions throughout the Requirements (WHY) → Solution (WHAT — design) → Plan (slice and scenario tasks) workflow. Every phase writes its own part of one document, `spec.md`, closed by its own approval gate; the Plan phase also creates the phase, slice, and scenario tasks in the spec's tracker. The specification describes the target state; /implement builds it by running those slice tasks.

## Interface

SpecStatus {
  id: string               // 3-digit zero-padded (001, 002, ...)
  name: string
  directory: string         // .start/specs/[NNN]-[name]/
  phase: Initialization | Requirements | Solution | Plan | Ready
  gates: {
    requirements: pending | draft | approved | skipped
    solution:     pending | draft | approved | skipped
    plan:         pending | draft | approved | skipped
  }
}

State {
  specId = ""
  currentPhase: Initialization | Requirements | Solution | Plan | Ready
  gates: {}
}

## Constraints

**Always:**
- Use `node ${CLAUDE_PLUGIN_ROOT}/scripts/spec.js` for all directory operations.
- Keep phase state in the `gates` frontmatter of `spec.md` and the decisions and assumptions in its `## Ledger` part — `spec.md` has no README beside it.
- Log all significant decisions with date, decision, and rationale.
- Keep the Assumptions table current — status changes (Proposed → Confirmed/Corrected/Standing) are updates to it, made when the specify skill reports them.
- Record every gate change, decision, open question, and assumption status change in the spec's event log as you make it: `node ${CLAUDE_PLUGIN_ROOT}/scripts/spec.js {specId} --event '<json>'` (event kinds in reference/spec-management.md). The progress dashboard reads only this log.
- A spec with no `spec.md` uses the legacy layout (`README.md`, `requirements.md`, `solution.md`, `plan.md`): read and continue it in those files.
- Confirm next steps with user before phase transitions.

**Never:**
- Transition phases without updating the `gates` frontmatter.
- Skip decision logging when user makes workflow choices.

## Reference Materials

- [Spec Management](reference/spec-management.md) — Spec ID format, directory structure, script commands, phase workflow, decision logging
- [Spec Template](template.md) — `spec.md`: the Requirements, Solution, and Plan parts plus the Ledger

## Workflow

### 1. Scaffold

Create a new spec with an auto-incrementing ID.

1. Run `node ${CLAUDE_PLUGIN_ROOT}/scripts/spec.js "$featureName"` in the terminal. It creates the spec directory, `spec.md` from template.md, and `.tracker/`.
2. Report the created spec status.

### 2. Read Status

Read existing spec metadata.

1. Run `node ${CLAUDE_PLUGIN_ROOT}/scripts/spec.js "$specId" --read` in the terminal.
2. Parse TOML output into SpecStatus.
3. Read the `gates` frontmatter of `spec.md` and suggest the next continuation point:

match (gates) {
  plan approved                     => "Plan approved. Proceed to implementation with /implement?"
  solution approved, plan not       => "Solution approved. Continue to Plan (phases, slice and scenario tasks)?"
  requirements approved, solution not => "Requirements approved. Continue to Solution?"
  nothing approved                  => "Start from Requirements?"
}

4. If the spec directory has no `events.jsonl`, run `node ${CLAUDE_PLUGIN_ROOT}/scripts/spec.js "$specId" --snapshot` once to start its event log from the current state.

### 3. Transition Phase

Update the spec directory to reflect the new phase.

1. Set the finished part's gate to `approved` (or `skipped`) and the next part's gate to `draft`, and record both as `gate` events.
2. Log the phase transition in the Decision log.
3. Hand off to the document-specific skill:

match (phase) {
  Requirements  => specify-requirements skill
  Solution      => specify-solution skill
  Plan          => specify-plan skill (writes the Plan part + tracker tasks)
}

4. On completion, return here for the next phase transition.

### 4. Log Decision

Append a row to the Decision log table in the Ledger part of `spec.md`.

### Entry Point

match ($ARGUMENTS) {
  featureName (new)   => execute step 1 (Scaffold)
  specId (existing)   => execute steps 2, 3, and 4 in order
}

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

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
specify sentimony Скилл specify для Claude Code превращает запрос в спецификацию с проверяемыми критериями приёмки. Он запускается, когда до кода нужно прояснить требования или выбрать подход. CX Codex +1 1 900установок openspec-archive-change openspec Скилл openspec-archive-change архивирует выполненные изменения спецификаций в экспериментальном цикле OpenSpec. Он проверяет готовность артефактов и задач перед фиксацией результата. CX Codex +1 4 500установок scope-triage sentimony Скилл scope-triage классифицирует входящие задачи разработки на три маршрута перед написанием кода: прямое исполнение, краткая спецификация или полный цикл проектирования. CX Codex +1 4 100установок om-brainstorm open-mercato Скилл om-brainstorm помогает обсудить задачу до написания кода, разобрать альтернативы и подготовить бриф для следующего шага. CX Codex +1 3 500установок story nschurmann Скилл story для Claude Code уточняет одну пользовательскую историю перед разработкой, добавляет критерии приёмки и формирует краткий план реализации. CX Codex +1 ★ 265звёзд репо requirement-convergence shinpr Скилл requirement-convergence для Claude Code отделяет целевой результат изменений от предложенных требований и фиксирует исключения пользователя. Включается на этапе сбора требований до проектирования архитектуры. CX Codex +1 ★ 720звёзд репо

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

Весь набор →
document Скилл document координирует генерацию документации для кода, API и проектов через параллельных специализированных субагентов. CX Codex +1 ★ 587звёзд репо api-contract-design Скилл api-contract-design для Claude Code помогает спроектировать и проверить контракт REST- или GraphQL-API до реализации. Он помогает согласовать ресурсы, схемы, версионирование и аутентификацию. CX Codex +1 ★ 587звёзд репо review-robustness Субагент review-robustness проверяет код на хрупкие места: лишние абстракции и небезопасную работу с общим состоянием в async-потоках. Пригодится на ревью PR и когда баг ловится только под нагрузкой. CX Codex ★ 587звёзд репо performance-analysis Скилл performance-analysis систематизирует профилирование и поиск узких мест в коде и инфраструктуре. Скилл запрещает предлагать оптимизации без метрик и предварительных замеров. CX Codex +1 ★ 587звёзд репо design-interaction design-interaction — субагент для Claude Code: проектирует навигацию, пользовательские потоки и информационную архитектуру. Включается при проблемах с onboarding и сложной структурой контента. CX Codex ★ 587звёзд репо analyze Скилл analyze запускает глубокое исследование кодовой базы или темы с проверкой фактов независимыми агентами-скептиками и ссылками на строки файлов. CX Codex +1 ★ 587звёзд репо test-strategy Субагент test-strategy планирует и проводит функциональные и нагрузочные проверки, расставляя приоритеты по риску. Помогает оценить покрытие, узкие места и готовность релиза. CX Codex ★ 587звёзд репо testing Скилл testing для написания эффективных тестов: правила мокирования по слоям, отладка падений, управление нестабильными тестами. CX Codex +1 ★ 587звёзд репо

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

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