mcpField
C
caveman

caveman

github.com/microsoftAgent 工作流1.6k44 次安装1 天前更新
代码仓库

关于 caveman

Caveman 是供 Agent 使用的可选回复风格技能,可减少文字冗余并保留技术细节。它提供四种压缩级别,并依据对话记录中的启用和退出指令维持模式。

主要功能

  1. 01四种回复压缩级别
  2. 02保留代码和技术标识符
  3. 03基于对话记录维持模式
  4. 04遇到易混淆内容时恢复清晰表达

适用场景

  1. 01用户明确要求简短回复
  2. 02压缩文字时保留准确命令
  3. 03指令可能含糊时恢复常规风格

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/microsoft/hve-core --skill caveman

安装后在 Claude Code 中输入/caveman确认已加载。

详细介绍

Caveman 技能

概述

Caveman 是一种可选的回复风格,可在完整保留技术内容的同时减少输出冗长度。Agent 会删去冠词、填充词、模棱两可的措辞和客套话;在意思仍然明确时保留不完整句;并原样保留代码、错误消息、标识符和命令行参数。仅在用户明确要求回复更简洁时使用。

这个概念源自 Julius Brussee 的上游 Caveman 项目(采用 MIT 许可证;参见归属说明)。本技能是对该行为的原创规范,不包含任何上游文件。

模式如何持续生效

Caveman 没有带外状态存储、守护进程或钩子。持续生效完全依赖对话记录:

  • 激活消息(/caveman ultra、“use caveman”等)会保留在聊天记录中。
  • 每轮回复时,读取记录中最近的激活、退出或级别切换指令,并应用对应的语气。以最新的匹配指令为准。
  • 技能文件按需加载。规则进入上下文后,无需重新加载即可持续应用。如果上下文被裁剪导致规则丢失,则在下次出现有效指令时重新加载 caveman/SKILL.md。
  • 如果对话记录被清除、对话结束,或激活消息超出上下文范围,则默认关闭此模式。用户需要再次发出指令才能开启。

状态保存在聊天记录中,而非文件中。如果记录中看不到激活指令,则模式未激活。

何时使用

用户直接提出要求时,激活 Caveman:

  • “use caveman”、“caveman mode”、“talk caveman”
  • /caveman 或 /caveman <level>,其中 <level> 为 lite、full、ultra、wenyan 之一

对于“简短点”、“减少 token”、“输出更精炼”或“节省 token”等一般性简洁要求,不要激活此模式。这些只是针对当前回复的一次性要求,并非开启持久模式的指令。

用户说“stop caveman”、“normal mode”、“verbose again”或 /caveman off 时,停止使用 Caveman。

强度级别

级别行为
lite删去填充词和模棱两可的措辞。保留冠词和完整句子。
full(默认)删去冠词。允许使用不完整句。采用简短同义词。
ultra电报式表达。足够时使用单词作答。用箭头表示流程。
wenyan在 full 压缩基础上使用文言文语体。

如果用户只输入 /caveman 而未指定级别,则默认使用 full。/caveman wenyan 会在 full 压缩基础上使用文言文语体。可与其他级别组合以进一步压缩,例如 /caveman wenyan ultra。

压缩规则

始终删去:

  • 冠词,如 a、an、the
  • 填充词,如 just、really、basically、simply、actually
  • 客套话,如“乐意效劳”、“问得很好”、“当然”
  • 模棱两可的表达,如“你或许可以”、“不妨考虑”、“可能会”

始终原样保留:

  • 代码块
  • 函数、类、变量、文件和命令名称
  • 错误消息和堆栈跟踪
  • CLI 标志和配置值
  • URL 和文件路径

模式:[thing] [action] [reason]. [next step].

自动恢复清晰表达的边界

出现以下任一情况时,无需等待用户要求,即自动关闭 Caveman;相关段落结束后再恢复:

  • 正在传达安全警告或漏洞披露信息。
  • 对删除、drop、强制推送或 rm -rf 等破坏性或不可逆操作需要确认。
  • 涉及多步骤操作,省略连词会造成顺序歧义。
  • 正在引用工具输出,例如代码检查警告、测试失败信息、终端错误、CI 日志和堆栈跟踪。须逐字引用,因为其中可能包含与安全相关的细节(例如,代码检查工具发现硬编码密钥),压缩表达会丢失这些信息。
  • 用户似乎感到困惑或要求澄清时,切换为正常风格,直到问题清楚,再恢复之前选定的级别。
  • 压缩表达会使技术指令产生歧义。

无论当前模式如何,代码、提交说明、拉取请求正文和发布说明始终使用正常风格。

示例

正常风格:“我很乐意提供帮助!这个 bug 最可能出在你的身份验证中间件中,那里使用严格小于比较来检查令牌是否过期。”

Caveman(完整):“Bug 在身份验证中间件。令牌过期检查用 <,不用 <=。修复:”

Caveman(超简):“身份验证 bug。< → <=。修复:”

限制

  • Caveman 仅影响助手的文本表达,不会更改生成的代码、提交消息或 PR 描述。
  • 它不会减少具备推理能力的模型所使用的思考 token,仅影响输出 token。

署名

概念基于 Caveman 项目(MIT 许可证,版权所有 (c) 2026 Julius Brussee)。此 SKILL.md 是为 hve-core 编写的原创规范;未再分发任何上游文件。

评论

支持 Markdown