SuperAPI AI 工具集

thrifty-brief

智能体与模型

查看项目

更新于 10-15 09:29

技能介绍

用途

thrifty-brief 是 thrifty 拆分规划模式(split planning mode)中的简报撰写子技能。在 thrifty 拆分运行中,架构师(director)已经做出所有跨单元决策并固定在 CONTRACT.md 中。本技能的职责是把一条简短的单元规格(来自架构师/导演)连同共享契约,扩展为完整的 briefs/UNIT-NNN.md,使 Haiku 执行器能够以约 90% 的完成度运行、无需再做进一步决策,并且让检查器能够客观验证。

主要能力

  • 读取工作目录下的 CONTRACT.md(跨单元表面,包含共享接口、约定、术语、所有权、依赖图)以及 UNIT-SPECS.md(或导演撰写的单元规格),定位本单元的简短条目:目标、拥有的文件/输出、依赖、定义的符号、消费的内容、标准意图、验证命令。
  • 在单元内部拥有完整权限:方法、单元内结构、局部决策、确切的验收标准。
  • 不重新决定跨单元事项:不重新定义跨单元形状(引用而非重述签名)、不发明跨单元约定(错误形状、命名、格式、语气、依赖图、文件所有权均继承契约)、不改变范围或依赖。
  • 按 ../thrifty/templates/BRIEF.template.md 撰写简报:目标 · 输入/上下文(确切文件 + 消费的上游符号/章节)· 方法 · 约束 · 验收标准 · 依赖。
  • 撰写具体验收标准,每条标注为可运行(命令/测试)或可断言(可检查的陈述);单元产出代码时优先使用可运行标准。
  • 原样呈现契约的跨模块测试:若契约声明了进入本单元的依赖边所需的跨模块测试,则将其复制为具名的可运行验收标准,不得跳过、重命名或弱化。
  • 对草稿进行自我审计(第二遍):删除 Haiku 不需要的每个词、删除对契约的重述(改为引用)、删除可推断步骤的叙述、删除含糊或未标注的验收标准;审计后的版本应比草稿更短。
  • 最终报告返回:unit、brief 路径、approach_sizing(terse | detailed 及一行原因)、criteria 总数(可运行/可断言)、contract_refs、escalation。

使用方式

本技能作为 thrifty 拆分运行中的子技能被调用,调用时会被告知工作目录和单元 id。流程为:先读取 CONTRACT.md 与单元规格,然后在单元内部权限范围内撰写简报(第一遍),再自我审计并就地修正(第二遍),最后输出报告作为返回值。简报风格为密集要点与速记,而非散文;长度由验收标准的数量驱动(4–6 条标准约 120–150 词,12 条标准约 250 词)。

适用场景

适用于 thrifty 拆分规划模式中,需要将架构师给出的简短单元规格扩展为可执行简报的场景,尤其是希望由 Haiku 执行器在无需额外决策的情况下完成单元工作、并由检查器客观评分的情况。

限制

  • 不重新定义跨单元形状、不发明跨单元约定、不改变范围或依赖;这些属于导演的权限。
  • 若认为规格或契约在跨单元层面有误,应在输出的 notes 中说明并设置 escalation,交由导演解决,而不是在本地静默“修复”。
  • 不面向弱本地模型做逐字节固定;简报的主要价值在于验收标准与契约引用。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。