技能文件规则抑制思想、结构逻辑与工程摘要本文分析一套面向LLM代理的项目技能文件体系myproject-safety, myproject-feedback, myproject-core, myproject-server, myproject-client解构其规则组织的设计思想。该体系的五份技能文件并非独立的规范清单而是一个层次分明、责任清晰的规则矩阵按约束刚性分层宪法级/强制级/参考级按知识域分片物理定律/反馈理论/编码规范/服务器/客户端通过显式优先级声明、禁令前置、穷举清单、强制模板等机制将抽象规范转化为可执行的硬约束。其核心设计思想是不依赖LLM的推理判断能力来遵守规范而是通过规则的绝对性、可验证性和互锁引用将规范转化为解码时的硬性约束锚点。本文提炼该体系的八项设计原则为同类复杂项目的技能文件编写提供方法论参考。1. 问题的本质LLM为何忽视规范在配备技能文件的代理系统中LLM频繁表现出规范忽视行为。其根源并非模型“不听话”而是注意力稀释长文本中软性建议“建议遵守”、“最好这样做”在解码时的注意力权重极低被当前任务上下文的统计模式淹没。优先级模糊当多条指令存在时LLM缺乏内在机制区分“必须遵守”与“可以参考”。无明确优先级声明的前提下模型倾向于选择语言上更“顺滑”的生成而非更规范的生成。可验证性缺失“请遵守技能文件”是模糊指令。模型无法判断自己是否已遵守因为违规缺乏可检测的边界条件。因此有效的技能文件不是“写得更清楚”而是必须结构化地将规范转化为不可绕过的约束锚点并将合规性转化为模型自身可判断的离散条件。2. 五份技能文件的职责矩阵该体系将规范划分为五个独立文件按知识域和约束刚性进行分片文件知识域约束刚性角色定位myproject-safety安全规范、备份、审计、穷举验证、分布式物理定律、输出模板宪法级不可违背的绝对规则源myproject-feedback分布式正负反馈博弈理论、收敛机制宪法级所有分布式决策的第一性原理myproject-core项目结构、编码规范、接口验证、模块加载强制级编码操作的基础约束myproject-server服务器架构、跨服通信、异步模型、CAP原则强制级服务器端专用规范myproject-client客户端UI系统、事件系统、模块交互强制级客户端专用规范关键设计将物理定律、反馈理论和强制审计从编码规范中分离形成独立的最高优先级文件。这确保了每次代码修改都同时受三份宪法级文件的约束——物理定律约束设计方向反馈理论约束分布式行为安全规范约束修改流程。3. 约束刚性的三级分层3.1 宪法级不因场景变化而失效myproject-safety和myproject-feedback中标记为“宪法级”的规则定义了不可因任何理由绕过的绝对边界。其语言特征使用[不可违背]、[强制]、零容忍等绝对性标记明确规定违规的后果“代码是错误的必须重写”禁止以具体理由绕过“不得以’看起来能工作’、之前这样做过’等理由绕过”这类规则的锚定效应最强。它们不仅告诉模型要做什么还预判并封堵了模型可能用来绕过规则的最常见借口。3.2 强制级必须遵守但允许框架内的选择myproject-core、myproject-server、myproject-client中的大部分规则属于强制级。例如编码命名规范、文件编码标准、UI/modules隔离规则。违反会导致代码无法工作如跨环境调用导致nil crash因而其约束刚性由运行时后果自然保证。3.3 清单级通过检查清单确保执行审计清单、变更检查清单、穷举清单等将抽象的“应该验证”转化为具体的“逐项打勾”。模型完成每项后可以明确判断是否遗漏使合规性可自检。4. 规则组织的结构模式4.1 禁令前置每个文件的头部都有“硬性准则”声明块在具体规范之前建立约束语境# 硬性准则本文件全部规则必须无条件遵守不得违背。没有例外。 强制声明本文件中所有规则必须无条件遵守。如果AI生成的代码违反以上任何规则则该代码是错误的必须重写。这种结构的意图是利用primacy效应——将约束性元指令放在文件最前端确保其在注意力分布中获得最高权重先于任何具体规范被处理。4.2 违规后果的显式化每条规则都附带明确的违规后果或检测标准使“是否遵守”成为可判断的离散状态违规后果示例 - “该代码是错误的必须重写” - “不准提交” - “视为违规” - “运行时崩溃”自然后果这不同于模糊的“注意遵守”。模型可以判断自己是否违反了带明确定义的规则。4.3 反例驱动大量规则通过“经典反例”补充正面的规范陈述。这是该体系最具特色的设计之一反例 - 编造 ctrl:GetPos() → 引擎只有 GetX() 和 GetY() → 运行时崩溃 - 编造 rawget(t, k) → 该项目中没有任何系统用过rawget反例的价值在于它们不是抽象原则而是模型最容易犯的具体错误的档案。当模型倾向于生成特定形式的幻觉时反例直接将这种幻觉模式标记为违规从而抑制其生成概率。4.4 强制模板与结构化输出myproject-safety的“强制输出模板”要求所有审计报告严格遵循五章结构调用链/分布式/全局状态/重连/反馈五问且规定“不按模板的全部重写”。这使输出质量可机械检查杜绝模型通过重组结构来掩饰遗漏。5. 技能间的互锁引用架构五份文件不是孤立的而是通过显式引用形成互锁网络myproject-safety ← 引用 → myproject-feedback反馈五问嵌入safety模板 ↓ 引用 ↓ 引用 myproject-core ← 共享 → myproject-server / myproject-client 变更检查清单被server和client引用互锁的工程意图防遗忘修改服务器代码时myproject-server的变更检查清单引用了myproject-core的接口存在性验证和myproject-safety的三项强制审计。单一文件的加载会连锁激活相关文件的约束。防矛盾myproject-safety的分布式物理定律如“方向约束”与myproject-feedback的负反馈形态如“方向约束”作为负反馈的第一形态在概念上对齐。两处定义一致防止模型因不同文件中的矛盾表述而产生选择性遵循。分层继承myproject-server和myproject-client各自包含领域特定的检查清单项但都继承myproject-core和myproject-safety的基础约束。这种继承关系确保了修改任何代码时基础约束和领域约束都被激活。6. 八项核心设计原则从该体系中可归纳出八条可推广的技能文件设计原则原则一约束刚性分层将规则按“宪法级/强制级/清单级”分层。宪法级规则不可绕过强制级规则有后果但允许框架内选择清单级确保逐项执行。同一文件内不混杂不同刚性的规则。原则二禁令前置文件头部声明绝对服从义务建立约束语境。这条语境本身是第一道锚点。原则三违规后果显式化每条规则定义违规的后果或检测标准使模型可自判合规性而非依赖外部审查。原则四反例驱动预判模型最可能违反规则的具体模式将其写入规则作为警示。这利用模型对负面示例的敏感性来抑制对应生成路径。原则五约束知识域分片按知识域将规范分为独立文件而非一个巨型技能文件。分片使每个文件职责单一避免长文本中的注意力稀释也便于按需加载。原则六互锁引用文件之间通过显式引用形成约束网络。单一文件的加载激活相关文件的约束防止孤立遗漏。概念对齐确保不同文件对同一原则的表述一致。原则七强制模板对需要多维度分析的任务定义不可协商的输出结构。模型无法通过重组输出格式来规避或合并必须覆盖的维度。原则八穷举要求显式化将“完整分析”转化为可量化的穷举清单状态组合数、分支数、协议路径数。模型即使无法做到形式化级别的完备也会因要求而显著降低遗漏概率。7. 工程边界与适用条件该体系在以下条件下效果最佳长周期复杂任务短任务中规则体系的加载成本可能超过收益。多轮次交互单轮问答中模型缺乏足够上下文来激活所有约束。分布式/状态机密集场景简单CRUD任务无需如此重的规范体系。模型具有较强的指令遵循能力对弱模型绝对性标记的效果可能衰减。过度约束的风险包括抑制模型对规范外问题的发现能力以及在探索性任务中因过于刚性而错失更优解。8. 结论该技能文件体系的本质不是“让LLM更听话”而是通过结构化的约束工程——分层刚性、禁令前置、违规后果显式化、反例注入、互锁引用、强制模板和穷举要求——将抽象的工程规范转化为不可绕过的解码约束。其核心假设是LLM不会主动遵循规范但会对经过注意力优化的、具有明确违规后果的、与反例形成对比的硬性指令做出更高的遵循概率。这套设计思想对任何需要LLM在已有复杂代码库中严格遵循规范的工程场景都具有参考价值。它表明有效的技能文件不是对规范的叙述性描述而是面向LLM推理机制的约束操作系统。
)
