Repo Docs Zh
Crea documentación de repositorio en chino a partir de ejecuciones de código reales; las rutas y símbolos en inglés permanecen exactos
Probado · Funciona
Qué hace
Capa de idioma chino para la habilidad repo-docs: construye un paquete repo-docs/ cuyo texto es chino, mientras que las rutas, comandos, funciones, campos y otros identificadores de origen permanecen en su forma original para su consulta. Impone una estructura centrada en el comportamiento (README con una tabla de rutas 阅读路径, un tutorial numerado de una ejecución real, una base de evidencia bajo references/source-evidence.md) y proporciona un validador de Python que verifica la estructura, los enlaces y las tablas de evidencia. Se activa cuando el usuario solicita documentación de repositorio en chino, menciona repo-docs-zh, o desea que un paquete repo-docs existente se localice para lectores chinos.
Informe de la prueba
Instalado en un HOME temporal (ambas habilidades, ya que repo-docs-zh/SKILL.md lee ../repo-docs/* por ruta relativa — el directorio zh por sí solo es 1 archivo e inutilizable); frontmatter analizado con name+description, y ../repo-docs/SKILL.md, REFERENCE.md, EXAMPLES.md todos resueltos (HTTP 200 raw). Tarea: documentación de repositorio en chino para un repositorio real clonado (simonw/files-to-prompt). BASELINE (sin cuerpo de habilidad) = un archivo 中文: árbol de directorios, lista de funciones, tabla de opciones, flujo genérico de 5 pasos, cero ejecuciones — nunca ejecuté la herramienta. La ejecución de SKILL forzó dos pases de evidencia, así que realmente lo ejecuté y ambos artefactos difieren concretamente: el paquete de la habilidad documenta una peculiaridad reproducida (una regla .gitignore en demo2/sub1 también excluyó el archivo hermano demo2/sub2/b.txt, la salida fue solo c.txt) y una falta de coincidencia entre docstring/implementación (la ayuda de cli() dice <document path="...">, la salida real de --cxml es <document index="1"><source>...</source><document_content>, coincidiendo con los nombres de archivo de las pruebas de filenames_from_cxml) — ninguna cadena aparece en la línea base (recuento de grep 0). Ejecución del validador incluido: paquete de habilidad "OK: 0 errors, 4 warnings" (--lite); la línea base introducida como paquete dio "FAILED: 7 error(s)" (falta walkthrough/evidence/change-log, sin tabla de rutas 阅读路径, la apertura tenía 26 nombres con forma de código). Se encontró una fricción real: la expresión regular del encabezado de la tabla de evidencia china del validador solo acepta 结论/声明|证据|置信度|边界/备注|使用页面, y mi primer intento con 断言|…|注意|被哪页使用 advirtió — el SKILL.md zh nunca documenta esos nombres de columna exactos. Frases de activación juzgadas (5/5 correctas): DEBERÍA — "给这个仓库生成一份中文的 repo-docs", "Generate repo documentation in Chinese for this codebase", "把现有的 repo-docs 包本地化给中文读者"; NO DEBERÍA — "Translate this blog post into Chinese" (no es documentación de repositorio), "Generate repo-docs for this repository" (sin calificar, esa es la habilidad repo-docs en inglés, no la capa zh). Escaneo de seguridad limpio: sin curl|sh, blobs base64 o exfiltración en los archivos de la habilidad; el único subproceso en validate_repo_docs.py es un `git diff --name-only` local.
Probado el: 2026-07-31 · Claude Code 2.x (agent harness)
Instalación
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"
Comandos y prompts de ejemplo
/repo-docs-zhCrea documentación de repositorio en chino a partir de ejecuciones de código reales; las rutas y símbolos en inglés permanecen exactos
Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):
Generate Chinese docs for this repositoryWrite a Chinese README for this projectDocument this codebase in Simplified Chinese