ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

Penpot 的 OpenCode /ste 技能:ASD-STE100 词汇替换表与单义裁决全解

Penpot 的 OpenCode /ste 技能:ASD-STE100 词汇替换表与单义裁决全解 Penpot 的 OpenCode /ste 技能ASD-STE100 词汇替换表与单义裁决全解【免费下载链接】penpotPenpot: The open-source design platform for Product teams that need scalable collaboration.项目地址: https://gitcode.com/GitHub_Trending/pe/penpot本文以 Penpot 仓库中 OpenCode 技能steASD-STE100 简化技术英语写作所附带的参考文件 word-substitutions.md 为主体完整呈现其 36 组“禁用词 → 批准词”映射、13 条“一词一义、一词一职”的规范裁决canonical rulings以及 5 类高频问题功能词的改写规则并结合同技能的 SKILL.md 工作流与 examples.md 的改写示例说明这份“工作词典”在起草前替换、写后自检两个环节中的具体调用方式。读完后你可以直接用它作为技术英语文本的词汇审查清单并理解每条裁决背后的设计动机。文档定位一份“工作近似”不是官方字典这份参考文件开篇即声明了它的性质内容汇编自公开二手来源STEMG/ASD 公开页面、TechScribe、Acrolinx 及培训材料是“一份工作近似working approximation不是官方 ASD 字典”。它同时给出一条兜底策略——当一个词没有列在表中、但读起来偏正式或带有拉丁语源色彩时优先选择最短、最常用的替代表达。这条原则实际上就是整张替换表的内在逻辑拉丁化、正式化的词utilize、commence、terminate、facilitate……被系统性替换为日常英语中最短的对应词。在技能层面该词典的地位由 SKILL.md 的 “Words” 规则明确起草前必须替换未批准的词汇“阅读references/word-substitutions.md并应用它它是本技能的工作词典”。此外写后自检Step 2 Self-check pass的第 8 项就是扫描“references/word-substitutions.md禁用列中的任何词”第 3 项扫描 should/would/could/may/might第 7 项扫描同物异名的同义词轮换见 自检清单原文。也就是说这份文件不只是查阅资料而是技能工作流中两次强制检查的依据。需要说明使用范围根据 SKILL.md 的前置元数据ste技能只在用户显式调用时输入/ste或明确写出“use the ste skill / apply ASD-STE100”才生效不会在“帮我简化一下”这类隐含意图时触发。而 SKILL.md 同时划定了词典的适用边界代码块、命令字符串、文件路径、错误信息、被引用的界面文案与专有名词保持原样STE 只约束围绕它们的行文。Unapproved → approved 完整替换表36 组以下是 word-substitutions.md 中 “Unapproved → approved” 一节的完整继承左列禁用右列为批准替代表达。括号内容是原表自带的语义限定务必保留——它们把替换范围精确到了特定用法。Do not useUse insteadutilize, leverage, employusecommence, initiate, begin, originatestartterminate, cease, concludestop, endensure, verify, confirm, validate, checkmake sure (that), examineperform, conduct, execute, carry outdofacilitate, assisthelpobtain, acquire, procuregetsufficient, adequateenoughapproximatelyaboutprior tobeforesubsequent to, following (prep.)afteradjacent tonearaccomplishdoadditional, supplementarymoreattempttryrequire, necessitateneed, mustmandatorynecessaryindicate, signifyshowobserve (watch)look at, examinerotateturndeactivateturn off, set to offactivate, energize (unless technical verb)turn on, starttoxicpoisonousin order totovia, by means ofthrough, withdue to, owing tobecause ofin the event of/thatifaccessible(rewrite: you can get access to)remainderrestdemonstrateshowmodify, alterchangeconstruct, fabricate, buildassemble, makeretainkeeplocate (find)finddepress (a button)push, pressproceedcontinue, go从表的结构可以看出三类替换动机拉丁化动词日常化utilize→use、commence→start、terminate→stop/end、obtain→get、demonstrate→show、modify→change、retain→keep、locate→find、proceed→continue/go。这类词语义与替代表达完全等价替换只改变语域不改变信息。冗短语缩短in order to→to、via/by means of→through/with、due to/owing to→because of、in the event of/that→if、prior to→before。右列往往给出多个可接受形式stop, endpush, press但一旦选定全文必须一致——这与 SKILL.md 的“Never rotate synonyms: pick one name for a thing and repeat it”规则直接对应。需要改写而非直接换词的情况accessible 右列是“(rewrite: you can get access to)”即不允许单点换词必须把形容词短语改写为可感知的动作句式depress 仅限定“按按钮”这一用法depress 作“使沮丧”等义时本就不该出现在技术文档里activate/energize 标注了“unless technical verb”的例外说明领域技术动词可以保留见下文“领域词豁免”。13 条单义裁决One meaning, one part of speech替换表解决“换个词”的问题而 canonical rulings 一节 解决更根本的问题同一个词在整个语料中只能有一个意义、一个词性。这一节的 13 条裁决逐一如下括号内为原表给出的示例或限定。close— 仅作动词移动到能阻断流动的位置或操作断路器。形容词用法未获批准 → 用near示例do not go near the propeller。test— 仅作名词do a test永远不写 test the system。check— 不作验证义动词 → 用 make sure that 或 examine。follow— 只表示“在……之后”。表示遵守规则、步骤时用obey示例Obey the safety instructions.。fall— 只表示“受重力向下移动”。表示数量变化用decrease。绝不用于“秋季”。oil— 仅作名词。Oil the bearing → Put oil on the bearing / Lubricate the bearing。right— 只表方向永不表“正确”。clear— 只表“无阻挡”。Wheels are clear of the ground → wheels do not touch the ground。help— 仅作动词名词义位用aidwith the aid of a mirror。above / below— 只表物理位置。数量比较用more than / less than。about— 两个批准义项“大约”与“关于某主题”。原表特别标注 Use carefully因为它是少数被保留双义的词需在文中保持语义可判定。turn— 旋转的通用动词turn on / turn off 表示电源状态是标准用法。这条裁决与替换表中 rotate→turn、deactivate→turn off 形成闭环全表的“旋转/开关”词汇最终都收敛到 turn 一个词上。level— 作为名词和形容词均获批准是单义规则下有记录的例外documented exception。这些裁决的共同设计动机可以从 SKILL.md 的总纲读出“One word, one meaning, one part of speech, used consistently.” 例如 clear 的形容词义clear of the ground、right 的“正确”义、test 的动词义都是英语中自然的用法但会在多语翻译和歧义检测中引入第二个意义因此被整体禁用而非逐句判断。高频问题功能词Frequent-offender function words功能词一节 处理的是 5 类“不指向具体词汇表、却高频违规”的句式问题should / would / could / may / might — 一律禁用。映射关系为要求requirement→must可能性possibility→can将来future→will。这与 SKILL.md 的模态动词规则一致“A hedge becomes a fact or a can: an explosion can occur.”——模糊表态要么升格为事实陈述要么降格为 can 引导的可能性。etc. — 删除或把完整列表写出来。不完整的列举在操作步骤中会造成歧义读者无法知道省略的部分是否也要执行。e.g. / i.e. — 分别替换为 for example / that is。对应 SKILL.md 的“No Latin abbreviations”规则。any / appropriate / applicable / relevant 作为模糊限定语hedges— 用你实际所指的具体事物替换。there is / there are 开头句 — 用真实主语改写。原表示例There are three bolts on the panel → The panel has three bolts. 这条规则在 examples.md 的常见错误清单中被再次列为检查项。工作流整合从文本分类到写后自检单独一张表不能直接使用它依赖技能定义的前后两个环节。环节一起草前分类与替换。SKILL.md 的 Step 0 要求先判定文本类型——程序性文本procedural被人逐步执行的指令还是描述性文本descriptive解释与背景混合文档按章节分别判定句子长度限制随之不同程序性每句最多 20 词描述性最多 25 词每段最多 6 句。词典替换本身不区分类型但“替换后是否满足字数上限”依赖分类结果例如 in order to→to 这类缩短型替换恰好帮助逼近 20/25 词上限。环节二写后自检。Self-check pass 要求在回复前逐项扫描 9 类问题并全部修复其中与本文词典直接相关的是第 3 项五个禁用的情态动词、第 7 项同义词轮换同一对象出现两个名字和第 8 项替换表禁用列中的任何词。环节三示例验证。examples.md 的 “Vocabulary and phrasing” 改写对恰好逐条演示了本文替换表与裁决的落点BeforeAfter命中的规则Utilize approximately 3 liters of water.Use about 3 liters of water.utilize→useapproximately→aboutRotate the cover until the jacks are accessible.Turn the cover until you can get access to the jacks.rotate→turnaccessible→按原表改写为 you can get access toExtend the jack until the wheels are clear of the ground.Extend the jack until the wheels do not touch the ground.clear 单义裁决改写为“不接触”Make sure that these steps are followed.Obey these steps.follow 单义裁决规则/步骤用 obeyPerform a compression of the log files prior to upload.Compress the log files before you upload them.prior to→beforeperform 的名词化动作改为动词Express actions as verbs, not nouns见 SKILL.mdEnsure file exists before running.Make sure that the file exists before you run the command.ensure→make sure (that)同时补齐冠词——SKILL.md 明确“Ensure file exists”是错误写法不得为省词而省略冠词、主语、动词领域词豁免与合规边界领域词豁免。替换表不覆盖“技术名词/技术动词”零件名、工具名、产品名、UI 标签等专有名词以及 drill、ream、boot、compile 这类领域动词SKILL.md 要求“保持原样、各用其一致的名字”且不得把名词动词化、把动词名词化。这解释了替换表为什么对 activate/energize 标注“unless technical verb”——是否豁免取决于该词在你的领域里是否是既定技术动词。合规边界。SKILL.md 的合规说明指出官方 ASD-STE100 规范及其字典受 ASD 版权保护本技能编码的是“转述规则 公开来源词表”用于认证级航空航天/国防交付物时完整合规需要官方规范文本与人工签核human sign-off且不得声称“已认证合规”。因此本文所述的替换表与裁决应理解为工程实践层面的工作近似可直接用于普通技术文档的词汇审查但不能替代官方字典的合规判定。此外 SKILL.md 要求使用美式英语拼写应用替换表时也应保持拼写一致。落地清单把上述内容压缩为一份可执行的审查顺序顺序与 Self-check pass 对齐判定段落类型procedural / descriptive确认 20/25 词上限扫描五个情态动词 should/would/could/may/might按 must / can / will 归类替换对照 36 组替换表清除禁用词注意 accessible、depress、activate 等带语义限定的行核对 13 条单义裁决close、test、check、follow、fall、oil、right、clear、help、above/below、about、turn、level的词性与意义是否越界删除 etc.、展开 e.g./i.e.、把 any/appropriate/applicable/relevant 换成具体对象、把 there is/are 开头句改为真实主语检查冠词缺失、同义词轮换、警告句“风险先于指令”的倒序WARNING/CAUTION 必须先给指令或条件再给风险见 SKILL.md最后确认代码块、路径、命令、报错原文与专有名词未被改动。这套“36 组替换 13 条裁决 5 类功能词 7 步自检”的组合就是 Penpot 仓库ste技能所采用的 ASD-STE100 工作词典的完整面貌它把“简化技术英语”从一句口号落成了逐词可查、逐项可扫、可用 examples.md 逐例复核的机械流程。【免费下载链接】penpotPenpot: The open-source design platform for Product teams that need scalable collaboration.项目地址: https://gitcode.com/GitHub_Trending/pe/penpot创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进