/acreadiness-policy — Políticas do AgentRC

Use esta habilidade quando o usuário perguntar sobre políticas, modo rigoroso, pontuação personalizada, desabilitar verificações, padrões de organização ou bloqueio de CI de prontidão.

Uma política é um pequeno arquivo JSON com três seções opcionais — criteria, extras, thresholds — que personalizam como o AgentRC pontua a prontidão.

Exemplos integrados

O AgentRC vem com três políticas de exemplo em examples/policies/:

Recomende estes como pontos de partida antes de escrever uma política personalizada.

Esquema de política

{
  "name": "my-policy",
  "criteria": {
    "disable":  ["env-example", "observability", "dependabot"],
    "override": {
      "readme":      { "impact": "high", "level": 2 },
      "lint-config": { "title": "Linter required" }
    }
  },
  "extras": {
    "disable": ["pre-commit"]
  },
  "thresholds": {
    "passRate": 0.9
  }
}

Pesos de impacto

Score = 1 − (deductions / max possible weight). Notas: A ≥ 0.9, B ≥ 0.8, C ≥ 0.7, D ≥ 0.6, F < 0.6.

Subcomandos

show

Lista as políticas atualmente em vigor (do array agentrc.config.json policies, ou nenhuma).

new <name>

Cria um esqueleto de policies/<name>.json com padrões sensatos. Guia o usuário através de:

1. O que desabilitar — pilares ou extras irrelevantes para sua pilha (por exemplo, desabilitar observability para um site estático).
2. O que aumentar — substituir impact para high ou critical para itens obrigatórios (por exemplo, readme, codeowners).
3. Limite de taxa de aprovação — linhas de base típicas da organização: 0.7 (flexível), 0.85 (padrão), 1.0 (rigoroso).
4. Referencie a política de agentrc.config.json:

   { "policies": ["./policies/<name>.json"] }
   

apply <path-or-pkg>

Executa agentrc readiness --json --policy <source> e renderiza o relatório novamente, passando para a habilidade assess / agente ai-readiness-reporter. Suporta encadeamento:

npx -y github:microsoft/agentrc readiness --json --policy ./org-baseline.json,./team-frontend.json

Bloqueio de CI

Combine políticas com --fail-level para impor um nível mínimo de maturidade em CI:

- run: npx -y github:microsoft/agentrc readiness --policy ./policies/strict.json --fail-level 3

Avançado

Políticas JSON podem desabilitar, substituir e definir limites — mas não podem adicionar novos critérios. Para nova lógica de detecção, aponte os usuários para o sistema de plugins TypeScript do AgentRC (docs/dev/plugins.md).

Regras de operação

• Nunca desabilite um pilar silenciosamente. Se o usuário quiser desabilitar observability, confirme e explique a troca.
• Prefira substituir impact em vez de desabilitar. Desabilitar oculta completamente a lacuna; substituir permite que ela ainda apareça no relatório.
• Recomende que os extras permaneçam habilitados. Eles não custam nada — não afetam a pontuação.
• Sugira camadas — a maioria das organizações quer uma política de linha de base + substituições por equipe encadeadas com --policy a.json,b.json.