JuliusBrussee/caveman-optimize

评估优化观察结果

将 Caveman 的只报告观察作为诊断输入。它们描述记录到的聚合形态；它们不是洞穴计划动作、节省估算、实现方案、实验资格或代码更改安全的证明。保持工作流由操作者选择且以证据为先。

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 缺失，则停止而不进行编辑并报告确切阻碍。不要回退到原始网关洞穴计划或项目 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. 报告观察结果，而非节省量

报告：

观察结果：<id> — <服务器标题>
记录的分析：<服务器观察原文>
候选方案：<文件:行号和批准的更改>
配对评估：<相同输入/夹具、基线结果、候选结果>
质量检查：<实际结果>
代码检查：<命令和实际结果>
会计说明：仅报告配置文件；$0 机会区间；无推断或验证的节省量
决定：<采用、拒绝或不确定>

切勿在没有提供商完整、相同请求会计且使用产品验证方法的情况下，将 token 或字节减少转换为美元。本地配对结果仅支持所声明候选方案在所声明夹具上的结果；它不能确立生产成本节省、因果推演证据或生命周期资格。