Repolode
coldteadotai

coldteadotai/abide

借助决策模型逐次检查每次编辑,让编码智能体遵守项目说明文件中的规则,违规即自动修复。

Star
623
Fork
47
未关闭 Issue
5
最近提交
28天前

这是什么?

Abide 面向 Claude Code、Codex、OpenCode 和 Pi 等编码智能体。AGENTS.md、CLAUDE.md 这类项目说明中常有 lint 工具无法检查的规则,例如“不要让原始错误信息直达用户”。Abide 把每条规则转换成一个问题,在每次编辑后或一轮对话结束时,交给 TypeSafe 的决策模型 Jev 打分。Jev 只看到规则和代码差异,看不到对话内容。

分数达到阈值时,智能体会被告知违反了哪条规则,并在同一轮中修复代码;中等分数只向用户显示提示,不触发修复。规则保存在可读、可提交的 .abide/rubric.json 中,判断有误时改写规则即可。命令行还支持审计现有文件、检查未提交改动以及回放历史会话。

安装通过 npx 完成,需要 TypeSafe 或 Vercel AI Gateway 的密钥。钩子可按智能体安装,也可安装到项目中,随代码库一起分发给团队成员。

核心功能

  • 01对每次编辑或每轮对话,逐条检查说明文件中的规则。
  • 02指出被违反的规则,并要求智能体在同一轮中修复。
  • 03规则保存在可提交、便于阅读的 rubric 文件中。
  • 04支持 Claude Code、Codex、OpenCode 和 Pi。
  • 05提供命令行审计现有文件、检查未提交改动。
  • 06可按文件 glob 限定规则范围,并用 .abideignore 排除文件。

适用场景

  • 强制执行 lint 无法检查的约定,如指定校验库或错误处理方式。
  • 防止智能体在长时间编码中引入不必要的抽象或超大文件。
  • 依据已有的书面规范审计现有代码库。
  • 通过项目仓库让团队共享同一套智能体规则。

快速上手

  1. 1

    保存你的 TypeSafe 或 Vercel AI Gateway 密钥

    npx @coldtea/abide login
  2. 2

    将钩子安装到本机所有代理中

    npx @coldtea/abide init
  3. 3

    像平常一样启动你的代理(claude、codex、opencode 或 pi)

使用前须知

  • 检查需要 TypeSafe API 密钥或 Vercel AI Gateway 密钥以及网络连接。
  • Codex 需要手动在 /hooks 中接受新的钩子条目。

收录于专题

标签

常见问题

abide 是什么?
借助决策模型逐次检查每次编辑,让编码智能体遵守项目说明文件中的规则,违规即自动修复。 Abide 面向 Claude Code、Codex、OpenCode 和 Pi 等编码智能体。AGENTS.md、CLAUDE.md 这类项目说明中常有 lint 工具无法检查的规则,例如“不要让原始错误信息直达用户”。Abide 把每条规则转换成一个问题,在每次编辑后或一轮对话结束时,交给 TypeSafe 的决策模型 Jev 打分。Jev 只看到规则和代码差异,看不到对话内容。
abide 可以免费使用吗?用的什么许可证?
abide 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
abide 还在维护吗?
活跃维护中。abide 最近一次提交是在 2026年10月10日。
abide 适合用来做什么?
强制执行 lint 无法检查的约定,如指定校验库或错误处理方式。 防止智能体在长时间编码中引入不必要的抽象或超大文件。 依据已有的书面规范审计现有代码库。 通过项目仓库让团队共享同一套智能体规则。
abide 怎么安装和运行?
保存你的 TypeSafe 或 Vercel AI Gateway 密钥: npx @coldtea/abide login 将钩子安装到本机所有代理中: npx @coldtea/abide init 像平常一样启动你的代理(claude、codex、opencode 或 pi)
在哪里获取 abide?
源代码和安装说明在 GitHub 上:https://github.com/coldteadotai/abide

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目