GATE与检查点模式：stitch-skills如何让AI Agent安全行驶
【免费下载链接】stitch-skillsA library of Agent Skills designed to work with the Stitch MCP server. Each skill follows the Agent Skills open standard, for compatibility with coding agents such as Antigravity, Gemini CLI, Claude Code, Cursor.项目地址: https://gitcode.com/GitHub_Trending/st/stitch-skills
stitch-skills 是一套面向 Stitch MCP 服务的 Agent Skills 技能库，它用 GATE（关卡门）与检查点（Checklist）两类机制，约束 AI Agent 按阶段推进任务、每个阶段先验收再继续，从而让 AI Agent 在执行设计生成、代码转换等长任务时"安全行驶"，不跳步、不跑偏。
为什么 AI Agent 需要"限速带" 🚧
AI Agent 擅长一口气把任务做完，但"一口气"恰恰是风险来源：跳过下载直接读本地文件、用错项目的配色令牌、未经你同意就启动开发服务器……这些"自作主张"在长任务里会被逐级放大。
stitch-skills 的思路很像给车辆设计关卡：
- GATE（关卡）：每个阶段末尾设一道门，条件不满足就不许进入下一阶段；
- 检查点（Checklist）：任务结束前，对照清单逐项自查验收。
所有技能都遵循 Agent Skills 开放标准，可被 Codex、Antigravity、Gemini CLI、Claude Code、Cursor 等编码 Agent 加载，详见 README.md。
关卡门 GATE：阶段验收后才放行
打开任意一个构建类技能（如 React 组件转换）的 SKILL.md，开头就是一句硬规则：
CRITICAL: Every step in this skill is MANDATORY. Do NOT skip any step or take shortcuts. Each section contains a GATE that must be satisfied before proceeding.（每一步都是强制的，不许跳步。每个章节都含一道 GATE，必须满足后才能继续。）
以"设计稿转 React 组件"技能为例，整条流水线被切分为 4 个阶段，每个阶段各有一道门：
| 阶段 | 关卡门内容 | 不放行的后果 |
|---|---|---|
| Phase 1 下载与获取 | 必须通过脚本下载全部屏幕并完成视觉审核，禁止直接读本地文件 | Agent 基于过期/缺失设计稿开工 |
| Phase 2 样式提取 | 必须用当前项目的样式令牌更新 style-guide，旧项目令牌一律无效 | 配色、字体与真实设计稿不符 |
| Phase 3 架构规则 | 组件必须拆分、数据解耦、类型安全，违反则npm run validate直接失败 | 生成"能跑但烂"的代码 |
| Phase 4 执行与校验 | 跑校验脚本、启动本地服务器等操作，必须先征得用户同意 | Agent 擅自动用你的机器 |
注意第四道门最特别：它把"验证"设为可选项，且必须询问用户。这就是 human-in-the-loop（人在环中）——关键动作的钥匙始终握在人手里。
反模式清单：把"不许做的事"写进技能
除了正向的关卡，每个阶段还配了 Anti-patterns（反模式）清单，用 ❌ 明确列出禁止行为。例如 Phase 1 的反模式（见 SKILL.md）：
- ❌ 不先调 MCP 接口就直接读
.stitch/designs/*.html - ❌ 跳过高可靠的下载脚本
- ❌ 发现已有文件时不问用户就假设复用
- ❌ 跳过截图的视觉审核
对新手来说，这种写法比"要仔细检查"之类的模糊叮嘱有效得多：它把常见踩坑点直接写死，Agent 照着排除即可。
检查点：任务结束前的自查清单
关卡管"过程"，检查点管"结果"。技能在resources/目录中内置了验收清单，例如架构质量门（Architecture Quality Gate）architecture-checklist.md：
- 结构完整性：逻辑抽到自定义 hooks；无巨石文件；静态文本移入
mockData.ts - 类型安全：Props 使用
Readonly<T>接口；模板占位符已替换 - 样式主题：所有颜色类应用了
dark:变体；无硬编码 hex 值
其他技能也有各自的检查点：视频生成技能对照 composition-checklist.md，设计文档提取技能内置 Quality Checklist（extract-design-md/SKILL.md）。执行阶段最后一步就是把产出对照清单逐条核销，未过项就地修复，避免"带病交付"。
接力棒系统：长任务的"断点续传" 🏃
更进阶的用法在 stitch-loop 技能里：让 Agent 自主循环建站，每轮迭代像接力赛一样交接"接力棒"。
.stitch/next-prompt.md：接力棒文件，记录当前任务，是每轮迭代的检查点——读完它才知道"现在该做什么".stitch/SITE.md：站点愿景、站点地图与路线图，防止重复建页.stitch/metadata.json：持久化项目 ID 与屏幕元数据，保证下一轮能接着改，而不是推倒重来
每轮迭代固定动作：读棒 → 查上下文 → 生成页面 → 集成进站点 →写下一棒。技能还明确支持 Human-in-loop 编排方式：开发者每轮审核后再放行，等于给自动化加了一个可暂停的检查点。这套"接力棒 + 持久化状态"的组合，正是断点续传思想在 Agent 工作流里的落地。
如何快速上手 stitch-skills 🚀
- 整体安装插件（推荐，最快）：
npx plugins add google-labs-code/stitch-skills --scope project --target claude-code（Claude Code 示例；Cursor、Codex 的用法见 README.md） - 按需挑选技能：
npx skills add google-labs-code/stitch-skills，注意技能之间存在依赖，选择性安装时请带齐所需依赖 - 前置条件：配置好 Stitch MCP 服务器（注册服务、设置凭据与环境变量），否则技能无法调用 Stitch 工具
仓库目录结构清晰：plugins/下分 stitch-design（设计工作流）、stitch-build（代码生成）、stitch-utilities（提示增强等工具），每个技能都是一个SKILL.md+ 脚本 + 资源清单的标准结构。
小结
stitch-skills 给 AI Agent 装上了三道"安全设施"：
- GATE 关卡门——阶段未验收不许前进，从源头杜绝跳步；
- 检查点清单——任务收尾前逐项核销，杜绝带病交付；
- 接力棒与人在环中——长任务可断点续传，关键动作始终由你拍板。
对新手而言，你不需要理解这些机制的实现细节，只要让 Agent 使用这些技能，"安全行驶"的规则就已经生效了。
【免费下载链接】stitch-skillsA library of Agent Skills designed to work with the Stitch MCP server. Each skill follows the Agent Skills open standard, for compatibility with coding agents such as Antigravity, Gemini CLI, Claude Code, Cursor.项目地址: https://gitcode.com/GitHub_Trending/st/stitch-skills
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
