canonkit

一个版本化的AI子代理团队 克劳德代码， 食典委 和 OpenCode. 每个代理拥有一个领域：产品、架构、安全、质量、用户体验、 性能、操作或文档。在提出任何建议之前，它会对风险进行评估 关于变化。小的，可逆的工作留给你的主代理。更改为auth， 秘密、移民或公共合同归拥有它们的代理机构所有。在克劳德。 代码中，钩子强制执行最重要的规则，因此它们即使在模型失效时也能保持不变 忘记他们。Codex和OpenCode得到了最重要的两个：没有git钩子 绕过并没有秘密写入文件。

每个特工都有一个Markdown文件 agents/的格式 克劳德代码是这样写的。对于Claude Code，安装是一个纯拷贝。法典和开放代码 获取同一主体的生成副本。不管怎样，每个特工都有一个信息源， 也不需要手工调和。

canonkit 1。X不是canonkit 0.x。 版本到 0.2.0 我们是不同的 工具。它生成了spec - kit风格的治理模板(.specify/,一个 结构，尺度轮廓)通过 canonkit init． 该工具已归档并 这里不存在它的任何命令。如果你用过，别针 [email protected].

是给谁的？

• 你使用Claude Code， Codex或OpenCode与子代理，你想要每一个 叫 只有当它的领地处于危险之中时，而不是每一个变化。
• 你想要一些保证，即使模型忘记了它们：确认 之前 git commit 和 git push，保密，并要求审查前 高风险变更算完成。
• 您希望了解委托成本（令牌、时间、每次分派的报告大小） 不用从你的机器上发送任何东西。

如果您希望每个任务一个代理，或者一个繁重的规范优先进程，那么它就不合适了。 Canonkit可以配合使用 openspec，但它不能取代它。

快速入门

要求Node 18+。在Linux、macOS和Windows上：

npx canonkit install --wire-hooks

在终端中，一个菜单询问安装哪个运行时。克劳德法典和法典 预先确定;OpenCode是可选择加入的。 --wire-hooks 每个门钩的电线 您选择的运行时间： ~/.claude/settings.json， $CODEX_HOME/hooks.json (然后运行 /hooks 在Codex一次信任它)，以及OpenCode 2插件。它保存了一个过时的 .bak 对于每个配置文件，它只更改，不更改其他任何内容。如果你离开 国旗, install 只打印Claude Code的JSON供您粘贴。 每个选项写了什么.

Codex代理默认为 gpt-6.1-sol． 遵循你的法典会议模式 而不是固定一个版本，设置 CANONKIT_CODEX_MODEL=inherit 当安装。 看到 模型配置 对于PowerShell 例如，覆盖和更新现有代理。

检查它是否有效：

npx canonkit doctor

doctor 只读取。每次检查打印一行(OK， WARN 或者 FAIL), 如果任何操作失败，则以1退出：

OK   agents: 10 core agents in ~/.claude/agents
OK   reference: managed blocks in ~/AGENTS.md and ~/.claude/CLAUDE.md
OK   hook file: ~/.claude/hooks/canonkit-hook.js, same as this package's
OK   hook syntax: node --check passes
OK   hook wiring: registered with its matcher under PreToolUse, PostToolUse, SubagentStop, UserPromptSubmit, Stop
OK   log: ~/.claude/canonkit-activity is writable
OK   forwarder: no meu-time-hook.js left, and no settings in sight run it
OK   config: file none (defaults), root ~/my-project

No check failed.

然后在任何项目中打开一个新的Claude Code会话：

1. /agents 应列出十大核心代理商(scott， archie， bob,……)。
2. 让它做点什么。你应该找个 canonkit gate: git commit/push requires explicit user authorization 提示。下降;你刚看到一扇门 火。没有提示吗?看到 如果没有门着火.

可选：仪表盘。 它在本地运行，并显示分派、令牌和 盖茨:

node ~/.claude/canonkit-dashboard/serve.js          # Linux, macOS, Git Bash
node $HOME\.claude\canonkit-dashboard\serve.js      # Windows PowerShell

然后打开 http://localhost:4317. 它记录了什么.

它如何决定：低还是高

每个代理使用一个共享的风险量表：

• 低：本地可逆。没有公开合同，认证，敏感数据或 运行时共享。
• 媒介：新的规则、流程、集成、许可或配置；一个 共享重构;一个貌似合理的回归。
• 高：认证，秘密，迁移，公共合同，新服务，支付，等等 生产部署，或任何难以回滚的部署。

下面两个例子都来自 路由eval 例:

“改正错别字 recieve 在README.md。” 这是LOW。主代理修复它 内联且不分派任何人。派遣需要一个冷启动，外加一份报告 之后的每一回合都要重读一遍，为了一个词的修正。

添加刷新令牌 src/auth/session.js”。 这是高的，因为它 触动身份验证。事情是这样的：

1. 主要代理商计划引进 加尔省 （保安），业主的授权。
2. 编辑 src/auth/session.js 启动高危门，然后你确认 编辑。
3. 这部作品没有按作者的要求完成。当转弯结束时，停闸 检查独立审稿人(Quinn, Gard, Archie， Perry或a 项目审阅者)被分派，或通过消息恢复， 最后一次之后 封闭的编辑． 如果没有，它会阻塞一次转弯 然后要了一个。

有一种情况介于两者之间：在 评论 在 src/auth/messages.js． 门仍然会触发，因为文件在 auth/。这个 但风险仍然很低，预期的行为是确认，解释为什么， 和 不 把加尔拉进来。一扇门告诉你要重新审视风险；事实并非如此 使改变高。

这个团队

核心：安装在用户级别，可用于每个项目。

专家：默认不安装。项目只有在添加时才会得到一个 这样就不会有特工被召来补全名单了

cd my-project
npx canonkit add maya nova      # writes Claude Code, Codex and OpenCode copies + the project's AGENTS.md

否决权是微弱的。 代理只能在自己的域内使用否决权 中等或高的变化，并且只针对它可以命名的风险。你可以否决a 否决。当你这样做时，代理记录下未付风险并继续帮助你。谁拥有 在边界，每个代理遵循的约定，以及集成 审查正在进行中 文档/ team.md.

堆栈包，每个项目

可选技能 向现有团队添加语言和框架指导。 选择项目使用的包；每个都是与核心分开安装的。

从项目中运行这些命令。你可以一次添加几个包，检查 什么是安装和删除包时，您停止使用它：

cd my-project
npx canonkit add typescript react
npx canonkit list
npx canonkit remove react

React和TypeScript是独立的。添加一个包安装它的指令； 它不安装编译器、运行时或项目依赖项。

拷贝到项目的 .agents/skills/canonkit-<stack>/ 和 .claude/skills/canonkit-<stack>/． 保存本地编辑和不相关的文件； 重复 add 更新完整的副本。细节，恢复和移除 文档/ install.md.

当门着火时

这张表是Claude Code。Codex和OpenCode一旦连接起来，就只执行git 旁路块和秘密块，用同样的理由文本 （哪个登机口在哪里）。 git、secret、高风险和性能提示符以 canonkit gate． 停止门开始于 Definition-of-done gate． 上下文大小的提醒是纯文本。

假警报。 高风险门匹配路径，所以它有时会触发 文件夹命名 sessions/ 或者 contracts/ 这与真实无关。每一个 项目可以调整这个 .claude/canonkit.json：

{
  "version": 1,
  "highRisk": { "include": ["src/billing/**"], "exclude": ["src/domain/contracts/**"] },
  "perfBudgets": ["perf/thresholds.yml"]
}

exclude 只能沉默暧昧的话。它从不让秘密支票沉默， 凭据路径(.env， *.pem，……)或强烈措词(auth， jwt， migrations 在代码中)。编辑 canonkit.json 它本身就是一扇门。不要编辑 钩子使门停止发射：下一个安装覆盖它。完整的规则 在 文档/ hooks.md.

如果没有门着火

运行 npx canonkit doctor． 钩子打不开 目的，所以一个坏的或未注册的钩子永远不会阻止你的会话。这也 意思是钩子断了不会发出警告。

运行时

每个目标是如何生成的，以及为什么OpenCode是可选的： 文档/ install.md. 哪个门在每个运行时做什么： 文档/ hooks.md.

命令

--dry-run 工作于每一个写的命令：它报告什么会改变和 写什么。

常见问题解答

每回合的成本是多少？ 克劳德代码列出了所有已安装的代理程序 每个回合的描述。这个列表加上两个全局块总共是 3 k令牌。代理的整个主体（约1-2k个令牌）仅在代理处于 派遣。 测量.

它会对每一笔小额找零都派出特工吗？ 这是不应该的。低工作时间 按规则内联。在每次发布之前，改变指令，路由 Eval用上面的拼写错误修复之类的情况检查这一点。如果你看到它发生， 请 打开一个问题.

我可以编辑已安装的代理吗？ 不到位：下一个 install 覆盖 ~/.claude/agents 还有托管块。要更改一个，请创建一个 使用不同名称的项目代理，或者更改此处的源代码并重新安装 （文档/ maintaining.md）. 托管块之外的文本 标记 ~/AGENTS.md 和 ~/.claude/CLAUDE.md 是你的，被保存。

有东西离开我的机器吗？ 钩子使遥测保持在本地 ~/.claude/canonkit-activity/;新记录省略任务描述和命令 片段，但仍然包括路径和标识符以及计数和计时。 旧的记录可以保留这些文本直到轮换。两个 项目附带问题 还有可选的 学习循环贡献 提供经消毒的草稿；出版需要您的审阅和明确授权。原始的日志 而个人的回忆不属于一份贡献。 字段列表.

一扇门在变化中被点燃，我确定是低的。 确认并说明原因。如果是一样的 路径总是无缘无故触发门，加到 highRisk.exclude (见 当门着火时）。

如何卸载？ 运行 npx canonkit uninstall --dry-run 预览一下 npx canonkit uninstall （或选择带标志的挽具）。它使用安装 清单，备份编辑过的藏物，完整保存观察到的藏物 并保持外部内容的管理 块。预清单安装和模糊的布线需要手动清理；看到 文档/ install.md.

我升级 meu-time. install 迁移日志文件夹和树叶 旧钩子名的转发器。看到 文档/ install.md.

文档

许可证

麻省理工学院