SuperAPI AI 工具集

completion-gate-init

部署与运维

查看项目

更新于 10-16 05:54

技能介绍

用途:当用户要求设置、安装或初始化 completion gate 时使用本技能。它是对官方安装脚本 scripts/init.sh 的便捷封装,脚本本身才是权威来源,应当直接运行而非自行重新实现。

主要能力:在用户项目根目录运行脚手架,生成 gate/(引擎与空清单)、control/surface_inventory.yaml、state/、.github/workflows/completion-gate.yml 以及一个 CODEOWNERS 示例。脚本是幂等的,默认不会覆盖已有文件(引擎或规范),除非加 --force。

使用方式:先定位 agent-completion-gate 检出目录(引擎与脚手架位于该仓库中,而非已安装的技能内;npx skills add 只分发技能,不分发门禁引擎)。若用户尚无检出目录,可执行 git clone https://github.com/zhjai/agent-completion-gate。然后在用户项目根目录运行 sh <checkout>/scripts/init.sh --dest .,并把脚本输出的 Next 步骤原样转述给用户;如被要求,可协助完成第 1 步(定义真实 surface 与检查)。

限制与注意:不要编辑 gate/acceptance_manifest.yaml 来弱化门禁,不要把 gate/ 与 control/ 移到工作进程可写的位置,也不得自行发明脚手架,只能运行脚本。不要声称门禁已处于激活或权威状态:它只有在用户(人类)设置所需状态检查与 CODEOWNERS 后才生效,此前的状态机限制需如实说明。不要让代理自行授予 complete,这种不对称正是设计要点:代理只能提出 candidate_complete,由 CI 或人类进行验证。