SuperAPI AI 工具集

plan-loop

编程与开发

查看项目

更新于 10-15 21:49

技能介绍

用途:Plan Loop 用于编码或工程任务的规划阶段,把功能、缺陷或重构提示词转化为基于真实仓库的可执行计划,产出可交接给下游执行循环或较小模型的工件。它只做规划,不写生产代码。

主要能力:产出 plan.md(人类可读布局)与 tasks.json(结构化任务,含文件、测试、依赖与原子子任务)。反馈信号分两部分:客观门禁 tools/validate_plan.py 检查 schema 形状、依赖图无环、拓扑序有效与组件覆盖;定性门禁由独立 principal engineer 代理评审对齐、分解、可测试性及初级执行者能否无猜测地完成。循环构建、校验、评审、修订,直到评审通过或达到预算。

使用方式:先解析绑定(prompt、repo、plan_file、tasks_file、pr_loc、sandbox_root、budget),若存在 loop.run.yaml 则加载确认,否则交互式推断并写入。每轮运行 python3 <skill_dir>/tools/validate_plan.py --tasks <tasks_file>,输出 JSON 的 ok 必须为 true。随后按清单构建计划、分解组件、拆分 PR 级任务、排序、拆原子子任务、写入并校验,再反复评审修订。

适用场景:需要把提示词变成可逐任务交接的执行计划,且计划基于真实仓库环境与约定。

限制:不用于写代码(属下游执行循环),不用于研究或实验提案。计划必须基于真实仓库,不得编造包、文件、API 或命令;无法确定的关键决策记为 open_question。仅可编辑 sandbox_root 内文件,repo 只读。评审者须独立,作者不得自评通过。具体安装与运行细节暂未提供。