Repo Docs Zh
Construit des documents de dépôt chinois à partir d'exécutions de code réelles ; les chemins et symboles anglais restent exacts
Testé · Fonctionne
Ce que fait
Surcouche en langue chinoise pour la compétence repo-docs : elle construit un package repo-docs/ dont la prose est en chinois tandis que les chemins, commandes, fonctions, champs et autres identifiants source restent dans leur forme originale pour la recherche. Elle impose une structure axée sur le comportement (README avec une table de routage 阅读路径, un walkthrough numéroté d'une exécution réelle, une base de preuves sous references/source-evidence.md) et fournit un validateur Python qui vérifie la structure, les liens et les tables de preuves. Se déclenche lorsque l'utilisateur demande de la documentation de dépôt en chinois, mentionne repo-docs-zh, ou souhaite qu'un package repo-docs existant soit localisé pour les lecteurs chinois.
Rapport de test
Installé dans un HOME temporaire (les deux compétences, puisque repo-docs-zh/SKILL.md lit ../repo-docs/* par chemin relatif — le répertoire zh seul est 1 fichier et inutilisable) ; le frontmatter a été analysé avec name+description, et ../repo-docs/SKILL.md, REFERENCE.md, EXAMPLES.md ont tous été résolus (HTTP 200 brut). Tâche : documentation de dépôt chinoise pour un dépôt réel cloné (simonw/files-to-prompt). BASELINE (pas de corps de compétence) = un fichier 中文 : arborescence de répertoires, liste de fonctions, tableau d'options, flux générique en 5 étapes, zéro exécutions — je n'ai jamais exécuté l'outil. L'exécution SKILL a forcé deux passes de preuves, donc je l'ai réellement exécutée et les deux artefacts diffèrent concrètement : le package de compétence documente une bizarrerie reproduite (une règle .gitignore dans demo2/sub1 excluait également le fichier frère demo2/sub2/b.txt, la sortie n'était que c.txt) et une incohérence docstring/implémentation (l'aide de cli() dit <document path="...">, la sortie réelle de --cxml est <document index="1"><source>...</source><document_content>, correspondant aux filenames_from_cxml des tests) — aucune de ces chaînes n'apparaît nulle part dans la base de référence (nombre de grep 0). Exécution du validateur fourni : package de compétence "OK: 0 errors, 4 warnings" (--lite) ; la base de référence, une fois ajoutée en tant que package, a donné "FAILED: 7 error(s)" (walkthrough/evidence/change-log manquants, pas de table de routage 阅读路径, l'ouverture avait 26 noms de forme de code). Friction réelle trouvée : l'expression régulière de l'en-tête de la table de preuves chinoise du validateur n'accepte que 结论/声明|证据|置信度|边界/备注|使用页面, et ma première tentative avec 断言|…|注意|被哪页使用 a averti — le SKILL.md zh ne documente jamais ces noms de colonnes exacts. Phrases de déclenchement jugées (5/5 correct) : DEVRAIT — "给这个仓库生成一份中文的 repo-docs", "Generate repo documentation in Chinese for this codebase", "把现有的 repo-docs 包本地化给中文读者" ; NE DEVRAIT PAS — "Translate this blog post into Chinese" (pas de documentation de dépôt), "Generate repo-docs for this repository" (non qualifié, c'est la compétence repo-docs anglaise, pas la surcouche zh). Analyse de sécurité propre : pas de curl|sh, de blobs base64, ou d'exfiltration dans les fichiers de compétence ; le seul sous-processus dans validate_repo_docs.py est un `git diff --name-only` local.
Testé le: 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"
Commandes et exemples de prompts
/repo-docs-zhConstruit des documents de dépôt chinois à partir d'exécutions de code réelles ; les chemins et symboles anglais restent exacts
Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :
Generate Chinese docs for this repositoryWrite a Chinese README for this projectDocument this codebase in Simplified Chinese