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

查看 11|回复 0
作者:nanyong0627   
Relay Rules
纯手打部分
开发这个项目之前我的困扰
我经常 cc 和 cx 切换实现需求,一个 claude.md 和 agents.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/
  • 您需要登录后才可以回帖 登录 | 立即注册

    返回顶部