SuperAPI AI 工具集

panel-plan

编程与开发

查看项目

更新于 10-15 20:10

技能介绍

用途:在尚未编写代码之前,对一个书面的设计或实现计划(Markdown 文件)做一次独立的多人评审,输出一份综合报告。适用于用户说“panel plan”“让小组评审我的计划”等单轮场景。评审代码 diff 或 PR 应改用 panel-review;需要反复迭代加固计划应改用 panel-plan-loop;计划还不存在则先做 brainstorming/writing-plans。

主要能力:把计划并行分发给多个独立本地 CLI 代理(默认 PATH 上所有受支持的 CLI:codex、claude、opencode,也可用 --panelist 指定子集),各代理在独立子进程中运行,不共享会话状态,只能看到计划、目标仓库(只读)和评审提示,因此是真正独立的第二意见。脚本用 nl 给计划加行号,便于代理引用 <plan>:LINE;代理以只读方式访问代码库(codex --sandbox read-only、claude --permission-mode plan、opencode plan agent)。最后把发现去重、按严重度分桶、汇总开放问题,并核对可疑结论。

使用方式:解析计划文件路径(显式路径 → 本次对话最新产出的计划 → 询问用户),计划必须是磁盘上存在的 Markdown 文件,若只在对话中则先写盘并确认路径;可选传入 --focus 指定关注点;运行 skills/panel-plan/panel-plan.sh --plan <file>。运行方式与 panel-review 一致:以 run_in_background: true 启动后台 Bash,用 BashOutput 每 10 秒轮询,直到每位评审者发出 done 心跳;不要用 Agent/TaskCreate 或 sleep && grep,也不要设置 ScheduleWakeup/cron 兜底。若环境不支持后台 BashOutput,可前台运行并设 timeout: 600000(默认 2 分钟会提前杀掉调用),此时会失去实时进度。脚本对每位评审者设默认 600 秒超时,静默不代表卡住。

适用场景与限制:产出报告为交付物,不会编辑计划文件;评审者可读取目标代码库以验证可行性,但不能修改任何内容,不使用 diff、git worktree 或 gh。若某评审者超时或失败,其余输出保留且脚本退出码为 2,需如实呈现失败而非丢弃该评审者。评审者会读取项目的 AGENTS.md/CLAUDE.md,可能对评审产生偏向。具体 CLI 参数与环境变量可用 bash skills/panel-plan/panel-plan.sh --help 查看。