Action GitHub
Bloquez les PR sur un audit de qualité des specs et plans qu'elles touchent.
Une action GitHub clé en main audite les fichiers spec/plan modifiés, publie un check run avec annotations inline, et fait échouer le check quand le gate est bloquant.
N'audite que les fichiers spec/plan modifiés par la PR.
Check run + annotations inline + commentaire de PR optionnel.
Préserve plafonds de dépenses, limites de débit et journaux d'audit.
Idéal pour : Les équipes qui veulent imposer la qualité des specs automatiquement sur chaque PR.
Mise en route
Suivez ces étapes pour être opérationnel.
Créez un secret de dépôt
Stockez votre clé agent comme secret chiffré CVAI_API_KEY (paramètres du dépôt ou de l'org).
Ajoutez le workflow
Copiez ce fichier dans .github/workflows/eqa-gate.yml dans le dépôt à protéger.
name: EQA Task-Plan Gate
on:
pull_request:
paths:
- "docs/specs/**/*.md"
- "docs/plans/**/*.md"
permissions:
contents: read
checks: write
pull-requests: write
jobs:
eqa-gate:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- id: changed
uses: tj-actions/changed-files@v45
with:
files: |
docs/specs/**/*.md
docs/plans/**/*.md
- if: steps.changed.outputs.any_changed == 'true'
uses: ./.github/actions/eqa-gate
with:
api-key: ${{ secrets.CVAI_API_KEY }}
files: ${{ steps.changed.outputs.all_changed_files }}
# base-url: https://communityvision.ai
# pr-comment: "true"Ajustez les chemins
Modifiez les filtres paths et les globs files pour cibler où vivent vos specs et plans.
Lisez les résultats
Onglet Checks de la PR : pass/fail global, annotations inline sur le diff, et commentaire collant optionnel.
Ressources utiles
Autres surfaces
CVAI vous rejoint partout où vous travaillez. Explorez les autres intégrations.
Auditez specs et plans en une seule commande, depuis votre terminal.
Une clé pour tout : applications agent, API REST v1 et serveur MCP natif.
Auditez la spec ouverte dans l'éditeur et voyez les problèmes en soulignés inline.
Mentionnez @CVAI dans un canal pour auditer un document, directement dans Slack.
Auditez n'importe quelle page en un clic, ou laissez les navigateurs IA appeler les outils CVAI dans la page.
Un bundle de tokens, assets et specs pour construire l'app mobile sans dérive de design.
Recevez les résultats par webhook signé, et intégrez vos rapports dans n'importe quelle page.
Action GitHub — questions fréquentes
Comment conditionner les pull requests à un audit de spécification CVAI ?
Stockez votre clé d'agent comme secret de dépôt chiffré CVAI_API_KEY, puis ajoutez le workflow de contrôle EQA sous .github/workflows/. Il n'audite que le markdown de spécification et de plan qu'une PR modifie, publie un check run avec des annotations en ligne et fait échouer le contrôle lorsque le verdict est bloquant.
La GitHub Action CVAI audite-t-elle chaque fichier à chaque PR ?
Non. Elle ne s'exécute que sur les fichiers de spécification et de plan qu'une PR modifie, à l'aide de filtres de chemin et de globs de fichiers que vous ajustez selon l'emplacement de vos specs et plans — en préservant les plafonds de dépenses, les limites de débit et la journalisation d'audit.