danyuchn/asd-ste100-skill

开发工具

把 ASD-STE100 简化技术英语规则做成 Claude Code 技能,为机器读者重写含糊的英文。

5,827
338
Python
MIT
创建于 3 个月前

这个项目把 ASD-STE100 简化技术英语规则打包成一个 Claude Code 技能,用来重写机器或非母语读者必须自行解析、无法追问澄清的英文:工具与函数描述、错误消息、系统提示词,以及智能体之间的消息。README 把“一个智能体读另一个智能体的输出”类比为“机务人员读维修指令”——没有作者可问,因此需要一词一义、一句一条指令。

实际会改变什么

你把文本贴进去,要求 Claude “disambiguate this”或“apply STE100 to this”。技能会选两种模式之一:strict 用于流程、错误消息和工具描述;STE-flavored 用于 README、PR 描述和解释性文字,保留句式纪律但不锁定固定词表。它逐句标记违规并重写,按自身说明会保留每个事实、条件和范围限定词。默认只输出重写后的文本,若有意保留某处未简化,则附一行 Kept as-is: 说明。要求“show the diff”或“explain the changes”会得到一张标明所违反规则的前后对照表。仓库提供了前后对照示例和带引用的规则摘要(示例、规则参考)。

检查器到底查什么

仓库附带的 Python linter 是确定性的结构性检查。按 README 所述,它检查分号、一小列软性短语动词(如 spin up、reach out)、名词化、营销形容词、被动语态、现在完成时、长句、同义词轮换,以及受支持列表项中的悬空连接词。它的缺口写得很明确:不检查名词簇长度,不认识清单外的短语动词(“take off the panel”能通过),也从不标记模糊限定词或情态。README 还说明,linter 不比对原文与重写、不验证要求强度是否一致、不能证明语义被保留,因此零违规只表示所配置的结构检查没有发现问题。项目自己的正文需要以 --baseline 36 运行才能通过基线,因为规则表引用了被禁止的模式;那些检查结果应视为示例而非缺陷。

安装与限制

最快方式是在项目根目录用 skills CLI:npx skills add danyuchn/asd-ste100-skill,除非设置 DISABLE_TELEMETRY=1,否则会发送匿名安装遥测(skills CLI);README 也给出把仓库克隆进 ~/.claude/skills/ 的替代路径。项目不复制 ASD 官方约 900 词的核准词典,因为 Issue 9 限制再分发;它应用“使用现有最朴素词语”的原则而非查固定词表,所以不是经过认证的 STE 检查器(ASD-STE100)。它也不适合创意写作、营销文案或任何以语气和细微差别为目的的文本;它改的是形式而非内容——空洞的段落会变得简短、干净,但仍然空洞。代码采用 MIT 许可(许可),另有希伯来语移植版,但 ASD-STE100 只定义英语(希伯来语版本)。

HotRepo 点评

仓库创建于 2026-07-20。HotRepo 记录到一次 Python 月度榜单观察:本月 +3,556 stars,2026-10-30 当日最高排名第 7。样本只覆盖一个记录日期,无法说明趋势是升是降。

本文由 AI 根据项目 README 生成,更新于 2026年10月30日,以项目官方文档为准。