К основному содержанию
промпт CX Codex GP ChatGPT

speckit.analyze — промпт для Claude Code: анализ spec, plan, tasks

Слэш-команда speckit.analyze сверяет spec.md, plan.md и tasks.md перед реализацией: ищет расхождения, дубли и требования, под которые не создана ни одна задача.

MIT ★ 110 обновлён 2026-10-19

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/speckit.analyze.md
Открыть на GitHub

Что делает speckit.analyze

Команда рассчитана на готовый набор артефактов: spec.md, plan.md и полный tasks.md уже лежат в каталоге фичи. Запустите её раньше /speckit.tasks — и она прервётся с ошибкой, попросив сначала выполнить недостающий шаг.

Внутри восемь шагов. Скрипт .specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks из корня репозитория отдаёт каталог фичи и список документов. Потом команда строит инвентарь требований с устойчивыми ключами и карту покрытия задач, а дальше идёт шесть проверок: дубли, размытые прилагательные вроде «быстро» без измеримых критериев, недописанные требования, конфликты с конституцией, требования без задач, расхождения в терминах. На выходе таблица находок, таблица покрытия и метрики.

Файлы команда не трогает, только читает. Конституция .specify/memory/constitution.md внутри анализа неприкосновенна: расхождение с её MUST-принципом всегда идёт как CRITICAL, и править нужно спецификацию, план или задачи, а не сам принцип. План исправлений выдаётся лишь по явному согласию пользователя.

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

  • Найти требование из spec.md, под которое не создана ни одна задача
  • Поймать расхождение между стеком в plan.md и требованиями спецификации
  • Собрать в один отчёт дубли и размытые формулировки до начала кодинга
  • Проверить план и задачи на соответствие конституции проекта
  • Выписать задачи, не привязанные ни к одному требованию или сценарию

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

  • /speckit.analyze — проверь артефакты фичи 003-payments перед реализацией
  • Запусти /speckit.analyze и покажи, какие требования остались без задач
  • /speckit.analyze с упором на конфликты с конституцией

Как установить speckit.analyze

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

.claude/commands/speckit.analyze.md

Вопросы о speckit.analyze

Как установить speckit.analyze в Claude Code?

Положите файл команды по пути .claude/commands/speckit.analyze.md в проекте, и она появится как /speckit.analyze.

Что делает speckit.analyze?

Сверяет spec.md, plan.md и tasks.md и печатает отчёт о расхождениях, дублях, двусмысленностях и пробелах в покрытии с разбивкой по severity. Ни один файл при этом не меняется.

Когда её запускать?

После того как /speckit.tasks создал полный tasks.md, и до перехода к реализации. Если чего-то из трёх артефактов не хватает, команда остановится и подскажет, какой шаг пропущен.

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

speckit.analyze.md · MIT
---
description: Perform a non-destructive cross-artifact consistency and quality analysis across spec.md, plan.md, and tasks.md after task generation.
---

## User Input

```text
$ARGUMENTS
```

You **MUST** consider the user input before proceeding (if not empty).

## Goal

Identify inconsistencies, duplications, ambiguities, and underspecified items across the three core artifacts (`spec.md`, `plan.md`, `tasks.md`) before implementation. This command MUST run only after `/speckit.tasks` has successfully produced a complete `tasks.md`.

## Operating Constraints

**STRICTLY READ-ONLY**: Do **not** modify any files. Output a structured analysis report. Offer an optional remediation plan (user must explicitly approve before any follow-up editing commands would be invoked manually).

**Constitution Authority**: The project constitution (`.specify/memory/constitution.md`) is **non-negotiable** within this analysis scope. Constitution conflicts are automatically CRITICAL and require adjustment of the spec, plan, or tasks—not dilution, reinterpretation, or silent ignoring of the principle. If a principle itself needs to change, that must occur in a separate, explicit constitution update outside `/speckit.analyze`.

## Execution Steps

### 1. Initialize Analysis Context

Run `.specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks` once from repo root and parse JSON for FEATURE_DIR and AVAILABLE_DOCS. Derive absolute paths:

- SPEC = FEATURE_DIR/spec.md
- PLAN = FEATURE_DIR/plan.md
- TASKS = FEATURE_DIR/tasks.md

Abort with an error message if any required file is missing (instruct the user to run missing prerequisite command).
For single quotes in args like "I'm Groot", use escape syntax: e.g 'I'\''m Groot' (or double-quote if possible: "I'm Groot").

### 2. Load Artifacts (Progressive Disclosure)

Load only the minimal necessary context from each artifact:

**From spec.md:**

- Overview/Context
- Functional Requirements
- Non-Functional Requirements
- User Stories
- Edge Cases (if present)

**From plan.md:**

- Architecture/stack choices
- Data Model references
- Phases
- Technical constraints

**From tasks.md:**

- Task IDs
- Descriptions
- Phase grouping
- Parallel markers [P]
- Referenced file paths

**From constitution:**

- Load `.specify/memory/constitution.md` for principle validation

### 3. Build Semantic Models

Create internal representations (do not include raw artifacts in output):

- **Requirements inventory**: Each functional + non-functional requirement with a stable key (derive slug based on imperative phrase; e.g., "User can upload file" → `user-can-upload-file`)
- **User story/action inventory**: Discrete user actions with acceptance criteria
- **Task coverage mapping**: Map each task to one or more requirements or stories (inference by keyword / explicit reference patterns like IDs or key phrases)
- **Constitution rule set**: Extract principle names and MUST/SHOULD normative statements

### 4. Detection Passes (Token-Efficient Analysis)

Focus on high-signal findings. Limit to 50 findings total; aggregate remainder in overflow summary.

#### A. Duplication Detection

- Identify near-duplicate requirements
- Mark lower-quality phrasing for consolidation

#### B. Ambiguity Detection

- Flag vague adjectives (fast, scalable, secure, intuitive, robust) lacking measurable criteria
- Flag unresolved placeholders (TODO, TKTK, ???, `<placeholder>`, etc.)

#### C. Underspecification

- Requirements with verbs but missing object or measurable outcome
- User stories missing acceptance criteria alignment
- Tasks referencing files or components not defined in spec/plan

#### D. Constitution Alignment

- Any requirement or plan element conflicting with a MUST principle
- Missing mandated sections or quality gates from constitution

#### E. Coverage Gaps

- Requirements with zero associated tasks
- Tasks with no mapped requirement/story
- Non-functional requirements not reflected in tasks (e.g., performance, security)

#### F. Inconsistency

- Terminology drift (same concept named differently across files)
- Data entities referenced in plan but absent in spec (or vice versa)
- Task ordering contradictions (e.g., integration tasks before foundational setup tasks without dependency note)
- Conflicting requirements (e.g., one requires Next.js while other specifies Vue)

### 5. Severity Assignment

Use this heuristic to prioritize findings:

- **CRITICAL**: Violates constitution MUST, missing core spec artifact, or requirement with zero coverage that blocks baseline functionality
- **HIGH**: Duplicate or conflicting requirement, ambiguous security/performance attribute, untestable acceptance criterion
- **MEDIUM**: Terminology drift, missing non-functional task coverage, underspecified edge case
- **LOW**: Style/wording improvements, minor redundancy not affecting execution order

### 6. Produce Compact Analysis Report

Output a Markdown report (no file writes) with the following structure:

## Specification Analysis Report

| ID | Category | Severity | Location(s) | Summary | Recommendation |
|----|----------|----------|-------------|---------|----------------|
| A1 | Duplication | HIGH | spec.md:L120-134 | Two similar requirements ... | Merge phrasing; keep clearer version |

(Add one row per finding; generate stable IDs prefixed by category initial.)

**Coverage Summary Table:**

| Requirement Key | Has Task? | Task IDs | Notes |
|-----------------|-----------|----------|-------|

**Constitution Alignment Issues:** (if any)

**Unmapped Tasks:** (if any)

**Metrics:**

- Total Requirements
- Total Tasks
- Coverage % (requirements with >=1 task)
- Ambiguity Count
- Duplication Count
- Critical Issues Count

### 7. Provide Next Actions

At end of report, output a concise Next Actions block:

- If CRITICAL issues exist: Recommend resolving before `/speckit.implement`
- If only LOW/MEDIUM: User may proceed, but provide improvement suggestions
- Provide explicit command suggestions: e.g., "Run /speckit.specify with refinement", "Run /speckit.plan to adjust architecture", "Manually edit tasks.md to add coverage for 'performance-metrics'"

### 8. Offer Remediation

Ask the user: "Would you like me to suggest concrete remediation edits for the top N issues?" (Do NOT apply them automatically.)

## Operating Principles

### Context Efficiency

- **Minimal high-signal tokens**: Focus on actionable findings, not exhaustive documentation
- **Progressive disclosure**: Load artifacts incrementally; don't dump all content into analysis
- **Token-efficient output**: Limit findings table to 50 rows; summarize overflow
- **Deterministic results**: Rerunning without changes should produce consistent IDs and counts

### Analysis Guidelines

- **NEVER modify files** (this is read-only analysis)
- **NEVER hallucinate missing sections** (if absent, report them accurately)
- **Prioritize constitution violations** (these are always CRITICAL)
- **Use examples over exhaustive rules** (cite specific instances, not generic patterns)
- **Report zero issues gracefully** (emit success report with coverage statistics)

## Context

$ARGUMENTS

© alfredoperez · MIT · alfredoperez/speckit-companion

Похожие промпты

Все промпты по теме «Настройка агента: память, контекст, субагенты» →
speckit.tasks Chat2AnyLLM Команда speckit.tasks генерирует tasks.md с пошаговым списком задач для фичи на основе plan.md и spec.md, с разбивкой по пользовательским историям. CX Codex +1 ★ 117звёзд репо speckit-specify github-spec-kit Скилл speckit-specify превращает фразу о фиче в папку со спецификацией: короткое имя, номер, шаблон spec.md и запись в .specify/feature.json. CX Codex +1 2 700установок speckit-baseline dceoy Скилл speckit-baseline для Claude Code читает код и собирает из него технонейтральную спецификацию с пользовательскими историями и требованиями. Восстанавливает документацию, когда код есть, а записанных требований к нему нет. CX Codex +1 1 600установок tlc-spec-lean Tech Leads Club - github.com/tech-leads-club Скилл tlc-spec-lean для Claude Code ведёт разработку функции от плана и проверяемых критериев до сборки и независимой проверки. Помогает подтвердить требования до начала работы. CX Codex +1 ★ 7 191звёзд репо speckit.checklist Chat2AnyLLM Команда speckit.checklist создаёт чек-лист для оценки требований к функции: ищет пробелы, неясные формулировки и неохваченные сценарии. Пригодится перед реализацией или ревью спецификации. CX Codex +1 ★ 117звёзд репо mold paulnsorensen mold превращает сложное проектное решение в проверенную спецификацию через диалог. Скилл нужен перед изменениями с риском для архитектуры или данных. CX Codex +1 823установок

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

Весь набор →
speckit.tasks Промпт speckit.tasks для Claude Code и Codex собирает из проектных документов план задач tasks.md, упорядоченный по зависимостям и пользовательским историям. Формирует этапы реализации проекта. CX Codex GP ChatGPT ★ 110звёзд репо changelog-entry Команда changelog-entry для Claude Code пишет запись changelog по PR или текущему diff, выбирая файл и формат. Запускается с номером PR или без аргумента. CX Codex +1 ★ 110звёзд репо eval-speckit-extension Скилл eval-speckit-extension проверяет работу расширения speckit-extension на реальной спецификации. Он валидирует срабатывание хуков жизненного цикла и запись шагов в .spec-context.json. CX Codex +1 ★ 110звёзд репо bench-experiment Команда bench-experiment запускает раунд бенчмарка приложения Conduit и сравнивает результаты с предыдущими прогонами. Она пригодится, чтобы проверить экспериментальные изменения на рабочих ячейках. CX Codex +1 ★ 110звёзд репо speckit.companion.living-sync Команда speckit.companion.living-sync синхронизирует живые спецификации с текущими правками рабочего дерева в один проход. Обновляет существующие файлы spec без перегенерации. CX Codex +1 ★ 110звёзд репо speckit.implement Промпт speckit.implement читает план разработки и выполняет задачи из tasks.md. Подходит для поэтапной реализации в Claude Code и Codex. CX Codex GP ChatGPT ★ 110звёзд репо publish-all Команда publish-all для Claude Code выпускает четыре компонента проекта, когда изменения готовы и прошли QA. CX Codex +1 ★ 110звёзд репо speckit.companion.doctor Команда speckit.companion.doctor проверяет здоровье пайплайна спецификаций: находит незавершённые шаги, пропущенные тесты, утечки задач и ложные отметки о дрифте. Работает только на чтение. CX Codex +1 ★ 110звёзд репо

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

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