SuperAPI AI 工具集

figure-it-out

智能体与模型

查看项目

更新于 10-16 17:27

技能介绍

Figure it out 是一个面向“没有更窄剧本可用”的任务的工作流设计技能。它适用于大型迁移、雄心勃勃的多部分改动,或人类离开一段时间后回来审查的工作。其核心主张是:在任何代码之前,先产出工作流本身——一串按任务调整严谨度的阶段,运行科学方法,并留下人类在离开后仍可审计的决策轨迹。

使用方式

名为 figure-it-out 的技能以加粗或反引号形式出现,或以 /<name> 形式运行时,指向本技能目录旁 ../<name>/SKILL.md 文件;未带前缀的原则名称指向 ../principle-<name>/SKILL.md。需要读取该文件并遵循它。多数 pstack 技能是 user-only,因此技能工具无法加载它们。

当任务不匹配任何现成手册时,就设计一套。交付物在代码之前就是工作流本身。

开始

打开任务列表(用 harness 的任务工具;若没有,则在 ~/.local/state/pstack/checklists/<repo>-<branch>.md 建清单文件),第一项是阅读 poteto-mode 技能的 Principles 部分,然后把下面各阶段加入待办。

阶段 A:Frame(框定)

先落地,再承诺。在能够陈述以下内容之前不要开始运行:

  • 完成定义作为可证伪的谓词(prove-it-works 原则技能)。
  • 范围,量化:粗略单位与工作量,加上落地时暴露的阻塞项。
  • 严谨级别,偏向更高。单向门与高影响半径获得更多严谨;可逆的低风险步骤获得更少。严谨是门禁与产物,不是“再努力一点”。

在承诺长时间运行前,先呈现框定与权衡。可逆工作继续进行(never-block-on-the-human 原则技能),但多小时的运行值得设置一个检查点。

阶段 B:设计工作流

拆解为原子的、可独立落地的单元。最未知、风险最高的优先。脚手架与验证先于功能(foundational-thinking 原则技能)。

在动手前先构建验证工具,基线与变更前状态一起捕获,使检查表现为“旧值 vs 新值”。

对于单向门的设计决策,运行 architect 技能(它运行 arena)。跳过机械性的、形态已经具体的工作。对已定设计再开一次 arena 属于过度工程(laziness-protocol 原则技能)。

决定哪些可以扇出。只在接缝处并行,并通过 t3_thread_launch 线程给每个 worker 独立 worktree 或分支,使用 worktree workspaceStrategy(separate-before-serializing-shared-state 原则技能)。先提交验证工具与任何准备工作,并以该提交作为 baseRef。不要过度扇出。按 poteto-mode 技能的 Subagents 部分,为每个子代理的作业挑选推理级别与快速或标准速度。

把设计好的阶段列表写下来。该列表就是人类审查的内容。

然后执行该设计。把其步骤作为具体条目加入任务列表中 Phase C 与 Phase D 条目之间。每步都在 Phase C 循环纪律下运行,并把 Phase D 日志贯穿其中:每落地一步就补一行,而不是把整条轨迹留到最后。

阶段 C:运行循环

每个单元都是一个实验。陈述假设,做最小改动,对真实产物测量谓词,有推进则保留,没有则回滚。应用 sequence-verifiable-units 原则技能,在开始下一个单元前验证当前单元,而不是把检查攒到最后。

通过检查产物来验证,绝不依赖自我报告。当某样东西过于轻松地通过时,先怀疑观察方法,再怀疑系统。

把委派的工作与裁判配对。若 worker 钻了门禁的空子,重置并加严契约。若门禁本身有错,在它自己的变更中修复门禁,而不是绕开它。

判定结果为 VERIFIED、NOT VERIFIED 或 INCONCLUSIVE。不确定不算通过。不要隐藏负面结果。

阶段 D:保留审计轨迹

通过 show-me-your-work 技能记录本次运行。figure-it-out 的工作通常足够庞大,值得把轨迹提交,使审查者能在 PR 中阅读。轨迹加 diff 才能让人类回来并信任这份工作。

阶段 E:验证并交回

对真实产品、而非仅验证工具,检查整体是否符合阶段 A 的谓词。把任何重复出现的纠正编码为门禁、lint 规则、检查或脚本(encode-lessons-in-structure 原则技能)。

回复内容:你设计的手册、严谨级别及原因、决策轨迹路径、对照谓词已验证的内容,以及仍未解决的部分。

限制与未提供信息

该技能依赖若干 pstack 原则技能与其他技能(如 poteto-mode、prove-it-works、never-block-on-the-human、foundational-thinking、laziness-protocol、architect、separate-before-serializing-shared-state、sequence-verifiable-units、show-me-your-work、encode-lessons-in-structure),这些文件的具体内容与可用性资料中暂未提供。具体的安装命令、收费模式、支持平台等信息暂未提供。t3_thread_launch、workspaceStrategy、reasoning level、speed 等具体参数取值资料中暂未提供。