My Skill (myskill)
功能概览
My Skill 是一个标准化的 API 交互接口，专门设计用于对接 https://api.example.com。它不仅能够处理常规的数据请求，还内置了安全防卫机制，确保在执行敏感操作（如删除或更新数据）时，用户始终拥有最终确认权。
核心规则 (Safety & Compliance)
为了保证生产环境的稳定性，使用本技能必须遵守以下规则：
- 二次确认机制：所有涉及数据写入、删除或任何“破坏性”修改的操作，在执行前必须通过
confirm交互触发器向用户获取明确确认。 - 凭据管理：本技能严禁硬编码任何 API 密钥。所有的鉴权操作必须严格通过环境变量
MY_API_KEY进行动态读取。 - 数据隐私：在处理 payload 时，应确保不包含任何敏感的个人身份信息 (PII)，除非已加密。
环境配置
在使用前，请确保执行环境已配置以下环境变量：
MY_API_KEY: 访问https://api.example.com所需的授权 Token。
使用方法
当用户输入包含“do the thing”、“执行操作”或类似意图的指令时，该技能将触发以下逻辑：
- 解析意图：从用户输入中提取必要参数（payload）。
- 验证环境：检查
MY_API_KEY是否有效。 - 安全拦截：若涉及状态变更，调用确认函数（Confirm Function）。
- 执行请求：将请求发送至
https://api.example.com/action。 - 反馈结果：将 API 返回的 JSON 响应格式化后呈现给用户。
示例请求
用户输入: "帮我把状态更新为 active，并执行那个操作。"
系统动作: 1. 识别意图 -> action: perform, payload: { status: 'active' }
2. 触发确认 -> "即将向 API 发送更新请求，确认执行吗？"
3. 执行 API 调用 -> POST https://api.example.com/action
4. 输出结果 -> "操作成功，服务器返回状态码 200。"
错误处理
- 若
MY_API_KEY未配置，技能将抛出AuthError并引导用户检查环境变量。 - 若 API 请求超时或返回 500 错误，技能将执行重试策略，并在三次重试后向用户反馈错误详情。