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/