danyuchn/asd-ste100-skill

项目概览

它把面向维修手册防误读的 ASD-STE100 控制语言原则，转用于无人介入环节中解析其他智能体输出的 AI 读者，并附带逐句规则违规标记和一个确定性 Python linter 脚本，思路具体且可验证（examples/before-after.md 中有改写前后示例）。

项目类型

AI Agent · 提示词工程

应用场景

文档办公

部署方式

查看项目说明

License

MIT

适合谁

• 在 Claude Code 中工作、需要让智能体输出更不易被下游智能体误读的开发者和 AI 工程师。
• 维护智能体间消息、工具描述、错误消息和系统提示词等英文文本的团队。

核心能力

• 把稠密、有歧义的英文改写为 ASD-STE100 简化技术英语。
• 逐句标记每一条规则违规：歧义用词、现在完成时/复杂时态、施动者不明的被动语态、一句多指令、过长名词堆叠、缺词、超长句、短语动词、名词化动作、分号、堆叠模糊限定词和营销形容词。
• 严格模式覆盖流程、错误消息和工具描述；STE-flavored 模式覆盖 README、PR 描述和说明性文字。
• 对每个被标记的句子进行改写，且不丢弃原文中的任何事实、条件或范围限定词。
• 仅单独输出改写后的文本，不加前言、模式声明或变更摘要；对刻意保留未简化的内容附一行 Kept as-is 说明。
• 当被要求展示 diff 或列出违规规则时，改为输出逐条命名规则的改写前后对照表。
• 确定性 Python linter，检查分号、一小部分短语动词、名词化、营销形容词、被动语态、现在完成时、长句、同义词轮换以及列表项中的悬空连词。
• 包含 examples/before-after.md（更多改写前后示例）和 linter-edge-cases.md 测试用例。

限制与风险

• 不复现 ASD 官方约 900 词的批准词典，而是应用其底层原则而非固定词表。
• 附带的 linter 仅检查结构模式，不验证改写是否保留了原意。
• ASD-STE100 Issue 9 仅允许经 ASD 书面授权或其列出的八类组织再分发，本项目不属于其中任何一类；采用前应自行评估相关合规影响。

如何开始

• 在项目根目录运行 npx skills add danyuchn/asd-ste100-skill（依赖 skills.sh CLI，支持一条命令安装与更新），或单次 git clone 安装到 ~/.claude/skills 作为 Claude Code skill；安装后粘贴文本并让 Claude 对其应用 STE100 即可验证。

核验依据

• README: A Claude Code skill that rewrites dense, ambiguous English into [ASD-STE100 Simplified Technical English](https://www.asd-ste100.org/) (STE)
• README: an **AI agent** parsing another agent's output, a tool description, an error message, or an inter-agent instruction, with no human in the loop to resolve ambiguity.
• README: Rewrites each flagged sentence — without dropping any fact, condition, or scope qualifier from the original.
• README: Picks a mode. **Strict** covers procedures, error messages, and tool descriptions. **STE-flavored** covers READMEs, PR descriptions, and explanatory prose.
• README: Flags every rule violation sentence-by-sentence: ambiguous word choice, present-perfect/complex tense, passive voice with an unclear actor, multi-instruction sentences, oversized…

来源更新时间：2026-10-10T18:11:24Z

打开原始 GitHub 项目