Trae

Éditeur : ByteDance Nom d'installation : trae Statut : GA Configuration native : <project>/.trae/rules/apothem-rules.md

InstallationCopy Anchor Link

apothem install --harness trae --project /path/to/project

L'adaptateur écrit un fichier de règles Trae de portée projet à partir des règles partagées d'Apothem et de la surface de gouvernance, et écrit les auxiliaires d'Apothem en tant que subagents Trae dans le projet (voir Subagents).

Il écrit aussi les skills d'Apothem, ainsi que les règles et templates qu'ils citent, dans votre répertoire personnel, avant de toucher au projet (voir Fichiers hors du projet).

Fichiers écrits :

• <project>/.trae/rules/apothem-rules.md, le fichier de règles.
• <project>/.trae/agents/<name>.md pour chaque auxiliaire Apothem, dans le projet.
• ~/.trae/skills/<name>/SKILL.md pour chaque skill et chaque commande Apothem, dans votre répertoire personnel.
• ~/.config/apothem/rules/ et ~/.config/apothem/templates/, dans votre répertoire personnel.

Fichiers hors du projetCopy Anchor Link

L'installation écrit aussi les skills d'Apothem dans votre répertoire personnel, avant de modifier quoi que ce soit dans le projet :

Ces dossiers sont partagés. Ils ne sont pas propres au projet :

• Chaque projet dans lequel vous installez trae utilise la même copie de ~/.trae/skills/, et l'installation y écrit les mêmes fichiers à chaque fois. Trae est le seul outil qui lit ce dossier. Les règles et templates sous ~/.config/apothem/ sont également écrits par les installations des autres outils, avec les mêmes fichiers.
• --project choisit le fichier de règles à écrire et le projet auquel l'installation appartient. Il ne change pas l'emplacement des skills.
• L'installation n'ajoute aucun fichier de skill ni de règle à votre dépôt. Le projet reçoit le fichier de règles et les fichiers de subagents dans .trae/agents/, plus le dossier de données .apothem/ que crée toute installation de projet.
• Les dossiers du répertoire personnel sont écrits en premier. Si cela échoue, par exemple parce qu'un dossier du chemin est un lien qui sort de votre répertoire personnel (un lien qui reste à l'intérieur est suivi) ou ne peut pas être écrit, l'installation s'arrête avec l'erreur avant que quoi que ce soit ne change dans le projet.
• Un dossier de skill portant le nom d'un skill Apothem qu'Apothem n'a pas écrit est laissé tel quel, et l'installation affiche un avertissement qui le nomme. Renommez-le ou déplacez-le, puis exécutez apothem update. apothem verify échoue tant que ce nom est occupé.
• Les fichiers totalisent quelques mégaoctets.

L'installation affiche une note qui nomme les dossiers qu'elle écrit hors de --project, et --dry-run les liste.

SubagentsCopy Anchor Link

Trae lit un subagent depuis un fichier Markdown dans <project>/.trae/agents/, selon la documentation des subagents de Trae. L'installation écrit un fichier par auxiliaire Apothem dans ce dossier. Elle installe pour le projet uniquement : la documentation donne comme dossier de niveau utilisateur ~/.trae-cn/agents/ alors que tous les autres dossiers utilisateur de Trae se trouvent sous ~/.trae/, et Apothem n'a pas confirmé lequel une installation internationale lit ; elle n'écrit donc ni l'un ni l'autre.

Chaque fichier conserve les instructions de l'auxiliaire inchangées et porte ces clés de frontmatter :

Seuls les noms d'outils figurant sur la page des subagents de Trae sont écrits :

Bash, Edit, Glob, Grep, Read, Skill, TodoWrite, WebFetch, WebSearch, Write, LSP

Un outil nommé par la source qui ne figure pas dans cette liste (par exemple MultiEdit ou PowerShell) est omis des deux champs. Un outil avec un motif, comme Bash(rm *), n'a pas de forme dans une liste séparée par des virgules : en tant qu'outil autorisé, il est omis, et en tant qu'outil refusé, il refuse l'outil entier. Un auxiliaire qui ne peut pas éditer de fichiers conserve cette limite : il ne liste ni Write ni Edit parmi ses outils et refuse les deux. Trae ne documente aucune limite de tours, donc le maxTurns de l'auxiliaire n'est pas écrit. L'installation n'écrit aucune clé model, de sorte qu'un auxiliaire utilise le modèle choisi dans la zone de chat, ni aucune clé mcpServers.

À savoir :

• La documentation anglaise de Trae indique d'activer Settings > Beta > Subagents > Enable Subagents Directory avant qu'il ne charge .trae/agents/. Sa page chinoise, mise à jour plus tard, indique que la fonctionnalité est généralement activée par défaut. Si Trae ne liste aucun des auxiliaires, vérifiez ce commutateur.
• Les fichiers de subagents sont des fichiers de projet ordinaires. Commitez-les avec le projet ou listez .trae/agents/ dans .gitignore ; Apothem ne choisit pas à votre place.
• Un fichier à vous portant le nom d'un auxiliaire Apothem est enregistré sous ~/.apothem/backups/ puis remplacé. La désinstallation ne le remet pas en place. Les fichiers portant d'autres noms ne sont jamais touchés.
• La documentation de Trae ne dit pas comment il traite une clé de frontmatter qu'elle ne liste pas, ni si .trae/agents/ s'applique dans la seconde fenêtre du « all-new TRAE » fusionné comme dans la fenêtre de l'IDE.

Correspondance entre le profil et la configuration nativeCopy Anchor Link

L'adaptateur lit le profil partagé d'Apothem et rend le fichier de règles du projet à chaque exécution de apothem install ou de apothem update. Le profil partagé est la source de vérité ; les modifications locales au projet apportées au fichier généré sont sauvegardées avant que la synchronisation suivante ne remplace le contenu géré par Apothem.

Le fichier s'ouvre sur un frontmatter YAML qui définit alwaysApply: true et une description, ce qui correspond au mode Always Apply de Trae selon la documentation des règles de Trae. Le bloc géré par Apothem le suit ; le texte que vous ajoutez après le bloc est conservé à chaque synchronisation.

Notes de compatibilitéCopy Anchor Link

La surface de règles actuelle de Trae a une portée de projet, sous .trae/rules/ ; les règles globales se trouvent sous ~/.trae/user_rules. L'adaptateur écrit un fichier dédié, apothem-rules.md, et n'écrase jamais les autres fichiers de règles de ce répertoire ni vos règles globales. La surface de serveurs d'outils .trae/mcp.json et la surface de skills .trae/skills/ du projet sont détenues par l'opérateur ; Apothem ne les écrit pas.

Trae documente ~/.trae/skills/ pour les skills globaux. Il ne lit le dossier inter-outils .agents/skills/ qu'après activation du paramètre Enable .agents Skills Directory ; l'installation écrit donc le dossier Trae. L'édition chinoise (TRAE CN) documente ~/.trae-cn/skills/ à la place ; son journal des modifications indique que les répertoires de skills globaux de TRAE CN et de l'édition internationale sont compatibles, pour l'édition personnelle uniquement. L'installation écrit ~/.trae/skills/ uniquement, et Apothem n'a pas confirmé si les autres éditions de TRAE CN le lisent. Apothem n'a pas non plus confirmé comment Trae traite une clé d'en-tête de SKILL.md qu'il ne liste pas.

VérificationCopy Anchor Link

apothem verify --harness trae --project /path/to/project

La commande verify confirme que :

1. La configuration native existe au chemin attendu.
2. Chaque cible gérée existe, y compris le dossier .trae/agents/ ; les fichiers gérés ne sont pas vides, et les configurations JSON ou YAML s'analysent correctement. Ajoutez --profile PATH pour vérifier en plus que les fichiers installés correspondent à ce profil. Pour .trae/agents/, la vérification porte sur l'existence du dossier, et non sur la présence de chaque fichier d'auxiliaire ; la commande apothem diff --harness trae --project /path/to/project liste les fichiers d'auxiliaires manquants ou obsolètes.
3. Chaque dossier de skill Apothem est en place avec un SKILL.md, quelle que soit l'installation qui l'a écrit, et aucun dossier de skill portant un nom Apothem n'appartient à quelque chose qu'Apothem n'a pas écrit. Une vérification en échec nomme les dossiers manquants ou étrangers.
4. La routine de vérification propre à l'adaptateur signale un succès.

Mise à jourCopy Anchor Link

apothem update --harness trae --project /path/to/project

Redérive le fichier de règles du projet à partir de l'état actuel du profil partagé.

La mise à jour réécrit aussi tout dossier de skill dont les fichiers diffèrent des fichiers actuels. Si vous avez installé avec une version antérieure qui n'écrivait aucun skill, la mise à jour les ajoute. Elle réécrit les fichiers de subagents qui diffèrent des fichiers actuels, et ajoute ceux qui manquent.

DésinstallationCopy Anchor Link

apothem uninstall --harness trae --project /path/to/project

Supprime le bloc Apothem, ainsi que le frontmatter qu'Apothem a écrit au-dessus, de <project>/.trae/rules/apothem-rules.md et conserve tout autre texte qu'il contient. Le fichier n'est supprimé que si rien d'autre n'y subsiste. Avant la modification, une copie horodatée du fichier est enregistrée sous ~/.apothem/backups/ ; aucun fichier de sauvegarde n'est laissé dans le projet. Le YAML du profil partagé et le moteur Apothem ne sont pas affectés.

La désinstallation supprime aussi les fichiers de subagents qu'elle a écrits dans <project>/.trae/agents/ et conserve tout autre fichier qui s'y trouve ; le dossier est supprimé lorsqu'il reste vide. Elle supprime les dossiers de skills qu'elle a écrits dans ~/.trae/skills/ ainsi que les règles et templates de ~/.config/apothem/, mais seulement si aucune autre installation Apothem ne les utilise encore. Un autre projet, ou un autre outil qui partage le dossier, peut les utiliser. Dans ce cas, la désinstallation conserve les dossiers, affiche quelle installation les utilise, et la dernière désinstallation les supprime. Les fichiers que vous avez ajoutés à ces dossiers restent, et un dossier laissé vide est supprimé. Chaque dossier est sauvegardé sous ~/.apothem/backups/ avant d'être supprimé.

Portail de conformitéCopy Anchor Link

python -m apothem.conformity.gate --all .

DépannageCopy Anchor Link

Paramètres de configurationCopy Anchor Link

Voir aussiCopy Anchor Link

• Tous les environnements — le catalogue complet des outils pris en charge
• Guide d'installation — installer Apothem dans cet environnement
• Référence de apothem harnesses — lister et inspecter les adaptateurs depuis la CLI