forked from bots-garden/ori
| ✨ Workspace panel, selectors, previews, desktop app, sandbox template, resizable file tree, light/dark theme | 1 | # Mentionner des fichiers et invoquer des skills depuis le composer |
| 2 | ||
| 3 | Ce guide montre comment désigner des fichiers du workspace à l'agent avec `@` et comment invoquer un skill ou une commande slash de Claude Code avec `/`, directement depuis le composer de messages. Il suppose qu'Ori tourne (voir le [tutoriel de premiers pas](../tutorials/getting-started.md)). | |
| 4 | ||
| 5 | ## Mentionner un fichier avec `@` | |
| 6 | ||
| 7 | 1. Dans le composer, tapez `@` en début de message ou après une espace. Une liste des fichiers du workspace apparaît ; continuez à taper pour filtrer — `@main` trouve `src/main.go` et `src/server/main_test.go`, et un fragment de nom de répertoire fonctionne aussi. | |
| 8 | 2. Déplacez-vous avec **↑ / ↓**, choisissez avec **Entrée** ou **Tab** (ou en cliquant). La mention devient `@src/main.go ` dans le texte. | |
| 9 | 3. Envoyez comme d'habitude. L'agent reçoit le texte plus un `resource_link` vers le fichier (`file:///…/src/main.go`), que l'adaptateur Claude Code transforme en référence de fichier que le modèle peut ouvrir. | |
| 10 | ||
| 11 | Si vous effacez une mention avant d'envoyer, sa pièce jointe disparaît aussi ; un `@` collé à un mot (`me@example.com`) n'ouvre jamais la liste. **Échap** ferme la liste pour la mention en cours. | |
| 12 | ||
| 13 | ## Invoquer un skill ou une commande avec `/` | |
| 14 | ||
| 15 | 1. Tapez `/` comme **premier** caractère du message. La liste présente, triés par nom, les skills trouvés dans `<cwd>/.claude/skills/` et `~/.claude/skills/` (étiquetés **skill**, avec la description de leur `SKILL.md`) et les commandes slash annoncées par l'agent via ACP (étiquetées **command**). | |
| 16 | 2. Filtrez par nom ou description, choisissez avec **Entrée** / **Tab** : le texte devient `/quality `. Ajoutez des arguments si le skill en prend, puis envoyez. | |
| 17 | ||
| 18 | Le skill est invoqué comme Claude Code l'invoque : c'est le texte `/quality …` qui part, il n'existe pas de méthode ACP séparée. Un `/` ailleurs dans le message est du texte ordinaire. | |
| 19 | ||
| 20 | ## Variantes | |
| 21 | ||
| 22 | - Avec l'agent mock (`make run-mock`), la liste `/` montre deux commandes de démonstration (`review`, `compact`) et la réponse reprend chaque fichier joint sous la forme `[attached: <nom>]` — pratique pour vérifier la plomberie sans Claude. | |
| 23 | - Les skills sont listés à la première ouverture de la liste ; ajoutez un skill sur disque et rechargez la page pour le voir. | |
| 24 | ||
| 25 | ## Voir aussi | |
| 26 | ||
| 27 | - Format d'échange des `attachments` : [référence du protocole WebSocket](../reference/websocket-protocol.md) | |
| 28 | - Les endpoints de recherche et de skills : [référence de l'API workspace](../reference/workspace-api.md) |