菜单
LuatOS产品知识查询路由：回答合宙产品问题或LuatOS开发问题时调用。触发条件：用户咨询合宙模组/开发板使用、API用法、代码报错、文档查询、问题调试等。先校验产品型号，再路由到code/docs MCP查询。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | luatos-query-route-skill |
| description | LuatOS产品知识查询路由：回答合宙产品问题或LuatOS开发问题时调用。触发条件：用户咨询合宙模组/开发板使用、API用法、代码报错、文档查询、问题调试等。先校验产品型号，再路由到code/docs MCP查询。 |
本技能用于处理用户关于合宙产品和LuatOS开发的所有咨询问题，包括但不限于：
必须调用本技能的场景：
// 场景A：上位机工具/前后端平台/产品选型推荐/api查询 → 跳过步骤1，继续步骤2
IF 用户咨询的内容是上位机工具 OR 用户咨询的内容是前后端平台问题 OR 用户咨询的内容是产品选型推荐 THEN
GOTO 步骤2：问题分类判断 // 跳过产品型号校验，继续执行步骤2
END
// 场景B：其他情况 → 必须校验产品型号
IF 未指定具体产品型号 THEN
使用 AskUserQuestion 工具弹出选择窗口，提供常见产品型号选项供用户选择
RETURN // 终止执行，等待用户选择后继续
END
有效产品型号示例： Air780EPM/EHM、Air8000系列、Air8101系列、Air1601/1602、Air780EHV、Air780EGP/EGG/EGH、Air780EHN/EHU、Air700ECH/ECP、Air780EPT/EHT/EG2/EGT/EVT、Air700ECT、Air6205、Air5101S、Air510W/530W等
AskUserQuestion调用格式：
AskUserQuestion 调用示例：
- question: "请选择产品型号"
- header: "产品型号"
- options:
- label: "Air780EPM/EHM"
- label: "Air8000"
- label: "Air8101"
- label: "Air1601/1602"
- label: "Air780EHV"
- label: "Air780EGP/EGG/EGH"
- label: "Air780EHN/EHU"
- label: "Air700ECH/ECP"
- label: "Air6205"
- label: "Air5101S"
- label: "Air510W/530W"
- multiSelect: false
流程图：
用户咨询
│
├── 上位机工具 ──────────────────┐
│ │
├── 前后端平台问题 ───────────────┼──→ 步骤2：问题分类判断
│ │
└── 产品选型推荐 ────────────────┘
│
▼ (若未指定产品型号)
终止执行
| 分类 | 判定条件（满足任一即属于该分类） |
|---|---|
| 代码相关 | 关键字：语法错误、编译失败、运行时异常、调试、代码优化、内存问题、硬件接口编程、脚本逻辑 指标词：报错、错误、编译、运行、调试、代码、语法、crash、bug |
| 文档相关 | 关键字：API函数描述、库/模块文档、硬件规格、协议详情、设置指南、最佳实践、配置选项、硬件设计 指标词：函数、API、文档、说明、参数、用法、手册 |
| 选型推荐 | 关键字：方案选型、产品选型、选型推荐、选哪个、哪个好、推荐什么 指标词：选型、推荐、选择、对比 |
| 不确定 | 无法判断 → 默认走文档路径 |
警告：以下行为均为严重违规，一旦发生必须立即终止并报告错误
禁止的降级行为：
MCP失败时的正确处理：
IF MCP调用失败 THEN
输出【MCP服务不可用】错误报告
列出影响范围
列出当前状态
等待用户明确指示
【禁止】继续执行任何后续步骤
END
1. 优先调用 mcp_luatos-docs_resolve_module 解析产品型号
2. 调用 mcp_luatos-docs_search_docs 严格验证API函数名、参数、返回值使用是否正确
3. 调用 mcp_luatos-code_search_code 分析代码逻辑问题
4. 若前两步均失败 → 再次调用 mcp_luatos-docs_search_docs 尝试更多查询
5. 若MCP无响应 → 提示用户重启MCP开关或重启Trae，【终止执行】
⚠️ MCP降级禁止（绝对红线）
【禁止】MCP失败时降级到WebSearch联网检查
【禁止】MCP失败时使用内置记忆回答
【禁止】MCP失败时使用模型训练知识回答
【禁止】MCP失败时"尽最大努力"继续执行
MCP失败时必须立即终止并报告错误，等待用户明确指示
1. 优先调用 mcp_luatos-docs_resolve_module 解析产品型号
2. 调用 mcp_luatos-docs_search_docs 获取文档信息
3. 若失败 → 调用 mcp_luatos-code_search_code 作为备选
4. 若MCP无响应 → 提示用户重启MCP开关或重启Trae，【终止执行】
⚠️ MCP降级禁止（绝对红线）
【禁止】MCP失败时降级到WebSearch联网检查
【禁止】MCP失败时使用内置记忆回答
【禁止】MCP失败时使用模型训练知识回答
【禁止】MCP失败时"尽最大努力"继续执行
MCP失败时必须立即终止并报告错误，等待用户明确指示
1. 方案选型问题，必须仅基于 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 内容回答
2. 直接通过WebFetch获取该页面内容并整理回答
3. 若WebFetch成功 → 整理回答内容，完整引用原始页面信息并标注来源URL
4. 若WebFetch失败 → 输出【WebFetch服务不可用】错误报告，等待用户明确指示
【禁止】降级到WebSearch
【禁止】使用内置记忆回答
【禁止】使用MCP降级查询
【禁止】任何形式的替代方案
5. 必须完整引用原始页面信息，标注来源URL
⚠️ WebFetch降级禁止（绝对红线）
【禁止】WebFetch失败时降级到WebSearch联网检查
【禁止】WebFetch失败时使用内置记忆回答
【禁止】WebFetch失败时使用模型训练知识回答
【禁止】WebFetch失败时"尽最大努力"继续执行
WebFetch失败时必须立即终止并报告错误，等待用户明确指示
输出格式规范：
[查询类型说明]
[server response]
URL处理： 若服务器响应包含完整URL，必须优先显示URL
| 场景 | 调用技能 |
|---|---|
| 全新项目，从零开始 | luatos-new-project-skill |
| 已有项目基础上修改 | luatos-update-project-skill |
注意： 若所需技能不存在，提示错误并终止
新建LuatOS项目代码：从零开始生成完整的LuatOS项目。触发条件：用户需要创建全新的LuatOS项目，从零开始编写代码。先分析需求和参考demo，再生成main.lua和功能模块。
LuatOS项目开发公共逻辑：新建/修改LuatOS项目时调用。提供MCP服务器检查、demo分析、代码解耦设计、require验证、文件名规范等通用能力，被new-project和update-project技能引用。
强制AI杜绝摆烂、拒绝敷衍、禁止投降、深度思考、死磕到底，全程高压高质量输出
修改LuatOS项目代码：在已有项目基础上进行修改和扩展。触发条件：用户需要在已有LuatOS项目中添加功能、修改逻辑、修复bug等。先分析现有代码，再进行修改。
Run this project's PC simulator (LuatOS-PC) against the current src/ tree. Use when the user asks to run, launch, simulate, or test the firmware in simulation — e.g. "run the sim", "simulate", "try it in sim", "test src/ in the simulator". Also invoked by the built-in /run skill since the device firmware is not directly runnable.