SuperAPI AI 工具集

figure-it-out

通用与其它

查看项目

更新于 11-19 03:05

技能介绍

figure-it-out 是一个“没有现成流程时,就设计一套流程”的技能。它在动手写代码之前,先交付工作流本身:一组可随任务复杂度调整严谨程度的阶段,按科学方法推进,并留下人类离开后仍可审计的决策轨迹。

使用方式:先打开一份待办清单,第一项是阅读 poteto-mode 技能的 Principles 部分,然后把下述阶段加入待办。

阶段 A:定题(Frame)。先打地基再承诺。开始前需能说清:以可证伪的谓词(对应 prove-it-works 原则技能)表述的完成定义;量化范围,包括粗略单位、工作量,以及打地基时暴露的阻碍;严谨程度偏高一档,单向门与高影响范围要求更高,可逆的低风险步骤要求较低,严谨体现为关卡与产物而非“更努力”;在投入长时间运行前先呈现定题与取舍。可逆工作照常推进(对应 never-block-on-the-human 原则技能),但数小时的运行应设一个检查点。

阶段 B:设计工作流。拆成原子化、可独立落地的单元,按未知风险最高的先做;脚手架与验证先于功能(对应 foundational-thinking 原则技能);在动手前搭好验证工具,并从改动前状态采集基线,使检查呈现为“旧值对新值”;对单向门的设计决策运行 architect 技能(它会运行 arena),对形态已具体的机械性工作则跳过,对已定设计再跑一次 arena 属于过度工程(对应 laziness-protocol 原则技能);决定哪些工作可并行展开,只在接缝处并行,每个执行者使用独立 worktree 或分支(对应 separate-before-serializing-shared-state 原则技能),不要过度展开;把设计好的阶段列表写下来,这份列表就是人类审阅的对象。随后执行该设计:把各步骤作为具体条目加入待办,放在阶段 C 条目之后、阶段 D 之前,每个步骤按阶段 C 的循环纪律运行,并把阶段 D 的日志贯穿其中,每落地一步记一行,而不是把整条轨迹留到最后。

阶段 C:运行循环。每个单元都是一次实验:陈述假设,做最小改动,在真实产物上对照谓词度量,有进展则保留,无进展则回退;应用 sequence-verifiable-units 原则技能,每个单元验证后再开始下一个,而不是把检查批量留到最后;通过检查产物来验证,绝不依赖自我报告,若某事通过得过于轻易,先怀疑观察方法再怀疑系统;委派的工作要配一个评判者,若执行者钻了关卡的空子,就重置并加固约定,若关卡本身有误,就在单独的改动中修正关卡,而不是绕开它;结论只有 VERIFIED、NOT VERIFIED、INCONCLUSIVE 三种,INCONCLUSIVE 不算通过,不要隐藏负面结果。

阶段 D:保留审计轨迹。通过 show-me-your-work 技能记录运行过程。figure-it-out 的工作通常足够重要,应把轨迹提交,以便审阅者在 PR 中阅读;轨迹加 diff 才能让人回来时信任这项工作。

阶段 E:验证并交回。在真实产品上、而不只是验证工具上,对照阶段 A 的谓词检查整体;把反复出现的纠正固化为关卡、lint 规则、检查或脚本(对应 encode-lessons-in-structure 原则技能)。回复内容包括:你设计的流程、严谨程度及理由、决策轨迹路径、哪些已对照谓词验证、哪些仍未决。

适用场景:需要设计监督流程的大规模迁移、目标宏大的多部分改动、人类离开后需复查的工作。限制:资料未提供具体安装命令、平台限制、收费信息或性能数据,这些暂未提供。