Agent Scripts
Instructions d'agent partagées, compétences et petits utilitaires portables pour les espaces de travail locaux de Peter.
Ce dépôt est l'endroit canonique pour :
AGENTS.MD: règles dures partagées pour les agents de type Codex/Claudeskills/: compétences de workflow réutilisables, y compris les compétences appartenant au dépôt exposées par lien symboliquescripts/: utilitaires légers en dépendances utilisés dans tous les projetshooks/: garde-fous locaux tels que la validation des compétences
Compétences
Les compétences constituent la couche de routage principale. Chaque skills/<nom>/SKILL.md possède un front matter YAML :
---
name: nom-de-la-competence
description: "Courte phrase de déclenchement générique."
---
Règles :
- Gardez les descriptions courtes et génériques ; optimisez pour le routage, pas la documentation.
- Gardez les corps de compétences concis et opérationnels.
- Préférez les scripts d'aide sous
skills/<nom>/scripts/lorsqu'un workflow a des commandes répétables. - Validez après modifications :
scripts/validate-skills. - Mettez
descriptionentre guillemets dans le front matter.
La découverte globale est construite par scripts/sync-skills (idempotent ; exécuté sur chaque Mac après clonage ou ajout de compétences) :
- Codex scanne les répertoires imbriqués, il reçoit donc des liens racine entière :
~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills,~/.codex/skills/manager -> ~/Projects/manager/skills. - Claude Code charge seulement
~/.claude/skills/<nom>/SKILL.md(exactement un niveau de profondeur ; les liens symboliques par entrée sont suivis, les sous-dossiers de catégorie ne sont pas scannés — vérifié sur la version 2.1.197). Il reçoit un miroir plat de liens par compétence couvrant les deux dépôts plus les extras locaux à la machine~/.codex/skills/<nom>. - Les collisions de noms se résolvent dans l'ordre agent-scripts > manager > codex-local ; le script affiche les doublons ignorés et supprime les liens gérés cassés/obsolètes.
Les compétences personnelles partagées vivent comme de vrais dossiers dans skills/. Les compétences partagées publiques d'OpenClaw vivent dans ../agent-skills et sont exposées ici avec des liens symboliques relatifs suivis. Les compétences appartenant au dépôt restent canoniques dans leur dépôt et sont exposées ici de la même manière, par exemple :
skills/autoreview -> ../../agent-skills/skills/autoreview
skills/discrawl -> ../../discrawl/.agents/skills/discrawl
Les compétences actuelles appartenant au dépôt liées par symbole incluent birdclaw, discrawl, gog, imsg, slacrawl, wacli, et wacrawl.
Instructions pour l'Agent
Les règles dures partagées vivent dans AGENTS.MD.
Configuration globale (également maintenue par scripts/sync-skills ; Claude Code lit uniquement CLAUDE.md, donc il crée un lien vers le fichier partagé AGENTS.MD) :
~/.codex/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD~/.claude/CLAUDE.md -> ~/Projects/agent-scripts/AGENTS.MD~/.claude/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD
Les dépôts en aval doivent utiliser un AGENTS.MD de style pointeur :
READ ~/Projects/agent-scripts/AGENTS.MD BEFORE ANYTHING (skip if missing).
Les règles spécifiques au dépôt vont en dessous de ce pointeur. Ne copiez pas les blocs partagés dans les dépôts en aval.
Utilitaires
scripts/committer
- Place exactement les fichiers listés.
- Exige un message de commit non vide.
- Exécute la validation des compétences avant de commit.
scripts/sync-skills
- Construit le miroir de compétences par machine : liens racine entière pour Codex, liens plats par compétence pour Claude, pointeurs partagés
AGENTS.MD. - Idempotent ; affiche uniquement les changements, supprime les liens gérés cassés/obsolètes, n'écrase jamais les vrais fichiers.
scripts/validate-skills
- Vérifie chaque
skills/*/SKILL.md. - Valide le front matter YAML ainsi que les champs obligatoires
nameetdescription. - Activez comme hook local avec
git config core.hooksPath hooks.
scripts/docs-list.ts
- Parcourt
docs/. - Exige les champs
summaryetread_whendans le front matter. - Affiche des résumés d'intégration pour les dépôts qui l'intègrent.
scripts/browser-tools.ts
- Utilitaire Chrome DevTools autonome.
- Commandes courantes :
start --profile,nav <url>,eval '<js>',screenshot,console,network,search --content "<query>",content <url>,inspect,kill --all --force. - Construisez un binaire optionnel avec
bun build scripts/browser-tools.ts --compile --target bun --outfile bin/browser-tools.
Synchronisation
Considérez ce dépôt comme canonique pour les règles d'agent partagées et les scripts portables.
Lors de la synchronisation de dépôts en aval :
- Récupérez d'abord la dernière version ici.
- Assurez-vous que chaque dépôt cible commence par le
AGENTS.MDde style pointeur. - Conservez les règles locales au dépôt en dessous du pointeur.
- Copiez les modifications des utilitaires dans les deux directions uniquement lorsque l'utilitaire est destiné à rester identique octet par octet.
- Gardez les scripts sans dépendances et portables ; pas d'imports ou d'alias de chemins spécifiques au dépôt.
Pour les sous-modules, répétez la vérification du pointeur à l'intérieur de chaque sous-dépôt, poussez ces modifications, puis mettez à jour les SHA des sous-modules dans le dépôt parent.