如何为Caveman贡献新Agent Profile:开源贡献完全指南
如何为Caveman贡献新Agent Profile开源贡献完全指南【免费下载链接】caveman why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman项目地址: https://gitcode.com/GitHub_Trending/caveman1/cavemanCaveman 是一个让 AI 编码 Agent「少说废话、少读废料」的 Token 压缩工具——它通过本地代理在每次调用前压缩 Agent 的输入基准测试显示可削减 33.2% 的输入 Token。而让 Caveman 支持一个新 Agent 的最简单方式就是贡献一个Agent Profile一个纯声明式的 JSON 文件教会caveman wrap如何把任意 AI 编码工具接入 Caveman 网关。本文带你完整走一遍开源贡献流程读懂契约、编写 Profile、通过编译器安全校验、提交 PR。为什么 Agent Profile 是最快上手入口对新手来说Caveman 贡献路径中最友好的一条就是纯 Profile 贡献只加一个 JSON 文件不改任何代码只要目标 Agent 说的是已有的通信协议、用已有的注入方式就属于数据级变更CI 全绿即可合入无需人工逐行评审。官方把这条路径称为最快的贡献路径规则都写在 docs/CONTRIBUTING_PROFILES.md 里。下面这张演示图展示了 Caveman 的效果同样是解释 React 重渲染问题穴居人版本 69 Token 变 19 Token修复方案完全一致。一个 Profile 到底在声明什么Profile 的本质是一组路由说明书告诉 CLI 三件事这个 Agent 说哪种协议wire protocol——Caveman 代理如何与它对话CLI 如何把它指到网关injection——改环境变量、还是写临时配置文件有没有可挂的钩子面command hook / memory hook——用于自动压缩命令输出、注入记忆。现有的 7 个原生 Profile 都在 agents/profiles/ 目录下可以直接抄作业示例 Profile协议注入方式aider.jsonopenai-chat环境变量codex.jsonopenai-responses环境变量gemini.jsongemini-generatecontent环境变量openclaw.jsonopenai-chat配置文件覆盖贡献前准备克隆仓库并定位关键文件先克隆仓库仓库是只读的不要直接改主分支git clone https://gitcode.com/GitHub_Trending/caveman1/caveman贡献 Profile 时你只需要关注这几个文件贡献规则docs/CONTRIBUTING_PROFILES.md契约 Schemaagents/profiles/schema.json——Profile 的法律条文注册表编译器agents/compile.mjs——校验并生成注册表保留命令表agents/reserved-verbs.json——Profile ID 不能撞车生成产物agents/agents.json发布用注册表一个 Profile 长什么样看懂必填字段以 gemini.json 为例一个最小可用的 Profile 包含这些必填字段schema_version固定为1idkebab-case、全局唯一就是caveman wrap id的选择器display_name/vendor/homepage展示信息binary_namesAgent 的可执行文件名用于自动探测install一行安装提示二进制缺失时展示wire_protocol只能选已有协议未知值会直接编译失败官方原则绝不猜测协议injection注入方式三选一。四种受支持的 wire protocol 定义在 agents/compile.mjs#L31-L35anthropic-messagesopenai-chatopenai-responsesgemini-generatecontent注入方式则有三种env环境变量、config-env-content内联 JSON 配置、config-file合并到用户配置文件。openclaw.json 展示了config-file写法的完整形态。编写你的新 Profile四步走第一步创建文件新建agents/profiles/你的id.json。注意id必须是小写字母数字加连字符如myagent且不能与保留命令冲突——先对照 reserved-verbs.json 里的 57 个保留词wrap、start、hooks、learn等都会撞车编译报错会直接点名冲突命令。第二步选择协议与注入方式打开目标 Agent 的文档确认它对 API 端点的控制方式支持通过环境变量改 Base URL→ 用env方法通过配置文件控制→ 用config-file方法。✅ 提示优先选env最简单injection_completeness可标为declarative真正的数据级添加。第三步填写诚实标签Caveman 有个鲜明的文化诚实声明绝不占位。两个关键字段tested_agent_version你实际验证过的 Agent 版本号没测过就填xinjection_completenessdeclarative纯声明即可路由/builder-assistedCLI 代码有辅助/code-only声明仅为摆设。编译器会交叉核对 CLI 实际构建器虚假声明会直接失败。第四步可选钩子如果目标 Agent 有工具调用钩子可声明command_hook自动把冗长命令输出压小目前没有可用钩子面就留空——留空是诚实的上限不代表功能缺失。四条安全边界编译器不会放过你Profile 编译器是**fail-closed失败即关闭**设计不认识的字段、未知的模板、危险的路径一律构建报错没有强制通过开关。四条硬性安全规则环境变量名白名单键必须形如*_BASE_URL、*_API_KEY、*_AUTH_TOKEN等PATH、NODE_OPTIONS这类加载器控制键被明确拒绝环境值只认模板值只能是{{cave_base_url}}、{{cave_proxy_url}}、{{cave_api_key}}、{{cave_org_id}}四个模板之一或安全标识符字面量写死 URL 或未知模板 编译失败路径圈禁指令与基础配置路径必须位于~/.profile-id/之下禁止..、绝对路径、跨 Profile 目录保留命令防撞Profile ID 和所有二进制名不得与 CLI 现有命令冲突。这些规则的实现见 agents/compile.mjsSchema 中的正则契约见 agents/profiles/schema.json#L9-L20。本地验证与提交 PR一键编译步骤Profile 写好后运行编译器重新生成注册表输出是确定性的同样输入不会产生 diffnode agents/compile.mjs npm install --ignore-scripts --no-audit --no-fund --no-package-lock --prefix packages/cli npm --prefix packages/cli run build node --test packages/cli/tests/agent-registry.runtime.mjs packages/cli/tests/agent-shortcut.runtime.mjs packages/cli/tests/porcelain.runtime.mjs⚠️提交清单三者缺一不可你的agents/profiles/id.json重新生成的agents/agents.json重新生成的packages/cli/src/agents.generated.ts。生成文件必须和源文件在同一个 PR里。最后项目采用开发者原创证书DCO每个提交都要签名git commit -s -m add id agent profileProfile-only 的 PR 在 CI 全绿后即可合入——CI 会重跑编译器、假 Agent 矩阵和首屏帮助快照。什么时候必须走代码评审如果你的目标 Agent 需要以下任何一项那就不是纯 Profile 变更而是核心改动必须先开讨论、走完整代码评审全新的 wire protocol全新的注入方法或钩子方法新的环境变量键形态或模板词汇需要修改编译器白名单或保留命令表此项强制创始人评审。 另请注意许可边界Profile 属于 MIT 目录LICENSING.md而引擎相关代码是 BSL-1.1详见 CONTRIBUTING.md 的贡献许可章节——如果你的改动只碰agents/profiles/MIT 规则最简单。新手贡献 FAQ问目标 Agent 用了全新的 API 协议怎么办答不要自己硬造协议。开一个 Discussion 先问或邮件联系维护者新协议属于核心变更。问为什么我的id编译报错答大概率撞了 reserved-verbs.json 里的保留命令换个 ID 即可。问可以只提交 JSON 不提交生成文件吗答不行。CI 会重新编译并比对产物缺失的生成文件会直接挂掉。问保持 PR 多小答一个 Profile 一个 PR。小而聚焦的 PR 审核最快。现在你已经掌握了从读懂契约到 PR 合入的完整链路——下一个让 30 Agent 生态再添一员的也许就是你的 Profile。【免费下载链接】caveman why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman项目地址: https://gitcode.com/GitHub_Trending/caveman1/caveman创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

舞台直拍视频后期全流程:音画同步、降噪与编码实战

舞台直拍视频后期全流程:音画同步、降噪与编码实战

如果你是一位经常观看线下演出、追虚拟偶像 live,或者本身就是视频创作者,大概率遇到过这样的情况:官方机位虽然稳,但镜头切得很碎,台上五个人,镜头永远只给C位。反而是现场某个角落拍出来的“舞台直拍”&a…

2026/10/25 19:27:14 阅读更多 →
AI会取代模拟IC工程师吗?Razavi教授:工具会进化,判断力仍是稀缺资源

AI会取代模拟IC工程师吗?Razavi教授:工具会进化,判断力仍是稀缺资源

AI会取代模拟IC工程师吗?Razavi教授在IEEE研讨会上给出了他的判断 最近两年,大模型席卷了几乎所有技术领域。代码生成、文档撰写、版图初步规划,AI在数字IC设计流程里已经渗透得相当深。于是很多做模拟IC的工程师心里开始打鼓:数…

2026/11/21 16:17:50 阅读更多 →
POD商品图批量生成:AI图案提取、自动上样与裂变设计工作流

POD商品图批量生成:AI图案提取、自动上样与裂变设计工作流

我做POD(按需打印)电商相关工具调研时,最常听到的一个抱怨不是“不会设计”,而是“时间全花在重复劳动上”。一张图案,要先从原图里抠出来,再拖到T恤模板上调整位置、角度、光影,最后导出一张商…

2026/11/15 15:22:09 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/20 23:27:28 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/20 23:27:28 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/20 23:27:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/20 21:55:32 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/20 23:27:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/20 22:59:12 阅读更多 →

日新闻

周新闻

月新闻