关于 figure-it-out
figure-it-out 是一项 Agent 技能,适用于没有现成流程可用的任务。它指导 Agent 界定范围与严谨度、逐步验证工作,并留下可审查的决策记录。
主要功能
- 01任务界定与范围估算
- 02按风险确定严谨度
- 03工作流设计与排序
- 04逐步实验和验证
- 05决策记录与交接
适用场景
- 01为没有匹配流程的任务制定计划
- 02将复杂工作拆分为可验证单元
- 03记录决策以便审查交接
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ mdsmithaustin/ pstack --skill figure-it-out安装后在 Claude Code 中输入/figure-it-out确认已加载。
附带文件agents/openai.yaml
详细介绍
找出解决办法
当任务不符合任何操作手册时,就设计一个。编写代码之前的交付物必须是工作流本身:一系列阶段,其严谨程度与任务相称,遵循科学方法,并留下决策记录,让人类离开后也能审计。
开始
打开工作清单,第一项是阅读 poteto-mode 技能的 Principles 部分。然后将以下阶段添加为清单项。
阶段 A:界定问题
先夯实基础,再做决定。明确说明以下内容后再开始执行:
- 将完成定义为一个可证伪的谓词(prove-it-works 原则技能)。
- 对每项请求给出
worth doing或won't do的判断,并简要说明理由,理由须结合项目设计和用户目标。在估算工作量之前作出这些判断。适配性判断不会取消明确要求。分别记录拟议的排除项和已授权的范围变更。 - 量化已接受事项的范围。对比各个选项时使用相同的衡量标准,包括实现、测试、文档、生成文件和验证工作量。指出排除项、不确定性,以及已发现问题的根本原因。
- 确定严谨程度,并倾向于更高标准。不可逆决策和影响范围大的事项需要更高标准;可逆且风险较低的步骤则可降低标准。严谨程度体现在关卡和产物上,而不是“更加努力”。
跟踪实际范围和工作量,并与估算对照。若所选方案超出被拒绝方案的可比估算,重新评估选择并报告超出情况。在自主授权范围内,除非现有关卡要求操作员介入,否则继续执行。
在开始长时间执行前,先展示问题界定和权衡。可逆工作继续推进(never-block-on-the-human 原则技能);若执行预计需要数小时,则设置一个检查点。
阶段 B:设计工作流
将工作拆分为原子化、可独立落地的单元。按风险最高的未知项优先排序。脚手架和验证先于功能(foundational-thinking 原则技能)。
- 在开始工作前构建验证工具,并从变更前状态采集基线,以便检查能对比“旧值与新值”。
- 对于不可逆的设计决策,使用 architect 技能(它会运行 arena)。对于形态已明确的机械性工作,则跳过。设计已确定后再运行一次 arena 属于过度设计(laziness-protocol 原则技能)。
- 决定哪些任务可并行展开。仅在边界清晰的部分并行处理,并为每位工作者分配独立的工作树或分支(separate-before-serializing-shared-state 原则技能)。不要过度并行。
- 写下设计好的阶段清单,供人类审阅。
然后执行设计。将其步骤作为具体事项添加到工作清单中,放在阶段 C 和阶段 D 条目之间。每一步都遵循阶段 C 的循环纪律执行,并在步骤完成时将阶段 D 的日志逐行穿插记录,而不是等到最后才补全全部记录。
阶段 C:运行循环
每个单元都是一次实验。说明假设,做出最小改动,针对真实产物按谓词进行测量;如果有进展就保留,否则就回退。 使用 principle-sequence-verifiable-units 技能。每个单元都要先验证,再开始下一个,不要把检查都堆到最后。
- 通过检查产物来验证,绝不要依赖自我报告。若某项检查轻易通过,应先怀疑观察方法,而不是系统。
- 委派工作时要配备评审者。如果执行者钻了门禁的空子,就重置并收紧约定。如果门禁本身有误,就通过单独的改动修复门禁,而不是绕过它。
- 对于每项新增回归测试,说明它保护的行为,并提供证据,证明该测试在修复前会因相关缺陷而失败、修复后会通过。可用上游版本、安全的定向变异或失败的测试夹具来提供缺陷。变异必须在一次性检出目录中进行。如果设置或编译失败,不能证明目标行为未通过。一次运行若覆盖多项测试,就重复利用该运行。对于其他新增测试,说明独立判定依据及该测试能拦截的一种合理缺陷。如果无法安全地运行失败测试或无法运行,应记录这一缺口,不要声称已证明回归测试有效。
- 结论分为 VERIFIED、NOT VERIFIED 或 INCONCLUSIVE。INCONCLUSIVE 不算通过。不要隐瞒负面结果。
阶段 D:保留审计记录
使用 show-me-your-work 技能记录本次运行。由该技能决定审计记录保留在本地还是提交。确保评审者能够获取持久的完成证据。
阶段 E:验证并交接
针对真实产品,依据阶段 A 的谓词检查整体结果,而不只是检查测试框架。将反复出现的修正编码为门禁、lint 规则、检查项或脚本(encode-lessons-in-structure 原则技能)。
交接前,将未解决的实质性缺陷和未满足的要求关联到现有跟踪项或已检入的已知问题文件。经授权后,创建缺失的记录。记录影响、证据、当前处置情况,以及已知的负责人。登记阻塞项并不意味着满足完成谓词。如果无法登记或未获授权,请说明这一缺口以及保留记录的位置。
**回复:**你设计的操作手册、严格程度及其原因、决策记录路径、依据谓词已验证的内容,以及仍未解决的问题。