爱意满满的作品展示区。
nanyong0627

[Relay Rules]agent 全局规则千篇一律,项目级规则很难管理,所以我开发了一个 Relay Rules

  •  
  •   nanyong0627 · 12h 42m ago · 359 views

    Relay Rules

    纯手打部分

    开发这个项目之前我的困扰

    我经常 cc 和 cx 切换实现需求,一个 claude.mdagents.md 我很难同步管理。

    经常项目级的规则是陈旧的、错误的,会导致 cc 和 cx 需要花大量时间再重头捋,或者是直接按照规则就往下开发了。

    经常让他们完成一个需求,他们考虑不全面,可能单单的就完成了这个,没有前后形成闭环。

    项目级规则越来越大,越来越乱,我不知道怎么管理了,重新一次次的让他们以真实代码为例。

    许多 agent 在代码里命名、注释有些随意,导致下个对话的时候,可能他就以命名、注释来直接省事接着写。

    agent 总结部分

    Relay Rules 把几件事接住了:

    • 新会话不从零开始:有交接、规则和上下文入口,agent 能接着上次做。
    • 不盲信旧文档:旧规则、README 、记忆都只能当线索,最终要看当前代码、配置、测试和工具输出。
    • 规则会跟着项目变:代码改了以后,会提示哪些规则可能过期,让 agent 去核实、更新、拒绝或留给用户确认。
    • 危险操作有窄门禁:比如强推、硬重置、删除、发布、生产变更,不让 agent 随手干。
    • 做完才算完:不是“改了代码就结束”,还要检查候选事项、验证路径、交代剩余风险。
    • 跨 Claude / Codex 可复用:同一套项目规则能给不同 agent 接力用,减少各说各话。

    核心理念是:让 agent 像一个靠谱的长期协作者,而不是一次性问答工具。

    可以拆成几条:

    证据优先

    不相信“以前写过什么”,先看当前代码、配置、测试、命令结果。文档和记忆只是线索。

    规则要活着

    项目会变,规则也要跟着变。不是写一堆 AGENTS.md / CLAUDE.md 放那儿老化,而是代码变了就提醒 agent 复查规则。

    渐进加载

    不把所有规则一次塞进上下文。平时只保留很短的总规则,碰到 UI 、发布、数据同步等具体领域时,再加载对应规则。

    agent 自己负责闭环

    普通实现细节不用总问用户。agent 应该自己判断、修改、验证、说明结果。只有高风险、不确定、会影响用户或线上状态的事才找用户确认。

    少拦截,但拦关键风险

    不把系统做成到处卡人的流程。真正硬拦的主要是危险命令和未处理的高风险事项,比如发布、生产、密钥、计费、删除。

    接力而不是重来

    一个会话没做完,要留下交接;下个会话能接着目标、基线、已验证和未验证的地方继续做。

    一句话说就是:

    Relay Rules 的理念是:用少量常驻规则、按需上下文、当前证据和窄门禁,把 AI agent 从“会写代码”推到“能长期、可靠、可接力地完成项目工作”。

    具体可以看 github: https://github.com/liyuhao957/relay-rules/

    No Comments Yet
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   1427 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 25ms · UTC 16:59 · PVG 00:59 · LAX 09:59 · JFK 12:59
    ♥ Do have faith in what you're doing.