figure-it-out

Figure it out

当任务与任何操作手册都不匹配时，就设计一套。编写任何代码之前，首先要交付工作流本身：一系列阶段，其严谨程度与任务相匹配，遵循科学方法，并留下决策记录，方便人类离开一段时间后回来审查。

开始

创建一个待办清单，第一项是阅读 poteto-mode 技能中的 Principles 部分。然后将以下阶段添加为待办事项。

阶段 A：界定

先打好基础，再做决定。只有能够明确说明以下内容后，才能开始执行：

• 将完成定义为一个可证伪的判定条件（prove-it-works 原则技能）。
• 量化范围：大致的工作单位和工作量，以及调研发现的阻碍因素。
• 严谨程度，倾向于从严。不可逆的决策和影响范围大的事项需要更高严谨度；可逆且风险较低的步骤则可以适当降低。严谨度体现在关卡和产物上，而不是“更加努力”。

在承诺长时间执行之前，先展示界定结果和权衡取舍。可逆的工作继续推进（never-block-on-the-human 原则技能），但持续数小时的执行需要设置一个检查点。

阶段 B：设计工作流

将任务拆解成原子化、可独立落地的单元。优先处理未知风险最高的部分。先搭建脚手架并完成验证，再开发功能（foundational-thinking 原则技能）。

• 在开始工作前构建验证工具链，并记录变更前的基线，让检查结果能够清楚体现“旧值与新值”的对比。
• 对于不可逆的设计决策，运行 architect 技能（它会运行 arena）。对于形态已经明确的机械性工作，则跳过。对已经定型的设计再运行一次 arena 就属于过度设计（laziness-protocol 原则技能）。
• 决定哪些工作可以并行展开。只在边界清晰的部分并行，并为每位工作者分配各自的 worktree 或分支（separate-before-serializing-shared-state 原则技能）。不要过度并行。根据 poteto-mode 技能的 Subagents 部分，为每个子 Agent 选择适合任务的推理级别和快速或标准速度。
• 写下设计好的阶段列表。这份列表就是供人类审查的内容。

然后执行设计。将各步骤作为具体事项添加到待办清单中，放在阶段 C 和阶段 D 条目之间。每个步骤都按照阶段 C 的循环纪律执行，并在步骤完成时逐行穿插记录阶段 D 的日志，而不是等到最后才补齐全部记录。

阶段 C：执行循环

每个单元都是一次实验。陈述假设，进行最小改动，针对真实产物按判定条件进行测量；如果改动推动了目标，就保留；否则就撤回。遵循 sequence-verifiable-units 原则技能，在开始下一个单元之前验证当前单元，而不是等到最后批量检查。

• 通过检查产物来验证，绝不依赖自我报告。如果某项检查轻易通过，先怀疑观测方法，再怀疑系统。
• 委派工作时要配备评判者。如果工作者钻验证关卡的空子，就重置并强化约定。如果关卡本身有问题，就在单独的变更中修复关卡，不要绕过它。
• 结论为 VERIFIED、NOT VERIFIED 或 INCONCLUSIVE。INCONCLUSIVE 不算通过。不要隐瞒负面结果。

阶段 D：保留审计记录

使用 show-me-your-work 技能记录执行过程。figure-it-out 的工作通常规模不小，足以提交这些记录，方便审查者在 PR 中查看。记录加上差异，能让人类之后回来时信任这项工作。

阶段 E：验证并交接

针对真实产品，按照阶段 A 的判定条件检查整体结果，而不只是验证工具链。将反复出现的修正编码为关卡、lint 规则、检查项或脚本（encode-lessons-in-structure 原则技能）。

**回复：**你设计的操作手册、严谨程度及其原因、决策记录路径、依据判定条件验证的内容，以及仍未解决的问题。