L'électron rare
131 lines
4.4 KiB
Markdown
131 lines
4.4 KiB
Markdown
# Kill LIFE Operator for VS Code
|
|
|
|
Extension VS Code orientee operationnel pour relier plusieurs projets locaux et piloter les agents comme un cockpit d'execution, de runbooks et de prochaines actions.
|
|
|
|
## Positionnement
|
|
|
|
`Kill LIFE Operator` est la version operationnelle du trio :
|
|
|
|
- `Studio` pour la construction produit.
|
|
- `Mesh` pour la coordination multi-repo.
|
|
- `Operator` pour l'execution, la supervision, les checks et les actions terrain.
|
|
|
|
## Ce que fait cette extension
|
|
|
|
- Scanne chaque projet ouvert dans le workspace, plus les racines ajoutees manuellement.
|
|
- Detecte par defaut `agents/*.md` et `.github/agents/*.md`.
|
|
- Affiche les agents trouves dans une sidebar dediee.
|
|
- Permet d'ouvrir un prompt agent, de le copier, ou de l'inserer dans l'editeur courant.
|
|
- Expose un participant de chat `@killops` avec des commandes `/agents`, `/pm`, `/architect`, `/firmware`, `/hw`, `/qa`, `/doc`.
|
|
|
|
Par defaut, `@killops` repond avec un biais operationnel : etat courant, checks, incidents, runbooks, priorite d'action et etapes executables.
|
|
|
|
## Demarrage rapide
|
|
|
|
```bash
|
|
npm install
|
|
npm run compile
|
|
npm run package:vsix
|
|
```
|
|
|
|
Ensuite dans VS Code :
|
|
|
|
1. Ouvre ce repo.
|
|
2. Lance `F5` pour ouvrir une fenetre d'extension development host.
|
|
3. Dans la nouvelle fenetre, ouvre ton vrai workspace projet.
|
|
4. Si besoin, ajoute d'autres depots via la commande `Kill LIFE Operator: Add Linked Project Root`.
|
|
|
|
## Utilisation
|
|
|
|
### Sidebar
|
|
|
|
La vue `Kill LIFE Operator` liste les projets detectes puis les agents trouves.
|
|
|
|
- Clic sur un agent : ouvre son fichier Markdown.
|
|
- Menu contextuel : copie ou insere le prompt.
|
|
|
|
### Chat
|
|
|
|
Dans le chat Copilot / agent de VS Code :
|
|
|
|
- `@killops /agents` : liste les projets et agents lies.
|
|
- `@killops /firmware` : aide a piloter l'execution cote firmware.
|
|
- `@killops /hw` : aide a cadrer les impacts hardware et les actions.
|
|
- `@killops /qa` : aide a definir checks, validations et evidence packs.
|
|
- `@killops /doc` : aide a produire runbooks, notes et passages de relais.
|
|
- `@killops` sans commande : agit comme cockpit operationnel.
|
|
|
|
## Installation
|
|
|
|
### Depuis un VSIX local
|
|
|
|
Le chemin recommande sur cette machine est l'installation via l'interface VS Code :
|
|
|
|
1. Genere le package avec `npm run package:vsix`.
|
|
2. Dans VS Code, ouvre `Extensions: Install from VSIX...`.
|
|
3. Selectionne `kill-life-operator-<version>.vsix`.
|
|
|
|
### Depuis le Marketplace
|
|
|
|
Les releases sont preparees pour le publisher `electron-rare`. Un tag `vX.Y.Z` publie automatiquement la meme archive `.vsix` sur GitHub Releases et sur le VS Code Marketplace des que le secret `VSCE_PAT` est disponible.
|
|
|
|
## Release automation
|
|
|
|
Le workflow [`.github/workflows/extension-ci.yml`](.github/workflows/extension-ci.yml) execute :
|
|
|
|
- Pull requests et pushes sur `main` : `npm ci`, `npm run check`, `npm run compile`, `npm run package:vsix`.
|
|
- Tags `v*` : verification `tag == v${package.json.version}`, creation de GitHub Release, puis publication Marketplace.
|
|
|
|
Sequence de release :
|
|
|
|
1. Mets a jour `package.json`.
|
|
2. Commit et merge sur `main`.
|
|
3. Cree un tag `vX.Y.Z` qui correspond exactement au champ `version`.
|
|
4. Pousse le tag.
|
|
|
|
## Marketplace setup
|
|
|
|
Avant la premiere publication Marketplace :
|
|
|
|
1. Cree le publisher `electron-rare` dans Visual Studio Marketplace / Azure DevOps.
|
|
2. Genere un Personal Access Token avec les permissions de publication Marketplace.
|
|
3. Ajoute ce token comme secret GitHub `VSCE_PAT` dans ce repo.
|
|
|
|
Commande utile :
|
|
|
|
```bash
|
|
gh secret set VSCE_PAT --repo electron-rare/kill-life-operator
|
|
```
|
|
|
|
## Local multi-root smoke test
|
|
|
|
Le workspace de reference est partage dans `../kill-life-studio/kill-life-local-smoke.code-workspace`.
|
|
|
|
Checklist de smoke test :
|
|
|
|
1. Installe les trois `.vsix` dans le meme profil VS Code.
|
|
2. Ouvre `../kill-life-studio/kill-life-local-smoke.code-workspace`.
|
|
3. Verifie les trois entrees d'activity bar.
|
|
4. Lance `Refresh Agents` dans chaque extension.
|
|
5. Confirme que les agents de `Kill_LIFE` et `Kill_LIFE/ai-agentic-embedded-base` sont visibles.
|
|
6. Ouvre le chat et verifie `@killops /agents`, puis `@killops /firmware` ou `@killops /qa`.
|
|
|
|
## Reglages
|
|
|
|
### `killLifeOperator.linkedProjectRoots`
|
|
|
|
Liste de chemins absolus supplementaires a scanner, en plus des dossiers deja ouverts dans le workspace.
|
|
|
|
### `killLifeOperator.agentSearchPatterns`
|
|
|
|
Globs utilises pour decouvrir les prompts d'agents dans chaque racine projet.
|
|
|
|
Valeurs par defaut :
|
|
|
|
```json
|
|
[
|
|
"agents/*.md",
|
|
".github/agents/*.md"
|
|
]
|
|
```
|