将人类编写的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从❌提升到✅。
最佳实践
- 将复合规则分解为原子规则
- 使用结构化标签而非自然语言描述
- 为每个规则元素使用单独的行
- 删除人类动机解释(AI不需要这些)
- 使用语义锚定创建可匹配的标签
- 在不同AI工具之间测试转换后的提示
技能元数据
- 风险等级:safe
- 来源:community