SkillProof tested Claude skills

Repo Docs Zh

Bygger kinesisk repo-dokumentasjon fra reelle kodekjøringer; engelske stier og symboler forblir eksakte

av YurunChen · YurunChen/repo-docs-skills

Bestått ★ 8.8/10

Repo Docs Zh — Bygger kinesisk repo-dokumentasjon fra reelle kodekjøringer; engelske stier og symboler forblir eksakte

Hva den gjør

Kinesisk-språklig overlegg for repo-docs-ferdigheten: den bygger en repo-docs/-pakke hvis prosa er kinesisk mens stier, kommandoer, funksjoner, felt og andre kildeidentifikatorer forblir i sin opprinnelige form for oppslag. Den håndhever en atferdsførst-struktur (README med en 阅读路径 rutetabell, en nummerert one-real-run gjennomgang, en bevisbase under references/source-evidence.md) og leverer en Python-validator som sjekker struktur, lenker og bevis-tabeller. Utløses når brukeren ber om kinesisk repo-dokumentasjon, nevner repo-docs-zh, eller ønsker en eksisterende repo-docs-pakke lokalisert for kinesiske lesere.

Testrapport

Installert i en midlertidig HOME (begge ferdigheter, siden repo-docs-zh/SKILL.md leser ../repo-docs/* via relativ sti — zh-katalogen alene er 1 fil og ubrukelig); frontmatter parset med name+description, og ../repo-docs/SKILL.md, REFERENCE.md, EXAMPLES.md alle løst (HTTP 200 rå). Oppgave: Kinesisk repo-dokumentasjon for et klonet reelt repo (simonw/files-to-prompt). GRUNNLINJE (ingen ferdighetskropp) = én 中文 fil: katalogtre, funksjonsliste, opsjonstabell, generisk 5-trinns flyt, null utførelser — jeg kjørte aldri verktøyet. FERDIGHETSKJØRING tvang to bevispass, så jeg utførte det faktisk og begge artefaktene avviker konkret: ferdighetspakken dokumenterer en reprodusert særegenhet (en .gitignore-regel i demo2/sub1 ekskluderte også søsken demo2/sub2/b.txt, utdata var kun c.txt) og et docstring/implementasjonsavvik (cli() help sier <document path="...">, reell --cxml-utdata er <document index="1"><source>...</source><document_content>, som matcher testenes filenames_from_cxml) — ingen av strengene vises noe sted i grunnlinjen (grep count 0). Medfølgende validator-kjøring: ferdighetspakke "OK: 0 errors, 4 warnings" (--lite); grunnlinjen droppet inn som en pakke ga "FAILED: 7 error(s)" (manglende walkthrough/evidence/change-log, ingen 阅读路径 rutetabell, åpningen hadde 26 kodeformede navn). Reell friksjon funnet: validatorens kinesiske bevis-tabellhode-regex aksepterer kun 结论/声明|证据|置信度|边界/备注|使用页面, og mitt første forsøk med 断言|…|注意|被哪页使用 advarte — zh SKILL.md dokumenterer aldri disse eksakte kolonnenavnene. Utløserfraser bedømt (5/5 korrekt): SKULLE — "给这个仓库生成一份中文的 repo-docs", "Generate repo documentation in Chinese for this codebase", "把现有的 repo-docs 包本地化给中文读者"; SKULLE IKKE — "Translate this blog post into Chinese" (ikke repo-dokumentasjon), "Generate repo-docs for this repository" (ukvalifisert, det er den engelske repo-docs-ferdigheten, ikke zh-overlegget). Sikkerhetsskanning ren: ingen curl|sh, base64-blobs, eller eksfiltrering i ferdighetsfilene; den eneste subprosessen i validate_repo_docs.py er en lokal `git diff --name-only`.

Testet på: 2026-07-31 · Claude Code 2.x (agent harness)

Installer

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"

Kommandoer og eksempelprompter

  • /repo-docs-zhBygger kinesisk repo-dokumentasjon fra reelle kodekjøringer; engelske stier og symboler forblir eksakte

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):

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

Full rapport →