--- name: figure-it-out description: "在没有更窄的现成手册适用时设计可审计手册:大型迁移、宏大的多部分变更,或人离开后回来审阅的工作。按任务调整严谨程度,运行假设循环并记录决策。用于 /figure-it-out 或“figure it out”。" disable-model-invocation: true --- # 弄清楚 任务不匹配任何现成手册时,就设计一个。任何代码之前的交付物就是工作流本身:按任务调整严谨程度的阶段序列,运行科学方法,并留下人离开后回来也能审计的决策轨迹。 ## 开始 打开待办列表,第一项是阅读 **poteto-mode** 技能的“原则”章节。然后把下述阶段添加为待办。 ## 阶段 A:界定框架 先立稳地基,再承诺执行。能够陈述下列内容前,不要开始运行: - 用可证伪谓词表述的完成定义(**prove-it-works** 原则技能)。 - 量化范围:大致单元和工作量,以及初步调查暴露的阻塞项。 - 严谨级别,并偏向更高。单向门和高影响范围需要更多严谨;可逆、低风险步骤可以少一些。严谨指的是关卡和产物,而不是“更加努力”。 承诺长时间运行前,展示框架和权衡。可逆工作继续进行(**never-block-on-the-human** 原则技能),但数小时的运行值得设置一个检查点。 ## 阶段 B:设计工作流 分解为原子化、可独立落地的单元。优先处理风险最高的未知项。基础设施和验证先于功能(**foundational-thinking** 原则技能)。 - 在工作之前构建验证工具,从变更前状态捕获基线,使检查能呈现“旧值与新值”。 - 单向门设计决策运行 **architect** 技能(它会运行 **arena**)。形态已经明确的具体机械工作跳过它。对已确定的设计再运行一次 arena 属于过度设计(**laziness-protocol** 原则技能)。 - 决定哪些工作展开。只在清晰的接缝间并行,并给每个工作者独立工作树或分支(**separate-before-serializing-shared-state** 原则技能)。不要过度展开。按 **poteto-mode** 技能的“子智能体”章节,为每个子智能体选择推理级别和适合工作的快速或标准速度。 - 写下设计后的阶段列表。该列表就是人审阅的内容。 随后执行设计。将各步骤作为具体条目添加到阶段 C 和阶段 D 条目之间。按阶段 C 的循环纪律执行每一步,并在每一步落地时把一行记录写入阶段 D 日志,而不是到最后才保存整条轨迹。 ## 阶段 C:运行循环 每个单元都是一次实验。陈述假设,做最小变更,在真实产物上按谓词测量;有进展就保留,没有进展就回退。应用 **sequence-verifiable-units** 原则技能,在开始下一单元前验证当前单元,而不是最后批量检查。 - 通过检查产物验证,绝不依赖自我报告。某件事轻松通过时,先怀疑观察方法,再怀疑系统。 - 委派工作与判定者配对。如果工作者规避关卡,重置并强化契约。如果关卡本身错误,在独立变更中修复关卡,不要绕过它。 - 结论为“已验证”“未验证”或“无法确定”。无法确定不算通过。不要隐藏负面结果。 ## 阶段 D:保留审计轨迹 通过 **show-me-your-work** 技能记录运行。figure-it-out 的工作通常足够宏大,应提交轨迹,让审阅者能在 PR 中阅读。轨迹加差异才能让人回来时相信这项工作。 ## 阶段 E:验证并交回 在真实产品上按阶段 A 的谓词检查整体,而不只检查测试工具。把任何反复出现的修正编码为关卡、lint 规则、检查或脚本(**encode-lessons-in-structure** 原则技能)。 **回复:** 所设计的手册、严谨级别及理由、决策轨迹路径、相对于谓词已验证的内容,以及仍待解决的内容。