SkillProof tested Claude skills

Repo Docs Zh

Bouwt Chinese repo-docs op basis van echte code-uitvoeringen; Engelse paden en symbolen blijven exact

Door YurunChen · YurunChen/repo-docs-skills

Getest · Werkt ★ 8.8/10

Repo Docs Zh — Bouwt Chinese repo-docs op basis van echte code-uitvoeringen; Engelse paden en symbolen blijven exact

Wat het doet

Chinees-talige overlay voor de repo-docs skill: het bouwt een repo-docs/ pakket waarvan de tekst Chinees is, terwijl paden, commando's, functies, velden en andere bron-identifiers in hun oorspronkelijke vorm blijven voor opzoeking. Het dwingt een gedrag-eerst structuur af (README met een 阅读路径 route tabel, een genummerde one-real-run walkthrough, een bewijsbasis onder references/source-evidence.md) en levert een Python validator die structuur, links en bewijstabellen controleert. Activeert wanneer de gebruiker vraagt om Chinese repo-documentatie, repo-docs-zh vermeldt, of een bestaand repo-docs pakket gelokaliseerd wil hebben voor Chinese lezers.

Testrapport

Geïnstalleerd in een tijdelijke HOME (beide skills, aangezien repo-docs-zh/SKILL.md ../repo-docs/* leest via relatief pad — de zh map alleen is 1 bestand en onbruikbaar); frontmatter geparset met name+description, en ../repo-docs/SKILL.md, REFERENCE.md, EXAMPLES.md allemaal opgelost (HTTP 200 raw). Taak: Chinese repo docs voor een gekloonde echte repo (simonw/files-to-prompt). BASELINE (geen skill body) = één 中文 bestand: dir tree, functie lijst, optie tabel, generieke 5-staps flow, nul uitvoeringen — ik heb de tool nooit uitgevoerd. SKILL run dwong twee bewijspassen af, dus ik heb het daadwerkelijk uitgevoerd en beide artefacten verschillen concreet: het skill pakket documenteert een gereproduceerde eigenaardigheid (een .gitignore regel in demo2/sub1 sloot ook de sibling demo2/sub2/b.txt uit, output was alleen c.txt) en een docstring/implementatie mismatch (cli() help zegt <document path="...">, echte --cxml output is <document index="1"><source>...</source><document_content>, matching tests' filenames_from_cxml) — geen van beide strings verschijnt ergens in de baseline (grep count 0). Gebundelde validator run: skill pakket "OK: 0 errors, 4 warnings" (--lite); de baseline ingevoegd als pakket gaf "FAILED: 7 error(s)" (ontbrekende walkthrough/evidence/change-log, geen 阅读路径 route tabel, opening had 26 code-shaped namen). Echte frictie gevonden: de Chinese evidence-table header regex van de validator accepteert alleen 结论/声明|证据|置信度|边界/备注|使用页面, en mijn eerste poging met 断言|…|注意|被哪页使用 waarschuwde — de zh SKILL.md documenteert die exacte kolomnamen nooit. Trigger formuleringen beoordeeld (5/5 correct): MOET — "给这个仓库生成一份中文的 repo-docs", "Generate repo documentation in Chinese for this codebase", "把现有的 repo-docs 包本地化给中文读者"; MOET NIET — "Translate this blog post into Chinese" (geen repo docs), "Generate repo-docs for this repository" (ongekwalificeerd, dat is de Engelse repo-docs skill, niet de zh overlay). Beveiligingsscan schoon: geen curl|sh, base64 blobs, of exfiltratie in de skill bestanden; de enige subprocess in validate_repo_docs.py is een lokale `git diff --name-only`.

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

Installatie

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"

Commando's en voorbeeldprompts

  • /repo-docs-zhBouwt Chinese repo-docs op basis van echte code-uitvoeringen; Engelse paden en symbolen blijven exact

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

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

Volledig rapport (Engels) →