ASD-STE100 Skill：为Claude Code改写歧义英文
给Claude Code用的英文改写技能，把代理消息变成STE100式短句，减少下游误读。
GitHub danyuchn/asd-ste100-skill 更新 2026-10-12 分支 master 星标 4.5K 分叉 259
Python 代理文本改写 ASD-STE100 Claude Code

🧭 决策指南

为什么现在热： 无法从材料判断

适合，如果你

  • 你要把tool description、error message或inter-agent instruction改成机器更容易解析的英文。
    README的“Scope”列出agent-to-agent messages、tool/function descriptions、error messages和inter-agent instructions。
  • 你希望用Strict模式处理procedures、错误消息和工具描述。
    README的“What This Skill Does”说明Strict覆盖procedures、error messages和tool descriptions。
  • 你需要检查分号、被动语态、长句或限定的phrasal verbs。
    README说明deterministic linter检查semicolons、passive voice、long sentences和短列表phrasal verbs。

不适合，如果你

  • 你的目标是获得正式的ASD-STE100认证合规文本。
    README明确说明项目不复现官方约900词词典，并建议认证文档使用真实标准。
  • 你的内容是creative writing或marketing copy，且voice和nuance很重要。
    README的“Scope”明确将creative writing和marketing copy列为Not built for。
  • 你需要linter证明改写没有改变需求强度或原文含义。
    README明确说明linter不比较原文与重写、不验证requirement strength，也不证明meaning preserved。

前置条件

  • 需要Claude Code，因为README将项目定义为Claude Code skill。
  • 可使用skills CLI安装，README给出的入口命令是npx skills add danyuchn/asd-ste100-skill。
  • 运行仓库自带linter时使用Python脚本scripts/ste-lint.py。
  • README未给出Claude Code、Python或skills CLI的版本要求。

第一步命令（README 原文）

npx skills add danyuchn/asd-ste100-skill

要注意

  • README自身的SKILL.md不能作为干净lint样例，因为规则表会引用被禁止模式。
    README明确说明仓库自身prose does not lint clean，并给出python scripts/ste-lint.py --baseline 41 SKILL.md。
  • examples/linter-edge-cases.md是测试fixture，不应当当作合规STE prose。
    README明确说明该文件包含故意无效的Markdown列表项。
  • linter只识别有限phrasal verbs，因此take off the panel会通过检查。
    README列出短列表phrasal verbs，并明确举例说明take off the panel passes。
  • 使用npx skills安装时会发送匿名安装telemetry，可用DISABLE_TELEMETRY=1退出。
    README的“Quick Install”说明telemetry包含skill name和timestamp，并给出DISABLE_TELEMETRY=1。

替代方案

  • ASD-STE100官方标准：需要认证STE合规文档，或需要官方约900词approved dictionary时更合适。
    README的“What This Skill Does”

材料未说明

  • README没有说明Claude Code的最低版本或兼容版本范围。
  • README没有给出重写延迟、吞吐量或大文本长度限制。
  • README没有提供自动化测试数量、覆盖率或CI状态。
  • README没有说明Python脚本需要哪些第三方依赖。
  • README没有说明除Claude Code之外的代理框架是否有直接集成方式。
  • 项目有9名贡献者和10个最近提交，但README没有说明维护者分工或未来发布计划。

💡 深度解析

6
不适合 我负责需要正式 ASD-STE100 合规证明的航空航天文档；这个 Claude Code skill 能否替代官方标准和合规审查？
适合读者： 为航空航天、医疗或工业安全文档寻找 ASD-STE100 依据、并需要正式合规证明的技术文档负责人

不适合替代官方标准或正式合规审查；它是面向代理输出的轻量级改写技能，不是 ASD-STE100 认证工具。

  • README 明确声明项目不复制 ASD 官方约 900 词 approved dictionary，而是应用其底层原则：使用最简单可用的词，并保持用法一致。
  • 文档还说明依赖 ASD dictionary 的规则只作 advisory 处理，因此不会完成完整词汇合规验证。
  • linter 只检查有限结构模式，不验证原文与改写的语义等价，也不证明要求强度未改变。
  • 项目 Scope 将目标放在 agent-to-agent messages、tool descriptions、error messages 和 system prompts；它不是针对航空、医疗或工业安全的正式证明流程。
  • What This Skill Does：It does not reproduce ASD's official ~900-word approved dictionary
  • What This Skill Does：The rules that depend on ASD's dictionary are flagged as advisory rather than enforced
  • What This Skill Does：It does not compare an original text with a rewrite ... or prove that the rewrite preserved meaning
  • Scope：Built for agent-to-agent messages, tool/function descriptions, error messages, system prompts
npx skills add danyuchn/asd-ste100-skill
材料未说明：README 未说明项目是否经过任何航空航天、医疗或工业安全领域的正式验证。；README 未说明如何生成可供审计或认证机构接受的合规报告。
不适合 我使用 Python 和 Markdown，希望在提交前检查 semicolon、passive voice、long sentence 和有限 phrasal verb；这个 linter 能否作为完整的 STE 合规门禁？
适合读者： 需要把 Claude Code 生成的 agent-facing 英文接入可重复检查流程、并希望用 Python linter 检查 Markdown 文本的开发者

不适合把它当作完整 STE 合规门禁；它适合做有限的结构检查，但不是官方词典验证器，也不判断语义保真。

  • README 列出的确定性检查包括分号、六类 soft phrasal verbs、名词化、营销形容词、被动语态、现在完成时、长句、同义词轮换和列表中悬空连接词。
  • 它明确不检查 noun-cluster length，也不知道支持列表之外的 phrasal verbs；同时不会检查 hedges 或 modality。
  • 项目不复制 ASD 官方约 900 词 approved dictionary，因此不能替代正式标准或认证审查。
  • linter 的零违规只表示已配置的结构规则没有发现问题，不代表文本没有歧义或改写保留了含义。
  • What This Skill Does：The deterministic linter checks semicolons ... passive voice ... long sentences
  • What This Skill Does：It does not check noun-cluster length ... and it does not know phrasal verbs outside its list
  • What This Skill Does：It does not reproduce ASD's official ~900-word approved dictionary
  • What This Skill Does：A zero-violation result means that the configured structural checks found no problems
python scripts/ste-lint.py --baseline 41 SKILL.md
材料未说明：README 未说明如何把 linter 接入具体的 pre-commit、CI 或代码审查平台。；README 未给出对任意项目 Markdown 文件配置自定义规则阈值的接口。
适合 我在 Claude Code 中编写英文 tool description 和 error message；下游代理没有人工澄清渠道，我是否应该用这个 skill 把它们改写成 Strict 模式？
适合读者： 在 Claude Code 中维护 tool/function descriptions、system prompts 和 error messages，并要求下游代理在没有人工追问渠道时准确解析的开发者

适合，因为 Strict 模式正是为工具描述、错误消息和操作流程设计的，并把“一个句子一个动作、明确主语和条件”作为改写重点。

  • README 的“What This Skill Does”明确规定：Strict covers procedures, error messages, and tool descriptions。
  • 技能会逐句检查歧义词、被动语态、多重指令、过长句、名词化和复杂时态，并在可能丢失事实、条件或范围时保留更长表达。
  • 默认只返回改写文本；需要审查规则时，可以要求“show the diff”或“explain the changes”。
  • 但它不会证明需求强度和语义完全保留，尤其不能替代工具契约验证；must、may、should、否定和例外仍需单独核对。
  • What This Skill Does：Strict covers procedures, error messages, and tool descriptions
  • What This Skill Does：without dropping any fact, condition, or scope qualifier
  • What This Skill Does：The linter checks structural patterns only
npx skills add danyuchn/asd-ste100-skill
材料未说明：README 未说明 Claude Code 技能在复杂领域术语、否定条件或嵌套例外上的实际改写准确率。；README 未提供工具契约或系统提示词的自动语义等价测试接口。
适合 我主要写英文 README 和 PR description，而不是 tool description；我希望减少歧义但保留解释性语气，应该使用 Strict 还是 STE-flavored？
适合读者： 编写英文 README、PR description 和 explanatory prose，同时要照顾非英语母语技术读者的技术作者

适合，优先使用 STE-flavored 模式；它保留句子纪律，但不像 Strict 那样强制固定词汇，较适合 README、PR description 和解释性文本。

  • README 的模式定义明确把 STE-flavored 用于 READMEs、PR descriptions 和 explanatory prose。
  • 该模式保留短句、单一动作和清晰边界等原则，但不执行 fixed-vocabulary lockdown，因此更能保留必要的技术术语。
  • 项目适合机器或非英语读者需要直接解析的英文文本，但不适合创意写作、营销文案或依赖语气与隐喻的内容。
  • 输出默认只有改写文本；若需要知道哪些规则改变了内容，可以在请求中加入“show the diff”。
  • What This Skill Does：STE-flavored covers READMEs, PR descriptions, and explanatory prose
  • What This Skill Does：STE-flavored keeps the sentence discipline but not the fixed-vocabulary lockdown
  • Scope：Not built for creative writing, marketing copy, or anything where voice and nuance are the point
  • Usage：To see which rules were applied, add "show the diff"
npx skills add danyuchn/asd-ste100-skill
材料未说明：README 未说明 STE-flavored 模式如何处理特定品牌名、API 名称或团队术语表。；README 未提供 README 或 PR 文本改写前后的可量化可读性指标。
视情况 我在多代理工具调用链中传递 inter-agent instructions；如果我需要保留条件、范围和要求强度，这个 skill 会不会为了变短而删掉关键信息？
适合读者： 构建多代理系统和工具调用链、需要在代理之间传递英文指令且没有人工澄清渠道的自动化工作流工程师

视情况：设计目标是保留条件和范围，但项目明确不保证改写后的语义、需求强度或原文完全等价。

  • README 说明改写时不删除任何 fact、condition 或 scope qualifier；如果缩短会损失精度，就保留较长版本并标记取舍。
  • 同时，linter 只检查结构模式，不比较原文与改写，也不证明 meaning preserved。
  • 项目把多代理消息、inter-agent instruction 和 system prompt 列为适用范围，说明它确实针对你的文本类型。
  • 但生成式改写仍可能误解领域术语、否定、例外或模态词；高风险调用不能只把“零违规”当作语义安全信号。
  • What This Skill Does：without dropping any fact, condition, or scope qualifier from the original
  • What This Skill Does：It does not compare an original text with a rewrite, verify that requirement strength stayed the same, or prove that the rewrite preserved meaning
  • Scope：agent-to-agent messages, tool/function descriptions, error messages, system prompts, inter-agent instructions
npx skills add danyuchn/asd-ste100-skill
材料未说明：README 未说明如何自动检测改写前后的 must、may、should 等模态词是否改变。；README 未说明是否能识别你的领域专有名词、工具参数约束或业务例外。
适合 我使用 Claude Code 项目级安装和 Python Markdown 检查；这个项目是否足够轻量，能直接加入现有仓库，而不需要服务端或数据库？
适合读者： 希望通过 npx skills 在 Claude Code 项目级环境安装技能，并需要把英文代理文本纳入现有 Markdown 检查流程的 Python 开发者

适合直接加入项目级仓库，因为安装方式是 npx skills 或 Git，运行结构由 Claude Code skill、规则文档、示例和独立 Python 脚本组成，不需要服务端或数据库。

  • README 的 Quick Install 提供项目根目录命令 npx skills add danyuchn/asd-ste100-skill，并说明技能安装到 current project。
  • Python linter 可直接通过命令行运行，例如对 SKILL.md 使用 python scripts/ste-lint.py --baseline 41 SKILL.md。
  • 项目数据表明主语言为 Python，许可证为 MIT；README 还提供 npx skills update 更新方式。
  • 但 README 没有现成的 CI、编辑器插件或服务接口，因此“直接加入”限于安装和命令行检查，自动化门禁仍需自行接线。
  • Installation / Quick Install：Run it from your project root
  • Installation / Quick Install：npx skills add danyuchn/asd-ste100-skill
  • What This Skill Does：The linter checks structural patterns only
  • 项目数据：main_language 为 Python；license 为 MIT License
npx skills add danyuchn/asd-ste100-skill
材料未说明：README 未说明 npx skills 的具体 Node.js 版本要求或与现有 Claude Code 配置冲突时的处理方式。；README 未提供 CI 配置样例或退出码契约。

✨ 核心亮点

  • 用ASD-STE100规则改写工具描述、错误消息和代理指令
  • Strict与STE-flavored两种模式覆盖不同英文文本
  • 确定性检查覆盖分号、被动语态和长句等结构模式
  • GitHub已有4,484颗星，但当前没有正式版本发布

🔧 工程化

  • 读取英文含义，逐句标记规则违规并重写，同时保留事实和条件
  • 运行python scripts/ste-lint.py可检查结构性STE模式
  • 使用show the diff可输出逐条规则对应的前后对照表

⚠️ 风险

  • 不包含ASD官方约900词词典，不能证明正式STE合规
  • linter不验证重写前后含义、需求强度或事实是否保持
  • linter不检查词组长度、完整词组动词或hedges和modality

👥 适合谁？

  • 需要处理agent-to-agent消息、工具描述或系统提示的Claude Code用户
  • 维护英文错误消息和inter-agent instructions的工程团队
  • 需要创意写作、营销文案或语气细腻表达的作者不应采用