CommunityImagegithub.com

asis-tobe

Explique, en une seule page HTML, comment un changement (PR, branche, arbre de travail non commité, ensemble de PRs sur plusieurs dépôts ou un issue) modifie chaque couche — données, payload API, comportement serveur, écran, résultat utilisateur — en plaçant AS-IS et TO-BE côte à côte et en reliant les couches par une chaîne causale.

Qu'est-ce que asis-tobe ?

Cette compétence génère un document HTML autonome comparant l'état actuel (AS-IS) et futur (TO-BE) pour chaque couche d'un changement logiciel : données (schéma, migrations), spécification API (payloads, types), comportement serveur/app, écran (captures d'écran), et impact utilisateur. Elle est particulièrement utile pour les développeurs, testeurs et planificateurs ayant besoin de visualiser rapidement l'impact complet d'une PR sur plusieurs dépôts, d'un issue ou de modifications locales non commitées. Fonctionne avec Claude Code, Cursor ou tout agent capable d'exécuter des scripts shell et Python. La compétence comprend des scripts pour générer des diagrammes ERD et des diff en ligne de commande, et impose des règles strictes de collecte de preuves (hash de commit, numéro de ligne) pour chaque lien de causalité. Elle produit une page HTML responsive avec deux thèmes de couleurs, un résumé exécutif en haut, et des tableaux comparatifs pour chaque couche touchée.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/chordpli/asis-tobe/tree/main

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

AS-IS / TO-BE

Trouvez les couches qu'un changement touche, mettez AS-IS et TO-BE côte à côte pour chacune, et reliez les couches avec des flèches étayées par des preuves : "ce champ est supprimé, donc cette réponse change, donc cela disparaît (ou apparaît) sur cet écran." Si le code change mais que ce que l'utilisateur voit reste identique, le dire est la conclusion. N'inventez pas de changements.

<skill> dans les commandes ci-dessous est le répertoire de base de cette compétence : le dossier qui contient ce SKILL.md (~/.claude/skills/asis-tobe pour une installation utilisateur, <projet>/.claude/skills/asis-tobe pour une installation projet). Remplacez-le par le chemin réel avant d'exécuter une commande.

Principes

  1. Côte à côte. AS-IS à gauche, TO-BE à droite. Jamais empilé verticalement.
  2. Comparez des artefacts réels. Payloads selon le « 실물 고르는 순서 » ci-dessous, écrans à partir de vraies captures d'écran, schémas à partir de la vraie migration et des diffs de modèles. Sans l'artefact réel : « 실물 없음: » ("pas d'artefact réel : "). Exemples faits à la main : « 예시(손으로 만듦) » ("exemple (fait à la main)").
  3. Dessinez seulement les couches modifiées. Une couche inchangée reçoit « 변경 없음 » ("aucun changement") plus une ligne de preuve. Pas de tableaux vides.
  4. Chaque flèche a une preuve. Un fichier:ligne ou un commit par maillon du chemin d'impact. Sans preuve, marquez-le « 추정: » ("estimation :").
  5. Dites qui utilise encore l'ancienne spécification. Tout ce qui continue d'exécuter l'ancien code après la livraison : builds d'applications déjà dans les stores, onglets de navigateur encore ouverts sur l'ancienne page, autres services, autres sites d'appel comme un outil d'administration ou un bot. Cela détermine l'ordre de merge et de déploiement.
  6. Résumé en premier. La boîte de résumé en haut doit seule supporter la décision : une phrase de conclusion dans les mots de l'utilisateur (pas de noms de champs ni de codes d'état), ce qui change pour l'utilisateur, comment c'est livré, si c'est réversible ; 3 éléments ou moins par groupe. Juste en dessous, trois cartes répondent à ce que tout lecteur demande ensuite, nommées par la question et non par un rôle : « 정해야 할 것 » (ce que le changement a décidé pour quelqu'un d'autre), « 먼저 볼 곳 » (taille, les fichiers à ouvrir en premier, les prémisses que le code énonce), « 직접 확인하는 법 » (éléments de vérification, puis comment l'exécuter) — règles dans references/document.md ("Cartes questions"). Les deux choses sur lesquelles une décision repose, le badge et la réversibilité, sont les éléments les plus visibles sur le premier écran. Dites chaque fait une fois : une phrase déjà dans la conclusion ou l'avertissement n'est pas répétée dans le lead, les cartes questions ou un scénario. Tout ce qui suit est une preuve. Pliez les longs payloads et les tableaux exhaustifs dans <details> ; ne les supprimez pas. Pas d'introduction, de récit de progression ou de remarques de clôture.
  7. La mise en page est le contenu. À 420px de large, la page ne doit pas défiler horizontalement (seuls les tableaux le peuvent). Largeur du corps limitée à 880px ; seuls les tableaux et les comparaisons côte à côte utilisent la pleine largeur. code dans les tableaux uniquement pour les identifiants ; seuls les chemins de fichiers et les identifiants sont en police monospace, les descriptions en coréen jamais. Phrases d'environ 70 caractères, modificateurs coupés. Deux schémas de couleurs commutés par un interrupteur au-dessus du titre : défaut Dusk, beige (AS-IS) et bleu ardoise (TO-BE) ; Bloom, rose (AS-IS) et menthe (TO-BE). Ne suivez pas le réglage du mode sombre système. Les lignes en tirets et pleines accompagnent toujours la couleur. Les surlignages de code en ligne utilisent le clair --a-mark, --b-mark, pas les couleurs sombres des puces. Rendu une fois dans chaque schéma et une fois à 420px.
  8. Termes du métier, expliqués une fois. Utilisez des mots que les développeurs, testeurs et planificateurs comprennent immédiatement. Dans le document coréen, utilisez 레이어, 필드, API 스펙, 호출처, deprecated, breaking change, mock 응답, avec une explication simple entre parenthèses uniquement à la première utilisation (par ex. codegen(서버 스펙으로 자동 생성한 타입 파일) — "fichiers de types générés automatiquement à partir de la spécification serveur"). Pour le jargon interne (「AC」, surnoms d'écran inventés), précisez ce que c'est à la première utilisation. Glossaire : references/terms.md. Si un terme vous bloque, lisez-le là ; ne sautez pas l'étape.

Couches

CoucheCe qu'il faut comparerD'où vient l'artefact réel
Données (데이터)Tables, champs, types, énumérations, contraintes, index. Un diagramme d'entité des seules entités modifiées, et le code du modèleMigrations, schéma ORM (prisma etc.), diff DDL
Spécification API (API 스펙)Payloads de requête et réponse, événements, types codegen. Ajouts, suppressions, changements de type, changements sémantiques par champDiff OpenAPI, DTOs de réponse, fixtures de test
Comportement (동작)Le résultat que le serveur et le client produisent pour la même entréeDiff d'assertions de test, code de transition d'état
Écran (화면)Deux captures de l'écran dans le même étatL'outil de capture d'écran du projet (references/adapters.md, «프로젝트 어댑터»)
Impact utilisateur (사용자 영향)Ce que les utilisateurs peuvent désormais faire ou ne plus faire, les chiffres qui changent. Inclut les états intermédiaires dus à l'ordre de déploiementAC de l'issue, la somme des couches ci-dessus, tableau de compatibilité

Listes de contrôle par couche et pièges courants : references/layers.md.

Choisir l'artefact réel (실물 고르는 순서, Spécification API)

Fixture de test serveur > exemple OpenAPI > appel réel enregistré > réponse mock client. Prenez le premier qui existe en entier. Si une source plus élevée n'est que partielle (une fixture construite à partir de variables, ou des tests qui construisent la requête en ligne et vérifient champ par champ) et que vous avez enregistré un appel réel, montrez la source plus élevée dans le panneau et l'appel enregistré comme texte complet, chacun étiqueté avec sa source. Un appel enregistré porte des valeurs qui diffèrent à chaque exécution (ids, horodatages) ; comparez ces payloads avec code_diff.py --mask id,time et dites-le dans la ligne de source, afin qu'un nouvel id ne soit pas compté comme un champ modifié. Un mock client (par ex. une réponse factice pour les captures d'écran) n'est pas l'artefact réel du serveur. Écrivez le chemin de la source choisie sous le payload. Si la fixture est construite à partir de variables sans JSON complet, transcrivez-la à partir des valeurs attendues du test, étiquetez-la « 예시(테스트 기대값에서 옮김) » ("exemple (transcrit à partir des attentes du test)"), et utilisez … là où c'est raccourci. Ne remplissez pas les champs absents des valeurs attendues ; laissez-les …. Si vous avez emprunté une valeur ailleurs (une réponse mock, etc.), notez la source à côté de ce champ.

Procédure

1. Définir le périmètre

  • Entrée PR : obtenez le diff par numéro de PR (gh pr diff <n> -R <repo>). Un chemin ou une branche seul donne un PR empilé avec sa base et mélange les changements d'autres personnes.
  • Entrée Issue : trouvez les PRs dans chaque dépôt (gh pr list -R <repo> --search <key> --state all). Deux dépôts ou plus vont dans un seul document.
  • Pas de PR : git diff <base>...HEAD dans l'arbre de travail, avec <base> le point de bifurcation, calculé à partir de la racine du dépôt (le main local est obsolète et mélange des centaines de fichiers) :
    git fetch origin main
    git merge-base origin/main HEAD
    
    Si le diff inclut des fichiers sans rapport avec l'issue, la base est erronée. Recalculez avant de répartir en couches.
  • Pas de dépôt distant : ignorez le fetch et prenez la base nommée par l'utilisateur, sinon le commit à partir duquel le travail a commencé (git merge-base main HEAD, ou HEAD lui-même pour un travail non commité).
  • Arbre de travail non commité : AS-IS est HEAD, TO-BE est l'arbre de travail. git diff HEAD manque les nouveaux fichiers, donc lisez aussi git ls-files --others --exclude-standard. Partout où un sha de commit est demandé, écrivez « 커밋 전 » ("non commité"). Ne commitez pas, ne stash pas et ne faites pas de checkout pour effectuer la comparaison.
  • Pas de PR ou d'issue : la cible est nommée par ce qu'elle est ("<dépôt> changement de l'arbre de travail", " branche"). Le tableau de déploiement reçoit une ligne par unité livrée (une branche, "커밋 작업 트리") avec la cellule PR la nommant ; la clé d'issue est supprimée, non inventée.
  • Par dépôt, écrivez une ligne <dépôt> <sha base court> → <sha branche court>. Utilisez-la textuellement dans le rapport. Dans le document, les PRs et shas vont une fois dans le tableau d'ordre de déploiement de la carte de résumé et le tableau de base (references/document.md), pas dans l'en-tête.

2. Assigner les fichiers modifiés aux couches

Chaque fichier va à une ou plusieurs couches ; si ce n'est pas clair, ouvrez-le. Les fichiers de test ne sont pas assignés ; ils sont une preuve pour la couche Comportement (동작). Ce tableau décide quelles sections de couche le document obtient ; c'est un matériel de travail et n'est pas imprimé dans le document.

3. Décider d'abord si l'écran change réellement

Même si le code de l'écran a changé, demandez avant de capturer : la branche modifiée est-elle atteignable avec les données actuelles ? Choisissez une valeur dont dépend la branche et trouvez si le serveur la produit réellement.

# Exemple : suppression de la branche où l'app affichait un badge « 품절 » ("sold out") lorsque stockState === 'SOLD_OUT'
git -C <dépôt serveur> grep -n "SOLD_OUT" -- <fichiers source>      # le serveur met-il cette valeur dans une réponse quelque part ?
git -C <dépôt app> grep -n "stockState" -- <types générés>        # valeurs que le type généré autorise

Aucun code serveur définissant la valeur (seulement des définitions de type ou d'énumération) signifie inaccessible, même si le type généré l'autorise. Enregistrez le fichier:ligne comme preuve pour « 변경 없음 ».

Si seul l'endroit qui calcule une valeur se déplace (par ex. le ERROR du serveur est désormais calculé par l'app comme lastError), mettez les deux formules côte à côte avec leur fichier:ligne. Même valeur pour la même entrée : même écran. Différente : trouvez une entrée qui produit une valeur différente et capturez cet état.

  • Atteignable : capturez à l'étape 4.
  • Inaccessible : la couche Écran reçoit « 현재 데이터로는 변경 없음: » ("aucun changement avec les données actuelles : "). Enregistrez l'état disparu sous « 실물 없음 » et montrez son ancienne apparence via les chaînes de test dont les assertions vérifiaient cet état. Si une confirmation est nécessaire, capturez un scénario représentatif et montrez la similitude avec md5.
  • Incertain : capturez.

4. Collecter les artefacts réels par couche

  • Données : trois parties, dans cet ordre.
    1. Diagramme d'entité, ouvert. Seulement les entités modifiées et celles directement attachées, 6 ou moins par côté. Écrivez-les en JSON et laissez le script dessiner les deux côtés en SVG en ligne : python3 -I <skill>/scripts/erd.py <spec.json> (le format de la spécification est dans l'en-tête du script). Ne dessinez jamais le SVG à la main et ne chargez jamais de bibliothèque de diagrammes ; la page est autonome. Le script marque lui-même les champs et entités ajoutés, supprimés et modifiés en comparant les deux côtés, donc écrivez chaque côté tel qu'il est réellement à ce commit.
    2. Code du modèle, plié (<details>) : le modèle tel que le code le contient (struct, classe, schéma ORM) à la base et maintenant. Un diff d'une ligne par modèle à partir de python3 -I <skill>/scripts/code_diff.py <ASIS.txt> <TOBE.txt> --label "<nom (chemin)>" --start-a <ligne> --start-b <ligne> ; un modèle nouveau ou supprimé utilise /dev/null pour le côté manquant. Le script calcule les lignes modifiées et affiche les deux vues (나란히 côte à côte, 합쳐서 unifié) pour que le lecteur bascule ; ne marquez jamais les lignes à la main.
    3. Tableau des champs, plié : ce que le diagramme omet (valeurs par défaut, contraintes, index, gestion des lignes existantes). Un seul champ modifié sans relation impliquée ne nécessite pas de diagramme : une ligne dans le tableau des champs, affichée ouverte. Si AS-IS n'avait pas de schéma stocké (en mémoire, un fichier), donnez seulement tobe au script avec asis_note indiquant où les données vivaient (fichier:ligne) ; le code du modèle est alors la preuve AS-IS, donc laissez ce <details> ouvert. La migration qui crée les premières tables est TO-BE. Si cela nettoie après une migration déjà livrée, « 이미 반영() » ("déjà appliqué ()") est le premier lien du chemin d'impact.
  • Spécification API : le payload avant et après en diff de lignes à partir de scripts/code_diff.py (même script que pour le code du modèle ; un appel par payload, --context 3 pour les longs, --mask id,time pour les appels enregistrés). En dessous, 필드 | AS-IS | TO-BE | 시맨틱 변경 (champ | AS-IS | TO-BE | changement sémantique). Un changement de nom ou de type uniquement fusionne les deux cellules en une seule ligne : <code class="old">start_time</code> → <code class="new">starts_at</code>. Sites d'appel :
    • git grep <champ> dans chaque dépôt, depuis la racine du dépôt (un sous-répertoire rend les chemins relatifs et retourne 0 résultats).
    • Aussi sur la version publiée : git grep -n <champ> <sha>. Son résultat décide l'ordre de merge et de déploiement et le badge. Lisez references/adapters.md ("Trouver la version publiée") avant de faire cela. Impératifs : seul un sha de la liste de build est confirmé, les autres sont « 추정: » ; si les sources divergent, greppez chaque sha et comptez toute occurrence comme « 배포된 앱이 읽는다 » ("l'application publiée le lit") ; ne choisissez jamais par nom de tag seul (les tags peuvent appartenir à un autre déploiement dans le même dépôt). Solution de repli légère lorsque la liste de build échoue (par ex. pas de connexion au service de build) : shas de l'issue ou des notes de version, sinon une borne inférieure « 추정: ».
    • La sortie de codegen n'est pas un site d'appel ; elle est régénérée à partir de la spécification serveur. Notez séparément « 다시 뽑으면 무엇이 바뀌나 » ("ce qui change si régénéré").
    • Greppez aussi le champ supprimé dans les réponses mock et fixtures de test du client. S'il reste, la vérification de type peut casser une fois le codegen régénéré après la livraison du serveur. Listez ces fichiers comme dernière étape de déploiement ("codegen 재생성과 fixture 정리", "régénérer le codegen et nettoyer les fixtures").
  • Comportement : 입력·상태 | AS-IS | TO-BE | 근거(테스트 이름) (entrée/état | AS-IS | TO-BE | preuve (nom du test)).
  • Écran : lisez references/screens.md ("Capture") avant de capturer. Même scénario, données, langue et taille des deux côtés, dans un seul arbre de travail temporaire (base pour AS-IS, branche pour TO-BE) ou, pour un travail non commité ou un dépôt que vous ne devez pas toucher, dans deux copies en dehors du dépôt ; installations et captures en arrière-plan, comparées par md5, puis, une fois l'étape 10 re-mesurée ce dont elle a besoin, arrêtez les serveurs et supprimez l'arbre de travail temporaire ou les copies (gardez-les si l'utilisateur veut l'exécution reproductible) ; ne les commitez jamais. Sans outil de capture mock, exécutez le vrai serveur de chaque version sur son propre port et capturez-le. Commandes de capture par projet : references/adapters.md. Ne sautez la capture que lorsque la plateforme ne peut pas être capturée (par ex. natif) ou que l'étape 3 a trouvé la branche inaccessible ; alors « 실물 없음: » plus les chaînes d'assertion de test. En cas de doute, capturez.

4b. Remplir le rail de scénarios

Lisez references/scenario-rail.md avant de remplir « 시나리오별 전후 ». Noms de cellules pour d'autres domaines : references/domains.md.

| Squelette | Web/app

Skills associés