SuperAPI AI 工具集

to-seams

编程与开发

查看项目

更新于 10-16 02:35

技能介绍

用途:记录一个已达成一致但尚未落地的跨仓库接口(seam)。seam 是逐字节粘贴进消费者提示词的约定文件,在生产者真正落地前,智能体把它当作事实依据读取。

主要能力与流程:

  1. 定位工作区,使用与 to-tickets 第 7 步相同的解析方式:ls "$(git rev-parse --show-toplevel)/../.claude/command-centre.toml" 2>/dev/null。若文件不存在则说明并停止,因为没有 [[seam]] 配置可读的 seam 没有意义。
  2. 询问 seam 所需的四项信息:Name(短 slug,如 customer-tier-field,作为 seam 文件名和 [[seam]] 键);Producer repo(command-centre.toml 中负责落地真实实现的 [[repo]] 名称);Consumer repo(s)(当前依据该约定构建的仓库,不写入配置,仅用于判断哪些工单下次运行 to-tickets 时应在 seams = [...] 中列出该 seam);lands_at(生产者仓库中真实实现合并后将存在的路径,可多个;若落地路径未定可留空,留空表示“不退休”而非错误)。
  3. 获取约定接口本身:请用户粘贴或口述消费者智能体应读取的确切内容,如 schema、类型、函数签名等。必须逐字粘贴,不做解析、标记或按符号寻址。若用户只给描述性文字,应要求提供实际接口文本而非转述。
  4. 写入前展示两处内容并等待批准:seam 文件的完整计划内容,以及将追加的 [[seam]] 块(含 name、producer_repo、lands_at)。必须获得明确确认后才写入,避免悄悄改变提示词。
  5. 按顺序写入:先写 <workspace>/.claude/seams/<name>,再向 <workspace>/.claude/command-centre.toml 追加 [[seam]] 块。按 name 做 upsert:若同名块已存在则原地替换而非重复,并说明。
  6. 完成后告知用户 seam 名称,以及哪些消费者工单下次运行 to-tickets 时应将其列入 seams = [...]。

适用场景:多仓库协作中接口尚未落地、但消费者侧需要先行开发时,用 seam 固定双方约定。

限制:seam 内容不被解析,仅作原文粘贴;consumer repo 不写入配置;lands_at 为空表示无退休指针;写入前必须人工确认。