SuperAPI AI 工具集

panel-plan-loop

智能体与模型

查看项目

更新于 10-15 20:10

技能介绍

用途:对一份书面计划进行多轮独立评审并迭代修订,直到不再出现重大关切。它建立在 panel-plan 之上:每一轮是对该技能的一次调用(无共享状态的新评审小组,读取计划及其目标仓库,返回综合发现与开放问题)。本技能负责单次评审之外的部分——循环、决定哪些修复直接应用、哪些提交用户、计划编辑、跨轮日志以及收敛判断。分工:panel-plan 只读评审并报告;本技能作用于报告,编辑计划并决定何时停止。

何时使用:用户有书面计划并希望加以硬化(评审、修复、再评审直到稳固);用户说“用评审小组迭代这个计划”“一直跑评审小组直到干净”等。不适用:只要一次不修改的评审用 panel-plan;评审代码 diff 或 PR 用 panel-review;计划尚不存在时应先进行头脑风暴或写计划。

启动前:先做重入保护,检查是否存在 <plan-dir>/<plan-basename>.review.md,若其最后条目为 ## FINALIZED 标记,说明已收敛,不得自动开始新一轮,应报告上次判定并询问用户是否重新开启。随后解析计划文件(优先级:显式路径 → 对话中最新计划 → 询问),必须是磁盘上的 markdown 文件,只存在于对话中时先写出。选定评审员(默认 PATH 上的 codex/claude/opencode,可子集)并固定聚焦项,各轮保持一致以便比较。命名评审日志文件为 <plan-dir>/<plan-basename>.review.md,每轮追加一条记录,计划文件本身不混入评审内容。

每轮流程:第一步,在解析出的计划文件上调用 panel-plan 技能(传入相同的评审员与聚焦选项),它启动小组并返回综合报告,发现按严重程度分桶(must-fix / should-fix / polish),每项含 <plan>:LINE 与建议 Fix,另有开放问题与风险判读;让其运行至完成,消费其综合输出。第二步,对每一项分诊:自动修复指直接编辑计划的明确无争议改进,如补明显缺口、纠正关于代码库的已证实错误假设、修正步骤顺序、补充缺失的错误/回滚/验证步骤、把含糊步骤具体化;提交用户指需要人工决策的内容,包括所有开放问题、无明确胜出的取舍、范围增减、产品/UX 决策、无法解决的评审员分歧、任何改变计划意图或成功标准的编辑——拿不准就提交用户。第三步,把自动修复和用户决定应用到计划,并向评审日志追加本轮记录。第四步,收敛检查:若本轮没有新的 CRITICAL/HIGH/MEDIUM 发现(只有 LOW/吹毛求疵或全部 NO_FINDINGS),则已收敛,告知用户并询问停止还是再跑一轮,不得在收敛后静默继续;否则自动开始下一轮。安全上限为 4 轮,达到上限仍未收敛则停止、报告未决项并询问用户。循环结束时(收敛、用户选择停止或达到轮次上限),必须在日志末尾追加 ## FINALIZED — round N(判定)标记,供重入保护读取。

重要限制:绝不通过重新调用自身来等待,不要设置会重跑本技能的定时唤醒;每轮由受控的 panel-plan 调用驱动,结束后交还控制权。不要在本技能内重新实现评审,若发现自己在解析评审员原始输出,说明越界,应改为调用 panel-plan 并消费其综合结果。评审日志需沿用评审员自报模型。资料未提供具体代码示例、收费或平台限制等信息。