L'électron rare
130 lines
4.5 KiB
Markdown
130 lines
4.5 KiB
Markdown
# Kill LIFE Studio for VS Code
|
|
|
|
Extension VS Code orientee produit pour relier plusieurs projets locaux, reutiliser leurs prompts agents et transformer des idees en specs, cadrage UX et roadmap.
|
|
|
|
## Positionnement
|
|
|
|
`Kill LIFE Studio` est la version produit du trio :
|
|
|
|
- `Studio` pour le cadrage produit, les specs, la narration, le scope et la clarte des livrables.
|
|
- `Mesh` pour l'orchestration multi-repo et les handoffs.
|
|
- `Operator` pour l'execution et l'operationnel.
|
|
|
|
## 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 `@killstudio` avec des commandes `/agents`, `/pm`, `/architect`, `/firmware`, `/hw`, `/qa`, `/doc`.
|
|
|
|
Par defaut, `@killstudio` repond avec un biais produit : besoins, priorisation, experience, spec-first et plan d'execution.
|
|
|
|
## 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 Studio: Add Linked Project Root`.
|
|
|
|
## Utilisation
|
|
|
|
### Sidebar
|
|
|
|
La vue `Kill LIFE Studio` 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 :
|
|
|
|
- `@killstudio /agents` : liste les projets et agents lies.
|
|
- `@killstudio /pm` : route la demande avec le prompt PM.
|
|
- `@killstudio /architect` : route la demande avec le prompt architecture.
|
|
- `@killstudio /doc` : route la demande avec le prompt documentation.
|
|
- `@killstudio` sans commande : agit comme studio produit relie aux agents du projet actif.
|
|
|
|
## Installation
|
|
|
|
### Depuis un VSIX local
|
|
|
|
Le CLI `code` n'est pas expose sur le `PATH` de cette machine. Le chemin recommande pour les tests locaux est 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-studio-<version>.vsix`.
|
|
|
|
### Depuis le Marketplace
|
|
|
|
La publication cible le publisher `electron-rare`. Une fois le publisher cree et le secret `VSCE_PAT` configure dans GitHub, chaque tag `vX.Y.Z` publie automatiquement la meme archive `.vsix` sur GitHub Releases et sur le VS Code Marketplace.
|
|
|
|
## Release automation
|
|
|
|
Le workflow [`.github/workflows/extension-ci.yml`](.github/workflows/extension-ci.yml) couvre les cas suivants :
|
|
|
|
- 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 pour enregistrer le secret depuis un terminal authentifie GitHub :
|
|
|
|
```bash
|
|
gh secret set VSCE_PAT --repo electron-rare/kill-life-studio
|
|
```
|
|
|
|
## Local multi-root smoke test
|
|
|
|
Le workspace canonique de validation locale est [`kill-life-local-smoke.code-workspace`](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-local-smoke.code-workspace`.
|
|
3. Verifie les trois entrees d'activity bar : Studio, Mesh, Operator.
|
|
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 `@killstudio /agents`, puis `@killstudio /pm`.
|
|
|
|
## Reglages
|
|
|
|
### `killLifeStudio.linkedProjectRoots`
|
|
|
|
Liste de chemins absolus supplementaires a scanner, en plus des dossiers deja ouverts dans le workspace.
|
|
|
|
### `killLifeStudio.agentSearchPatterns`
|
|
|
|
Globs utilises pour decouvrir les prompts d'agents dans chaque racine projet.
|
|
|
|
Valeurs par defaut :
|
|
|
|
```json
|
|
[
|
|
"agents/*.md",
|
|
".github/agents/*.md"
|
|
]
|
|
```
|