Les spécifications ne sont utiles que si elles se traduisent fidèlement en code fonctionnel. L'agent de spécification vers PR d'implémentation lit un document de conception ou un PRD comme source de vérité, en extrait les exigences essentielles pour l'implémentation et ancre le travail dans vos modèles existants et vos références antérieures. Il transmet ensuite un plan structuré à un générateur de code afin de produire une pull request d'implémentation de haute qualité dans GitHub, accompagnée d'un résumé concis et d'un lien, permettant aux ingénieurs de réviser, d'itérer et de fusionner selon leur flux de travail habituel.

Découvrez-le en action

Fonctionnalités

Réduit le temps de démarrage « page blanche » grâce à des exigences prêtes à implémenter, extraites de la spécification.
Assure la cohérence du travail en ancrant les modifications dans les patterns GitHub existants et les travaux antérieurs.
Accélère le passage de la spécification au code grâce à 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 : https://docs.your-org.com/designs/payments/v2-recurring-billing
Dépôt cible : payments-service
Pull request générée : https://github.com/your-org/payments-service/pull/942

Résumé

L'agent Implémentation à partir d'un document de conception/PRD a analysé le document de conception Recurring Billing v2, identifié la surface d'API requise, les modifications du modèle de données et les points d'intégration avec le service de facturation existant, puis produit une pull request d'implémentation en mode brouillon. La pull request ajoute l'entité RecurringSchedule, de nouveaux endpoints pour la création et l'annulation de plannings, ainsi qu'un traitement en arrière-plan pour générer les factures selon la cadence configurée, en cohérence avec les flux décrits dans la spécification.

Changements clés dans la pull request

Ajout de RecurringSchedule et du schéma de persistance associé pour modéliser les plans de facturation récurrente
Implémentation des endpoints POST /v2/recurring-schedules et DELETE /v2/recurring-schedules/{id} tels que spécifiés dans le document de conception
Introduction d'un worker de planification qui crée les factures selon le bon calendrier, avec un traitement idempotent et une journalisation alignée sur les jobs existants
Ajout de tests d'intégration couvrant les parcours de création, de mise à jour, d'annulation et de génération de factures décrits dans les exigences

Retourné à l'ingénieur

Document de conception : Recurring Billing v2
Pull request d'implémentation : payments-service#942
Résumé : Implémente l'API de facturation récurrente et le traitement en arrière-plan conformément à la conception documentée, incluant le schéma, les endpoints, le worker et les tests
Prochaines étapes : Examiner l'implémentation générée, ajuster les éventuels noms ou cas limites qui n'étaient pas pleinement spécifiés dans le PRD, et fusionner une fois la CI validée

Workflow de l'agent

Étape 1 : ingérer le document de conception ou le 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 formats d'API et les contraintes.

Étape 2 : extraire les exigences et les 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 général.

Étape 3 : rassembler le contexte du code

En utilisant GitHub comme source de données requise, l'agent trouve les services, modules, bibliothèques et implémentations similaires associés afin d'aligner le nouveau travail sur l'architecture établie.

Étape 4 : élaborer un plan d'implémentation

L'agent regroupe les exigences, les référentiels et répertoires cibles, les travaux antérieurs pertinents et tout comportement incontournable dans un plan ciblé pour Glean code writer.

Étape 5 : générer les modifications

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 référentiels concernés, en réutilisant les travaux antérieurs lorsque cela est pertinent.

Étape 6 : créer et résumer la pull request

L'agent intègre le diff généré dans une pull request GitHub et renvoie un résumé concis relié à la spécification d'origine, accompagné du lien de la PR pour la revue et l'itération.