AGENT SKILL

iakaframe-update

Exécute le checkpoint « update iakaframe » — régénère l'état des lieux, fait un commit global atomique et pousse sur le gestionnaire de source. Utiliser cette skill quand l'utilisateur dit "update iakaframe", "update", "checkpoint", "sauvegarde le projet", "commit global", "pousse tout", "change de version", ou marque une pause de dev qui doit être versionnée. C'est la contrepartie en écriture de l'état des lieux (lecture seule) dans la méthode iakaframe.

License 许可
MIT
所属仓库
iakasju/iakaframe
最近更新
2026-10-12
Stars
★ 0
Forks
0

01 前言 Front Matter

id
iakaframe-update
name
iakaframe-update
subskills
[ "iakaframe-etat-des-lieux", "iakaframe-gestion-de-source" ]
description
Exécute le checkpoint « update iakaframe » — régénère l'état des lieux, fait un commit global atomique et pousse sur le gestionnaire de source. Utiliser cette skill quand l'utilisateur dit "update iakaframe", "update", "checkpoint", "sauvegarde le projet", "commit global", "pousse tout", "change de version", ou marque une pause de dev qui doit être versionnée. C'est la contrepartie en écriture de l'état des lieux (lecture seule) dans la méthode iakaframe.

03 SKILL.md 正文

iakaframe — Update / checkpoint (commit global + push)

Tu agis ici comme l'orchestrateur en mode écriture. Là où la skill iakaframe-etat-des-lieux constate sans rien modifier, celle-ci grave un point de sauvegarde : elle régénère l'état des lieux, commite tout le travail en cours et pousse sur le gestionnaire de source. C'est le geste réflexe à chaque changement de version et à chaque pause/reprise.

Quand l'exécuter

  • À chaque changement de version (--reason version --version vX.Y.Z).
  • À chaque pause de dev / reprise (--reason pause / --reason reprise).
  • Comme simple point de sauvegarde intermédiaire (filet de sécurité git).

Procédure

  1. Lancer la commande dans le répertoire du projet (elle enchaîne snapshot + commit global + push) :
    iakaframe update --reason version --version v0.4.0 --note "..."
    
    Options : --reason version|pause|reprise|manual, --version vX.Y.Z, --note "...", --no-push, --remotes <a,b,c> (cibles, parmi les forges self-hosted uniquement — GitHub et tout hôte hors forge en sont exclus, opt-in ou pas), --publier <vX.Y.Z> (publication vitrine explicite, cf. § Garde-fous).
  2. Si la commande n'est pas disponible, reproduire sa séquence à la main :
    # a) régénérer l'état des lieux (faits git)
    iakaframe snapshot --reason version --version v0.4.0
    # b) commit global atomique
    git add -A
    git commit -m "chore(<projet>): update etat des lieux + commit global (version v0.4.0)"
    # c) push EXPLICITE vers le remote de la forge (jamais un `git push` nu)
    git push origin main
    
  3. Compléter le récit de reprise dans specs/etat-des-lieux.md (rôle Cowork) si la raison est pause/reprise : ce qui vient d'être fait, ce qui reste, la prochaine étape — avant le commit, pour qu'il soit inclus.
  4. Confirmer à l'humain : version, hash du commit, push OK/KO, arbre propre.

Garde-fous

  • Commit global = git add -A : tout est pris. Vérifier qu'aucun secret ni artefact lourd indésirable n'est embarqué (token, dumps, binaires) — sinon ajuster .gitignore avant de commiter.
  • Conventional commits (chore:, feat:, fix:…) pour rester lisible.
  • Jamais de git reset --hard ni de git push --force côté IA.
  • Si le remote n'existe pas encore → brancher d'abord via la capacité iakaframe-gestion-de-source (le serveur concret est le produit sélectionné à l'install).
  • update sur un projet pas encore versionné sur son dépôt distant bascule en init (auto-détection).
  • Jamais de push hors forge self-hosted : GitHub n'est pas un remote de la méthode — le fan-out par défaut ne l'atteint jamais, même configuré comme remote, opt-in ou pas.
  • Un agent ne lance jamais --publier : c'est un acte du décideur, réservé au terminal interactif (refusé automatiquement hors TTY, en CI, ou avec IAKA_NON_INTERACTIF) — un agent n'a pas de TTY, il ne peut donc jamais faire aboutir cette confirmation.
  • Ne jamais contourner par git push github à la main : si un dépôt est opt-in vitrine (iakaframe.json → pushOptInRemotes), la seule voie d'écriture reste iakaframe update --publier <vX.Y.Z>, avec l'accord du décideur.

Place dans le cycle

Symétrique de iakaframe-etat-des-lieux : l'une lit, l'autre grave. C'est le checkpoint qui rend la reprise possible — reprendre un projet = lire etat-des-lieux.md, pas fouiller sa mémoire.

04 同仓库更多 Skills