98 lines
5.6 KiB
Markdown
98 lines
5.6 KiB
Markdown
---
|
|
issueRef: "#282"
|
|
version: 3
|
|
updatedBy: {"kind":"agent","agent_id":"a6c6ea12-bfc6-4bdc-8031-324102dfa34d"}
|
|
updatedAt: 1788871877354
|
|
---
|
|
# Cadrage initial
|
|
|
|
Besoin utilisateur : les plugins IdeA doivent pouvoir apporter des skills et des tools MCP consommables par les agents, avec une configuration par projet. L'utilisateur veut un panneau Settings projet permettant de choisir quels plugins sont utilisés dans ce projet, puis d'attribuer les skills/tools de ces plugins aux agents, comme les skills IdeA et les tools MCP IdeA.
|
|
|
|
# Décision produit proposée
|
|
|
|
Modèle en trois niveaux :
|
|
|
|
1. Plugin installé globalement dans IdeA.
|
|
2. Plugin activé explicitement pour un projet.
|
|
3. Skills/tools du plugin attribués explicitement à un agent du projet.
|
|
|
|
Un plugin installé globalement ne rend pas automatiquement ses capabilities disponibles partout. L'activation projet rend les capabilities visibles/attribuables ; l'attribution agent décide ce que l'agent peut réellement utiliser.
|
|
|
|
# Contrainte multi-harness
|
|
|
|
La feature doit être IdeA-native et fonctionner pour tous les harness/profils supportés par IdeA : Claude Code, Codex, OpenCode local/cloud, et futurs adapters. Elle ne doit pas dépendre d'un mécanisme propre à Codex, ni de `.codex-plugin/plugin.json`, ni d'un dossier `$CODEX_HOME`.
|
|
|
|
Le contrat attendu : IdeA résout les plugins activés pour le projet et les assignments de l'agent, puis projette les capabilities effectives dans la surface adaptée à chaque harness :
|
|
|
|
- Claude Code : convention file / contexte injecté + MCP config selon les mécanismes déjà projetés pour Claude.
|
|
- Codex : AGENTS.md/contexte injecté + config MCP Codex selon les mécanismes déjà projetés pour Codex.
|
|
- OpenCode : contexte/config OpenCode selon les mécanismes déjà projetés pour OpenCode.
|
|
|
|
`idea_skill_read(name)` doit rester une API IdeA, pas une API Codex : elle lit les skills effectivement assignés à l'agent quelle que soit son implémentation de harness, dès lors que ce harness dispose du pont/outillage IdeA correspondant. En mode sans MCP, conserver les stratégies existantes de projection fichier/contexte.
|
|
|
|
# UX recommandé
|
|
|
|
Ajouter `Settings projet > Plugins` :
|
|
|
|
- liste des plugins installés globalement ;
|
|
- toggle `Activé pour ce projet` ;
|
|
- résumé des capabilities : `N skills`, `N tools MCP`, etc. ;
|
|
- détail `Voir les capabilities` avec sections `Skills fournis`, `Tools MCP fournis` ;
|
|
- dans la configuration agent, section `Capabilities de plugins`, groupée par plugin, séparée de `Skills IdeA` et `Tools MCP IdeA`.
|
|
|
|
Libellés à préserver :
|
|
|
|
- `Installé globalement` = existe dans IdeA ;
|
|
- `Activé pour ce projet` = chargé/exposé dans ce projet ;
|
|
- `Attribué à l'agent` = utilisable par cet agent.
|
|
|
|
# Architecture recommandée
|
|
|
|
Étendre `idea-plugin.json` avec `contributes.skills` read-only, package-relative, par exemple :
|
|
|
|
```json
|
|
{
|
|
"capabilities": ["ui", "mcp", "tooling"],
|
|
"contributes": {
|
|
"skills": [
|
|
{
|
|
"id": "unity.build-debug",
|
|
"name": "unity-build-debug",
|
|
"description": "Diagnose Unity build failures.",
|
|
"kind": "workflow",
|
|
"path": "skills/unity-build-debug/SKILL.md"
|
|
}
|
|
],
|
|
"mcpServers": [
|
|
{
|
|
"id": "unity-tools",
|
|
"displayName": "Unity Tools",
|
|
"command": "dist/mcp-server.js",
|
|
"transport": "stdio",
|
|
"autoStart": true
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
Créer un document projet versionné dédié, par exemple `.ideai/project-plugins.json`, séparé du registry global plugin et des agents natifs. Il stocke plugins activés et assignments agent vers `{ source: "plugin", pluginId, skillId/serverId/toolName }`.
|
|
|
|
Au lancement agent : charger agent + settings projet plugins + plugins activés, vérifier état installed/runtime-active/hash, résoudre skills natifs + plugin skills assignés, injecter seulement le manifeste `# Skills disponibles`, et faire en sorte que `idea_skill_read(name)` lise uniquement les skills effectivement assignés à cet agent.
|
|
|
|
Pour MCP tools plugin : garder la policy existante, namespace stable des tools plugin (`{ pluginId, serverId, toolName }`) et refuser l'exécution si non autorisé dans les permissions effectives de l'agent. La projection MCP doit passer par les adapters déjà responsables de chaque harness, pas par une configuration spécifique à Codex.
|
|
|
|
# Contraintes
|
|
|
|
- Hot reload plugin doit relire `contributes.skills` et `contributes.mcpServers`, publier `plugin_reloaded`, recalculer le catalogue projet effectif et marquer les assignments cassés `missing/stale` sans les supprimer.
|
|
- Uninstall global conserve des tombstones projet/agent, pour éviter de perdre une config lors d'un uninstall temporaire.
|
|
- Scope cross-project : un plugin installé est global, mais son usage est project-scoped ; `idea_project_ask_agent` utilise uniquement les assignments du projet cible.
|
|
- Ne pas mélanger avec `.codex-plugin/plugin.json` : cette feature est IdeA-native et multi-harness. Les skills Codex bundlés restent hors contrat tant qu'un pont explicite n'est pas conçu.
|
|
|
|
# Découpage proposé
|
|
|
|
B1 Domaine : contributions skills plugin, settings projet plugins, refs skills/tools plugin, validation.
|
|
B2 Infrastructure : validator manifest, store `.ideai/project-plugins.json`, lecture package-relative des SKILL.md, catalogue tools plugin.
|
|
B3 Application : use cases settings/assignments, resolver skills, `idea_skill_read`, lancement agent, permissions MCP dynamiques avec projection par harness.
|
|
F1 Frontend : Settings projet > Plugins, détail plugin, attribution agent, catalogue permissions groupé.
|
|
QA : validator, store, injection/read-skill sur Claude Code/Codex/OpenCode, permissions MCP par harness, hot reload, uninstall tombstones. |