SuperAPI AI 工具集

fable-ruki-agenty

智能体与模型

查看项目

更新于 11-06 18:15

技能介绍

用途与定位

这是一个面向 Claude Code 的手动编排模式。核心思路是:Fable 模型令牌成本高、限额紧,因此只让它做更便宜模型无法完成的事——思考、解决分歧、编写任务规格;而读取、研究、编码、验证等具体工作交由子代理完成:Sonnet 负责代码与分析,Haiku 负责读取与核对。每执行一次原本可由子代理完成的工具调用,都会消耗 Fable 的限额。

硬性禁令

  • 不写代码,不修改文件。Fable 自己唯一调用的工具是 gh(issues)和流水线追踪。
  • 不亲自阅读代码库。需要上下文时,派出 Sonnet 侦察兵,给出具体问题和回答格式,返回摘要。
  • 没有在 issue 正文中准备好完整规格就分派任务。用原始 issue 直接下命令「做 #2」是主要的反模式:执行者会自行侦察,重复消耗令牌。
  • 默认不使用 ultrathink / xhigh。high 已足够;xhigh 只用于解决确实复杂的架构分歧。

流水线

侦察(侦察兵)→ 规格写入 issue 正文(Fable 编写)→ 指针式分派(执行者)→ 验证器(全新上下文)→ 验收 → 下一项。

  1. 侦察(子代理并行):一个侦察兵查看待办列表,一个绘制代码库地图。每人给定具体问题与报告格式:文件、行号、接口约定、重复项、陷阱。不修改任何内容。读取用 Haiku,代码分析用 Sonnet。
  2. 规格写入 issue 正文:规则是 issue 先行,无例外。任何任务——来自待办、来自聊天、口头临时提出——都先变成带完整规格正文的 issue,再加入队列。回复用户仅一行:「已开 #8,排队在 #3 之后」。规格是对 issue 正文的完全重写(gh issue edit N --body),原始表述融入「目标」部分。分派前不添加评论、不保留历史:分派时刻,issue 正文就是任务的唯一且完整文档。

规格包含以下部分:

  • 目标: 一句话说明合并后用户看到什么。
  • 上下文: 要修改的文件与行号;接口约定(消息格式、schema);陷阱(重复项、生成文件)。包含执行者「无需自行研究」所需的全部信息。
  • 已解决的分歧: 每个分歧给出决策 + 一行理由。
  • 步骤: 按文件编号的修改计划。
  • 边界: 明确不做什么(不顺手重构、不动生成文件、不加任务之外的功能)。
  • DoD + 验证: 验收清单与具体的命令/场景验证(运行什么、打开什么、应看到什么)。

分歧由 Fable 自行解决,不因问题阻塞流水线。用户可在分派前查看 issue 正文中的决策并覆盖。例外:分歧改变范围或涉及费用时,停下来提问。规格就绪的测试标准:执行者无需打开任何文件「侦察」、无需提任何问题即可完成任务。

  1. 分派——指针式:issue 正文已自足,因此给执行者(Sonnet)的提示是简短信封,不重复规格:执行者角色、工作目录、指定阅读 gh issue view N 并严格按规格执行、不越界不做产品决策、完成后运行 DoD 中的验证、在 main 上做一次带 closes #N 的 conventional commit 但不自行关闭 issue、报告变更文件/验证结果/与规格的偏差。顺序由文件冲突决定,而非代理数量:修改同一文件的任务严格串行直接提交 main;文件不重叠的一组任务在各自 worktree 中并行,合并顺序由编排者决定。
  2. 执行者工作时不要等待:Fable 不阻塞在报告上,而是继续编写队列中后续任务的规格、解决分歧、更新 issue 正文。执行者报告时,规格队列已就绪。分派提前写好的规格前,用一行与上一任务实际 diff 做核对。
  3. 验收——独立验证器:每个任务配一个干净上下文、窄提示的验证器子代理:「运行 issue #N 的 DoD 部分中的命令/场景,返回事实:通过/不通过,看到了什么」。它不做代码评审,只执行验证。验证者不是执行者。失败处理:第一次失败,由同一执行者(保有上下文)按验证器的点对点清单返工;第二次失败后,换全新上下文的执行者 + 验证器诊断(有时问题是执行者上下文陷得太深);全新执行者仍失败,则停止该任务:标记 blocked,向用户简短诊断(试过什么、卡在哪、假设),流水线继续处理独立任务。成功则关闭并添加一条验收评论,最多三行:gh issue close N --comment "<SHA> — <验证器一行结论>"。不要修改 issue 正文:规格保持为「当初订了什么」的干净文档。
  4. 最终评审:流水线最后一个任务是独立的 issue 评审:对从起始提交开始的整个 diff 做一次 Sonnet 审查。检查维度由 Fable 在评审规格中给出(处理器正确性、资源泄漏、功能间冲突)。发现的 bug 通过同一评审者以修复提交处理。

沟通纪律

  • 一条简短流水线状态(待办列表):已完成 / 进行中 / 被什么阻塞。
  • 不转述子代理报告,只说决策与下一步。
  • 进度只依据本次会话工具结果中的事实;未验证就说明未验证。
  • 定期核对限额消耗;剩余较少时降低 effort、合并任务,而不是跳过规格。

适用场景与限制

适用于使用 Claude Code、希望控制昂贵模型令牌消耗、以 GitHub issue 为任务载体、由廉价子代理执行开发与验证的工程流程。限制:依赖 GitHub issue 与 gh 工具;需要子代理与 worktree 支持;分派与验证流程需人工监督;具体模型可用性与定价未在资料中提供,暂未提供。