SkillProof tested Claude skills

Repo Docs Zh

Tworzy chińską dokumentację repozytorium na podstawie rzeczywistych uruchomień kodu; angielskie ścieżki i symbole pozostają niezmienione

Autor: YurunChen · YurunChen/repo-docs-skills

Testowano · Działa ★ 8.8/10

Repo Docs Zh — Tworzy chińską dokumentację repozytorium na podstawie rzeczywistych uruchomień kodu; angielskie ścieżki i symbole pozostają niezmienione

Co robi ten skill

Nakładka języka chińskiego dla umiejętności repo-docs: tworzy pakiet repo-docs/, którego proza jest chińska, podczas gdy ścieżki, polecenia, funkcje, pola i inne identyfikatory źródłowe pozostają w oryginalnej formie do wyszukiwania. Wymusza strukturę zorientowaną na zachowanie (README z tabelą tras 阅读路径, numerowany instruktaż one-real-run, baza dowodów pod references/source-evidence.md) i dostarcza walidator Pythona, który sprawdza strukturę, linki i tabele dowodów. Uruchamia się, gdy użytkownik prosi o chińską dokumentację repozytorium, wspomina repo-docs-zh lub chce, aby istniejący pakiet repo-docs został zlokalizowany dla chińskich czytelników.

Raport z testu

Zainstalowano w tymczasowym HOME (obie umiejętności, ponieważ repo-docs-zh/SKILL.md czyta ../repo-docs/* przez ścieżkę względną — sam katalog zh to 1 plik i jest bezużyteczny); frontmatter sparsowany z name+description, a ../repo-docs/SKILL.md, REFERENCE.md, EXAMPLES.md wszystkie rozwiązane (HTTP 200 raw). Zadanie: chińska dokumentacja repozytorium dla sklonowanego rzeczywistego repozytorium (simonw/files-to-prompt). LINIA BAZOWA (bez treści umiejętności) = jeden plik 中文: drzewo katalogów, lista funkcji, tabela opcji, ogólny 5-etapowy przepływ, zero wykonań — nigdy nie uruchomiłem narzędzia. Uruchomienie umiejętności wymusiło dwa przejścia dowodowe, więc faktycznie je wykonałem i oba artefakty różnią się konkretnie: pakiet umiejętności dokumentuje odtworzoną osobliwość (reguła .gitignore w demo2/sub1 wykluczyła również siostrzany demo2/sub2/b.txt, wyjście to tylko c.txt) oraz niezgodność docstring/implementacji (pomoc cli() mówi <document path="...">, rzeczywiste wyjście --cxml to <document index="1"><source>...</source><document_content>, pasujące do filenames_from_cxml testów) — żaden z tych ciągów nie pojawia się nigdzie w linii bazowej (grep count 0). Uruchomienie dołączonego walidatora: pakiet umiejętności "OK: 0 errors, 4 warnings" (--lite); linia bazowa wstawiona jako pakiet dała "FAILED: 7 error(s)" (brak walkthrough/evidence/change-log, brak tabeli tras 阅读路径, otwarcie miało 26 nazw w kształcie kodu). Znaleziono prawdziwe tarcia: regex nagłówka chińskiej tabeli dowodów walidatora akceptuje tylko 结论/声明|证据|置信度|边界/备注|使用页面, a moja pierwsza próba z 断言|…|注意|被哪页使用 ostrzegła — zh SKILL.md nigdy nie dokumentuje tych dokładnych nazw kolumn. Ocenione frazy wyzwalające (5/5 poprawnie): POWINIEN — "给这个仓库生成一份中文的 repo-docs", "Generate repo documentation in Chinese for this codebase", "把现有的 repo-docs 包本地化给中文读者"; NIE POWINIEN — "Translate this blog post into Chinese" (nie dokumentacja repozytorium), "Generate repo-docs for this repository" (niekwalifikowane, to angielska umiejętność repo-docs, a nie nakładka zh). Skan bezpieczeństwa czysty: brak curl|sh, blobów base64 ani wycieku w plikach umiejętności; jedynym podprocesem w validate_repo_docs.py jest lokalne `git diff --name-only`.

Testowano: 2026-07-31 · Claude Code 2.x (agent harness)

Instalacja

git clone --depth 1 https://github.com/YurunChen/repo-docs-skills.git /tmp/repo-docs-zh-src
mkdir -p ~/.claude/skills
cp -R /tmp/repo-docs-zh-src/skills/repo-docs ~/.claude/skills/repo-docs
cp -R /tmp/repo-docs-zh-src/skills/repo-docs-zh ~/.claude/skills/repo-docs-zh
# Both dirs are required: repo-docs-zh/SKILL.md is an overlay that reads ../repo-docs/SKILL.md,
# REFERENCE.md, PAGE_RULES.md and EXAMPLES.md by relative path. Installing only repo-docs-zh leaves it broken.
# Upstream alternative: bash /tmp/repo-docs-zh-src/install.sh --agent claude  (installs both skills, same layout)
# Validator (bundled, Python 3 stdlib only, no extra deps):
#   python3 ~/.claude/skills/repo-docs/scripts/validate_repo_docs.py <repo>/repo-docs --repo-root <repo> [--lite]
# Usage: "用 repo-docs-zh 给这个仓库生成中文文档" / "Generate Chinese repo docs for this project"

Komendy i przykładowe prompty

  • /repo-docs-zhTworzy chińską dokumentację repozytorium na podstawie rzeczywistych uruchomień kodu; angielskie ścieżki i symbole pozostają niezmienione

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

  • Generate Chinese docs for this repository
  • Write a Chinese README for this project
  • Document this codebase in Simplified Chinese

Pełny raport →