用途:把本地已获用户确认的图片、HTML、Markdown 等资源上传到指定的 Stitch 项目。由于 MCP 工具对文件做 base64 编码后会超出模型输出 token 上限(约 16K),该技能改用自带 Python 脚本直接通过 HTTP 发送文件。
主要能力:支持 .png、.jpg、.jpeg、.webp、.html、.htm、.md,脚本按扩展名自动识别 MIME 类型;可指定上传后的屏幕标题与生成来源。
使用方式:先用 list_projects 找到 projectId;再从已批准的密钥来源(如 Claude Code 的 ~/.claude.json 中 X-Goog-Api-Key 头或 auth 参数)获取 API Key,不得打印或粘贴到对话中,无合规来源时应停止并报告。运行前必须暂停并向用户展示待上传文件的路径、大小、类型,获得明确批准后再执行:
python3 <SKILL_DIR>/scripts/upload_to_stitch.py --project-id <PROJECT_ID> --file-path <PATH_TO_FILE> --api-key <API_KEY> [--api-url <STITCH_API_URL>] [--title <SCREEN_TITLE>] [--generated-by <GENERATED_BY>]
--project-id、--file-path、--api-key 必填;--api-url 默认 https://stitch.googleapis.com;--title 可填页面路由(如 /dashboard);--generated-by 可注明生成方式。macOS 若报 SSL 证书错误,可安装 certifi 或设置 SSL_CERT_FILE 后重跑。
适用场景:把提取的静态 HTML、设计稿截图或 DESIGN.md 等资产同步进 Stitch 项目。
限制:需用户确认目标与文件;不得泄露密钥;宿主未暴露相应 MCP 工具时不得声称调用成功,应走本地 .stitch/ 产物、导出文件或 Stitch 网页界面等回退路径;生成结果需经本地渲染或语法验证。