mp-skills CLI 工具

mp-skills 是用于管理小程序 AI 开发模式 SKILL 的命令行工具，支持搜索、安装、管理、创建和调试 SKILL。

安装

npm install -g mp-skills

或使用 npx 直接运行（无需安装）：

npx mp-skills [command]

命令参考

命令	描述
`find`	搜索远程可用的 Skill
`add`	从注册表或 GitHub 仓库安装 Skill
`list`	列出已安装和远程可用的 Skill
`remove`	移除已安装的 Skill
`update`	检查并更新已安装的 Skill
`create`	在项目中创建新的 Skill（支持模板和 AI 辅助模式）
`new`	创建新小程序项目骨架
`setup`	一站式环境搭建（云函数、数据库、服务检查）
`validate`	静态校验
`execute`	执行原子接口
`render`	渲染原子组件
`eval`	质量评估
`doctor`	健康检查（云函数联通性、数据库、服务配置）
`status`	查看云函数、数据库、服务的状态差异

`find` — 搜索 Skill

跨注册仓库搜索可用的业务 Skill，无需提前知道具体仓库：

# 列出所有远程可用 Skill
npx mp-skills find

# 按关键词搜索（中英文均可）
npx mp-skills find 咖啡
npx mp-skills find payment
npx mp-skills find 挂号

`add` — 安装 Skill

从注册表、GitHub 仓库或本地路径安装 Skill。需在小程序项目根目录执行。

# 从注册表（交互式选择）
npx mp-skills add awesome-miniprogram

# GitHub shorthand，安装指定 Skill
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills -s order-skill

# 安装全部
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills --all

# 从本地路径安装
npx mp-skills add ./my-local-skill

# 跳过确认
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills -s order-skill -y

参数： -s, --skill <name> 指定 Skill | --all 安装全部 | -y, --yes 跳过确认

安装后自动：

拷贝 Skill 到 miniprogram/skills/<name>/
更新 miniprogram/app.json 的 agent.skills + subPackages
更新 project.config.json 的 packOptions.include
写入 skills-lock.json 版本锁

`list` — 列出 Skill

# 列出已安装的
npx mp-skills list

# 列出远程可用的
npx mp-skills list --remote

# 同时列出已安装和远程
npx mp-skills list --all

参数： -r, --remote 远程列表 | --all 同时显示

`remove` — 移除 Skill

npx mp-skills remove order-skill
npx mp-skills remove --all      # 移除全部
npx mp-skills remove order-skill -y   # 跳过确认

参数： --all 移除全部 | -y, --yes 跳过确认

`update` — 更新 Skill

# 检查所有
npx mp-skills update

# 检查指定
npx mp-skills update order-skill payment-skill

`create` — 创建 Skill

在当前小程序项目中创建一个新的 Skill。支持模板模式和 AI 辅助模式。

模板模式：

npx mp-skills create weather-skill
npx mp-skills create weather-skill -p ./my-miniprogram  # 指定项目目录

AI 辅助模式（--mode agent）： 进入 AI 多轮会话，自动生成并校验代码：

# 描述业务场景，AI 自动生成
npx mp-skills create coffee-order --mode agent -s "咖啡点单、订单管理"

# 在已有 Skill 上迭代
npx mp-skills create my-skill --mode agent -q "createOrder 接口缺少 amount 字段"

# 不指定名称，AI 扫描项目后自决
npx mp-skills create --mode agent

参数： -p, --project <path> 项目目录 | --mode template|agent 运行模式 -s, --scenario <desc> [agent] 业务场景 | -q, --query <text> [agent] 迭代诉求 --provider <name>, -m, --model <name> [agent] LLM 配置 -e, --env <envId> [agent] 云开发环境 ID

`new` — 创建新项目

创建新小程序项目，含 AI Skill 支持的基础配置：

npx mp-skills new my-app
cd my-app
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills -s order-skill

`setup` — 环境搭建

一站式环境搭建：聚合云函数、创建数据库集合、检查服务配置：

# 完整流程
npx mp-skills setup

# 仅处理云函数
npx mp-skills setup --cloud-functions

# 仅处理数据库
npx mp-skills setup --database

# 预览模式
npx mp-skills setup --dry-run

# 指定云开发环境
npx mp-skills setup --env-id your-env-id

参数： -f, --cloud-functions 仅云函数 | -d, --database 仅数据库 -s, --services 仅服务检查 | --dry-run 预览 | --env-id <id> 环境 ID

`validate` — 静态校验

npx mp-skills validate
npx mp-skills validate ./path/to/project  # 指定项目

`execute` — 执行原子接口

npx mp-skills execute -n getDrinkList
npx mp-skills execute -n searchRestaurants -a '{"keyword":"川菜"}'
npx mp-skills execute -n getDrinkList -p ./path/to/project

参数： -n, --name <api-name> 接口名称（必填） | -a, --args <json> 参数 -p, --project <path> 项目路径

`render` — 渲染原子组件

npx mp-skills render -n restaurantList
npx mp-skills render -n restaurantList -p ./path/to/project

参数： -n, --name <api-name> 组件名称（必填） | -p, --project <path> 项目路径

`eval` — 质量评估

对已安装 Skill 的项目启动端到端质量评估：

# 生成 3 个测试用例执行评估
npx mp-skills eval -c 3

# AI 辅助评估
npx mp-skills eval --mode agent -c 3

# 只评估指定 Skill
npx mp-skills eval -s order-skill -c 3

# 无界面模式（适合 CI）
npx mp-skills eval --headless -c 3

参数： -c, --cases <n> 测试用例数 | -s, --skill <name> 指定 Skill -p, --project <path> 项目目录 | --headless 无界面模式 --provider <name>, -m, --model <name> LLM 配置

`doctor` — 健康检查

检测云函数联通性、数据库集合、服务配置：

npx mp-skills doctor
npx mp-skills doctor ./path/to/project  # 指定项目

`status` — 状态查看

查看云函数、数据库、服务的状态差异：

npx mp-skills status
npx mp-skills status ./path/to/project  # 指定项目

LLM 凭证配置

create --mode agent 与 eval 命令需配置 LLM 凭证（BYOK）：

export WXA_SKILL_EVAL_LLM_BASE_URL=<your-endpoint>
export WXA_SKILL_EVAL_LLM_API_KEY=<your-key>
export WXA_SKILL_EVAL_LLM_MODEL=<model-name>

内置预设提供方：

提供方	默认模型	Base URL
DeepSeek	`deepseek-v4-flash`	`https://api.deepseek.com/v1`
智谱 GLM	`glm-5.1`	`https://open.bigmodel.cn/api/paas/v4`
Kimi (Moonshot)	`kimi-k2.6`	`https://api.moonshot.cn/v1`
MiniMax	`minimax-m2.7`	`https://api.minimaxi.com/v1`

凭证会写入当前目录的 .env 文件。

工具 Skill

工具 Skill 与业务 Skill 不同，它们不安装到小程序中，而是供 AI coding 工具读取的引导文档。AI 工具读取 SKILL.md 后按步骤执行，帮你完成开发任务。

工具 Skill 使用 skills CLI 安装（与 mp-skills 是不同工具）：

# 安装工具 Skill（安装给 AI coding 工具使用）
npx skills add TencentCloudBase/mp-skills -s wxa-find-skills
npx skills add TencentCloudBase/mp-skills -s wxa-create-ai-miniprogram
npx skills add TencentCloudBase/mp-skills -s wxa-create-mp-skill

详细介绍请查看工具 Skill。

安装​

命令参考​

find — 搜索 Skill​

add — 安装 Skill​

list — 列出 Skill​

remove — 移除 Skill​

update — 更新 Skill​

create — 创建 Skill​

new — 创建新项目​

setup — 环境搭建​

validate — 静态校验​

execute — 执行原子接口​

render — 渲染原子组件​

eval — 质量评估​

doctor — 健康检查​

status — 状态查看​

LLM 凭证配置​

工具 Skill​

更多信息​

安装