Build Workspace Docs
Regeneruje README.md i WORK_AREAS.md w przestrzeni roboczej biblioteki ai-agent-skills za pomocą CLI
Działa po konfiguracji
Co robi ten skill
Opakowuje polecenie `build-docs` CLI `ai-agent-skills` w celu regeneracji plików README.md i WORK_AREAS.md zarządzanej przestrzeni roboczej biblioteki umiejętności z skills.json, tak aby tabele półek, liczniki umiejętności i tabele źródeł odpowiadały katalogowi. Uruchamia się, gdy użytkownik prosi o przebudowę lub ponowną synchronizację wygenerowanej dokumentacji przestrzeni roboczej biblioteki ai-agent-skills po dodaniu, zaimportowaniu lub kuracji umiejętności. Wymaga Node/npx i zainicjowanej przestrzeni roboczej zawierającej .ai-agent-skills/config.json.
Raport z testu
Zbudowano prawdziwą przestrzeń roboczą w tymczasowym HOME (`npx ai-agent-skills@4.3.2 init-library demo-lib --areas "frontend,workflow"`, zaimportowano dwie umiejętności house-copy, a następnie dodano trzeci wpis katalogowy do skills.json, aby dokumentacja stała się nieaktualna), skopiowano ją dwukrotnie i wyprodukowano dwa artefakty: bazowy, w którym ręcznie edytowałem README.md/WORK_AREAS.md, oraz artefakt umiejętności z przepisanego przepływu CLI. Wygenerowana dokumentacja różniła się od mojej ręcznej edycji w dwóch wywnioskowanych liniach — statystyki README „3 house copies · 0 cataloged upstream” vs moje „2 house copies · 1 cataloged upstream”, oraz komórka źródłowa WORK_AREAS „workspace” vs moje „upstream/seo-pack” — tzn. CLI poprawnie wywnioskował tier/author z skills.json, gdzie ja zgadłem źle, a drugie uruchomienie było identyczne bajtowo (idempotentne). Jednak kroki 1 i 3 umiejętności (`build-docs --dry-run` i `--dry-run --format json`) zakończyły się błędem 1 z komunikatem „ENOENT ... /opt/homebrew/lib/node_modules/ai-agent-skills/WORK_AREAS.md”; opublikowany tarball 4.3.2 nie zawiera WORK_AREAS.md (wykluczony przez .npmignore i package.json files[]), a cli.js:6846 przekazuje kontekst przestrzeni roboczej jako obiekt opcji, więc `generatedDocsAreInSync` wraca do spakowanego katalogu głównego pakietu. Wymuszenie uruchomienia go na załatanej kopii pakietu pokazało, że udokumentowane pole `currentlyInSync` porównuje się z README repozytorium upstream zamiast z przestrzenią roboczą, zgłaszając readmeMatches:false zaraz po pomyślnej regeneracji. Frontmatter ma name+description, nie ma odwołań do skryptów ani spakowanych plików, i nie znalazłem żadnych oznak bezpieczeństwa (brak curl|sh, base64, dostępu do poświadczeń ani tekstu iniekcji) w 52-liniowym SKILL.md.
Testowano: 2026-07-21 · Claude Code 2.x (agent harness)
Instalacja
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.
Komendy i przykładowe prompty
/build-workspace-docsRegeneruje README.md i WORK_AREAS.md w przestrzeni roboczej biblioteki ai-agent-skills za pomocą CLI
Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):
Regenerate the README for this workspaceUpdate WORK_AREAS.md to reflect current skillsPreview doc changes before regenerating them