Communitygithub.com

requirement-clarifier (Clarificador de Requisitos)

Estação de triagem em três modos para solicitações ambíguas (crescer + mudar + melhorar). Cenários nativos em chinês, neutro em runtime, com tabela de roteamento de mais de 30 skills.

O que é requirement-clarifier (Clarificador de Requisitos)?

Este skill atua como um 'balcão de triagem' para desenvolvedores e agentes de IA que recebem solicitações vagas ou complexas. Ele não executa tarefas diretamente; em vez disso, estrutura ideias nebulosas em requisitos acionáveis, organiza pilhas de tarefas em uma ordem de execução lógica e analisa soluções existentes para identificar pontos de melhoria. Com três modos principais — 'growme' (esclarecimento), 'change' (triagem de tarefas) e 'improve' (otimização de estrutura) — ele pergunta três perguntas essenciais: 'O que o usuário realmente quer?', 'Qual a complexidade?' e 'Por onde começar?'. Ele é neutro em runtime (funciona com qualquer plataforma de agente, como Claude Code ou Cursor) e suporta cenários nativos em chinês, mas pode ser adaptado para qualquer idioma. Inclui uma tabela de roteamento com mais de 30 skills para encaminhamento preciso, garantindo que o agente nunca fique preso em um loop infinito de esclarecimento.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add yingzhengzhang06-sys/requirement-clarifier

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Esclarecimento de Requisitos e Triagem de Tarefas (Grow / Change / Improve)

Gancho de uma frase: Não mexa ainda – antes de agir, responda a três perguntas: 'O que o usuário realmente quer?', 'Qual é a complexidade?' e 'Por onde começar?'.

Ele é o 'balcão de triagem' – sem pressupor domínio, sem executar por você. Transforma ideias vagas em requisitos estruturados, pilhas de tarefas em uma sequência de execução roteada, e soluções existentes em uma lista de melhorias. Em seguida, aponta claramente qual skill deve ser usado a seguir – ele mesmo não executa.

Este skill é um roteador que distribui o problema do usuário para três sub-skills:

  • growme-mode – Esclarecimento de requisitos ('me ajude a pensar')
  • change-mode – Triagem de tarefas ('qual fazer primeiro')
  • improve-mode – Otimização de estrutura ('como melhorar')

Posicionamento Central

Qualquer solicitação onde 'não está claro por onde começar' passa primeiro por este skill. Três ações:

  1. Esclarecer (growme): Transformar ideias vagas em requisitos executáveis
  2. Triar (change): Organizar pilhas de tarefas em ordem de execução
  3. Melhorar (improve): Converter soluções existentes em uma lista de pontos a serem otimizados

Responder às três perguntas essenciais do usuário:

  • O que você realmente quer? (growme produz 'especificação de requisitos')
  • Por onde devo começar? (change produz 'ordem de execução')
  • Isso está certo agora? (improve produz 'pontos de melhoria')

Regras de Roteamento

Ao receber a entrada do usuário, primeiro determine qual modo se aplica (pode ser múltiplo, em série):

Característica do usuárioModoExemploRoteamento para
Expressou o resultado, mas o caminho não está clarogrowme'Quero criar um skill de ensino com IA'growme-mode
Possui várias tarefas que precisam de ordenação ou seleçãochange'Tenho 8 skills para refinar'change-mode
Já tem uma solução, mas não tem certeza se é a idealimprove'Veja se este SKILL.md está correto'improve-mode

Princípios de decisão:

  • A maioria das solicitações primeiro faz growme (esclarecimento) e depois decide se precisa de change / improve em série
  • Ordem serial: growme → change → improve (primeiro entenda o que é necessário, depois ordene, depois revise a solução)
  • Informe claramente ao usuário o modo atual que você identificou e peça confirmação ou correção
  • Se não houver necessidade de triagem, diga diretamente 'não é necessário' – não use o skill por usar
  • Uma única conversa pode envolver vários modos – execute-os em série conforme necessário

Não roteie de volta para si mesmo: após a triagem, aponte para outro skill executivo – nunca faça 'após A, use o requirement-clarifier para esclarecer novamente'.


Cenários de Ativação

Ativação forte (chamada direta):

  • 'Me ajude a pensar / Como fazer isso / Tenho uma ideia' → growme-mode
  • 'Como ordenar essas tarefas / O que fazer primeiro / Quais são os caminhos possíveis / Me ajude a triar' → change-mode
  • 'Como otimizar / Quais problemas existem / Me ajude a revisar esta solução / Faça uma auditoria' → improve-mode

Ativação fraca (chamar quando o contexto contiver semântica de 'incerteza'):

  • Receber uma solicitação de uma frase sem critérios de aceitação
  • Pilha de tarefas sem dependências declaradas
  • Solução existente com usuário expressando 'sinto que algo não está certo'
  • Vários membros da equipe descrevem o mesmo objetivo de forma inconsistente

Não ativar (limites claros):

  • Informação já está completamente clara → vá direto para a execução, não use o skill por usar
  • Pergunta clara e pequena ('Como usar X') → use AskUserQuestion diretamente
  • Já é um problema de domínio específico ('Como escrever este botão no front-end') → roteie para frontend-design / ui-ux-pro-max etc.
  • Apenas escrita / tradução / geração → roteie para original-writing / humanizer / content-rewrite

Formato de Saída (Perspectiva do Roteador)

Modo identificado: growme / change / improve (podem ser combinados)

【growme】 → Carregar growme-mode (executar esclarecimento de requisitos)
【change】  → Carregar change-mode (executar triagem de tarefas)
【improve】 → Carregar improve-mode (executar otimização de estrutura)

Próxima ação sugerida: [rotear para skill XX específico / executar diretamente / solicitar mais esclarecimentos]

Estrutura de Arquivos (Este Kit)

requirement-clarifier/             ← Roteador (você está aqui)
├── SKILL.md                       ← Este arquivo: roteamento + ativação + limites
├── growme-mode/                   ← Sub-skill 1: Esclarecimento de requisitos
│   ├── SKILL.md
│   └── references/
│       ├── seven-dimensions.md    ← 7 dimensões de questionamento
│       ├── ask-question-toolkit.md ← Técnicas de uso do AskUserQuestion
│       └── red-flags.md           ← Contraexemplos comuns de falso esclarecimento
├── change-mode/                   ← Sub-skill 2: Triagem de tarefas
│   ├── SKILL.md
│   └── references/
│       ├── complexity-rubric.md   ← Rubrica de julgamento de complexidade
│       ├── priority-matrix.md     ← Matriz P0/P1/P2/P3
│       ├── routing-table.md       ← Tabela de roteamento com 30+ skills
│       └── parallel-dependency.md ← Dependências e paralelismo
├── improve-mode/                  ← Sub-skill 3: Otimização de estrutura
│   ├── SKILL.md
│   └── references/
│       ├── seven-leverage-points.md ← 7 tipos de pontos de melhoria
│       ├── smart-criteria.md      ← Princípios SMART
│       └── red-flags.md           ← Contraexemplos de falsa melhoria
├── examples/                      ← Casos reais
│   ├── fake-clarification.md      ← Amostra de falso esclarecimento
│   ├── fake-triage.md             ← Amostra de falsa triagem
│   └── fake-improve.md            ← Amostra de falsa melhoria
├── test-prompts.json              ← 6 amostras de teste vivo + perguntas de autoavaliação
├── README.md                      ← Fachada do kit (template house-style)
├── LICENSE                        ← MIT
└── .claude-plugin/
    └── marketplace.json           ← Plugin de dois canais

Relatório de refinamento foi movido para refined-skills/13-meta-skill-and-governance/refinement-reports/requirement-clarifier-refinement-report.md (armazenado centralmente para facilitar a visualização do refinamento de todos os skills).


Gotchas (Nível do Roteador)

❌ O que NÃO fazer

  1. Não 'executar no lugar' – Este skill é o 'balcão de triagem', não a 'sala de cirurgia'. Após esclarecer e triar, aponte claramente para o próximo skill executivo
  2. Não 'usar por usar' – Se a entrada do usuário já estiver clara o suficiente, apenas confirme
  3. Não 'presumir domínio' – Não presuma front-end, back-end, conteúdo, negócios ou qualquer outro domínio
  4. Não 'rotear de volta para si mesmo' – Após a triagem, não aponte para o requirement-clarifier; feche o ciclo com 'triagem → execução → verificação'
  5. Não 'pular o growme e ir direto para change' – A premissa de uma pilha de tarefas é 'já saber o que é necessário'; caso contrário, primeiro esclareça
  6. Não 'fazer mais de 5 perguntas de uma vez' – Mais de 5 significa que você não está identificando o essencial
  7. Não 'listar mais de 7 pontos de melhoria' – Mais de 7 significa que você não está priorizando, apenas enumerando

✅ Critérios para considerar como concluído

Antes de gerar a saída, pergunte-se:

'O usuário consegue começar a trabalhar diretamente com esta saída?'

  • Sim → Concluído
  • Não → O que ainda está faltando? Volte e preencha
  • Não tenho certeza → Adicione uma observação: 'O usuário precisa confirmar XX antes de começar a execução'

Quando Carregar os Sub-skills

  • Solicitações relacionadas a growme → Carregar growme-mode/SKILL.md + references/seven-dimensions.md
  • Solicitações relacionadas a change → Carregar change-mode/SKILL.md + references/priority-matrix.md + references/routing-table.md
  • Solicitações relacionadas a improve → Carregar improve-mode/SKILL.md + references/seven-leverage-points.md
  • Autoavaliação de conclusão → Ler a seção Gotchas deste arquivo

Contagem de Palavras e Estrutura

  • SKILL.md principal (roteador): ≤ 200 linhas (atual ~150 linhas, dentro do limite)
  • Sub-skills SKILL.md: ≤ 250 linhas
  • Sub-skills references/: Carregar sob demanda, não incluir no contexto principal
  • Número total de arquivos do esqueleto: ≤ 20

Habilidades Relacionadas