SuperAPI AI 工具集

maintain-translated-skills

写作与研究

查看项目

更新于 10-16 09:44

技能介绍

用途:维护技能(skill)仓库的本地化版本。它只做内容本地化,不负责 Git fork 同步,适合需要对上游技能内容进行翻译并用本地仓库持续维护的场景。

核心规则:翻译自然语言说明,行为关键内容必须原样保留。需保留目录名与技能文件夹名、slash 命令与 CLI 命令、代码块与行内代码、文件路径、URL、包名、工具名、API 标识符、环境变量、YAML/JSON/TOML 及 frontmatter 键、SKILL.md 的 frontmatter name 值,以及目标仓库 policy 中声明为保护词的内容。若不确定某段是否影响行为,应原样保留并标记待复核。

目标策略:变更译制仓库前需读取 .skill-localization/policy.json。若不存在,大范围刷新前应创建或索取;窄范围单文件修改可谨慎推断,但应建议补上。需要字段细节时读取本技能仓库的 references/policy-schema.md;创建或重写目标 README 前读取 references/localized-readme-pattern.md。

初始本地化:检查源与目标仓库结构;在目标仓库创建 policy,设置 upstreamRepo、localizedRepo、locale、公开/私有 bucket、manifest、索引文件、保护模式与验证命令;翻译含说明的文件;仅在译制仓库需要时保留可执行支持文件;更新 README 与 bucket 索引;最后运行 portable validator 和目标仓库验证命令。

上游刷新:把上游当内容来源而非仓库治理权威;对比源与目标找出新增、变更、删除项;翻译新增和变更的自然语言;保留受保护内容;本地化安装命令指向 localizedRepo;未经 policy 明确要求,不导入上游 issue 标签、发布状态、CI 政策、分支政策或维护者元数据;按 policy 的 publicBuckets、privateBuckets、indexPaths、manifestPaths 更新公开索引与 manifest;必要时在目标 README 记录简短同步说明并运行验证。

索引与 manifest 维护:公开技能由 publicBuckets 决定,每个公开技能应出现在配置的公开索引和 manifest 中,README 条目链接到对应 SKILL.md;私有技能不得进入公开索引和公开 manifest,但可保留 bucket README。

审查与发布:先运行 portable validator,例如 node /path/to/skills-localizer-zh-CN/scripts/validate-translated-skills.mjs --root /path/to/translated-repo,再运行目标仓库 policy 中的验证命令。最终报告应含改动文件、翻译文件、复制或保留文件、删除或过期文件、索引与 manifest 变更、验证结果、复核标记,以及安装路径、代码块、frontmatter、路径、标识符和 Markdown 结构等不变量检查。

限制:不要把完整命令输出粘进 README;重写 README 时首屏应先服务目标语言用户(身份、解决的问题、安装命令、下一步操作),翻译策略、同步记录和验证说明放次要位置;维护记录保持简短;优先提交小而可审的 patch,不把无关仓库治理改动混入本地化刷新。