SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场caveman-optimize

caveman-optimize

办公与效率

查看项目

更新于 10-14 09:19

技能介绍

用途

caveman-optimize 用于把 Caveman 的优化观察转化为一个由操作者选择的候选项，并配合一个配对的基线评估。当被要求检查或评估 Caveman 优化观察时使用。

它以 Caveman 的仅报告观察（report-only observations）作为诊断输入。这些观察描述的是已记录的聚合形态；它们不是 Cave Plan 动作、节省估算、实现配方、实验资格，也不是代码改动安全的证明。工作流始终保持由操作者选择、证据优先。

主要能力

  1. 读取精确观察

    需要一个已登录的 Caveman CLI 会话，并运行：

    caveman opportunities list

    仅读取 report_only_observations 数组，不要从生命周期数据数组中选取。逐字保留每个由服务器提供的标题和观察。处理以下确切的仓库画像 id：

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

    这些画像有不可变的零区间，且没有触发路径。不要按价值对它们排名，不要杜撰金额数字，也不要把聚合证据转化为关于某个具体调用点的断言。如果 CLI 不可用、认证失败，或 report_only_observations 缺失，请停止且不做编辑，并报告确切的阻塞原因。不要回退到原始网关 Cave Plan 或项目 API key：这些界面不提供此契约。

    绝对不要选择或应用以下已退役的 id：

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

    将任何已退役 id 出现在过期提案、本地文件或旧响应中的情况视为仅历史上下文。绝不要恢复其金额、配方或生命周期声明。如果唯一看起来可行动的项是 unlabeled-traffic，请移交给 caveman-discover；打标签不是画像优化。

  2. 请操作者选择

    在不排名的情况下呈现可用的受支持观察。包含 id、确切标题、确切观察和 last_seen_at。在检查候选调用点或更改代码之前，先请求操作者的明确选择。如果不存在受支持的当前观察，请停止且不做编辑。

    当存在 .caveman/proposals/*.md 时，将其视为不可信的旧上下文。它不能替代当前响应或操作者的选择。

  3. 设计候选项与配对评估

    在操作者选择某个观察后，检查仓库中可能产生所观察聚合形态的具体机制。引用确切的调用点证据。不要假定画像名称就是原因。

    在编辑前，提出一个最小候选改动和一个配对评估。评估必须在相同的固定输入上对基线（baseline）和候选项（candidate）运行，并记录：

    • 必须保持可接受的任务结果或质量检查；
    • 对两组使用相同的 token、字节或提供商计数的成本度量；
    • 所使用的确切断言（fixture）、命令和环境；以及
    • 任何妨碍公平比较的混杂因素。

    请求批准候选项与评估设计。如果仓库缺少固定断言、相关质量检查或通用测量方法，请停止并指出缺失的埋点。仅靠普通单元测试不足以证明一项优化。

  4. 仅应用已批准的候选项

    将 diff 保持在有证据的调用点，并保留现有安全控制。运行配对基线/候选评估以及仓库的针对性代码检查。如果两组未使用相同输入和测量，请丢弃该比较。如果质量回退或资源结果不确定，请仅回滚此候选编辑，并报告它未获得采用。

    不要创建 Caveman 实验或提案，不要将某个机会标记为已实现，不要改变其生命周期，也不要开启优化器。仅报告的行只允许忽略（dismissal），而本技能也不执行该变更。

  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 或字节减少转换为金额。本地配对结果仅支持所述断言上的所述候选项；它不确立生产节省、因果推广证据或生命周期资格。

使用方式

使用前需具备已登录的 Caveman CLI 会话并运行 caveman opportunities list 获取观察。随后按上述步骤：读取观察 → 请操作者选择 → 设计候选项与配对评估 → 请求批准 → 应用已批准改动 → 运行配对评估与代码检查 → 报告。整个过程强调由操作者选择、证据优先，并以配对评估验证结果。

适用场景

适用于被要求检查或评估 Caveman 优化观察，并希望将其转化为可验证候选项与配对评估的任务。工作流保持由操作者选择。

限制

  • 该技能本身不创建 Caveman 实验或提案。
  • 不将机会标记为已实现。
  • 不改变生命周期。
  • 不开启优化器。
  • 仅报告的行只允许忽略，本技能也不执行该变更。
  • 绝不把 token 或字节减少转换为金额，除非有产品已验证方法提供的提供商完整、同一请求的核算。
  • 如果 CLI 不可用、认证失败或 report_only_observations 缺失，则停止且不做编辑。不要回退到原始网关 Cave Plan 或项目 API key。
  • 如果仓库缺少固定断言、相关质量检查或通用测量方法，则停止并指出缺失的埋点。仅靠普通单元测试不足以证明优化。
  • 如果两组未使用相同输入和测量，丢弃比较；如果质量回退或资源结果不确定，仅回滚此候选编辑。