☰
【研发类-AI和ML开发Skills】ai-md 技能
2026/10/3 8:40:33 网站建设 项目流程

将人类编写的CLAUDE.md转换为AI原生的结构化标签格式。在4个模型上经过实战测试。相同的规则,更少的令牌,更高的合规性。

技能概述

ai-md 技能是一种将人类编写的CLAUDE.md(或任何LLM系统指令)转换为结构化标签格式的方法论,AI模型更可靠地遵循这种格式,同时使用更少的令牌。

下载地址:https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ai-md

核心悖论

我们证明的悖论:用自然语言添加更多规则会降低合规性。将相同的规则转换为结构化格式可以恢复并超越它。

人类散文(6条规则,1行) → AI遵循其中4条 结构化标签(6条规则,6行) → AI遵循所有6条 相同的内容。不同的格式。不同的结果。

触发条件

  • 您的CLAUDE.md很长,但AI仍然忽略您的规则
  • 冗长的系统指令导致令牌使用过高
  • 您想要优化任何LLM系统提示以提高合规性
  • 在AI工具之间迁移规则(Claude、Codex、Gemini、Grok)

工作原理:LLM实际如何处理指令

LLM不会"阅读"——它们会关注。理解这一点会改变一切。

机制1:注意力分裂

当多条规则共享一行时,模型的注意力在所有令牌之间平均分配。每条规则获得一部分注意力权重。一些规则会丢失。

当每条规则有自己的行时,模型将其作为独立单元处理。每条规则获得完整的注意力权重。

机制2:零推理标签

自然语言迫使模型从上下文中推断含义。标签明确声明含义。无需推理=没有误解。

关键洞察:像trigger:、action:、exception:这样的标签适用于所有语言。模型不需要解析中文/日文/英文语法来理解结构。标签是人类与AI之间的通用语言。

机制3:语义锚定

带标签的子项创建可匹配的标签。当用户的输入包含关键词时,模型将其直接匹配到相应的标签——就像哈希表查找而不是全文搜索。

转换过程

阶段1:理解——像编译器一样阅读,而不是像人类

将CLAUDE.md视为构建状态机来阅读,而不是阅读文档。

对于每个句子,询问:

  • 这是触发器吗?(什么输入激活此行为?)
  • 这是行动吗?(AI应该做什么?)
  • 这是约束吗?(AI不应该做什么?)
  • 这是元数据吗?(优先级、时机、持久性、异常?)
  • 这是人类解释吗?(为什么存在规则——删除这个)

阶段2:分解——将每个|和()分解为原子规则

合规性失败的第一大来源是复合规则。一行包含3条用|分隔的规则,对AI来说看起来像1条指令。它需要是3条独立的指令。

分割器测试:如果您可以在句子的两部分之间放置"AND",它们是独立的规则,必须在单独的行上。

实际证明

这种特定技术修复了一个在所有模型上连续失败5次的测试用例。标签new-api:在第一次尝试时将Codex T5从❌提升到✅。

最佳实践

  1. 将复合规则分解为原子规则
  2. 使用结构化标签而非自然语言描述
  3. 为每个规则元素使用单独的行
  4. 删除人类动机解释(AI不需要这些)
  5. 使用语义锚定创建可匹配的标签
  6. 在不同AI工具之间测试转换后的提示

技能元数据

  • 风险等级:safe
  • 来源:community

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询