Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Centralize skillify command list in SKILL.md via build-step generator

Aperta
  • Qualcosa non va?
#175 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
64/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
node.js, typescript
Ambito
documentation

Direzione di ricerca

Inizia leggendo src/cli/skillify-spec.ts per confermare la sorgente SKILLIFY_COMMANDS e il formato di output di renderSkillifyCommands(). Esamina tests/pi/skillify-spec-drift.test.ts e gli script di build in package.json per seguire i pattern esistenti per i drift-test e i passaggi di build. Poi aggiungi o verifica i marker dei comandi nei tre file SKILL.md, implementa scripts/sync-md-commands.mjs, esegui npm run build e assicurati che i test in tests/ rilevino qualsiasi drift manuale di SKILL.md.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Context

PR #129 introduced SKILLIFY_COMMANDS in src/cli/skillify-spec.ts — the single source of truth for the hivemind skillify ... command list. As part of #129 we centralized all TypeScript-side consumers of that list:

  • 4 per-agent SessionStart inject blocks (claude-code, codex, cursor, hermes) via renderSkillifyCommands()
  • The pi inline mirror in pi/extension-source/hivemind.ts (guarded by a drift test in tests/pi/skillify-spec-drift.test.ts)
  • hivemind --help top-level output in src/cli/index.ts (centralized in #129 as part of the kaghni feedback)
  • hivemind skillify --help usage() in src/commands/skillify.ts (centralized in #129)

What remains hand-typed are the 3 shipped SKILL.md files:

  • claude-code/skills/hivemind-memory/SKILL.md — ## Skill Management (skillify) section
  • codex/skills/deeplake-memory/SKILL.md — same block
  • openclaw/skills/SKILL.md — same block (pre-dates #129, on main since April)

These can't be solved the same way as the TS callers because SKILL.md is shipped Markdown — it can't import TypeScript at runtime. We need a build-step generator.

Proposed approach

  1. Markers in each SKILL.md — wrap the command block in HTML-comment markers so the generator can locate it deterministically without ambiguity:

    <!-- SKILLIFY_COMMANDS_START -->
- `hivemind skillify` — show current scope...
...
<!-- SKILLIFY_COMMANDS_END -->

  2. Generator script — add scripts/sync-md-commands.mjs that:

    • Imports the compiled SKILLIFY_COMMANDS from bundle/cli.js (or dist/skillify-spec.js)
    • Renders the block in the same bullet format the SKILL.md files use today
    • Rewrites the content between <!-- SKILLIFY_COMMANDS_START --> / END in all 3 files

  3. Wire into npm run build — append node scripts/sync-md-commands.mjs to the build pipeline so the markdown can't drift in CI.

  4. Drift detection test — under tests/, mirror the structure of tests/pi/skillify-spec-drift.test.ts: read each SKILL.md, parse the block between markers, assert it matches what renderSkillifyCommands() would produce. Fails CI if a developer edits the markdown by hand and skips the build.

  5. Same pattern for ORG_COMMANDS (optional, can be a separate sub-task) — the org/auth command list (hivemind login, whoami, org list, …) is hand-typed in the same 3 SKILL.md files plus the per-agent SessionStart hooks. Extracting an ORG_COMMANDS constant and applying the same generator closes the symmetric debt.

Why a separate PR

  • Scope: #129 ships the hivemind skillify mine-local user-facing feature. Wiring a Markdown generator + drift test would tangle the build pipeline with the feature work and expand the review surface significantly.
  • Risk surface: A scripts/sync-md-commands.mjs + npm run build change touches CI and can break the release flow. Worth landing on its own branch where it's the focus.
  • Independence: This change has zero behavior impact on the mine-local feature — it's pure documentation upkeep.

Acceptance criteria

  • All 3 SKILL.md files have the skillify command block generated from SKILLIFY_COMMANDS
  • npm run build regenerates the blocks deterministically
  • Drift test fails if a SKILL.md block is edited by hand and not regenerated
  • Optionally: same applied to org/auth commands via ORG_COMMANDS

Reference

Lingua principale
TypeScript
Stelle
1.6k
Fork
112
Merge medio
19h 9m
PR unite (30g)
11

Preparare l'ambiente

  • Nessun Dockerfile né file Docker Compose
  • Ha un modello di pull request
  • Nessuna guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di activeloopai/hivemind

Tutte le issue di activeloopai/hivemind

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.