要让qoderwake skill直接执行excel清洗、sql聚合或api数据拉取，需走skill注册→上下文绑定→结构化调用路径：先在控制台启用skill并手动添加依赖；再通过--context参数以本地路径、数据库连接串或json结构体绑定数据源；最后按input_schema校验参数，用--params传入合法配置并监控任务状态获取输出。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让QoderWake Skill直接介入Excel清洗、SQL聚合或API数据拉取等具体数据处理环节，而不是只停留在“分析一下”这种模糊指令层面，就得绕过自然语言对话层，走Skill注册→上下文绑定→结构化调用这条技术路径。
确认Skill已安装并启用
进入QoderWake控制台→点击左下角「Skill管理」→在列表中查找目标Skill名称（如excel-cleaner-v2.3、sql-aggregator-skill或api-fetcher-pro）。若状态为“未启用”，点击右侧开关按钮激活；若根本没出现，说明该Skill尚未部署到当前沙盒环境，需联系管理员上传对应.qwsk包文件。
注意：启用后Skill不会自动加载依赖库，比如excel-cleaner-v2.3依赖openpyxl 3.1+，必须手动进入「依赖管理」添加，否则后续调用会报ModuleNotFoundError。
绑定数据源上下文
Skill本身不持有数据，必须通过--context参数显式挂载输入源。支持三种方式：
方法一：本地文件路径绑定
执行CLI命令：qoderwake skill invoke --skill=excel-cleaner-v2.3 --context="/input/raw_data.xlsx"。路径必须是QoderWake沙盒可读目录，【/input/是唯一允许读取的根路径，写入仅限/output/】。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
方法二：数据库连接字符串注入
适用于sql-aggregator-skill：在命令中加入--context="mysql://user:pwd@10.0.1.5:3306/analytics?charset=utf8mb4"，注意密码需URL编码，特殊字符如@要转为%40。
方法三：JSON结构体直传（仅限轻量数据）
用--context='{"data":[{"id":1,"name":"A"},{"id":2,"name":"B"}]}'方式传入，避免文件IO开销，但单次传输上限为2MB，超限会触发ContextPayloadTooLargeError异常。
执行结构化任务调用
第一步：确定Skill输入契约
运行qoderwake skill describe --skill=excel-cleaner-v2.3，查看其input_schema字段，确认必需参数——例如该Skill强制要求sheet_name和drop_empty_rows两个键存在，缺一不可。
第二步：构造合法调用参数
以清洗Excel为例，完整命令为：qoderwake skill invoke --skill=excel-cleaner-v2.3 --context="/input/raw_data.xlsx" --params='{"sheet_name":"Sheet1","drop_empty_rows":true,"output_format":"xlsx"}'。其中--params内容必须严格匹配Schema定义，布尔值不能写成"true"字符串，否则校验失败。
第三步：监控执行与产物提取
命令返回JSON格式结果，含task_id和output_path字段。立即执行qoderwake task status --id [task_id]查状态，成功后产物自动落盘至/output/cleaned_20260730_1944.xlsx，文件名含时间戳防覆盖。
