Stitch 资产上传助手
将本地图片、HTML 和设计文档可靠上传到 Google Stitch 项目。
证据显示要求有效API密钥，并在上传前要求用户确认文件路径、大小和类型；但允许通过命令行传递密钥，未说明密钥暴露风险、敏感数据处理、上传范围、撤销或回滚机制，且会将本地内容发送至外部Stitch服务，因此扣分。
脚本具备扩展名检查、文件存在性检查、MIME映射、超时和HTTP错误输出，主路径较清晰；但未处理一般网络异常、JSON解析失败、超大文件、项目或响应语义错误，文档还提到的--create-screen-instances参数并未在实际参数解析器中提供，因此扣分。静态评估不超过10分。
目标场景、输入类型、必需参数和基本触发条件较明确；但仅支持有限文件扩展名，未定义敏感文件、超大文件或不适用场景，核心功能依赖Stitch及海外端点，未提供中文或中国大陆网络可达性说明，因此扣分。
SKILL.md采用步骤、参数和文件类型表格组织，提供安装前提、故障提示，仓库也提供Apache-2.0许可证和安全报告入口；但缺少该技能的版本、变更记录、维护责任人、更新路径、完整示例和更系统的限制/故障排查说明，因此扣分。
脚本能把图片、HTML和Markdown编码并提交为Stitch screen，理论上覆盖核心上传任务，且避免模型输出base64截断；但没有该技能专属测试、真实结果或可验证输出示例，API请求兼容性和上传后的可用性仍需人工确认，因此按静态上限保守扣分。
源代码、参数定义和数据构造逻辑可审计，仓库有CI验证工作流；但CI只覆盖无关的react-components示例，没有覆盖本技能脚本或真实Stitch上传，缺少第三方执行证据和交叉佐证，因此扣分。
- 上传会将指定本地文件发送到外部Stitch API；上传前应确认文件不含敏感信息，并避免在共享进程或日志环境中暴露命令行API密钥。
- 文档与脚本的--create-screen-instances参数不一致，且网络、解析和超大文件失败路径覆盖不足。
- Stitch依赖海外服务；中国大陆网络可达性、数据驻留和合规性未在材料中说明。
这个 Skill 能做什么，适合哪些场景？
这是 google-labs-code/stitch-skills 中的一个 Agent Skill，专门把本地视觉资产、HTML 页面和 Markdown 设计文档上传到 Stitch 项目。它先通过 Stitch MCP 的 list_projects 确认目标项目，再读取 MCP 配置中的 API 密钥，并运行上传脚本直接通过 HTTP 发送文件。该脚本旨在绕过 MCP 工具处理 base64 文件时可能遇到的输出长度限制。使用它需要已配置并运行 Stitch MCP 服务器、可访问本地文件系统，并提供有效的 Stitch API 密钥。
读取本地 PNG、JPG、JPEG、WEBP、HTML、HTM 或 MD 文件；调用 Stitch MCP 的 list_projects 查找目标 projectId；从 Antigravity、Gemini CLI 或 Claude Code 的配置位置提取 Stitch API 密钥和可选 API URL；运行提供的 Python 上传脚本，将文件通过 HTTP 上传到 Stitch；可选设置上传屏幕标题和生成来源，并根据扩展名自动选择 MIME 类型。
- 设计师需要把本地 mockup 或图片资产上传到已有的 Stitch 项目时。
- 前端工程师需要把提取出的静态 HTML 页面发送到 Stitch 进行设计整理时。
- 团队需要将 DESIGN.md 或其他 Markdown 设计文档上传到 Stitch 项目时。
- 直接调用 Stitch MCP 上传文件因 base64 输出过长而失败或被截断时。
这个 Skill 有哪些优点和局限？
- 支持图片、HTML 和 Markdown 设计文档等多种本地文件。
- 通过脚本直接发送文件，可规避 MCP base64 输出长度限制。
- 支持 Stitch API URL、屏幕标题和生成来源等可选参数。
- 遵循 Agent Skills 开放标准，并可用于 Claude Code 和 Codex 等兼容客户端。
- 必须配置并运行 Stitch MCP 服务器，并拥有有效的 Stitch API 密钥。
- 上传前需要人工确认文件路径、大小和类型，不能完全无人值守。
- 源材料未提供测试覆盖、版本兼容范围或独立 skill 的维护指标。
- 文档未说明除列出的文件扩展名外的格式是否受支持。
如何安装这个 Skill？
可按仓库 README 使用选择性安装命令：npx skills add google-labs-code/stitch-skills。也可以在 Codex 中添加 google-labs-code/stitch-skills marketplace，并安装 stitch-design 插件。安装前需要配置并运行 Stitch MCP 服务器；README 未规定该单个 skill 的独立安装目录。
如何使用这个 Skill？
先通过 list_projects 找到目标 projectId，确认 MCP 配置中存在有效的 Stitch API 密钥，然后使用类似“Upload .stitch/landing_page.html to Stitch project projects/987654321.”的请求。执行上传脚本前，必须先向用户展示待上传文件的路径、大小和类型，并等待明确批准；随后运行 scripts/upload_to_stitch.py，传入 --project-id、--file-path 和 --api-key，可选传入 --api-url、--title 与 --generated-by。
这个 Skill 与同类方案有什么区别？
它与直接调用 Stitch MCP 工具的方式形成明确对比：当直接 MCP 调用因文件 base64 编码导致输出过长或被截断时，该 skill 使用上传脚本通过 HTTP 发送文件。源材料没有提供与其他独立上传产品的比较。