用途:altimate-code 是一个自带数据工程工具的 CLI AI 智能体,可处理 SQL 分析、列级血缘、dbt 等数据工程任务。本技能的作用是把任务委派给它,并把结果原样返回给用户。
前提检查:调用前必须先确认已安装且在 PATH 中,运行 command -v altimate-code。若无输出(退出码 1),停止并告知用户:未安装时可用 npm install -g altimate-code 安装,需 Node.js 20+。不要替用户安装,由用户自行决定。若已安装但找不到,可检查 npm bin -g 是否在 PATH 中,或用 npm config get prefix 查找全局安装位置。安装后需先运行一次 altimate-code 进行配置,设置 LLM 提供商认证和仓库连接。
调用方式:run 为非交互模式,接收消息、执行任务、将最终结果打印到 stdout 后退出。最小调用:altimate-code run "<task description>" --yolo。推荐调用会加 --output 与 --dir:altimate-code run "<task description>" --yolo --output /tmp/altimate-result.md --dir "$(pwd)"。
主要参数:--yolo 非交互必需,自动批准工具调用;--output <path> 写出最终回复到文件;--dir <path> 指定运行目录;--model provider/model 覆盖模型;--format json 输出原始 JSON 事件;--continue 或 --session <id> 继续会话。
结果返回:读取输出文件内容并原样传给用户,不要重新总结、格式化或解读。
适用场景示例:查找 Snowflake 中昂贵的查询、为 dbt 模型生成列级血缘、对表进行数据剖析等。
限制与常见问题:缺少 --yolo 会因权限提示挂起;任务过于模糊可能导致输出为空;未配置 LLM 提供商凭证会提示“No provider configured”,可运行 altimate-code providers 设置;仓库凭证未配置会报错,需在 ~/.config/opencode/ 或通过环境变量配置。altimate-code 使用自己的 LLM,费用和速率限制计入其配置的提供商而非 Claude Code。会话保存在本地,可用 altimate-code session list 查看历史,用 --continue 恢复。长任务建议使用 --output 而非抓取 stdout。