Escreve especificações técnicas com requisitos, design e critérios de teste. Use quando precisar criar specs técnicas, documentar requisitos, ou definir contratos de API.
From laravel-toolkitnpx claudepluginhub aronpc/ai --plugin laravel-toolkitThis skill is limited to using the following tools:
references/requirements-gatherer.mdreferences/research-agent.mdreferences/spec-critic.mdreferences/spec-writer.mdDesigns and optimizes AI agent action spaces, tool definitions, observation formats, error recovery, and context for higher task completion rates.
Enables AI agents to execute x402 payments with per-task budgets, spending controls, and non-custodial wallets via MCP tools. Use when agents pay for APIs, services, or other agents.
Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.
Cria especificações técnicas completas com requisitos, design, API e plano de testes.
| Skill | Quando usar junto |
|---|---|
roadmap | Para usar features do roadmap como input |
codebase | Para descobrir melhorias baseadas no código |
ui-ux | Para descobrir melhorias de interface |
planner | Para transformar spec em plano de implementação |
sprint | Para criar sprint a partir da spec |
issues | Para converter issues em requisitos |
Use esta skill quando precisar:
Não use para:
O pipeline de criação de specs tem 4 estágios:
1. Requirements Gatherer → Coleta requisitos
2. Research Agent → Pesquisa soluções
3. Spec Writer → Escreve spec.md
4. Spec Critic → Revisa e refina
Para tarefas simples e diretas, use Quick Spec:
Veja references/requirements-gatherer.md para detalhes do coletor.
Coletar e documentar requisitos de forma estruturada.
{
"title": "Feature Title",
"problem_statement": "What problem does this solve?",
"functional_requirements": [
{"id": "FR-1", "description": "Requirement", "priority": "must"}
],
"non_functional_requirements": [
{"id": "NFR-1", "type": "performance", "description": "Requirement"}
],
"constraints": ["Constraint 1"],
"acceptance_criteria": ["AC-1: Criterion"],
"open_questions": ["Question 1"]
}
Veja references/requirements-gatherer.md para detalhes.
Pesquisar soluções e tecnologias necessárias.
{
"integrations_needed": [
{
"name": "Integration Name",
"type": "API|Library|Service",
"purpose": "Why needed",
"documentation_url": "https://...",
"notes": "Implementation notes"
}
],
"alternatives_considered": [
{"name": "Alt 1", "pros": [], "cons": [], "decision": "rejected"}
],
"technical_notes": "Important technical details"
}
Veja references/research-agent.md para detalhes.
Criar documento de especificação completo.
# [Feature Name]
## Overview
[Brief description of the feature]
## Problem Statement
[What problem this solves]
## Goals
- Goal 1
- Goal 2
## Non-Goals
- What this feature will NOT do
## Technical Design
### Architecture
[Diagrams, flow descriptions]
### Data Model
[Schema, data structures]
### API Design
[Endpoints, contracts]
### UI/UX Design
[Mockups, user flows]
## Implementation Plan
[Phases, milestones]
## Testing Strategy
[Unit, integration, e2e tests]
## Risks & Mitigations
[Risk assessment]
## Open Questions
[Unresolved items]
## References
[Links to docs, resources]
Veja references/spec-writer.md para detalhes.
Revisar e refinar a especificação.
{
"overall_quality": "excellent|good|needs_work|poor",
"issues": [
{
"section": "Technical Design",
"issue": "Missing error handling",
"severity": "major|minor",
"suggestion": "Add error handling section"
}
],
"recommendations": ["Recommendation 1"]
}
Veja references/spec-critic.md para detalhes.
Para tarefas simples, crie uma spec minimalista:
# Quick Spec: [Task Title]
## Task
[One-line description of what to do]
## Files to Modify
- `path/to/file1.ts` - [What to change]
- `path/to/file2.ts` - [What to change]
## Change Details
[Specific changes to make]
## Verification
- [ ] [How to verify it works]
# Criar diretório de spec
mkdir -p specs/[feature-name]
# Coletar requisitos
# Usar Requirements Gatherer
# Pesquisar integrações
# Usar Research Agent
# Criar spec.md
# Usar Spec Writer
# Criticar spec
# Usar Spec Critic
# Iterar se necessário
# Spec pronta para implementation planner
references/requirements-gatherer.md - Coleta de requisitosreferences/research-agent.md - Pesquisa de integraçõesreferences/spec-writer.md - Escrita de spec.mdreferences/spec-critic.md - Crítica e refinamento