菜单
Enchaîne `/forge:report` puis `/forge:sync` en une passe après livraison d'une story (feature, refacto ou évolution technique) — compte rendu d'écarts intention vs code livré, puis réalignement de la doc. Délègue à un subagent isolé.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Transforme un besoin flou en brief pour `/feature-pitch` — interview accessible (irritant, qui, résultat attendu) ancrée sur le code existant. Pour qui sait ce qui le gêne mais pas le pitcher. Produit `docs/story/NNN-f-<slug>/brief.md`.
Reconstruit le `metadata.json` manquant des stories antérieures — déduit le titre du H1, les dates `created`/`updated` de l'historique git, la timeline `changelog` de l'apparition de chaque artifact, la livraison (`delivery.commit`/`release`) des commits et tags, propose des `tags` à valider. Déclenche sur « générer les métadonnées des anciennes stories », « backfill metadata.json », « reconstruire les métadonnées ».
Rédige un Architecture Decision Record (MADR léger) depuis un artifact (pitch/plan/review/report) ou un topic libre — contexte, drivers, options, conséquences. Produit `docs/adr/NNNN-<slug>.md` avec backlinks et index auto.
Commit Conventional Commits v1.0.0 en français depuis le diff courant — analyse, génère `type(scope): sujet` (corps si pertinent), commit, rebase (jamais de merge), puis push. Bloque sur secrets, code de debug ou conflit de rebase.
Chiffre le temps « tout compris » d'une story à facturer (feature, refacto, tech) : cadrage, implem, tests, review, doc, release. Lit brief/pitch/plan. Réaliste + marge, en heures. Produit `docs/story/NNN-<f|r|t>-<slug>/estimate.md`.
Implémente une feature depuis un plan technique validé — sous-tâches trackées, qualité continue (lint, types, tests), checkpoints humains avant choix structurants. Prérequis un `plan.md` sous `docs/story/<NNN>-f-<slug>/`.
| name | report-and-sync |
| description | Enchaîne `/forge:report` puis `/forge:sync` en une passe après livraison d'une story (feature, refacto ou évolution technique) — compte rendu d'écarts intention vs code livré, puis réalignement de la doc. Délègue à un subagent isolé. |
| user_invocable | true |
| argument-hint | [slug-story ou chemin docs/story/NNN-<f|r|t>-<slug>/] |
| allowed-tools | ["Agent","AskUserQuestion"] |
Cette skill est un point d'entrée slash pour le subagent forge:report-and-sync. Le subagent enchaîne deux phases :
/forge:report pour produire report.md (constat des écarts entre intention et code livré)/forge:sync pour appliquer les écarts validés à la doc d'intention (pitch.md + plan.md pour une feature, plan.md pour un refacto ou une évolution tech) avec changelog interneLe wrapper te donne un point d'entrée slash explicite et préserve l'isolation de contexte : c'est le subagent qui pilote l'enchaînement, pas la session principale.
Récupère les arguments transmis dans $ARGUMENTS (slug de story ou chemin docs/story/NNN-<f|r|t>-<slug>/).
Si $ARGUMENTS est vide, demande à l'utilisateur le slug ou le chemin de la story. La clôture documentaire a besoin d'une story livrée explicitement nommée — ne devine pas.
Invoque le tool Agent avec :
subagent_type: "forge:report-and-sync"description: "Report+Sync story <slug>"prompt : transmets le slug/chemin et toute consigne complémentaire de l'utilisateur (par exemple, contraintes particulières sur le sync, sections à ne pas réaligner, etc.). L'agent connaît sa propre procédure REPORT → SYNC.Quand le subagent rend la main, relaie à l'utilisateur :
report.md produitLa spécification complète (enchaînement REPORT → SYNC, architecture inline) vit dans la définition du subagent forge:report-and-sync, que tu invoques par son nom — tu n'as aucun fichier à lire manuellement.