不会还有人把「尽量注意」当成 Rule 吧?不可判定=等于没写 | 硬约束与加载顺序

51 阅读13分钟

不会还有人把「尽量注意」当成 Rule 吧?不可判定=等于没写 | 硬约束与加载顺序

全文速览:「注意安全」「别乱改」不是 Rule,是标语:门口贴「请文明通行」,小偷照样进。这篇教你把规矩写成机器能判违规的硬约束,附禁止项/必须项模板和三个故意作恶的演练用例。

系列:《从 Rule 到落地:AI 工程化实践》第 4 篇
标签:Rule · 硬约束 · AI工程化 · 质量门禁
专栏:从小白到AI落地大师

序言

上文我们画了五站主线。童鞋们若痛点是「助手好心乱改」,第一站就是 Rule。别急着写长篇制度散文——先问一句更狠的:你写的那条,机器能不能判定违规?

说句扎心的:很多团队所谓 Rule,其实是气氛组发言。「注意安全」「别乱改」「最好先测一下」——听着都对,助手没法遵守。你可以理解为:门口贴着「请文明通行」,小偷照样进——因为那不是门禁,是标语。标语越多,大家越以为安全工作做完了,其实只是墙纸换厚了。

本篇钉三件事:必须、禁止、建议三语气怎么分;硬约束到底写哪些内容;加载顺序如何裁决冲突。alwaysApply 路由细节留给下篇,完整业务包实战留给第 6 篇。读完你要能起草一份最小可行 Rule 目录,分得清硬约束与建议,并知道冲突时谁覆盖谁。别追求一次写全宇宙——先写十个真能判的,比写一百个「请尽量」强一百倍。

记住一句话:写不清判定条件的,别进硬约束文件——标语越多,不等于门禁越多。

概念

开篇几个词,融入叙述,不做卡片农场。

Rule,就是可判定的必须与禁止;建议另册,别和门禁混装。硬约束,是违反即可拦截或明确提示的条目——「我觉得不太好」不算。加载顺序,是全局到仓库再到场景的冲突裁决机制,不是文件名好看排序。门禁,是不满足条件就不允许继续的检查点,过不了就该停,而不是「先改完再说」。

换个接地气说法:Rule 是宪法,不是操作手册。手册是 Skill 的事。宪法要能一锤定音判合不合规;「尽量注意」连庭外调解都算不上。简单来说就是——写不清判定条件的,别进硬约束文件。进了也是噪声,还会在 Context 吃紧时挤掉真红线。

三种语气,务必分清。必须:例如改公共 API 前先补契约测试。禁止:例如不在日志和提交中写密钥明文。建议:例如提交信息写清动机——建议另册,不进常驻硬约束。把建议和禁止混在一段里,助手分不清权重;你可以理解为消防通道指示灯旁边贴满「欢迎光临」,真正要命的那条反而看不见。

问题在哪

写不好 Rule,通常栽在四处。细心的朋友对照一下,别对号入座太疼。

第一处,不可判定。「不要乱改」无效;「未经确认不修改 infra 目录与密钥相关文件」有效。前者是心情,后者是坐标。助手不是故意作恶,是你没给可执行的红线。你越用形容词,它越只能猜。

第二处,语气混装。命名建议、提交风格、真正的生产禁止项糊成一锅。会话一长,模型对约束的遵守会被噪声拉低——不是玄学,是注意力被稀释。安全条款若和「变量名尽量语义化」同级,出事时你也说不清到底哪条该挡。

第三处,加载顺序靠默契。全局禁止强制推送,某发布流程又需要例外。若不写明场景包覆盖全局时必须显式声明并加双人确认,冲突时要么全堵死,要么全放开。全放开更隐蔽:看起来流程很顺,门禁早被悄悄拆了。

第四处,把 SOP 塞进 Rule。步骤越长,越像 Skill 误投。Rule 应该短、可检索、带版本与变更说明。你打开文件要能十秒找到禁止项标题,而不是在散文里考古。散文适合博客,不适合门禁。

举例

虚构规则包 acme-rules,最小目录可以长这样——不求一次写全,求可演练:

acme-rules/
  00-load-order.md
  10-security-hard.md
  20-engineering-gates.md
  90-suggestions.md

硬约束条目示例,注意每句都能判违规:

## 禁止
- 不在日志/提交中写入密钥与令牌明文
- 不删除未跟踪的本地用户文件,除非用户点名路径
- 未经确认不修改 /infra 与密钥相关文件

## 必须
- 改公共 API 前先补充/更新契约测试
- 涉及映射变更时,变更说明写清影响面与风险等级

加载顺序写成瀑布:全局,再到仓库,再到场景。后者覆盖前者时必须显式声明。举例:全局禁止强制推送;某发布技能临时允许,但要双人确认并留下审计字段。没有「显式」二字,就是偷偷拆门禁——出了事还对不上责任链。

硬约束内容从哪三类下手?安全:密钥、生产变更、不可逆操作。工程:格式、测试门禁、评审要求。协作:哪些目录默认只读、哪些入口禁止「顺便重构」。三类各先写两三条,比空喊「全面规范」管用。

验收怎么证明 Rule 生效?别靠感觉,也别靠「已经写进仓库」。用一次故意违规演练。让助手尝试把令牌写成明文放进示例配置——期望拦截或明确要求改占位符。让助手无测试改公共入口——期望提示先补契约测试,而不是「顺便重构」。演练不过,Rule 就还是气氛。

说句自嘲的:我第一次演练时助手笑嘻嘻把密钥写进去了,我还以为模型坏了——其实是条款里全是「请注意」,没有一条「禁止」。后来改成人话,拦截才出现。不是模型突然听话,是我们终于把标语换成了门禁。

演练是事后验证,落笔时就能事前拦。拿一份真实水平的草稿判一遍,一共四步:

步骤总览

  1. 把「硬约束」文件里的原句逐条列出,附上它声称的语气;
  2. 先扫气氛组触发词(尽量 / 最好 / 注意 / 适当…)——语气声称是门禁、句子里却是软词,直接打回;
  3. 过了气氛关,再查有没有可核查的坐标(路径 / 动作 / 前置条件);
  4. 建议类不硬拦,只确认它待在软册里——别回头混进门禁。
# rule_lint.py —— Rule 可判定性检查:标语和门禁,机器分得出来
# 纯标准库,复制即跑。用法:python rule_lint.py

# 草稿:某团队「硬约束」文件里的原句(左边是文件里写的,右边是声称的语气)
DRAFTS = [
    ("注意安全,别乱改",                              "禁止"),   # 标语:先被气氛词抓走
    ("改动尽量谨慎一点",                              "禁止"),   # 气氛组本组
    ("禁止跳过回归就合并",                            "禁止"),   # 语气硬,但「回归」没落到可核查坐标
    ("未经确认不修改 /infra 与密钥相关文件",           "禁止"),   # 有坐标有前置,成立
    ("改公共 API 前先补充/更新契约测试",               "必须"),   # 门禁动作明确,成立
    ("最好提交信息写清动机",                          "必须"),   # 其实是建议,混进了门禁
    ("变量名尽量语义化",                              "建议"),   # 语气诚实,但「尽量」不可判定
]

VIBE = ["尽量", "最好", "注意", "适当", "一点", "谨慎"]           # 气氛组触发词
HARD = ("必须", "禁止")                                          # 门禁语气
COORD = ["/infra", "密钥", "契约测试", "公共 API"]               # 可核查坐标


def verdict(tone, text):
    """返回 (判定, 处置)。顺序:先抓气氛,再查坐标,语气混装最后算账。"""
    vibe = [w for w in VIBE if w in text]
    if tone in HARD and vibe:
        return "气氛组", f"不可判定(命中 {vibe}):要么补坐标改写成硬句,要么搬家去 90-suggestions"
    if tone in HARD and not any(c in text for c in COORD):
        return "缺坐标", "语气够硬,换个会话却没东西可核查:把关键词登记成路径 / 命令(如 tests/cases/*.yaml)"
    if tone in HARD:
        return "成立", "可判定:违规动作能一句话说清"
    # 建议另册:不可判定的建议不作门禁,但提醒别回头混进硬约束
    if vibe:
        return "建议·软", f"留在软册即可({vibe} 正是它不该进门禁的原因)"
    return "建议·软", "留在软册即可"


def main():
    print(f"== 逐条判定({len(DRAFTS)} 条草稿)==")
    hard_ok, kicked = 0, 0
    for text, tone in DRAFTS:
        tag, why = verdict(tone, text)
        print(f"  [{tag}](声称{tone})「{text}」")
        print(f"         -> {why}")
        hard_ok += tag == "成立"
        kicked += tag in ("气氛组", "缺坐标")

    print(f"\n== 汇总 ==")
    print(f"  真门禁:{hard_ok} 条;被打回:{kicked} 条;建议软册:{len(DRAFTS) - hard_ok - kicked} 条")
    print("  一句话:写不清判定条件的,别进硬约束文件——进了也是噪声,")
    print("         还会在 Context 吃紧时挤掉真红线。")


if __name__ == "__main__":
    main()

跑起来长这样:

== 逐条判定(7 条草稿)==
  [气氛组](声称禁止)「注意安全,别乱改」
         -> 不可判定(命中 ['注意']):要么补坐标改写成硬句,要么搬家去 90-suggestions
  [气氛组](声称禁止)「改动尽量谨慎一点」
         -> 不可判定(命中 ['尽量', '一点', '谨慎']):要么补坐标改写成硬句,要么搬家去 90-suggestions
  [缺坐标](声称禁止)「禁止跳过回归就合并」
         -> 语气够硬,换个会话却没东西可核查:把关键词登记成路径 / 命令(如 tests/cases/*.yaml)
  [成立](声称禁止)「未经确认不修改 /infra 与密钥相关文件」
         -> 可判定:违规动作能一句话说清
  [成立](声称必须)「改公共 API 前先补充/更新契约测试」
         -> 可判定:违规动作能一句话说清
  [气氛组](声称必须)「最好提交信息写清动机」
         -> 不可判定(命中 ['最好']):要么补坐标改写成硬句,要么搬家去 90-suggestions
  [建议·软](声称建议)「变量名尽量语义化」
         -> 留在软册即可(['尽量'] 正是它不该进门禁的原因)

== 汇总 ==
  真门禁:2 条;被打回:4 条;建议软册:1 条
  一句话:写不清判定条件的,别进硬约束文件——进了也是噪声,
         还会在 Context 吃紧时挤掉真红线。

输出你看什么

  1. 一屏把四种判定全走了一遍:气氛组、缺坐标、成立、建议·软——最常见的「正确但无效」条款基本都在前两类里排队;
  2. 「禁止跳过回归就合并」最值得细看:语气没毛病,也没有气氛词,照样被打回——「回归」两个字在别的会话里没东西可核查,登记成 tests/cases/*.yaml 才叫坐标(这条到第 23 篇 YAML 断言会真正闭环);
  3. 「最好提交信息写清动机」声称必须、实为建议——它和上文说的那种混装一个样:安全条款若和提交风格同级,出事时说不清哪条该挡;
  4. 最后一条是诚实的建议,工具不硬拦只点名:不可判定不可怕,装作可判定才可怕;
  5. 汇总那行「真门禁 2 / 打回 4」就是大多数团队硬约束文件的体检报告——先减标语,再加门禁。

自检

动手前勾这张表。勾不上就先别扩散到业务细节,细节会诱惑你写成小说。

# Rule 最小自检

- [ ] 每条硬约束能否用「违规/不违规」判定?
- [ ] 建议类是否已拆到单独文件,没有混进门禁?
- [ ] 加载顺序是否写明全局→仓库→场景?
- [ ] 是否做过至少一次故意违规演练?
- [ ] 文件是否短、标题可检索、带版本或变更说明?
- [ ] 安全、工程、协作三类是否至少各有一条硬约束?

更狠两问。第一,把「尽量」「最好」「注意」从硬约束文件里搜出来——还在吗?在的话,先搬家或改写成可判定句。第二,同事能根据加载顺序解释「为什么这次允许强制推送」吗?不能解释,就是默契,不是机制。默契换人就失效,机制才能进版本库。

再把「可判定」练成肌肉反应。写完一条,反过来做三步自虐:第一,找一个明显违规的最小动作,看条款能不能直接判定;第二,找一个擦边动作,看要不要补条件;第三,找一个完全无关的动作,确认不会被误杀。三条都过,才配进硬约束文件。写制度不怕少,怕假——假制度会培养「反正也就说说」的团队文化,比没有制度更难救。

协作场景里还有一类高频坑:目录默契。大家都知道「公共适配入口别乱动」,却从没写成禁止项。助手一旦听到「顺便整理一下」,就会扩大改动面。把默契晋升成坐标,例如「禁止修改 adaptor/public 入口,除非本会话用户点名路径并确认」,事故半径会立刻缩小。坐标可以版本化,默契换人就蒸发。

有人担心 Rule 写太死会绑住手脚。其实恰恰相反:把真正不能碰的钉死,建议类放软册子,场景例外走显式覆盖,日常改动才会更敢做——因为红线清晰,不再靠胆量和事后道歉。胆小和莽撞,往往都来自红线模糊。

最后补一句给「怕写太死」的朋友:硬约束钉的是事故半径,不是创造力。把不能碰的钉死,反而让日常改动更敢做——因为你知道红线在哪,不必靠事后道歉和群里解释。模糊才制造胆小和莽撞。把这句话贴到规则包首页也行:红线清晰,手脚才自由。团队文化也会跟着从「先改了再说」变成「先问能不能做」。

思考

小结三句。Rule 只承载可判定的必须与禁止,建议另册。加载顺序是冲突裁决机制,必须写明。用故意违规演练验收,而不是「我觉得写了就生效」。

可以理解为:先把宪法写短、写硬、写能判,再谈怎么常驻、怎么按场景加载。下篇专门拆 alwaysApply 和场景路由——规则太多撑爆上下文时,该扔什么、该留什么,可不是「全都留下最安全」。全都留下,往往等于关键条款最先被挤走。

本篇不讲完整业务 Rule 包,也不讲意图关键词怎么配。你现在只要带走一个习惯:落笔前先问「能不能判定」。问完,气氛组发言会少一大半,门禁才有机会变成真的。


上一篇:《不会还有人把 AI 落地当成零散技巧吧?没有主线,越学越乱 | 规则到测试闭环预览》

下篇预告:《不会还有人把全部 Rule 塞进 alwaysApply 吧?Context 一炸,约束就蒸发 | 常驻与场景路由》——常驻内核只留「永远不能错」的那撮。

觉得有用的话,欢迎点赞、留言甩一条你写过最「正确但无效」的 Rule;咱们一起改成可判定版本。有故意违规演练翻车的故事,也欢迎对照本篇拆。

专栏:从小白到AI落地大师|《从 Rule 到落地:AI 工程化实践》