De spécification à PR d'implémentation
Passez de la spécification à un brouillon de PR fondé sur votre base de code, pour que les ingénieurs puissent réviser et affiner plus vite.
Aperçu
Les spécifications ne sont utiles que si elles se traduisent clairement en code fonctionnel. L'agent de spécification à PR d'implémentation lit un document de conception ou un PRD comme source de vérité, extrait les exigences importantes pour l'implémentation et ancre le travail dans vos modèles existants et vos réalisations antérieures. Il transmet ensuite un plan structuré à un code writer pour produire une pull request d'implémentation de haute qualité dans GitHub, ainsi qu'un résumé concis et un lien afin que les ingénieurs puissent réviser, itérer et fusionner dans leur flux de travail habituel.
Voyez-le en action
Fonctionnalités
- Réduit le temps passé face à une « page blanche » grâce à des exigences prêtes pour l'implémentation extraites de la spécification.
- Assure la cohérence du travail en l'ancrant dans les modèles GitHub existants et les réalisations antérieures.
- Accélère le passage de la spécification au code avec un plan structuré prêt pour la génération de code.
- Simplifie la revue avec une PR et un résumé lié à la spécification, que les ingénieurs peuvent valider rapidement.
Exemple de résultat
Document de conception : <span class="text-color-green">https://docs.your-org.com/designs/payments/v2-recurring-billing</span>
Dépôt cible : payments-service
Pull request générée : <span class="text-color-green">https://github.com/your-org/payments-service/pull/942</span>
Résumé
L'agent de mise en œuvre à partir du document de conception/PRD a analysé le document de conception Recurring Billing v2, identifié les surfaces d'API requises, les changements de modèle de données et les points d'intégration avec le service de facturation existant, puis a produit une PR d'implémentation brouillon. La pull request ajoute l'entité <span class="text-color-green">RecurringSchedule</span>, de nouveaux endpoints pour la création et l'annulation des programmations, ainsi qu'un traitement en arrière-plan pour générer les factures selon la cadence configurée, conformément aux flux décrits dans la spécification.
Principaux changements dans la PR
- Ajout de <span class="text-color-green">RecurringSchedule</span> et du schéma de persistance associé pour modéliser les plans de facturation récurrents
- Implémentation des endpoints POST <span class="text-color-green">/v2/recurring-schedules and DELETE /v2/recurring-schedules/{id}</span> tels que spécifiés dans le document de conception
- Introduction d'un worker de planification qui crée les factures au bon moment, avec un traitement idempotent et une journalisation alignée sur les tâches existantes
- Ajout de tests d'intégration couvrant les parcours de création, mise à jour, annulation et génération de factures décrits dans les exigences
Restitué à l'ingénieur
- Document de conception : <span class="text-color-green">Recurring Billing v2</span>
- PR d'implémentation : <span class="text-color-green">payments-service#942</span>
- Résumé : Implémente l'API de facturation récurrente et le traitement en arrière-plan conformément à la conception documentée, y compris le schéma, les endpoints, le worker et les tests
- Étapes suivantes : Relire l'implémentation générée, ajuster tout nommage ou cas limites qui n'étaient pas entièrement spécifiés dans le PRD, puis fusionner après validation de la CI
Workflow de l’agent
Étape 1 : Ingestion du document de conception ou du PRD
L'utilisateur fournit un document de conception ou un PRD. L'agent le lit comme source de vérité et en extrait l'intention, les comportements souhaités, les modèles de données, les formes d'API et les contraintes.
Étape 2 : Extraction des exigences et des contraintes
L'agent distille le document en exigences orientées implémentation, en séparant ce qui impacte directement la structure du code du contexte plus large.
Étape 3 : Collecte du contexte de la base de code
En utilisant GitHub comme source de données requise, l'agent trouve les services, modules, bibliothèques et implémentations similaires pour aligner le nouveau travail sur l'architecture établie.
Étape 4 : Élaboration d'un plan d'implémentation
L'agent regroupe les exigences, les dépôts et répertoires cibles, les réalisations antérieures pertinentes et les comportements obligatoires dans un plan ciblé pour Glean code writer.
Étape 5 : Génération des changements
L'agent invoque Glean code writer avec le plan et le contexte afin que le code puisse être généré ou modifié dans les dépôts concernés, en réutilisant les réalisations antérieures lorsque cela est pertinent.
Étape 6 : Création et synthèse de la pull request
L'agent encapsule le diff généré dans une pull request GitHub et renvoie un résumé concis relié à la spécification d'origine, ainsi que le lien de la PR pour révision et itération.
Work AI qui fonctionne.
