/acreadiness-assess — Avaliação de prontidão para IA

Use esta habilidade sempre que o usuário solicitar uma avaliação de prontidão para IA, uma verificação de prontidão, uma auditoria ou quiser ver o quão pronto seu repositório está para IA.

Esta habilidade é a etapa de Medição no loop Medir → Gerar → Manter do AgentRC. O resultado é um painel HTML autônomo que o usuário pode abrir com file:// ou confirmar no repositório.

Etapas

1. Confirmar pré-requisitos. Node 20+ deve estar no PATH. Se não tiver certeza, execute node --version.

2. Decidir sobre uma política (opcional, mas recomendado):

   • Se o usuário forneceu --policy <source>, capture-o.
   • Caso contrário, verifique agentrc.config.json para um array policies.
   • Se nenhum dos anteriores, execute sem política (padrões internos).
   • Para um guia sobre políticas, sugira a habilidade acreadiness-policy.

3. Executar a varredura de prontidão na raiz do repositório com saída estruturada:

   npx -y github:microsoft/agentrc readiness --json [--policy <source>] [--per-area]
   

   O envelope JSON CommandResult<T> é sua entrada para a próxima etapa.

4. Transferir para o agente personalizado ai-readiness-reporter para interpretar o JSON e produzir reports/index.html. O agente renderiza através do template empacotado report-template.html (enviado junto com esta habilidade), para que cada relatório tenha uma aparência e sensação idênticas. O agente:

   • Lê o report-template.html empacotado e substitui os placeholders por dados reais.
   • Incorpora todo o CSS, envia um único arquivo estático (funciona sob file://).
   • Renderiza o nível de maturidade, pontuação geral, nota, taxa de aprovação vs. limite.
   • Detalha todos os 9 pilares em Saúde do Repositório (8) e Configuração de IA (1) com o que mede, por que importa para IA, estado atual e uma recomendação específica.
   • Marca cada pilar com um selo de relevância para IA (Alta / Média / Baixa).
   • Apresenta Extras separadamente (eles nunca afetam a pontuação).
   • Mostra a Política Ativa, incluindo quaisquer critérios e limites desativados/substituídos.
   • Produz um Plano de Remediação Priorizado (🔴 Corrigir Primeiro / 🟡 Corrigir em Seguida / 🔵 Planejar).
   • Incorpora o JSON bruto do AgentRC para reutilização.

5. Informar ao usuário onde o relatório está (reports/index.html) e como abri-lo. Resumir no chat: nível de maturidade, pontuação geral, três pilares com as pontuações mais baixas e a ação de maior alavancagem (quase sempre: executar a habilidade acreadiness-generate-instructions).

Notas

• O AgentRC também possui um renderizador HTML integrado (--visual / --output report.html), mas sua saída é intencionalmente genérica. Esta habilidade produz um painel personalizado e opinativo através do agente personalizado — mais próximo de uma revisão de código do que de um despejo de métricas.
• Para controle de CI, recomende agentrc readiness --fail-level <n> (1–5).
• A habilidade nunca modifica arquivos do repositório, exceto pela criação de reports/index.html.