SuperAPI AI 工具集

carbon-monitor-adapt-harness

智能体与模型

查看项目

更新于 11-03 16:17

技能介绍

用途

该技能在 Carbon Monitor 的克隆仓库中使用,产出唯一文件 specs/<slug>/SPEC.md,供后续会话据此实现。它只读取文档并写该文件,不做代码修改,也不运行项目脚本。

主要能力

  • 分阶段加载文档:在需要某一步时才读取相应章节,按标题定位、读到下一个同级标题为止。reading-map.md 列出每个步骤和每个 SPEC 章节所需的来源。
  • 引导选择分支:A(为另一个仓库做 PR 审查并保留审查任务)或 B(在同一框架上运行不同任务,例如定时任务、IBM Cloud 部署、成本追踪、遥测与 Slack 报告,针对其他系统)。B 的适配规模大于 A。
  • 结构化访谈:按文件顺序一次一问,最多十问;每问说明默认值并接受“default”;跳过已以任何形式回答的问题;当所有 SPEC 章节都能填充时提前停止。
  • 生成 SPEC:读取 reading-map.md 与 templates/SPEC.md,复制模板到 specs/<slug>/SPEC.md,填写头部(git rev-parse --short HEAD 的短 SHA 与当天日期),再按顺序填写各章节,每节只读映射列出的来源,不提前读取后续章节。

使用方式(技能描述中的步骤)

  1. 定向:只读 docs/HARNESS.md 第 1 节(循环与三条不变式)。
  2. 分支:逐字提问“Which of these are you doing?”并等待回答,然后加载 interview/pr-review.md(A)或 interview/new-job.md(B)。
  3. 访谈:一次一问,每问带默认值,最多十问。
  4. 写 SPEC:按阅读地图逐节拉取上下文并填写。
  5. 检查并结束:确认模板各节齐全无占位符、docs/HARNESS.md 第 2、3 节每行都有决策、第 6 节对 B 完整或对 A 为 none、引用的现有文件与函数均能在仓库中找到、新名称已标注为新、每个未决问题都有负责人;然后打印 SPEC 路径、三个最高风险的未决问题和下一步骤。

下一步骤的原文为:Start a fresh session and say: "Implement specs/<slug>/SPEC.md, one task at a time, verifying each against its acceptance criteria."

SPEC 写作规则

  • docs/HARNESS.md 第 2、3 节表格的每一行都要在第 3 节有决策。
  • SPEC 中引用为“现已存在”的每个文件与函数都必须在仓库中,并给出路径;名称需通过搜索确认。SPEC 引入的新名称必须标注为新(位于 replace 或 add 行、第 6 节的 New 列或某个任务中)。
  • 分支 B 必须用 docs/HARNESS.md 第 5 节的所有名称(新旧)填写第 6 节。
  • 第 1 步中的不变式保持不变,除非第 9 节说明必须修改的理由。
  • 验收标准为可测试的 given/when/then 语句。
  • 任务有序、粒度小,并注明文件与验收标准。
  • 未确定事项放入第 13 节并注明由谁决定,不做猜测。

适用场景

需要把 Carbon Monitor 测试框架复用到 PR 审查或其他定时任务场景,并希望先产出一份规范、再由后续会话实现时使用。

限制

  • 只写 SPEC 文件,不改代码、不跑脚本。
  • 访谈最多十问,一次一问。
  • Bob 与 claude 可直接配置使用;其他 CLI worker agent 需要适配器(见 docs/HARNESS.md 第 4 节“Add an agent”),其 agent 文件在需要时再读取。
  • 具体收费、价格、平台支持范围等资料暂未提供。