Spec Kit Integration Skill

Proposito

Esta skill integra o GitHub Spec Kit para habilitar Spec-Driven Development:

Spec Creation - Criar especificacoes usando template
Technical Plan - Gerar plano tecnico da spec
Task Breakdown - Quebrar plano em tasks executaveis
Spec Analysis - Validar qualidade da spec

Pre-requisitos

# Instalar Specify CLI
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

# Ou via pip
pip install git+https://github.com/github/spec-kit.git

Comandos Disponiveis

/spec-create

Cria uma nova spec usando o template:

specify init .
# ou
specify create feature-name

/spec-plan

Gera technical plan de uma spec existente:

specify plan feature-name.spec.md

/spec-tasks

Quebra o plan em tasks:

specify tasks feature-name.plan.md

/spec-analyze

Valida qualidade da spec:

specify analyze feature-name.spec.md

Templates

Spec Template

# Spec: {Feature Name}

## Overview
{Brief description of what this feature does}

## Problem Statement
{What problem does this solve?}

## Proposed Solution
{High-level description of the solution}

## Requirements

### Functional Requirements
- FR-001: {requirement}
- FR-002: {requirement}

### Non-Functional Requirements
- NFR-001: {requirement}

## Acceptance Criteria
- [ ] AC-001: {criterion}
- [ ] AC-002: {criterion}

## Out of Scope
- {item not included}

## Dependencies
- {dependency}

## Risks
- {risk}

## Open Questions
- {question}

Technical Plan Template

# Technical Plan: {Feature Name}

## Architecture Overview
{High-level architecture description}

## Components
### Component 1
- Responsibility: {description}
- Technology: {tech stack}
- Interfaces: {APIs, events}

## Data Model
{Entity relationships, schemas}

## API Design
{Endpoints, contracts}

## Security Considerations
{Authentication, authorization, data protection}

## Testing Strategy
{Unit, integration, e2e approach}

## Deployment Plan
{Rollout strategy, feature flags}

## Risks and Mitigations
| Risk | Mitigation |
|------|------------|
| {risk} | {mitigation} |

Task Template

# Task: {Task ID}

## Parent
- Spec: {spec-name}
- Plan: {plan-section}

## Description
{What needs to be done}

## Acceptance Criteria
- [ ] {criterion}

## Implementation Notes
{Technical details, considerations}

## Dependencies
- {blocking tasks}

## Estimate
{T-shirt size or story points}

Fluxo de Uso

1. Criar Spec (/spec-create)
   - Preencher requisitos
   - Definir acceptance criteria
   - Validar com stakeholders

2. Gerar Technical Plan (/spec-plan)
   - Definir arquitetura
   - Detalhar componentes
   - Planejar testes

3. Quebrar em Tasks (/spec-tasks)
   - Tasks atomicas
   - Dependencias mapeadas
   - Estimativas

4. Implementar Tasks
   - @code-author implementa cada task
   - @code-reviewer valida
   - Marcar tasks completas

5. Validar Spec
   - Todos os ACs atendidos
   - Spec pode ser fechada

Integracao com SDLC

| Fase SDLC | Artefato Spec Kit | |-----------|-------------------| | Fase 2 (Requisitos) | Spec | | Fase 3 (Arquitetura) | Technical Plan | | Fase 4 (Planejamento) | Tasks | | Fase 5 (Implementacao) | Task execution |

Validacao de Qualidade

spec_quality_checks:
  completeness:
    - has_overview: required
    - has_problem_statement: required
    - has_proposed_solution: required
    - has_requirements: required
    - has_acceptance_criteria: required

  clarity:
    - no_ambiguous_terms: warning
    - measurable_criteria: required
    - testable_requirements: required

  structure:
    - follows_template: required
    - consistent_formatting: warning
    - linked_to_issues: optional

Hooks de Validacao

{
  "PreToolUse": [{
    "matcher": "Write(*.spec.md)",
    "hooks": [{
      "type": "command",
      "command": "specify analyze $TOOL_INPUT_FILE_PATH || true"
    }]
  }]
}

Pontos de Pesquisa

Para melhorar:

"spec-driven development best practices"
"requirements documentation automation"
"GitHub Spec Kit advanced usage"

spec-kit-integration