SuperAPI AI 工具集

plan-brief

智能体与模型

查看项目

更新于 10-15 20:08

技能介绍

用途:把复杂需求转成三件产物——详细执行计划文档、供全新会话执行该计划的自包含启动提示词、以及执行报告返回后的审查(含所需修复提示词)。本技能只做规划与审查,不亲自执行计划,也不派生执行子代理。

主要能力与流程:Phase 0 完整吸收需求,用 2-3 句复述目标、范围、可观察完成标准,并区分显式需求与待定细节;Phase 1 调研项目规则(AGENTS.md)、README、项目记忆与文档、入口及需求涉及的调用链,确认现状、复用点、兼容边界与项目自身约定,事实自行查证而非臆造命令或 API;Phase 2 逐轮盘问未决细节,只问会改变范围、行为、兼容性、风险、执行顺序或验收的问题并给出推荐,必须敲定运行环境(解释器、venv/conda 路径与激活命令、环境变量名、工作目录、包管理器、版本)、输入输出、执行顺序、文档位置(默认 docs/plans/YYYY-MM-DD-<slug>.md)、验证方式与验收责任;验证方式为强制决策,TDD 仅用于反馈快、测试便宜的场景,研究、长时或重算任务默认用 smoke-and-read(最小真实执行路径+重读代码+检查相邻行为,不写 pytest/测试脚手架);Phase 3 采用最小可用改动取向,优先复用现有代码、标准库、已装依赖,根因修复并考虑共享逻辑的同类调用方,破坏性操作需授权门;Phase 4 输出结构化 Markdown 计划(目标与范围/现状/环境与前提/执行步骤/注意事项与已知坑/验证方式/交付物清单),步骤含做什么、文件或命令、预期结果与依赖;Phase 5 启动提示词同时写入计划文档的围栏块并在对话中打印,含计划路径、AGENTS.md 与相关文档、范围、环境、步骤顺序、验证方式、授权门、交付物,并要求执行会话写 <plan-basename>.report.md 开发报告,部分完成须如实标注,不得伪造完成。

审查闭环:用户带回报告后本技能并排读计划与报告,仅在需要证据处抽查代码,制作逐步核对表(报告主张/证据/判定),审查规范遵循与偏离原因,给出符合/部分符合/不符合结论及按优先级的最小修复项,写 <slug>.review.md 并在对话打印,绝不修改执行方的报告;需要修复时按 Phase 5 规则生成新的自包含启动提示词,修复轮次各自产出 report-2、review-2 等,不覆盖旧文件;判定为符合即置 Status: done (rounds: N) 并更新项目记忆与文档。

限制与注意:返回路径由用户中转,本会话不会被执行方自动唤醒;硬性边界是计划与启动提示词交付后规划工作即告完成,不得在本会话执行计划、派生执行子代理或自行开启修复轮次;同一阻塞项无进展时停止并把未决问题交回用户。官方未提供更多细节。