管理技能变量
编辑技能时，如果工作流需要调用外部 API 或访问数据库，往往会涉及 API Key、Token、密码等敏感凭证。直接把明文写进技能文件会带来泄露风险。变量管理让你在每个技能内部以「变量」的方式安全托管这些敏感信息——技能文件里只写变量名占位符，真实值由平台加密存储，查看和执行技能时不会明文展示。
核心机制
| 概念 | 说明 |
|---|---|
| 变量声明 | 在技能编辑器中创建变量，定义变量名（如 API_KEY）和描述 |
| 密钥配置 | 填入真实密钥值后由平台加密保存，保存后界面只显示脱敏值（如 ••••••••xxxx） |
| 占位符引用 | 技能文件中使用每个文件类型支持的变量引用格式（如 ${SKILL_SECRET.变量名}）引用变量，运行时平台自动注入真实值 |
| 发布校验 | 发布技能时自动检测是否存在未配置的变量或明文密钥，有风险时拦截并提示处理 |
创建和使用变量
在技能编辑器中，可以通过以下方式管理变量：
- 「+ 新增变量」：点击编辑器头部的按钮，填写变量名称、描述和密钥值。变量名称仅支持英文字母、数字和下划线，且不能以数字开头。
- 「$ 插入变量」：在 SKILL.md 编辑区域输入
$，即可唤起变量列表。选择变量后，系统会自动插入对应的变量引用，例如${SKILL_SECRET.变量名}。 - 「重新配置」：可在变量管理面板中更新已有变量的密钥值，变量名称和文件中的引用无需重新修改。
- 「删除变量」：可删除不再使用的变量。若技能文件中仍存在该变量的引用，需要先完成相应调整。
智能变量检查
如果不确定技能文件中是否存在明文 AK、Token、密码等敏感信息，或者已经创建变量，但不确定文件中的变量是否正确使用，可以使用「智能变量检查」。
智能变量检查会扫描整个技能，识别敏感明文以及变量引用、读取等问题，并根据当前技能内容完成必要的变量配置和文件修改。检查只处理与敏感信息及变量使用相关的内容，不修改其他业务逻辑。
根据当前的配置情况，可以通过以下几种方式使用：
- 完全手动配置：如果熟悉变量配置和代码，可以自行「新增变量」，并在对应文件中完成变量读取和引用。
- 先创建变量，再交给智能变量检查完成文件修改：如果已经知道需要托管哪些敏感信息，可以先新增变量，再点击「智能变量检查」。系统会识别已有变量及文件中尚未完成的变量使用，自动完成相关文件修改和验证。
- 直接使用智能变量检查完成处理：如果不确定技能中有哪些敏感信息，或不清楚不同文件应该如何使用变量，可以直接点击「智能变量检查」。系统会扫描技能文件，识别需要处理的敏感信息，复用已有变量或新增变量，并完成相关文件修改和验证。