bolbol
/
nas-runbooks
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: runbook skills n8n officiels + maj _INDEX

This commit is contained in:
mcp-nas-deploy 2026-07-10 00:23:32 +00:00
parent f7fcb54b67
commit 23b2b21381
2 changed files with 34 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
_INDEX.md
View File

@ -10,6 +10,7 @@
| Runbook | Date | Tags | | Runbook | Date | Tags |
|---------|------|------| |---------|------|------|
| [Skills n8n officiels (n8n-io/skills) — socle 14 skills, tap auto 3 instances](common/n8n-skills-officiels.md) | 2026-07-10 | n8n, skills, hermes, tap |
| [PROTOCOL-INFRA — règles opérationnelles](common/PROTOCOL-INFRA.md) | maj continue | infra, protocole | | [PROTOCOL-INFRA — règles opérationnelles](common/PROTOCOL-INFRA.md) | maj continue | infra, protocole |
| [Ports Registry NAS (source de vérité services — miroir de /volume1/docker/ports-registry.md)](common/ports-registry.md) | 2026-07-04 | infra, ports, registry | | [Ports Registry NAS (source de vérité services — miroir de /volume1/docker/ports-registry.md)](common/ports-registry.md) | 2026-07-04 | infra, ports, registry |
| [mcp-nas — référence opérationnelle consolidée (run_command v2, contraintes post-audit)](common/mcp-nas-reference.md) | 2026-07-09 | infra, mcp-nas, scripting | | [mcp-nas — référence opérationnelle consolidée (run_command v2, contraintes post-audit)](common/mcp-nas-reference.md) | 2026-07-09 | infra, mcp-nas, scripting |
@ -119,4 +120,4 @@
- **Fusionnés** : MCP-NAS-SCRIPTING + mcp-nas-run-command-v2 → `mcp-nas-reference.md` · OPENCODE-GO-MIGRATION + migration-provider-opencode-go → `opencode-go-migration.md` · BIFROST-VK-OPENCODE-FIX + bifrost-vk-stale-cache → `bifrost-vk-incidents.md` · nyora-doc-api-footer-bug-docx + nyora-doc-api-rebuild-footer-docx → `nyora-doc-api-rebuild.md` (footers supprimés de tous les formats le 08/07). - **Fusionnés** : MCP-NAS-SCRIPTING + mcp-nas-run-command-v2 → `mcp-nas-reference.md` · OPENCODE-GO-MIGRATION + migration-provider-opencode-go → `opencode-go-migration.md` · BIFROST-VK-OPENCODE-FIX + bifrost-vk-stale-cache → `bifrost-vk-incidents.md` · nyora-doc-api-footer-bug-docx + nyora-doc-api-rebuild-footer-docx → `nyora-doc-api-rebuild.md` (footers supprimés de tous les formats le 08/07).
- **Supprimés (obsolètes)** : gotenberg-pdf.md (container désinstallé 21/06), ports-registry.md dupliqué à la racine (identique à common/), hermes-nyora/_INDEX.md (sous-index abandonné). - **Supprimés (obsolètes)** : gotenberg-pdf.md (container désinstallé 21/06), ports-registry.md dupliqué à la racine (identique à common/), hermes-nyora/_INDEX.md (sous-index abandonné).
- **Re-sphérés depuis common/** : hermes-perso-SOUL-veille-ingest → hermes-perso/ (données familiales) · kanban-evaluateur-ao → hermes-tt/ · veille-hebdo-nyora, workflow-claude-glm-nyora, veille-dr-nexum-cron-timezone-publish-n8n → hermes-nyora/. - **Re-sphérés depuis common/** : hermes-perso-SOUL-veille-ingest → hermes-perso/ (données familiales) · kanban-evaluateur-ao → hermes-tt/ · veille-hebdo-nyora, workflow-claude-glm-nyora, veille-dr-nexum-cron-timezone-publish-n8n → hermes-nyora/.

32
common/n8n-skills-officiels.md Normal file
View File

@ -0,0 +1,32 @@
# Runbook — Skills n8n officiels (socle best-practices)
**Date** : 2026-07-10 | **Instance** : Toutes (common) | **Statut** : Déployé
## Objectif
Ajouter le pack officiel `n8n-io/skills` (Apache-2.0) comme socle générique de qualité pour la construction/édition de workflows n8n par les 3 instances Hermes, via le tap Gitea existant.
## Ce qui a été fait
- Import de 14 skills (13 capacités + meta-routeur `using-n8n-skills-official`) + 51 références dans `bolbol/hermes-skills/skills/`, commit `c67e1517`.
- Attribution Apache-2.0 dans `skills/_n8n-official/` (LICENSE + ATTRIBUTION.md).
- **Non importé** : hooks SessionStart/PreToolUse (spécifiques Claude Code, non portables OpenCode Go) et `plugins/` (duplicata). Le lazy-loading est déjà assuré nativement par le système de taps (vercel-labs/skills lit chaque SKILL.md par son frontmatter `description`).
## Distribution (tap déjà en place)
`taps.json` des 3 instances pointe déjà `http://172.17.0.1:3232/bolbol/hermes-skills.git` path `skills/`. Aucune modif de taps.json nécessaire.
**Activation** : au prochain refresh du tap (nouvelle session agent / restart container `hermes-workspace-*`). Pas de rebuild.
## Articulation avec n8n-bolbol (préséance)
Les `-official` = socle générique. `n8n-bolbol` (surcouche infra) **PRIME** en cas de divergence :
- LLM via Bifrost (`x-bf-vk`), jamais opencode.ai
- Appels internes : Baserow via header `Host`, `gitea:3000`
- Code nodes VM Node.js 24 : `require('https')`, pas de `fetch`/`$helpers`/`new URL`
- `publish_workflow` obligatoire après `update_workflow`
→ À faire (proposé, non appliqué) : ajouter en tête de `n8n-bolbol/SKILL.md` un pointeur "socle = skills n8n-*-official, ce skill les précise".
## Pièges rencontrés (capitalisation)
- **git absent** du container mcp-nas ET du NAS → tout passe par l'**API HTTP Gitea** (change-files multi-fichiers, Gitea 1.21.11 : `POST /contents` avec `files:[]` = 1 commit propre).
- **Ancien password `bolbol` (`2L2u519wgitea`) périmé → 401.** Utiliser `GITEA_DEPLOY_TOKEN` (scope write:repository, audit sécu 08/07) du `.env`, header `Authorization: token <TOK>`.
- **SSH `Best0f` par mot de passe échoue** (clé absente dans mcp-nas, `SSHPASS` env ≠ mot de passe Best0f). Contournement : accès fichiers direct via le mount **`/mnt/docker` = `/volume1/docker`** ; opérations Git via API.
- Téléchargement d'un repo externe sans git : `curl -L <tarball GitHub> | tar xz` (egress ouvert depuis mcp-nas).
## Tags
infra, n8n, skills, hermes, tap, gitea-api