多个 AI 编码 Agent 轮番上阵,项目规范总是不一致?用 Klaussy 一统九大 Agent 的配置管理
你的团队在用 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 CLI | GEMINI.md、.geminiignore | 分层作用域(仅访问子目录时加载) |
| Codex CLI | AGENTS.md、.codex/config.toml | 沙箱配置文件 |
| Google Antigravity | AGENTS.md、rules/*.md | 跨 Agent 项目级规则 + 插件式路径规则 |
| Cline | .clinerules/ | 事件命名 hooks(commit、read 等) |
| Aider | CONVENTIONS.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 :5 阶段 Bug 修复流程,先复现 Bug → 写失败测试 → 实现修复 → 跑全量测试-debug :多阶段计划执行,写-plan plan.md后等待人工确认才修改文件:对暂存变更做安全检查(泄露密钥、调试残留、冗长注释)-precommit :调用 Klaussy 的确定性正则引擎清理 AI 痕迹-humanize
加上内置的 commit、pr、implement、refactor、explain、test 和 new-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 不支持动态守卫,它会优雅降级为静态规则。
参考链接