Skill 中文说明生成器

要解决什么问题

Agent 技能生态里，大量 Skill 只有英文 SKILL.md，中文用户要上手得自己啃原文、再手工整理成 README。目录分散、frontmatter 格式不一、章节命名也不统一，纯靠 Agent 临场发挥容易漏章节、表格列对不齐，批量时还容易重复覆盖已有文档。

技能如何工作

本技能把流程拆成确定性机械步骤和语言本地化两层：

• 目录发现：默认扫描本技能上级文件夹（兄弟技能包所在目录）；也可用 --skills-dir 指定其它路径。只要子目录里有 SKILL.md 就会被识别，与具体平台无关。
• 解析与草稿：scripts/generate_readme.py 读取 YAML frontmatter 与 Markdown 章节；frontmatter 异常时降级为正则提取，不中断任务。脚本产出 README_CN.md 骨架，并把触发条件、功能特性、注意事项、参数表、使用方法/配置等原文预填进对应章节，待译处用占位标记，Agent 主要做翻译与润色。
• 批量与跳过：支持「全部」模式；已存在 README_CN.md 或 使用说明.md 时默认跳过，除非 --force。
• 质量检查：生成后校验必备章节、标题层级、表格列数、是否残留未翻译占位符。
• 一键翻译（可选）：配置 DEEPSEEK_API_KEY 后可用 --translate，由 scripts/llm_bridge.py 将结构化 JSON 字段回填中文；无密钥或网络失败时优雅降级为带占位符的草稿，不报错中断。

无 Python 或脚本缺失时，Agent 仍可按技能内「草稿模板」独立完成八段结构文档，功能不依赖外部运行时。

适用边界与注意点

• 技术术语、API/CLI、参数名（如 --model）、环境变量名保持英文；代码块原样保留，只译说明文字。
• 脚本退出码：0 成功或仅跳过；1 存在生成失败；2 参数错误。
• 定稿前需移除全部翻译占位符，并核对文档长度与章节完整性（技能内附有质量检查清单）。