SuperAPI AI 工具集

figure-it-out

智能体与模型

查看项目

更新于 10-15 16:26

技能介绍

用途

figure-it-out 适用于没有更窄的现成 playbook 可匹配的任务,例如大型迁移、雄心勃勃的多部分改动,或人类离开一段时间后回来审查的工作。它的核心主张是:在写任何代码之前,先设计工作流本身——一套按任务规模调整严格度的阶段序列,运行科学方法,并留下人类可以事后审计的决策轨迹。

主要能力

  • 先框定再承诺:要求把完成定义写成可证伪的谓词,量化范围(粗略单位与工作量)以及 grounding 暴露出的阻塞项,并确定严格度等级(偏向高严格度:单向门和高影响范围获得更多严格度,可逆低风险步骤获得更少)。严格度体现为门禁和产物,而不是“更努力”。
  • 设计工作流:分解为原子的、可独立落地的单元,风险最高的未知优先排序,脚手架和验证先于功能。在工作之前构建验证工具,并从变更前状态捕获基线,使检查读作“旧值 vs 新值”。
  • 决定哪些工作扇出:只在接缝处并行,每个 worker 拥有自己的 worktree 或分支,避免过度扇出。
  • 运行循环:每个单元是一个实验——陈述假设、做最小改动、在真实产物上对照谓词测量、有进展则保留、无进展则回退。逐单元验证,而不是在最后批量检查。
  • 保留审计轨迹:通过 show-me-your-work 技能记录运行过程,轨迹加 diff 让人类回来时能信任工作。
  • 验证并交回:在真实产品上对照 Phase A 谓词检查整体,把反复出现的纠正编码为门禁、lint 规则、检查或脚本。

使用方式

开始时打开一个 todolist,第一项是阅读 poteto-mode 技能的 Principles 部分,然后把下面的阶段作为 todo 加入。

  • Phase A: Frame——先 grounding 再承诺。在能陈述完成定义(可证伪谓词)、量化范围与阻塞项、严格度等级之前,不要开始运行。在承诺长时间运行前呈现框定与权衡;可逆工作继续推进,但多小时的运行值得一个检查点。
  • Phase B: Design the workflow——分解为原子、可独立落地的单元,风险最高的未知优先,脚手架和验证先于功能。在工作之前构建验证工具并捕获基线。对于单向门设计决策,运行 architect 技能(它会运行 arena);对于形状已经具体的机械性工作则跳过。决定哪些工作扇出,只在接缝处并行,每个 worker 有自己的 worktree 或分支。把设计好的阶段列表写下来,这就是人类审查的内容。然后执行设计,把步骤作为具体条目加入 todolist 的 Phase C 和 Phase D 条目之间,每个步骤在 Phase C 循环纪律下运行,并把 Phase D 日志贯穿其中,每落地一步就写一行,而不是把整条轨迹留到最后。
  • Phase C: Run the loop——每个单元是一个实验:陈述假设、做最小改动、在真实产物上对照谓词测量、有进展则保留、无进展则回退。逐单元验证,而不是在最后批量检查。通过检查产物来验证,绝不依赖自我报告。当某件事通过得太容易时,先怀疑观察方法而不是系统。委派的工作配一个 judge;如果 worker 钻了门禁的空子,重置并加固契约;如果门禁本身错了,在它自己的变更中修复门禁,而不是绕开它。判定为 VERIFIED、NOT VERIFIED 或 INCONCLUSIVE;INCONCLUSIVE 不算通过,不要隐藏负面结果。
  • Phase D: Keep the audit trail——通过 show-me-your-work 技能记录运行。figure-it-out 的工作通常足够宏大,值得把轨迹提交,让审查者能在 PR 中阅读。轨迹加 diff 是让人类回来并信任工作的关键。
  • Phase E: Verify and hand back——在真实产品上对照 Phase A 谓词检查整体,而不仅仅是验证工具。把任何反复出现的纠正编码为门禁、lint 规则、检查或脚本。回复内容包括:你设计的 playbook、严格度等级及原因、决策轨迹路径、对照谓词已验证的内容,以及仍然开放的事项。

适用场景

  • 大型迁移。
  • 雄心勃勃的多部分改动。
  • 人类离开一段时间后回来审查的工作。
  • 没有更窄的现成 playbook 可匹配的任务。

限制

资料未提供该技能的具体安装命令、支持的平台、收费或价格信息。资料未提供其依赖的 poteto-mode、architect、show-me-your-work 等技能的具体获取方式。资料未提供实际使用效果或性能数据。