Communitygithub.com

tangjuyo/bloqueador-de-principios

Cria ou atualiza a constituição do projeto a partir de entradas interativas ou princípios fornecidos.

O que é bloqueador-de-principios?

Esta skill permite que um agente de IA (como Claude Code, Cursor ou Codex) crie ou atualize a constituição de um projeto — um documento de governança central — armazenado em `.specify/memory/constitution.md`. Ela segue um fluxo rigoroso: primeiro, verifica o conteúdo da entrada do usuário separando princípios de intenções não relacionadas à governança (como implementação de código ou deploy), que são adiadas. Depois, consulta hooks de extensão configurados (antes e depois da atualização) em `.specify/extensions.yml`, executando-os conforme necessário. A skill então resolve o template de constituição ativo via `resolve-template.sh`, coleta valores para placeholders (como `RATIFICATION_DATE`) a partir da entrada do usuário ou do contexto do repositório, e aplica versionamento semântico automaticamente. O resultado é um documento validado, com relatório de impacto e seção de próximas ações para intenções adiadas. Suporta a integração com extensões personalizadas através de hooks opcionais ou obrigatórios, garantindo que o processo de governança seja flexível e automatizado.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tangjuyo/reels-blocker/tree/HEAD/.claude/skills/speckit-constitution

Perguntar na sua IA favorita

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

Documentação

Entrada do Usuário

$ARGUMENTS

Você DEVE considerar a entrada do usuário antes de prosseguir (se não estiver vazia).

Guarda de Escopo

O trabalho deste comando é limitado a atualizar a própria constituição do projeto. Templates e comandos dependentes leem a constituição em tempo de execução e não são modificados aqui.

  • Classifique cada parte da entrada do usuário como conteúdo da constituição ou uma intenção separada e não relacionada à governança.
  • Se a entrada incluir solicitações de implementação de funcionalidades, geração de código, refatoração, construção ou deploy, você NÃO DEVE executá-las. Extraia-as como intenções adiadas.
  • Você NÃO DEVE criar, modificar ou excluir arquivos fonte do aplicativo, rotas de funcionalidades, componentes, testes, arquivos de deploy ou outros artefatos não relacionados ao fluxo de trabalho da constituição.
  • Se não estiver claro se uma instrução é conteúdo da constituição, peça esclarecimento antes de fazer alterações.
  • Após concluir a atualização da constituição, inclua uma seção Próximas Ações para cada intenção adiada. Liste a intenção original e sugira o comando apropriado do Spec Kit, como /speckit-specify, sem invocá-lo.
  • Se não houver intenções não relacionadas à governança, omita a seção Próximas Ações.

Verificações Pré-Execução

Verificar hooks de extensão (antes da atualização da constituição):

  • Verifique se .specify/extensions.yml existe na raiz do projeto.
  • Se existir, leia-o e procure por entradas sob a chave hooks.before_constitution.
  • Se o YAML não puder ser analisado ou for inválido, não ignore silenciosamente: informe ao usuário que .specify/extensions.yml não pôde ser lido (inclua o erro do analisador) e que nenhum hook foi verificado, incluindo quaisquer hooks obrigatórios (optional: false) registrados ali; em seguida, continue normalmente.
  • Filtre hooks onde enabled é explicitamente false. Trate hooks sem um campo enabled como habilitados por padrão.
  • Para cada hook restante, não tente interpretar ou avaliar expressões de condition do hook:
    • Se o hook não tiver um campo condition, ou ele for nulo/vazio, trate o hook como executável.
    • Se o hook definir uma condition não vazia, pule o hook e deixe a avaliação da condição para a implementação do HookExecutor.
  • Ao construir invocações de comando a partir de nomes de comando do hook, substitua pontos (.) por hífens (-). Por exemplo, speckit.git.commit → /speckit-git-commit.
  • Para cada hook executável, produza a seguinte saída com base em sua flag optional:
    • Hook opcional (optional: true):
      ## Extension Hooks
      
      **Pre-Hook Opcional**: {extension}
      Comando: `/{command}`
      Descrição: {description}
      
      Prompt: {prompt}
      Para executar: `/{command}`
      
    • Hook obrigatório (optional: false):
      ## Extension Hooks
      
      **Pre-Hook Automático**: {extension}
      Executando: `/{command}`
      EXECUTE_COMMAND: {command}
      
      Aguarde o resultado do comando do hook antes de prosseguir para o Rascunho.
      
      Após emitir o bloco acima, você DEVE realmente invocar o hook e aguardar sua conclusão antes de continuar. Execute-o da mesma forma que você mesmo executaria o comando nesta sessão/agente (a invocação pode ser diferente do ID literal {command} mostrado acima, por exemplo, um agente em modo skills executa como /skill:speckit-... ou $speckit-...). Apenas emitir o bloco não executa o hook.
  • Se nenhum hook estiver registrado ou .specify/extensions.yml não existir, ignore silenciosamente.

Rascunho

Você está atualizando a constituição do projeto em .specify/memory/constitution.md. O scaffold ativo da constituição é resolvido em tempo de comando a partir de constitution-template através da pilha de resolução de presets/templates do Spec Kit.

Siga este fluxo de execução:

  1. Execute .specify/scripts/bash/resolve-template.sh constitution-template --json a partir da raiz do repositório e analise TEMPLATE_CONTENT como o template ativo.

    • O resolvedor compartilhado aplica substituições do projeto, compondo camadas de preset, e camadas de extensão antes do fallback para o template principal. Ele DEVE ser bem-sucedido antes de continuar.
    • Se falhar, pare e reporte o erro de resolução; não continue com apenas uma camada contribuinte.
    • Se .specify/memory/constitution.md existir, carregue-o como a fonte dos valores e alterações atuais específicas do projeto. Preserve informações que ainda são aplicáveis ao aplicar o novo scaffold resolvido.
    • Se não existir, use o template resolvido como documento inicial.
    • Não escreva de volta em nenhuma camada de template versionado.
    • Identifique cada token de espaço reservado no formato [ALL_CAPS_IDENTIFIER]. IMPORTANTE: O usuário pode precisar de menos ou mais princípios do que os usados no template. Se um número for especificado, respeite-o – siga o template geral. Você atualizará o documento de acordo.
  2. Colete/derive valores para os espaços reservados:

    • Se a entrada do usuário (conversa) fornecer um valor, use-o.
    • Caso contrário, infira a partir do contexto existente do repositório (README, docs, versões anteriores da constituição, se embutidas).
    • Para datas de governança: RATIFICATION_DATE é a data de adoção original (se desconhecida, pergunte ou marque como TODO), LAST_AMENDED_DATE é hoje se alterações forem feitas, caso contrário, mantenha a anterior.
    • CONSTITUTION_VERSION deve ser incrementada de acordo com as regras de versionamento semântico:
      • MAJOR: Remoções ou redefinições de governança/princípios incompatíveis com versões anteriores.
      • MINOR: Novo princípio/seção adicionado ou orientação materialmente expandida.
      • PATCH: Esclarecimentos, correções de redação, refinamentos não semânticos.
    • Se o tipo de incremento for ambíguo, proponha a justificativa antes de finalizar.
  3. Elabore o conteúdo atualizado da constituição usando o template resolvido como estrutura necessária:

    • Substitua cada espaço reservado por texto concreto (nenhum token entre colchetes restante, exceto slots de template intencionalmente retidos que o projeto optou por não definir ainda — justifique explicitamente qualquer retenção).
    • Preserve a hierarquia de cabeçalhos e os comentários podem ser removidos uma vez substituídos, a menos que ainda adicionem orientação esclarecedora.
    • Garanta que cada seção de Princípio tenha: uma linha de nome sucinta, um parágrafo (ou lista de marcadores) capturando regras inegociáveis, e uma justificativa explícita se não for óbvia.
    • Garanta que a seção de Governança liste o procedimento de emenda, a política de versionamento e as expectativas de revisão de conformidade.
  4. Produza um Relatório de Impacto de Sincronização como um comentário HTML no topo do arquivo de constituição após a atualização. Este relatório é material de rascunho temporário para revisão humana da emenda, não conteúdo de governança; espera-se que seja removido antes do arquivo de constituição alterado ser commitado.

    • Mudança de versão: antiga → nova
    • Lista de princípios modificados (título antigo → título novo, se renomeado)
    • Seções adicionadas
    • Seções removidas
    • TODOs de acompanhamento se algum espaço reservado foi intencionalmente adiado.
  5. Validação antes da saída final:

    • Nenhum token entre colchetes inexplicado restante.
    • Linha de versão corresponde ao relatório.
    • Datas no formato ISO AAAA-MM-DD.
    • Princípios são declarativos, testáveis e livres de linguagem vaga ("deveria" → substituir por DEVE/DEVERIA com justificativa, quando apropriado).
  6. Escreva a constituição completa de volta em .specify/memory/constitution.md (sobrescreva).

  7. Produza um resumo final para o usuário com:

    • Nova versão e justificativa do incremento.
    • Quaisquer espaços reservados TODO ou itens adiados que exijam acompanhamento manual.
    • Mensagem de commit sugerida (por exemplo, docs: alterar constituição para vX.Y.Z (adições de princípios + atualização de governança)).
    • Uma seção Próximas Ações para quaisquer intenções adiadas não relacionadas à governança.

Requisitos de Formatação e Estilo:

  • Use cabeçalhos Markdown exatamente como no template (não rebaixe/eleve níveis).
  • Quebre linhas longas de justificativa para manter a legibilidade (idealmente <100 caracteres), mas não force com quebras estranhas.
  • Mantenha uma única linha em branco entre as seções.
  • Evite espaços em branco à direita.

Se o usuário fornecer atualizações parciais (por exemplo, apenas uma revisão de princípio), ainda assim execute as etapas de validação e decisão de versão.

Se informações críticas estiverem faltando (por exemplo, data de ratificação realmente desconhecida), insira TODO(<NOME_DO_CAMPO>): explicação e inclua no Relatório de Impacto de Sincronização sob itens adiados.

Escreva apenas .specify/memory/constitution.md; não crie ou modifique arquivos fonte do template.

Verificações Pós-Execução

Verificar hooks de extensão (após a atualização da constituição): Verifique se .specify/extensions.yml existe na raiz do projeto.

  • Se existir, leia-o e procure por entradas sob a chave hooks.after_constitution.
  • Se o YAML não puder ser analisado ou for inválido, não ignore silenciosamente: informe ao usuário que .specify/extensions.yml não pôde ser lido (inclua o erro do analisador) e que nenhum hook foi verificado, incluindo quaisquer hooks obrigatórios (optional: false) registrados ali; em seguida, continue normalmente.
  • Filtre hooks onde enabled é explicitamente false. Trate hooks sem um campo enabled como habilitados por padrão.
  • Para cada hook restante, não tente interpretar ou avaliar expressões de condition do hook:
    • Se o hook não tiver um campo condition, ou ele for nulo/vazio, trate o hook como executável.
    • Se o hook definir uma condition não vazia, pule o hook e deixe a avaliação da condição para a implementação do HookExecutor.
  • Ao construir invocações de comando a partir de nomes de comando do hook, substitua pontos (.) por hífens (-). Por exemplo, speckit.git.commit → /speckit-git-commit.
  • Para cada hook executável, produza a seguinte saída com base em sua flag optional:
    • Hook opcional (optional: true):
      ## Extension Hooks
      
      **Hook Opcional**: {extension}
      Comando: `/{command}`
      Descrição: {description}
      
      Prompt: {prompt}
      Para executar: `/{command}`
      
    • Hook obrigatório (optional: false):
      ## Extension Hooks
      
      **Hook Automático**: {extension}
      Executando: `/{command}`
      EXECUTE_COMMAND: {command}
      
      Após emitir o bloco acima, você DEVE realmente invocar o hook e aguardar sua conclusão antes de continuar. Execute-o da mesma forma que você mesmo executaria o comando nesta sessão/agente (a invocação pode ser diferente do ID literal {command} mostrado acima, por exemplo, um agente em modo skills executa como /skill:speckit-... ou $speckit-...). Apenas emitir o bloco não executa o hook.
  • Se nenhum hook estiver registrado ou .specify/extensions.yml não existir, ignore silenciosamente.

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

Habilidades Relacionadas