SuperAPI AI 工具集

plan

智能体与模型

查看项目

更新于 10-15 12:21

技能介绍

用途

该技能用于在实现前或实现过程中,将复杂工作分解为可验证的任务与依赖关系。目标是构建一份另一个会话可以执行并验证的计划,而无需重新发现决策。计划需要足够紧密地指定成果与依赖以防止偏离,同时把实现选择留给执行过程中遇到的代码与证据。

用户指令优先于本技能指南。规划不增加审批要求。如果执行已被授权,计划就绪后继续执行;如果用户只要求计划,则交付计划而不开始实现。

按不确定性决定规划规模

规划深度应与工作形态匹配:

  • 清晰、可逆且检查直接的变更:用简短的心智或内联计划执行。
  • 若干具有已知模式的依赖行为:记录任务、接口与验收检查。
  • 不确定的架构或迁移:解决决定性未知项,并规划一个有代表性的纵向切片。
  • 跨智能体、会话或环境的工作:保留所有权、状态、依赖与恢复指令。

文件数量不是风险的可靠代理。一行授权变更可能比跨多文件的机械重命名需要更多分析。规划应足以暴露不确定或不可逆的部分,而不是预测每一次编辑。

确立实际起点

检查仓库状态、相关差异以及讨论中的代码路径。定位现有实现模式以及脚本、钩子或 CI 中真实的验证命令。在已配置的情况下,通过已安装的 Sibyl 技能读取相关项目记忆。

记录约束执行的事实:

  • 可观察的用户或系统成果。
  • 当前基线以及正在检查的修订版本或环境。
  • 受影响的接口、所有权与兼容性义务。
  • 可能使拟议工作失效的不确定性。
  • 明确的约束、非目标与用户更正。

将继承的计划视为假设。在执行前对照当前代码树重新检查重要主张。区分已验证事实、待检查假设与过时前提。当前提失败时更新计划本身;脱离的评论会让执行者继续遵循过时指令。

选择有用的切片

在分解新机制之前,先寻找可满足请求的现有能力。简化必须保留所请求的结果。不要用方便的管道演示替代困难的产品目标。

当纵向切片能尽早证明可行性时,优先选择穿过不确定边界的切片:真实输入经过变更逻辑到达需要它的消费者。围绕兼容性与部署顺序规划迁移。源文件顺序不决定安全发布顺序。

将实现及其行为验证保留在同一个可问责任务中。标题包含“和”并不证明任务应拆分。当任务具有可独立审查的成果、不同的所有者或真实的依赖边界时,才拆分任务。测试基础设施前置条件可以单独列出;功能测试不应成为孤立的后续任务。

为每个任务提供可执行契约

仅使用任务需要的字段:

  • 成果:交付的行为或工件。
  • 范围:已知文件/模块以及允许的扩展规则。
  • 依赖:所需输入或接口及其生产者。
  • 验证:精确的可运行检查以及它证明的行为。
  • 完成证据:预期的工件、断言、观察或报告。
  • 风险与恢复:兼容性、回滚或未解决的外部依赖(当重要时)。

示例:

任务:在请求边界拒绝过期会话

成果:过期会话收到既定的未授权响应。 范围:会话验证器及其请求级测试。 依赖:仓库中已确认的现有时钟注入接口。 验证:[仓库的精确聚焦测试命令]。 用例:过期、有效与边界时间会话保持预期行为。 完成:测试覆盖请求路径并报告已执行用例。

已知时优先使用真实文件路径;将拟议路径标注出来,而不是假装探索已完成。可复制命令仍需要断言:“渲染”不能证明生成的策略与预期资源匹配。

映射依赖与所有权

并行化独立成果。文件分离有助于避免冲突,但不能证明独立性:两个模块可能共享模式、生成文件、测试数据库、端口或输出目录。命名这些共享资源及其所有者。

选择依赖就绪的工作,而不是强制每个任务进入同步波次。当任务共享有意义的集成检查点时,波次才有用。指定集成所有者,并在分支或补丁汇合后验证组合行为。当委派增加有用容量且当前指令允许时,参考 orchestrate。

审查计划中缺失的消费者、不兼容的发布状态与不必要的范围。对于重要架构或策略,在需要或合理时寻求独立批评。保持审查针对未解决的决策。只有当新证据或具体缺陷改进计划时,更多轮次才有用;仅分歧不足以证明无休止修订。

使计划可恢复

使用项目的规范跟踪器或约定的工件位置。使用 Sibyl 时,使用其已安装技能获取当前任务与记忆命令。避免在聊天、仓库文件与记忆中重复完整计划;选择一个权威计划并从跟踪器链接到它。

不要仅因为工作跨会话就创建或提交规划文档。遵循仓库关于临时文件与规划工件的规则。如果必须创建文档,将其放在未来智能体实际可访问的位置,并在委派简报中包含未跟踪的上下文(当其检出不会包含它时)。

有用的检查点记录当前修订版本、已完成成果与证据、活跃所有权、待定决策以及确切的下一步。保留用户更正,否则它们可能在压缩期间丢失。恢复时重新阅读检查点并检查实时状态;笔记描述的是过去状态,不是当前状态的保证。

在不丢失目标的情况下重新规划

当实现暴露新约束时,更改受影响的任务并解释其对成果、依赖或风险的影响。将更正贯穿到表格与验收标准中,而不仅仅是编辑的段落。仅当被拒绝替代方案的理由有助于未来决策时才保留它们。

在集成边界,将累积差异与预期成果进行比较。测试可能通过而范围漂移。审查强度跟随变化的风险与覆盖范围,而不是任务编号或先前通过的任务数量。强制项目验证仍适用于后期工作。

仅在所需证据存在时标记完成工作。将不可用的外部门禁与已完成的本地检查分开报告,附上其确切阻塞与下一步行动。记录阻塞状态时遵循宿主的任务状态规则;本技能不重新定义它们。

证据与限制

审查日期 2026-09-04。Anthropic 2026 年 3 月的 harness 报告描述了面向成果的规范与协商验证标准,同时观察到重复评估也可能增加实现复杂性。这是一项工程案例研究,并不证明每个项目都需要规划器-生成器-评估器流水线。

此处程序使用该区分:保留可测试契约并调整执行路径。通过产生的工作与更正成本评估规划变更,而不是计划的大小。

反模式

  • 在阅读代码前精确预测编辑:指定已验证边界与不确定细节。
  • 将每个功能与其测试分离:保持一个所有者对交付行为负责。
  • 仅基于文件名并行化:检查共享接口与运行时资源。
  • 授权构建后仍要求审批:在现有范围内继续。
  • 因为任务延迟而放宽审查:使审查匹配当前风险与证据。
  • 维护多个竞争进度账本:保留一个权威计划并链接收据。
  • 成功已覆盖后仍继续分解:执行;当证据改变工作时重新规划。

本技能不是什么

  • 不是琐碎工作或固定文件数量阈值的要求。
  • 不是执行仅计划请求的许可。
  • 不承诺初始架构、时间表或任务列表不能改变。