SuperAPI AI 工具集

plan-eng-review

通用与其它

查看项目

更新于 10-15 21:50

技能介绍

用途:锁定执行计划,在动手编码前做工程评审,提前发现架构问题。触发场景包括“review the architecture”“engineering review”“lock in the plan”,以及在用户已有计划或设计文档、即将开始编码时主动建议使用。语音触发别名有 tech review、technical review、plan engineering review。

主要能力:以工程经理模式审查指定目标,逐项走查架构、数据流、图示、边界情况、测试覆盖与性能,以交互方式给出有倾向性的建议。评审模式明确不主动构建功能、验收用例或基准,除非用户显式授权;证据优先使用现有测试、示例或对当前行为的有界探测。

使用方式:先执行范围门禁(Scope gate),确认要评审的目标——当前分支 diff、用户粘贴或指定的计划/设计文档,或某个具体文件、目录、路径;无法确定时通过 AskUserQuestion 给出 A/B/C 菜单并等待回答,绝不猜测目标。计划模式下若宿主指示为计划模式且存在计划文件,则自动选择 B(评审该计划)并公告一行说明。目标选定后运行 Preamble 命令:~/.claude/skills/gstack/bin/gstack-skill-start --skill "plan-eng-review" --model "claude",读取其输出的 KEY: value STATUS 行以驱动后续规则。之后按启动序列加载 Brain Context、检查网络研究就绪、运行 Design Doc Check 与 Prerequisite Skill Offer,再进入工程评审的 Step 0。

限制:计划模式下受宿主与系统只读限制约束,技能不能自行豁免;若宿主阻止某操作则跳过并说明。若 gstack-skill-start 输出缺少 SKILL_START_PROTO: 1,进入降级模式并采用安全默认值,提示用户运行 ./setup 或 /gstack-upgrade。ask 工具不可用或失败时按会话类型分流(headless 标记 BLOCKED、交互式回退为纯文本、投放式自动选择推荐项)。PROACTIVE 为 false 时不自动调用或建议任何技能。其余细节暂未提供。