SuperAPI AI 工具集

plan-eng-review

编程与开发

查看项目

更新于 11-17 00:30

技能介绍

plan-eng-review 是一个面向“工程经理模式”的计划评审技能,来自 ariadoss/superskills(gstack)。它的定位不是替用户开发功能,而是对一个明确的评审目标做结构化检查,并用现有测试、示例或对当前行为的有界探测来支撑结论。

用途与范围 技能首先执行“范围门”:评审前必须确定目标,目标可以是当前分支差异(进行中的改动)、用户粘贴或指出的计划/设计文档,或某个具体文件、目录、路径。若目标缺失、含糊、冲突、被引用或已过期,技能要求先澄清,或在没有其他例外时给出固定选项菜单并停止等待回答,不得凭空猜测目标。在宿主明确处于计划模式时,技能可自动选择“评审当前计划”(宿主引用的计划文件或本会话刚起草的计划)并发送一行公告,便于用户中断;若用户显式指定了其他目标,则以用户指定为准。

主要能力与规则 技能定义了完整的提问与决策流程:决策简报需包含一句话问题标题、项目/分支背景、通俗解释(ELI10)、选错的代价、推荐项及理由、完整性评分、每个选项的优缺点,以及一句权衡总结;并用连续 D 编号记录问题,不因阶段切换而重置。它区分“选项在覆盖度上不同”和“选项在类型上不同”,前者给出 0-10 的完整性评分,后者注明不评分。对不可逆或破坏性操作,要求更强的显式确认,模糊回复不算确认。技能还规定了当提问工具不可用或调用失败时的回退策略:交互会话改用散文形式的决策简报并等待用户输入;无头会话则标记为阻塞;派生或无值守会话按推荐项自动决定(但破坏性选项除外)。

使用方式与启动顺序 使用方式为在支持的环境中调用该技能,然后按其流程执行:先处理范围门,运行启动脚本 gstack-skill-start,读取其回显的状态行以确定会话类型与遥测上下文;缺失启动协议时进入降级安全默认值。随后按顺序进行上下文恢复、加载可用的 Brain Context、检查网络研究就绪状态、运行设计文档检查与前置技能提示,再进入工程评审的读取、准备与范围质询环节。技能还说明与共享前言的配合方式,以及指令块仅在直接工具结果且会话 ID 匹配时生效。

适用场景与限制 适合在编码代理或类似宿主环境中,对分支改动、计划文档或指定代码路径做评审前的把关,尤其强调先界定范围、再用证据说话,避免未授权的功能开发或基准构建。限制在于:它本身是评审流程技能,不负责实现功能;大量行为依赖宿主提供的提问工具、计划模式元数据与启动脚本;具体平台支持、收费与价格信息暂未提供;详细步骤以其技能文件与共享前言为准。