2026年7月2日 2 分钟阅读

多个 AI 编码 Agent 轮番上阵,项目规范总是不一致?用 Klaussy 一统九大 Agent 的配置管理

tinyash 0 条评论

你的团队在用 Claude Code、Cursor、GitHub Copilot 等多个 AI 编码 Agent?每个 Agent 需要自己的规则文件、技能配置、权限白名单——CLAUDE.md.cursor/rules/.github/instructions.md…… 改一次通用规范,就要同步到四五个不同位置,还容易漏掉。项目组成员各用各的 Agent,Review 时发现代码风格全不一样,PR review 时才发现有的 Agent 没遵守约定。

这其实是个常见的多 Agent 协作痛点。Stephanie Dover(前 GitHub、Twitch、Microsoft 工程师)开发的 Klaussy-Agents 就是专门解决这个问题的:你只需维护一份中央规范,klaussy 命令一次编译,就能为九大主流 AI 编码环境生成原生规则、技能和守卫脚本。

Klaussy 是什么

Klaussys 的核心思想很简单——一次编写,处处适配(Write once, align everyone)。你在项目根目录维护一份 CLAUDE.md(或其他中央规范格式),然后运行:

pip install klaussy-agents
cd your-project
klaussy init

它自动扫描你的代码仓库,检测技术栈(Python、Go、Node、Rust、Make),然后为已安装的每个 AI 编码 Agent 生成原生格式的规则文件——不是通用 Markdown,而是每个 Agent 各自认识的配置文件和目录结构。

默认生成全部九种 Agent 的配置。你也可以只针对特定 Agent:

klaussy init --agents claude,cursor

支持九大 Agent 的适配差异

每个 AI 编码 Agent 有自己独特的规则机制。Klaussy 的差异化适配是它最核心的价值:

Agent生成的目标文件特性
Claude Code.claude/skills/.claude/settings.json含 allow/deny 白名单和 read/fetch hooks
Cursor.cursor/rules/*.mdc自动匹配规则、终端权限白名单、.cursorignore
GitHub Copilot.github/instructions.md自定义 applyTo 文件匹配器
Gemini CLIGEMINI.md.geminiignore分层作用域(仅访问子目录时加载)
Codex CLIAGENTS.md.codex/config.toml沙箱配置文件
Google AntigravityAGENTS.mdrules/*.md跨 Agent 项目级规则 + 插件式路径规则
Cline.clinerules/事件命名 hooks(commit、read 等)
AiderCONVENTIONS.md.aider.conf.yml平板约定,支持本地 Ollama
OpenCode.opencode/rules/*.md.opencode/skills/Bun 插件桥接守卫脚本

每种 Agent 的格式、作用域和机制都不同——Klaussy 不只复制粘贴,而是理解每个 Agent 的能力边界后做针对性输出。

智能守卫脚本:超越规则文件

Klaussy 不只会生成静态规则。它还安装了一套跨 Agent 的动态守卫脚本,在 Agent 执行关键操作时自动拦截和保护:

1. 提示注入防御(read_guard.py

当 Agent 读取本地文件或网络内容时,自动扫描是否包含提示注入指令——这个脚本被 Claude Code 和 Antigravity 原生支持,能在外部数据进入 Agent 上下文前拦截恶意指令。

2. 评论人性化(comment_guard.py

Agent 生成的 PR comment、commit message 经常带 AI 腔调?这个守卫会自动去除 AI 填充词、机器人式格式和啰嗦开头,让输出读起来像人类工程师写的。

3. 计划引导(plan_guidance.py

在 Agent 进入计划阶段时注入严格的约束——最少行数变更、不要过度工程化、先写测试——从源头防止 scope creep。

4. Git 提交守卫(commit_guard.py

自动触发项目的 lint 和格式化流程,只有通过检查才允许 Agent 提交,保持 Git 历史整洁。

命名空间技能:每个仓库的专属 Agent 助手

Klaussy 还会为你的仓库生成命名空间技能——以 为前缀的技能,自动适配到每个 Agent 的能力模型:

  • -review:多视角代码 Review(正确性 + 安全 + 架构),自带自我反驳阶段过滤误报
  • -debug:5 阶段 Bug 修复流程,先复现 Bug → 写失败测试 → 实现修复 → 跑全量测试
  • -plan:多阶段计划执行,写 plan.md 后等待人工确认才修改文件
  • -precommit:对暂存变更做安全检查(泄露密钥、调试残留、冗长注释)
  • -humanize:调用 Klaussy 的确定性正则引擎清理 AI 痕迹

加上内置的 commitprimplementrefactorexplaintestnew-worktree 等技能,每个 Agent 上手就有了完整的项目 QA 基础设施。

更多集成方式

除了 CLI,Klaussy 还提供多种使用入口:

作为 Claude Code 插件:

/plugin marketplace add steph-dove/klaussy-agents
/plugin install klaussy@klaussy

作为 MCP 服务器(.mcp.json 配置):

{
  "mcpServers": {
    "klaussy": {
      "command": "klaussy-mcp",
      "env": { "PYTHONUNBUFFERED": "1" }
    }
  }
}

Python SDK 编程方式:

from klaussy import toolkit

toolkit.init(repo=".", agents=["claude", "cursor"])

适用场景

  • 团队协作:多人各自使用不同 Agent,需要一个统一的规范出口
  • 多 Agent 工作流:同一个人在不同任务中选择不同 Agent(大小模型灵活切换)
  • CI/CD 集成:在 pipeline 中自动校验 Agent 配置是否过时
  • 开源项目:为贡献者提供清晰、无歧义的 Agent 引导文件

写在最后

Klaussy 目前是 v0.13.0,MIT 许可证,支持 Python 3.10+。它解决的是一个看似简单却在实际使用中反复踩坑的问题——当你在一个项目里同时使用多个 AI 编码 Agent,规范管理就成了麻烦。与其手动维护四五份不同格式的配置文件,不如用一个 klaussy init 一次性搞定。

如果你在团队中同时推广多个 AI 编程工具,或者自己日常在 Claude Code 和 Cursor 之间切换,Klaussy 可以帮你在配置管理上节省不少精力。

💡 小贴士:Klaussy 的守卫脚本默认只在支持它们的 Agent 上激活(Claude Code、Antigravity)。如果某个 Agent 不支持动态守卫,它会优雅降级为静态规则。

参考链接

发表评论

你的邮箱地址不会被公开,带 * 的为必填项。