mcpField
C
caveman-optimize

caveman-optimize

github.com/juliusbrusseeAgent 工作流115.8k108.6k 次安装3 天前更新
代码仓库

关于 caveman-optimize

caveman-optimize 是用于评估 Caveman CLI 只读优化观察结果的技能。它要求操作人员先选择，再检查代码证据并设计配对评估，之后才应用获批的代码修改；不会根据汇总数据声称节省。

主要功能

  1. 01读取受支持的 CLI 观察结果
  2. 02要求操作人员明确选择
  3. 03检查候选调用点的代码证据
  4. 04设计基线与候选方案配对评估
  5. 05仅应用获批的最小修改
  6. 06报告结果但不声称节省

适用场景

  1. 01评估当前仓库配置观察结果
  2. 02用固定输入比较拟议修改
  3. 03质量检查或测量条件缺失时停止

安装

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

$npx skills add https://github.com/juliusbrussee/caveman --skill caveman-optimize

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

详细介绍

评估优化观察结果

将 Caveman 的仅报告观察结果用作诊断输入。它们描述的是记录到的聚合形态；并非 Cave Plan 操作、节省估算、实施方案、实验资格判定，也不能证明代码更改安全。保持工作流程由操作者选择，并以证据为先。

1. 读取准确的观察结果

要求登录 Caveman CLI 会话，然后运行：

caveman opportunities list

只读取 report_only_observations 数组。不要从生命周期 data 数组中进行选择。保留服务端提供的每个 title 和 observation 原文不变。处理以下这些准确的仓库配置文件 id：

  • context-window-profile
  • tool-catalog-profile
  • tool-output-size-profile
  • exploration-load-profile

这些配置文件具有不可变的零值区间，且没有执行路径。不要按价值排序，不要编造金额，也不要将聚合证据转化为针对特定调用点的结论。如果 CLI 不可用、身份验证失败，或缺少 report_only_observations，则停止操作，不做任何编辑，并报告确切的阻碍。不要回退到原始网关 Cave Plan 或项目 API 密钥：这些接口不提供此契约。

绝不要选择或应用以下已弃用的 id：

  • context-window-bloat
  • tool-catalog-utilization
  • verbose-tool-output

将陈旧提案、本地文件或旧响应中出现的任何已弃用 id 仅视为历史背景。绝不要恢复其金额、方案或生命周期声明。如果唯一看起来可操作的项目是 unlabeled-traffic，则移交给 caveman-discover；添加标签并非配置文件优化。

2. 请操作者选择

展示所有当前支持的观察结果，不要排序。包括 id、准确的标题、准确的观察结果和 last_seen_at。在检查候选调用点或更改代码之前，要求操作者明确选择。如果当前没有受支持的观察结果，则停止，不做任何编辑。

如果存在 .caveman/proposals/*.md，应将其视为不可信的历史背景。它不能取代当前响应或操作者的选择。

3. 设计候选方案和成对评估

操作者选择观察结果后，检查仓库，找出可能导致所观察到的聚合形态的具体机制。引用准确的调用点证据。不要假设配置文件指出了原因。

编辑前，提出一项最小候选更改和一套成对评估。评估必须使用完全相同的固定输入运行基线和候选方案，并记录：

  • 必须保持可接受的任务结果或质量检查；
  • 两组使用相同的 token、字节数或提供方统计成本指标；
  • 使用的准确测试夹具、命令和环境；以及
  • 阻碍公平比较的任何混杂因素。

请求批准候选方案和评估设计。如果仓库缺少固定测试夹具、相关质量检查或通用测量方法，则停止并指出缺少的检测工具。普通单元测试本身不能证明优化有效。

4. 仅应用获批的候选方案

将差异限制在有证据支持的调用点，并保留现有安全控制。运行成对的基线/候选评估以及仓库中针对性的代码检查。如果两组未使用完全相同的输入和测量方式，则丢弃比较结果。如果质量下降或资源结果不明确，则仅还原此候选编辑，并报告该方案未达到采用标准。

不要创建 Caveman 实验或提案，不要将机会标记为已实施，不要更改其生命周期，也不要启用优化器。仅报告行只允许予以忽略，本技能也不会执行该更改。

5. 报告观测结果，而非节省金额

报告：

Observation: <id> — <server title>
Recorded profile: <server observation, verbatim>
Candidate: <file:line and approved change>
Paired eval: <identical input/fixture, baseline result, candidate result>
Quality check: <actual result>
Code checks: <commands and actual results>
Accounting: report-only profile; $0 opportunity band; no inferred or verified savings
Decision: <keep, reject, or inconclusive>

除非产品经过验证的方法提供了完整的提供商数据和同一请求的核算信息，否则绝不要将 Token 或字节数的减少换算成美元。配对本地测试结果仅支持在指定测试样本上使用指定候选项；它不能证明生产环境中的节省、因果性推出证据或生命周期资格。

评论

支持 Markdown