SkillProof tested Claude skills

Repo Docs Zh

Opbygger kinesiske repo-docs fra reelle kodekørsler; engelske stier og symboler forbliver nøjagtige

Af YurunChen · YurunChen/repo-docs-skills

Testet · Virker ★ 8.8/10

Repo Docs Zh — Opbygger kinesiske repo-docs fra reelle kodekørsler; engelske stier og symboler forbliver nøjagtige

Hvad det gør

Kinesisk-sproget overlay for repo-docs-færdigheden: den bygger en repo-docs/-pakke, hvis prosa er kinesisk, mens stier, kommandoer, funktioner, felter og andre kildeidentifikatorer forbliver i deres originale form til opslag. Den håndhæver en adfærdsførst-struktur (README med en 阅读路径 routingtabel, en nummereret one-real-run walkthrough, en evidensbase under references/source-evidence.md) og leverer en Python-validator, der kontrollerer struktur, links og evidens-tabeller. Udløses, når brugeren beder om kinesisk repo-dokumentation, nævner repo-docs-zh, eller ønsker en eksisterende repo-docs-pakke lokaliseret til kinesiske læsere.

Testrapport

Installeret i en midlertidig HOME (begge færdigheder, da repo-docs-zh/SKILL.md læser ../repo-docs/* via relativ sti — zh-mappen alene er 1 fil og ubrugelig); frontmatter parsed med name+description, og ../repo-docs/SKILL.md, REFERENCE.md, EXAMPLES.md alle løst (HTTP 200 raw). Opgave: Kinesisk repo-docs for et klonet reelt repo (simonw/files-to-prompt). BASELINE (ingen færdighedskrop) = én 中文 fil: dir tree, funktionliste, option table, generisk 5-trins flow, nul eksekveringer — jeg kørte aldrig værktøjet. SKILL-kørsel tvang to evidens-pass, så jeg udførte det faktisk, og begge artefakter adskiller sig konkret: færdighedspakken dokumenterer en reproduceret særhed (en .gitignore-regel i demo2/sub1 udelukkede også søskende demo2/sub2/b.txt, output var kun c.txt) og et docstring/implementeringsmismatch (cli() help says <document path="...">, reel --cxml output er <document index="1"><source>...</source><document_content>, matchende tests' filenames_from_cxml) — ingen af strengene vises nogen steder i baselinen (grep count 0). Bundled validator-kørsel: færdighedspakke "OK: 0 errors, 4 warnings" (--lite); baselinen, der blev droppet ind som en pakke, gav "FAILED: 7 error(s)" (mangler walkthrough/evidence/change-log, ingen 阅读路径 routingtabel, åbningen havde 26 kodeformede navne). Reel friktion fundet: validatorens kinesiske evidens-tabel header regex accepterer kun 结论/声明|证据|置信度|边界/备注|使用页面, og mit første forsøg med 断言|…|注意|被哪页使用 advarede — zh SKILL.md dokumenterer aldrig disse nøjagtige kolonnenavne. Udlø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 docs), "Generate repo-docs for this repository" (ukvalificeret, det er den engelske repo-docs færdighed, ikke zh overlayet). Sikkerhedsscanning ren: ingen curl|sh, base64 blobs eller exfiltration i færdighedsfilerne; den eneste subprocess i validate_repo_docs.py er en lokal `git diff --name-only`.

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

Installation

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-zhOpbygger kinesiske repo-docs fra reelle kodekørsler; engelske stier og symboler forbliver nøjagtige

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen 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

Læs hele rapporten →