requirements-gathering — скилл для Claude Code: сбор требований
Помогает агенту собрать и записать требования от заказчиков до начала разработки. Пригодится на старте проекта и при планировании фич.
npx skills add aj-geddes/useful-ai-prompts --skill requirements-gathering -a claude-codeЧто делает requirements-gathering
Скилл задаёт агенту порядок работы с требованиями: определить, кто влияет на проект, вытащить из них потребности, записать всё письменно и получить согласование. Внутри — пять справочников в каталоге references/: поиск стейкхолдеров, техники выявления требований, документирование, валидация и подпись, матрица трассировки.
В SKILL.md есть пример на Python: класс StakeholderDiscovery с категориями участников и методами для их поиска. Полные реализации лежат в справочниках, а не в самом файле скилла.
Отдельный блок с практиками перечисляет, что делать и чего избегать: писать измеримые формулировки, задавать критерии приёмки, расставлять приоритеты по MoSCoW, различать обязательное и желательное. Избегать стоит расплывчатых слов вроде «быстро» и «легко», а также изменений объёма без процесса. Если в команде уже есть свой формат ТЗ, скилл будет навязывать чужую структуру — это повод сначала прочитать справочники.
Какие задачи решает
- собрать требования от всех групп заказчиков на старте проекта
- записать договорённости письменно вместо устных обещаний
- составить матрицу трассировки требований
- расставить приоритеты фич по MoSCoW
- прописать критерии приёмки для пользовательских историй
Примеры запросов агенту
- Помоги собрать требования для нового проекта: определи стейкхолдеров и их потребности
- Составь матрицу трассировки требований по этому списку фич
- Проверь мои требования на расплывчатые формулировки и допиши критерии приёмки
Как установить requirements-gathering
1Через Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill requirements-gathering -a claude-code2Вручную: положить файлы
~/.claude/skills/requirements-gathering/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/requirements-gathering/
1Через Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill requirements-gathering -a codex2Вручную: положить файлы
.agents/skills/requirements-gathering/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill requirements-gathering -a cursor2Вручную: положить файлы
.cursor/skills/requirements-gathering/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install aj-geddes/useful-ai-prompts requirements-gathering2Вручную: положить файлы
.github/skills/requirements-gathering/SKILL.md1Через Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill requirements-gathering -a gemini-cli2Командой платформы
gemini skills install https://github.com/aj-geddes/useful-ai-prompts --path skills/requirements-gatheringВручную: положить файлы
.devin/skills/requirements-gathering/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill requirements-gathering -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о requirements-gathering
Как установить requirements-gathering в Claude?
Выполните npx skills add aj-geddes/useful-ai-prompts --skill requirements-gathering -a claude-code. Файл скилла появится по пути ~/.claude/skills/requirements-gathering/SKILL.md.
Что делает requirements-gathering?
Проводит агента по шагам сбора требований: поиск стейкхолдеров, выявление потребностей, документирование, валидация и согласование. Цель — договориться о том, что именно строится, до начала разработки.
Какие платформы поддерживаются?
Claude, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Для каждой платформы своя команда установки и свой путь к файлу скилла.
Исходный текст
SKILL.md · MIT
---
name: requirements-gathering
description: >
Systematically collect, document, and validate requirements from stakeholders.
Ensure clarity, completeness, and agreement before development begins to
reduce scope creep and rework.
---
# Requirements Gathering
## Table of Contents
- [Overview](#overview)
- [When to Use](#when-to-use)
- [Quick Start](#quick-start)
- [Reference Guides](#reference-guides)
- [Best Practices](#best-practices)
## Overview
Effective requirements gathering establishes a shared understanding of what will be built, preventing misalignment and expensive changes later in the project.
## When to Use
- Project kickoff and planning
- Feature development initiation
- Product roadmap planning
- System modernization projects
- Customer discovery
- Stakeholder alignment sessions
- Writing user stories and acceptance criteria
## Quick Start
Minimal working example:
```python
# Identify and analyze stakeholders
class StakeholderDiscovery:
STAKEHOLDER_CATEGORIES = [
'End Users',
'Business Owners',
'Technical Leads',
'Operations/Support',
'Customers',
'Regulatory Bodies',
'Integration Partners'
]
def identify_stakeholders(self, project):
"""Map all stakeholder groups"""
return {
'primary': self.get_primary_stakeholders(project),
'secondary': self.get_secondary_stakeholders(project),
'tertiary': self.get_tertiary_stakeholders(project),
'total_to_engage': self.calculate_engagement_strategy(project)
}
def analyze_stakeholder_needs(self, stakeholder):
"""Understand what each stakeholder needs"""
return {
// ... (see reference guides for full implementation)
```
## Reference Guides
Detailed implementations in the `references/` directory:
| Guide | Contents |
|---|---|
| [Stakeholder Discovery](references/stakeholder-discovery.md) | Stakeholder Discovery |
| [Requirements Elicitation Techniques](references/requirements-elicitation-techniques.md) | Requirements Elicitation Techniques |
| [Requirements Documentation](references/requirements-documentation.md) | Requirements Documentation |
| [Requirement Validation & Sign-Off](references/requirement-validation-sign-off.md) | Requirement Validation & Sign-Off |
| [Requirements Traceability Matrix](references/requirements-traceability-matrix.md) | Requirements Traceability Matrix |
## Best Practices
### ✅ DO
- Engage all key stakeholders early
- Document requirements in writing
- Use specific, measurable language
- Define acceptance criteria
- Prioritize using MoSCoW method
- Get stakeholder sign-off
- Create traceability matrix
- Review requirements regularly
- Distinguish must-haves from nice-to-haves
- Document assumptions and constraints
### ❌ DON'T
- Rely on memory or verbal agreements
- Create requirements without stakeholder input
- Use ambiguous language (quickly, easily, etc.)
- Skip non-functional requirements
- Ignore constraints and dependencies
- Over-document trivial details
- Rush through requirements phase
- Build without stakeholder agreement
- Make scope changes without process
- Forget about edge cases and error conditions
© aj-geddes · MIT · aj-geddes/useful-ai-prompts