agent-scripts — Shared Guardrail Scripts for Agents

简介

可在多个仓库同步复用的 Agent 护栏脚本与 AGENTS 规则：包含技能校验 hook、提交辅助脚本、文档索引工具等，适合把团队默认规范固化成可执行资产，并用指针式 AGENTS 保持一致。

• 适合谁： 希望在多个仓库里共享一致护栏（规则/校验器/辅助脚本），并保持字节级一致的团队
• 可搭配： git hooks、Bun/Node 工具（部分脚本需要）、采用指针式 AGENTS 的任意仓库
• 准备时间： 20–40 分钟

实战建议

• 量化建议：统计有多少仓库采用指针式 AGENTS.MD；目标是单一事实来源，而不是复制粘贴漂移。
• 量化建议：每次提交都跑 validator，记录“skill 校验失败率”的趋势（应逐步下降）。

为什么指针式 AGENTS 更靠谱

把护栏复制到每个仓库，迟早会分叉。 指针式规则的好处是：

• 共享规则只有一个“权威来源”。
• 全局更新快，且更容易回滚。
• 仓库确实需要个性化时，也能清晰地写在指针下方。

安全落地方式

1. 先选一个试点仓库。
2. 在 AGENTS.MD 顶部加入指针行。
3. 仓库特有规则放在指针行之后。

维护习惯

护栏变更只在这里改一次，然后像升级依赖一样推广：写变更点、做一次验证回放。

FAQ

这是只适合个人仓库的做法吗？ 答：不是。多仓库团队普遍需要共享脚本与共享规则；这种模式可泛化复用。

必须装 Bun 吗？ 答：只有在需要重新构建编译版工具时才需要；规则文本与 hooks 仍可独立使用。

最容易踩的坑是什么？ 答：共享规则改了却没有推广/回滚计划；更新应像依赖升级一样管理。