SkillProof tested Claude skills

Repo Docs Zh

Vytváří čínskou repo dokumentaci ze skutečných spuštění kódu; anglické cesty a symboly zůstávají přesné

od YurunChen · YurunChen/repo-docs-skills

Otestováno · Funguje ★ 8.8/10

Repo Docs Zh — Vytváří čínskou repo dokumentaci ze skutečných spuštění kódu; anglické cesty a symboly zůstávají přesné

Co umí

Čínskojazyčná vrstva pro dovednost repo-docs: vytváří balíček repo-docs/, jehož próza je čínská, zatímco cesty, příkazy, funkce, pole a další identifikátory zdrojů zůstávají ve své původní podobě pro vyhledávání. Vynucuje strukturu zaměřenou na chování (README s tabulkou směrování 阅读路径, číslovaný one-real-run walkthrough, základ důkazů pod references/source-evidence.md) a dodává Python validátor, který kontroluje strukturu, odkazy a tabulky důkazů. Spouští se, když uživatel požádá o čínskou repo dokumentaci, zmíní repo-docs-zh, nebo chce existující balíček repo-docs lokalizovat pro čínské čtenáře.

Testovací report

Nainstalováno do dočasného HOME (obě dovednosti, jelikož repo-docs-zh/SKILL.md čte ../repo-docs/* relativní cestou — samotný adresář zh je 1 soubor a nepoužitelný); frontmatter parsován s name+description, a ../repo-docs/SKILL.md, REFERENCE.md, EXAMPLES.md se všechny vyřešily (HTTP 200 raw). Úkol: Čínská repo dokumentace pro klonované skutečné repo (simonw/files-to-prompt). BASELINE (bez těla dovednosti) = jeden soubor 中文: strom adresářů, seznam funkcí, tabulka možností, obecný 5krokový tok, nulové spuštění — nástroj jsem nikdy nespustil. Spuštění SKILL vynutilo dva průchody důkazů, takže jsem jej skutečně spustil a oba artefakty se konkrétně liší: balíček dovednosti dokumentuje reprodukovanou zvláštnost (pravidlo .gitignore v demo2/sub1 také vyloučilo sourozenecký demo2/sub2/b.txt, výstup byl pouze c.txt) a neshodu docstringu/implementace (cli() help říká <document path="...">, skutečný výstup --cxml je <document index="1"><source>...</source><document_content>, odpovídající názvům souborů testů z filenames_from_cxml) — ani jeden řetězec se nikde v baseline nevyskytuje (grep count 0). Spuštění přiloženého validátoru: balíček dovednosti "OK: 0 errors, 4 warnings" (--lite); baseline vložený jako balíček dal "FAILED: 7 error(s)" (chybí walkthrough/evidence/change-log, žádná tabulka směrování 阅读路径, úvod měl 26 názvů ve tvaru kódu). Nalezeno skutečné tření: regulární výraz pro hlavičku čínské tabulky důkazů validátoru přijímá pouze 结论/声明|证据|置信度|边界/备注|使用页面, a můj první pokus s 断言|…|注意|被哪页使用 varoval — zh SKILL.md nikdy nedokumentuje tyto přesné názvy sloupců. Posouzení spouštěcích frází (5/5 správně): MĚLO by — "给这个仓库生成一份中文的 repo-docs", "Generate repo documentation in Chinese for this codebase", "把现有的 repo-docs 包本地化给中文读者"; NEMĚLO by — "Translate this blog post into Chinese" (ne repo docs), "Generate repo-docs for this repository" (nekvalifikované, to je anglická dovednost repo-docs, ne zh overlay). Bezpečnostní sken čistý: žádné curl|sh, base64 bloby, ani exfiltrace v souborech dovednosti; jediný podproces v validate_repo_docs.py je lokální `git diff --name-only`.

Testováno: 2026-07-31 · Claude Code 2.x (agent harness)

Instalace

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"

Příkazy a ukázkové prompty

  • /repo-docs-zhVytváří čínskou repo dokumentaci ze skutečných spuštění kódu; anglické cesty a symboly zůstávají přesné

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

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

Kompletní testovací report (anglicky) →