SuperAPI AI 工具集

plan-eng-review

编程与开发

查看项目

更新于 11-08 20:16

技能介绍

plan-eng-review 是一个用于工程项目计划评审的技能,其定位是“工程经理模式”的方案评审,核心目标是在用户开始写代码之前,把执行计划锁定下来。

用途 资料说明,该技能适用于以下场景:用户要求“评审架构(review the architecture)”“工程评审(engineering review)”“锁定计划(lock in the plan)”;或者用户已经完成计划或设计文档、即将开始编码时,可主动建议调用,以在实现前发现架构问题。语音触发别名包括 tech review、technical review、plan engineering review。

主要能力 评审范围包括架构(architecture)、数据流(data flow)、图表(diagrams)、边界情况(edge cases)、测试覆盖(test coverage)和性能(performance)。技能会以交互方式逐项走查上述问题,并给出有明确倾向的建议(opinionated recommendations)。

使用方式 该技能以 SKILL.md 形式定义在 gstack 技能集中,运行时先执行一段前置脚本(preamble),主要动作包括:调用 gstack-update-check 检查更新;在 ~/.gstack/sessions 下创建并使用以 $PPID 命名的会话标记文件,清理超过 120 分钟的会话文件并统计数量;读取 proactive、skill_prefix、telemetry、explain_level、question_tuning、checkpoint_mode、checkpoint_push、routing_declined 等配置;输出当前分支、仓库模式、会话类型(spawned/headless/interactive)、计划模式状态等环境信息;统计项目学习记录数量并在超过 5 条时检索最近 3 条;写入时间线日志;检测 CLAUDE.md 中的技能路由规则。此外还包含首次运行提示、遥测询问、proactive 询问、技能路由规则写入建议、vendored 拷贝迁移提醒等一次性引导流程,以及升级提示处理。

在计划模式(plan mode)下,技能被视为可执行指令而非参考资料,从 Step 0 开始按步骤执行;AskUserQuestion 的首次调用属于工作流进入计划模式,不视为违规。若 AskUserQuestion 不可用或调用失败,采用失败回退:headless 模式为 BLOCKED,交互模式为散文回退。遇到 STOP 点应立即停止,不继续工作流,也不调用 ExitPlanMode;仅在技能工作流完成或用户要求取消技能/离开计划模式后才调用 ExitPlanMode。

当 PROACTIVE 为 false 时,不自动调用或主动建议技能;若认为某技能有用,应先询问用户是否运行。SKILL_PREFIX 为 true 时建议或调用 /gstack-* 名称。在由 AI 调度器生成的会话(SPAWNED_SESSION)中,不使用 AskUserQuestion 交互提示,自动选择推荐选项,不运行升级检查、遥测提示、路由注入或 lake intro,并以文字报告说明产出、决策和不确定项。

适用场景 适合在工程项目进入实现阶段前使用,对架构方案、数据流、边界条件、测试覆盖和性能安排做集中评审,尤其适合用户已有设计文档、需要在动手编码前确认方案是否成立的情况。

限制 资料未提供该技能的具体价格、收费模式、支持的平台范围或效果数据,这些事实暂未提供。前置脚本依赖 gstack 的目录结构与相关二进制(如 gstack-update-check、gstack-config、gstack-timeline-log 等)。部分行为受配置项和运行环境(如 Conductor 主机、headless 模式)影响。