用途:为需要 API key 或其他凭证的技能定义统一的安全凭证协议,用于验证凭证是否存在,并在缺失时提示用户添加,避免敏感密钥进入智能体上下文或对话历史。
主要能力:当某个需要凭证的技能与用户请求相关时,先检查凭证是否已存在于 .env 文件(通常位于 ~/.env 或项目根目录),再执行该技能的其他工作。验证时使用 grep -sq "^CREDENTIAL_NAME=" ~/.env,其中 CREDENTIAL_NAME 替换为实际变量名(如 ALPHAGENOME_API_KEY 或 USER_EMAIL)。退出码为 0 表示凭证存在,可继续;任何非零退出码表示缺失,必须立即停止,不得运行该技能的任何工具或脚本,也不得仅以“密钥缺失”结束回合,而应生成命令提示用户运行。
使用方式:缺失时不要让用户把凭证粘贴到聊天中,而是生成终端命令让用户自行执行。模板为 printf "Enter CREDENTIAL_NAME (typing hidden): " && read -s val && echo && echo "CREDENTIAL_NAME=$val" >> "ENV_FILE" && echo "Saved.",需替换 CREDENTIAL_NAME 与 ENV_FILE(通常为 ~/.env)。read -s 会隐藏输入,必须告知用户输入不可见;同时应提供调用技能给出的注册链接或获取说明。调用技能内的辅助脚本通过 dotenv 自动从 .env 加载凭证,无需手动读取、导出到 shell 环境或作为 CLI 参数传入。
限制:禁止使用 cat ~/.env、不带 -q 的 grep、echo $VAR 或 printenv 检查凭证;不得将密钥值打印到终端或读入上下文。资料未提供具体注册链接、支持平台或额外配置细节。