Build Workspace Docs
Regeneruje README.md a WORK_AREAS.md v pracovním prostoru knihovny ai-agent-skills pomocí CLI
Funguje s nastavením
Co umí
Obaluje příkaz `build-docs` CLI `ai-agent-skills` pro regeneraci souborů README.md a WORK_AREAS.md spravovaného pracovního prostoru knihovny dovedností ze skills.json, takže tabulky polic, počty dovedností a zdrojové tabulky odpovídají katalogu. Spouští se, když uživatel požádá o přestavbu nebo resynchronizaci generované dokumentace pracovního prostoru knihovny ai-agent-skills po přidání, importu nebo kurátorství dovedností. Vyžaduje Node/npx a inicializovaný pracovní prostor obsahující .ai-agent-skills/config.json.
Testovací report
Vytvořil jsem skutečný pracovní prostor v dočasném HOME (`npx ai-agent-skills@4.3.2 init-library demo-lib --areas "frontend,workflow"`, importoval dvě „house-copy“ dovednosti, poté přidal třetí záznam do katalogu do skills.json, aby se dokumentace stala zastaralou), zkopíroval jsem ho dvakrát a vytvořil dva artefakty: základní, kde jsem ručně upravil README.md/WORK_AREAS.md, a artefakt dovednosti z předepsaného toku CLI. Generovaná dokumentace se lišila od mé ruční úpravy na dvou odvozených řádcích — statistiky README „3 house copies · 0 cataloged upstream“ vs mé „2 house copies · 1 cataloged upstream“, a zdrojová buňka WORK_AREAS „workspace“ vs mé „upstream/seo-pack“ — tj. CLI správně odvodilo úroveň/autora ze skills.json, kde jsem se mýlil, a druhý běh byl byte-identický (idempotentní). Nicméně kroky 1 a 3 dovednosti (`build-docs --dry-run` a `--dry-run --format json`) oba skončily s chybou 1 a zprávou „ENOENT ... /opt/homebrew/lib/node_modules/ai-agent-skills/WORK_AREAS.md“; publikovaný tarball 4.3.2 neobsahuje WORK_AREAS.md (vyloučeno .npmignore a package.json files[]), a cli.js:6846 předává kontext pracovního prostoru jako objekt možností, takže `generatedDocsAreInSync` se vrací k rootu balíčku. Vynucení spuštění proti opravené kopii balíčku ukázalo, že dokumentované pole `currentlyInSync` se porovnává s vlastním README upstream repozitáře namísto pracovního prostoru, hlásí readmeMatches:false hned po úspěšné regeneraci. Frontmatter má name+description, nejsou odkazovány žádné skripty ani balené soubory a nenašel jsem žádné bezpečnostní nedostatky (žádné curl|sh, base64, přístup k pověřením ani injekční text) v 52řádkovém SKILL.md.
Testováno: 2026-07-21 · Claude Code 2.x (agent harness)
Instalace
git clone --depth 1 https://github.com/MoizIbnYousaf/Ai-Agent-Skills.git /tmp/build-workspace-docs-src mkdir -p ~/.claude/skills cp -R /tmp/build-workspace-docs-src/skills/build-workspace-docs ~/.claude/skills/build-workspace-docs # Runtime dependency (not stated in SKILL.md): Node.js + network for `npx ai-agent-skills`. # Only usable inside a workspace created by: npx ai-agent-skills init-library <name> # Alternative install via the project's own CLI: npx ai-agent-skills install build-workspace-docs # KNOWN BREAKAGE (verified on ai-agent-skills@4.3.2): steps 1 and 3 of the skill body # (`build-docs --dry-run` and `build-docs --dry-run --format json`) exit 1 with # "ENOENT ... node_modules/ai-agent-skills/WORK_AREAS.md" because that file is # excluded from the published npm tarball. Run the bare `npx ai-agent-skills build-docs` instead.
Příkazy a ukázkové prompty
/build-workspace-docsRegeneruje README.md a WORK_AREAS.md v pracovním prostoru knihovny ai-agent-skills pomocí CLI
Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):
Regenerate the README for this workspaceUpdate WORK_AREAS.md to reflect current skillsPreview doc changes before regenerating them