用途:该技能为 Gemini API 开发提供规范指引。规划阶段用于预先定义架构,编码与调试阶段用于校验代码模式。
主要能力与约束: 规划阶段需核对架构约束。查询文档可用 Docs MCP 的 search_docs 或参考 llms.txt 获取最新 SDK 规范;SDK 导入须使用 @google/genai(JS/TS)或 google-genai(Python),不得使用旧版 SDK;Web 应用须运行在本地开发服务器(如 localhost),禁止 file:// 执行;API 密钥与凭证须保留在服务端或后端代理,禁止暴露在客户端代码;计划须包含动态系统指令时间注入;生产代码路径不得使用静态桩响应,非功能元素须禁用或隐藏。
编码与调试阶段使用标准模式:输入法合成事件处理(Enter 键、e.isComposing 或 keyCode 229、Shift+Enter),发送后清空 input.value,loading 时禁用输入与按钮,trim 为空不发;语音输入须真实请求麦克风权限并提供监听、错误、重试与文本回退;模型选择可用 new GoogleGenAI({}).models.list(),时间感知用 const systemInstruction = Current local time: ${new Date().toLocaleString()};API Key 校验通过 SDK 列出模型实现;工具组合按 Gemini 2.x 与 3.x 区别适配,禁用搜索时在 systemInstruction 追加提示;工具执行错误或未知工具名不得直接抛出,须返回结构化 functionResponse 错误 JSON;历史记录不使用复数 functionCalls 字段,逐个映射 functionCall 与 functionResponse,保留 thought、signature 与工具上下文;错误处理返回含 code、message、details 的结构化 JSON,状态码如 429,调试信息不得含 API 密钥;Markdown 渲染用 marked 解析并经 DOMPurify.sanitize 处理。
使用方式与输出:产出包括验证日志(文档查询链接、模型清单)、检查清单(ID、项、结果、证据)、代码变更、冒烟测试输出、剩余风险与复发防护。
限制:资料未提供收费、价格、平台支持范围与效果说明;上述代码模式为技能内给定示例,具体项目集成方式暂未提供。