P374 · Skill 编写

翻译说明时保留可执行标识符

Preserve Executable Identifiers Across Localization

解释文字可以翻译,指令加载器和引用解析器使用的名称必须原样保留。

编辑审核

以下示例与示意结果由本站编写,用于说明方法,不是模型实测结果。

使用场景

只授权翻译release-check,已知name、调用$release-check及references/checklist.md均由机器解析。解释文字可中文,改字段键或路径却会破发现有引用。

具体做法

先清点机器身份、schema键、路径、调用和需保字面示例,再翻译其外叙述。解析译前后身份及引用,核字段类型/目标文件与允许工具;展示标题可本地化但不顶替机器name。要改名则另记录授权与调用方迁移,不混在翻译中。语法和实际加载分别验证。

反例

name改“名称”、release-check改中文、路径也翻但文件不迁;只要易读便算完成。

改进写法

翻译description值和正文,保留name: release-check、$release-check、references/checklist.md和YAML键。解析比较身份/引用且检查文件可达,再做实际宿主加载测试或标未测;不把语法通过当已激活。

为什么这样改

人读标签与机器符号用途不同。字面清单保护加载与引用语义,允许自然解释而不误改授权之外接口。

如何验证

教学译文name仍release-check、引用同路径,说明为中文。改成名称字段应让schema检查失败,翻路径但文件不变应暴露缺目标。正文提到通用词不必全部保英文。

适用边界

此法保护真正机器解析项,不强迫所有术语英文。不同宿主前言规则需核;授权改名可以迁移,但须明确范围。冻结术语表的语言习惯不是所有本地化要求。

原文与版本

如何收录这些方法