Mentionner des fichiers et invoquer des skills depuis le composer

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

# Mentionner des fichiers et invoquer des skills depuis le composer

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)).

## Mentionner un fichier avec `@`

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.
2. Déplacez-vous avec **↑ / ↓**, choisissez avec **Entrée** ou **Tab** (ou en cliquant). La mention devient `@src/main.go ` dans le texte.
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.

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.

## Invoquer un skill ou une commande avec `/`

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**).
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.

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.

## Variantes

- 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.
- Les skills sont listés à la première ouverture de la liste ; ajoutez un skill sur disque et rechargez la page pour le voir.

## Voir aussi

- Format d'échange des `attachments` : [référence du protocole WebSocket](../reference/websocket-protocol.md)
- Les endpoints de recherche et de skills : [référence de l'API workspace](../reference/workspace-api.md)