feature-spec — скилл для Claude Code: что делает и как установить
Набор из 42 правил для составления PRD, фиксации скоупа и приоритизации задач. Помогает инженеру спланировать функционал до написания кода.
npx skills add pproenca/dot-skills --skill feature-spec -a claude-codeЧто делает feature-spec
Скилл задаёт структуру планирования фич через 42 правила, разбитых на 8 категорий по уровню влияния. Первыми идут границы скоупа и ясность требований с префиксами scope- и req-. За ними следуют методы приоритизации вроде MoSCoW и RICE. Границы определяются до кодинга.
В технической части агент проверяет контракты API и модели данных. Для формулировки критериев приёмки используется формат Given-When-Then. Без выявления допущений и фиксации рамок скилл не даёт переходить к полной разработке.
Управление изменениями опирается на заморозку скоупа и ведение журнала отложенных задач. Правила не требуют сторонних зависимостей для работы.
Какие задачи решает
- определить чёткие границы скоупа и MVP
- составить критерии приёмки в формате Given-When-Then
- приоритизировать задачи методами MoSCoW или RICE
- описать контракты API и модели данных до начала кодинга
- зафиксировать регламент запросов на изменение требований
Примеры запросов агенту
- Помоги составить PRD для системы аутентификации пользователей и выдели MVP.
- Примени скоринг RICE к бэклогу фич из документа
features.md. - Сформулируй критерии приёмки Given-When-Then для сценария оплаты заказа.
Как установить feature-spec
1Через Skills CLI (Vercel)
npx skills add pproenca/dot-skills --skill feature-spec -a claude-code2Вручную: положить файлы
~/.claude/skills/feature-spec/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/feature-spec/
1Через Skills CLI (Vercel)
npx skills add pproenca/dot-skills --skill feature-spec -a codex2Вручную: положить файлы
.agents/skills/feature-spec/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add pproenca/dot-skills --skill feature-spec -a cursor2Вручную: положить файлы
.cursor/skills/feature-spec/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install pproenca/dot-skills feature-spec2Вручную: положить файлы
.github/skills/feature-spec/SKILL.md1Через Skills CLI (Vercel)
npx skills add pproenca/dot-skills --skill feature-spec -a gemini-cli2Командой платформы
gemini skills install https://github.com/pproenca/dot-skills --path skills/.experimental/feature-specВручную: положить файлы
.devin/skills/feature-spec/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add pproenca/dot-skills --skill feature-spec -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о feature-spec
Как установить feature-spec в Claude Code?
Выполните команду npx skills add pproenca/dot-skills --skill feature-spec -a claude-code. Также можно сохранить файл по пути ~/.claude/skills/feature-spec/SKILL.md.
Зачем нужны префиксы правил вроде scope-?
Префиксы делят 42 правила на 8 категорий и задают приоритет проверок, выдвигая границы проекта на первое место.
Какие методы оценки фич поддерживает скилл?
В категорию приоритизации входят метод MoSCoW, скоринг RICE, модель Кано и сопоставление ценности с трудозатратами.
Исходный текст
SKILL.md · MIT
--- name: feature-spec description: Feature specification and planning guidelines for software engineers. This skill should be used when writing PRDs, defining requirements, managing scope, prioritizing features, or handling change requests. Triggers on tasks involving feature planning, specification writing, stakeholder alignment, or scope management. --- # Software Engineering Feature Specification and Planning Best Practices Comprehensive feature specification and planning guide for software engineers, product managers, and technical leads. Contains 42 rules across 8 categories, prioritized by impact to prevent scope creep and ensure project success. ## When to Apply Reference these guidelines when: - Writing PRDs or feature specifications - Defining requirements or user stories - Managing scope and preventing scope creep - Prioritizing features and backlog items - Handling change requests - Aligning stakeholders on project goals ## Rule Categories by Priority | Priority | Category | Impact | Prefix | |----------|----------|--------|--------| | 1 | Scope Definition | CRITICAL | `scope-` | | 2 | Requirements Clarity | CRITICAL | `req-` | | 3 | Prioritization Frameworks | HIGH | `prio-` | | 4 | Acceptance Criteria | HIGH | `accept-` | | 5 | Stakeholder Alignment | MEDIUM-HIGH | `stake-` | | 6 | Technical Specification | MEDIUM | `tech-` | | 7 | Change Management | MEDIUM | `change-` | | 8 | Documentation Standards | LOW | `doc-` | ## Quick Reference ### 1. Scope Definition (CRITICAL) - `scope-define-boundaries` - Define explicit scope boundaries - `scope-document-assumptions` - Document all assumptions explicitly - `scope-work-breakdown` - Break scope into measurable work items - `scope-define-mvp` - Define MVP before full feature set - `scope-stakeholder-signoff` - Get stakeholder signoff on scope ### 2. Requirements Clarity (CRITICAL) - `req-specific-measurable` - Write specific, measurable requirements - `req-user-stories` - Structure requirements as user stories - `req-avoid-solution-language` - Avoid solution-specific language - `req-functional-nonfunctional` - Separate functional and non-functional - `req-consistent-terminology` - Use consistent terminology - `req-traceability` - Maintain requirements traceability ### 3. Prioritization Frameworks (HIGH) - `prio-moscow-method` - Use MoSCoW prioritization method - `prio-rice-scoring` - Apply RICE scoring for objectivity - `prio-value-vs-effort` - Map value vs effort explicitly - `prio-dependencies-first` - Identify and order dependencies - `prio-kano-model` - Apply Kano model for feature classification ### 4. Acceptance Criteria (HIGH) - `accept-given-when-then` - Use Given-When-Then format - `accept-testable-criteria` - Write testable acceptance criteria - `accept-edge-cases` - Include edge cases in acceptance - `accept-definition-of-done` - Define clear definition of done - `accept-avoid-over-specification` - Avoid over-specification ### 5. Stakeholder Alignment (MEDIUM-HIGH) - `stake-identify-stakeholders` - Identify all stakeholders early - `stake-early-feedback` - Gather feedback early and often - `stake-conflict-resolution` - Resolve conflicts explicitly - `stake-communication-plan` - Establish communication cadence - `stake-success-metrics` - Align on success metrics ### 6. Technical Specification (MEDIUM) - `tech-system-context` - Document system context and dependencies - `tech-api-contracts` - Define API contracts before implementation - `tech-data-model` - Specify data models and schema changes - `tech-error-handling` - Plan error handling and recovery - `tech-performance-requirements` - Specify performance requirements - `tech-security-considerations` - Document security considerations ### 7. Change Management (MEDIUM) - `change-formal-process` - Use formal change request process - `change-impact-assessment` - Assess full impact before approval - `change-version-tracking` - Version all specification documents - `change-scope-freeze` - Implement scope freeze periods - `change-defer-log` - Maintain deferred items log ### 8. Documentation Standards (LOW) - `doc-single-source` - Maintain single source of truth - `doc-consistent-templates` - Use consistent document templates - `doc-decision-records` - Document key decisions with context - `doc-accessible-format` - Keep documentation accessible - `doc-glossary-terms` - Define project terminology
© pproenca · MIT · pproenca/dot-skills