核心用法
本 Skill 是一个 API 调用辅助工具，旨在帮助用户快速构造和发送针对 PoYo 平台 Gemini 3.5 Flash 模型的请求。它支持两种主流调用格式：OpenAI 兼容的 /v1/chat/completions 端点，以及谷歌原生的 Gemini Native Format（包含 generateContent 和 streamGenerateContent）。用户可通过简单的环境变量配置 ${POYO_API_KEY}，结合提供的 Shell 脚本或手动构造 payload，完成从文本生成、代码辅助到多模态对话的多种任务。
使用场景覆盖：文本生成与摘要、结构化响应输出、编程辅助、多模态 prompt 规划、流式响应处理，以及服务端 curl 示例的快速生成。Skill 内置完整的参数映射指南，包括 generationConfig（温度、topP、topK、最大输出 token、停止序列）和可选的 safetySettings 配置。
显著优点
1. 双格式支持：同时兼容 OpenAI 风格的 chat completions 和谷歌原生格式，降低迁移成本，方便不同技术栈的开发者接入。
2. 安全实践规范：API 密钥通过环境变量管理，无硬编码风险；代码结构清晰，包含 set -euo pipefail 等错误处理机制；文档中明确列出安全规则，禁止密钥泄露至前端或日志。
3. 依赖极简：仅依赖系统原生 curl 工具，无第三方包引入，从根本上规避供应链攻击风险，依赖审计评分高达 95 分。
4. 功能边界清晰：Skill 严格限定为"辅助构造"角色，不主动发起未经授权的 API 调用，所有执行均需用户显式确认，符合最小权限原则。
5. 流式与同步双模式：完整支持 stream: true 和 streamGenerateContent，满足实时交互场景的性能需求。
潜在缺点与局限性
1. T3 来源可信度：发布者为个人开发者 coolhackboy，非官方或知名组织维护。虽然代码透明无混淆，但相比 T1/T2 来源仍需额外人工审查，生产环境建议 fork 后自行维护。
2. 外部 API 强依赖：核心功能完全依赖 PoYo 服务可用性（api.poyo.ai），若平台发生故障、限流或政策变更，将直接影响 Skill 可用性。且用户数据需离境传输，存在合规考量。
3. 功能范围受限：仅针对 Gemini 3.5 Flash 单一模型优化，不支持 PoYo 平台上其他模型（如 Gemini 1.5 Pro）的快捷调用，也不提供高级功能如批量处理、微调或成本估算。
4. 无运行时保护：Skill 本身不包含沙箱或输入验证层，恶意构造的 payload 可能直接传递至下游 API，需用户自行确保输入安全。
5. 隐私合规待完善：虽然文档建议不记录敏感信息，但缺少自动的数据脱敏机制，且 GDPR 的"用户数据知情同意"项标记为警告状态。
适合的目标群体
- 后端开发者：需要快速集成 Gemini 3.5 Flash 至现有服务，且熟悉 Shell/curl 的技术人员。
- AI 应用原型搭建者：希望在 PoYo 平台验证 Gemini 模型效果，追求最小依赖和快速启动的个人开发者或小型团队。
- 多模态实验用户：需要探索 Gemini Native Format 的
contents+parts结构，进行图文混合 prompt 规划的 AI 研究者。 - 隐私敏感型用户：倾向于代码透明、可本地审查的 T3 工具，而非黑盒化的官方 SDK。
使用风险
1. 供应链与域名风险：PoYo 平台虽信誉良好，但非谷歌官方直营，存在服务商变更或终止风险。建议监控其服务状态页面，关键业务应准备模型降级方案。
2. 凭证泄露风险：虽然 Skill 推荐使用环境变量，但在共享服务器、CI/CD 日志或调试输出中仍存在意外暴露可能。务必配置日志脱敏规则，禁止在异常堆栈中打印 ${POYO_API_KEY}。
3. 成本与配额风险：API 调用按 token 计费，流式模式下高频请求易触发速率限制。建议在调用层封装指数退避重试逻辑，并设置预算告警。
4. 数据跨境合规：用户内容将传输至 PoYo 全球部署节点，涉及数据主权问题。处理欧盟、中国等强监管区域数据时，需确认 PoYo DPA（数据处理协议）覆盖范围。
5. T3 维护可持续性：个人开发者维护的项目可能存在更新延迟或弃坑风险，建议关注社区 Issue 活跃度，关键生产场景考虑贡献代码或接管维护。