QoderWake技能列表调用指南：100+岗位技能查询与扩展教程

部署了QoderWake数字员工后，快速掌握其技能体系是释放其价值的第一步。无论你是想了解其核心能力，还是需要精准调用内置的岗位技能，本指南将为你提供清晰的操作路径。

一、即时查询：通过自然对话获取技能清单

最快捷的方式是直接询问。QoderWake支持自然语言交互，你无需记忆菜单路径，在任意对话窗口提出需求即可获得实时反馈。

操作流程如下：

1. 在对话框中输入查询指令，例如：“列出我当前可用的所有技能。” 或 “展示已激活的Skill列表。”。

2. AI将返回一份结构化列表，包含技能名称、版本、功能简介，并明确标识出“数字程序员”、“数字HR”等内置岗位技能。

3. 如需精准筛选，可附加条件。例如：“仅显示与代码审查相关的内置技能。” 系统将自动过滤并呈现结果。

二、可视化浏览：使用斜杠命令调出技能面板

在集成开发环境（IDE）中，斜杠命令提供了更稳定、可视化的技能管理界面，便于浏览与快速调用。

具体步骤如下：

1. 在IDE聊天输入框内，键入 / （斜杠符号）。

2. 按下回车，右侧将展开“技能目录”面板。所有可用技能以分类卡片形式呈现。

3. 每张卡片展示技能图标、名称、分类标签（如“岗位类”、“工具类”）及启用状态。

4. 点击卡片上的 “复制调用指令” 按钮，即可获取标准执行命令，例如 skill exec --use="interview-question-generator"，便于后续集成与调用。

三、开发者模式：通过命令行进行技能审计与导出

对于需要批量管理、技能审计或CI/CD集成的开发者，命令行工具（CLI）提供了强大的程序化操作能力，支持导出结构化数据。

执行流程如下：

1. 确保CLI工具已完成初始化与身份认证。通常执行：qoder init && qoder auth login。

2. 执行导出命令。例如，将所有技能以JSON格式导出至文件：qoder skill list --format=json > installed-skills.json。

3. 在生成的JSON文件中，查找 "builtin": true 字段，即可识别出平台预置的百余种岗位技能。

4. 若需仅查看岗位类技能，可使用过滤参数并以表格形式输出：qoder skill list --category=role-based --format=table。

四、调用内置岗位技能的三种标准方法

定位技能后，QoderWake为所有内置岗位技能（如“根因定位”、“变更简报生成”）提供了统一的调用契约，适配不同工作流。

主要调用方式如下：

1. 自然语言触发：在对话中直接描述需求并指定执行岗位。例如：“请以数字程序员的身份，评估本次代码提交的潜在风险点。”

2. 结构化指令触发：适用于自动化脚本或已知技能ID的场景。使用 skill exec 命令并指定参数。例如：qoder skill exec --use="code-diff-analyzer" --input=diff/PR-2284.patch。

3. API网关触发：面向系统集成。向 /v1/skill/execute 端点发送POST请求，在请求体中指定技能ID与输入载荷。例如：{"skill_id": "resume-parser", "input_payload": {"url": "https://cv.example.com/xxx.pdf"}}。

五、创建与集成自定义技能

当内置技能无法满足特定业务场景时，你可以创建自定义技能，并将其无缝接入现有技能体系，调用体验与内置技能一致。

核心步骤包括：

1. 声明技能：在本地创建YAML定义文件（如 my-hr-skill.yaml），明确技能名称、输入输出格式等元数据。

2. 注册技能：通过CLI执行注册命令：qoder skill register --file=my-hr-skill.yaml。

3. 生效与验证：注册成功后，系统返回注册ID。该技能将立即生效，并出现在所有技能列表中。你可在IDE中直接搜索到。

4. 验证调用效果：使用自然语言指令测试。例如输入：“使用我新注册的面试排程技能，为下周三的三场技术面试生成时间安排。” 观察任务是否被正确路由与执行，即可确认集成成功。