{"id":50824123,"url":"https://github.com/tencentcloudbase/mp-skills","last_synced_at":"2026-06-16T20:00:59.324Z","repository":{"id":363767983,"uuid":"1264823567","full_name":"TencentCloudBase/mp-skills","owner":"TencentCloudBase","description":" Miniprogram skills tool - npx mp-skills  让小程序快速接入微信 AI 开发模式——通过安装现成的 Skill（咖啡点单、医院挂号、出行打车等），快速为用户提供 AI 驱动的对话式服务体验。支持快速创建新的 AI 小程序和 Skill，或将现有小程序改造为支持 AI 开发模式，并提供评测校验工具保障质量。","archived":false,"fork":false,"pushed_at":"2026-06-15T12:55:16.000Z","size":2759,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-15T19:33:12.781Z","etag":null,"topics":["agent-skills","ai-agent","cli","llm","typescript","wechat"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TencentCloudBase.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-10T08:01:07.000Z","updated_at":"2026-06-15T12:55:22.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/TencentCloudBase/mp-skills","commit_stats":null,"previous_names":["tencentcloudbase/mp-skills"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/TencentCloudBase/mp-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TencentCloudBase%2Fmp-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TencentCloudBase%2Fmp-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TencentCloudBase%2Fmp-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TencentCloudBase%2Fmp-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TencentCloudBase","download_url":"https://codeload.github.com/TencentCloudBase/mp-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TencentCloudBase%2Fmp-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34421326,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-16T02:00:06.860Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","ai-agent","cli","llm","typescript","wechat"],"created_at":"2026-06-13T17:00:22.387Z","updated_at":"2026-06-16T20:00:59.288Z","avatar_url":"https://github.com/TencentCloudBase.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mp-skills\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"media/logo.svg\" alt=\"mp-skills logo\" width=\"480\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.npmjs.com/package/mp-skills\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/mp-skills.svg?style=flat-square\" alt=\"npm version\"\u003e\u003c/a\u003e\u0026nbsp;\n  \u003ca href=\"https://www.npmjs.com/package/mp-skills\"\u003e\u003cimg src=\"https://img.shields.io/npm/dm/mp-skills.svg?style=flat-square\" alt=\"npm downloads\"\u003e\u003c/a\u003e\u0026nbsp;\n  \u003ca href=\"https://github.com/TencentCloudBase/mp-skills/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/npm/l/mp-skills.svg?style=flat-square\" alt=\"license\"\u003e\u003c/a\u003e\u0026nbsp;\n  \u003ca href=\"https://nodejs.org/\"\u003e\u003cimg src=\"https://img.shields.io/node/v/mp-skills?style=flat-square\" alt=\"node version\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"media/term-screenshot.svg\" alt=\"mp-skills terminal screenshot\" width=\"600\"\u003e\n\u003c/p\u003e\n\n让小程序快速接入微信 AI 开发模式——通过安装现成的业务 Skill（咖啡点单、医院挂号、出行打车等），快速为用户提供 AI 驱动的对话式服务体验。支持快速创建新的 AI 小程序和 Skill，或将现有小程序改造为支持 AI 开发模式，并提供评测校验工具保障质量。\n\n\u003e [微信 AI 开发模式官方文档](https://developers.weixin.qq.com/miniprogram/dev/ai/guide.html)\n\n---\n\n\n## 快速开始\n### 发现并安装 Skill\n\n```bash\n# 1️⃣ 先搜索看看有哪些可用 Skill\nnpx mp-skills find\n\n# 2️⃣ 交互式选择并安装 Skill\nnpx mp-skills add TencentCloudBase/awesome-miniprogram-skills\n\n# 3️⃣ 或直接安装指定 Skill\nnpx mp-skills add TencentCloudBase/awesome-miniprogram-skills -s \u003cname\u003e\n\n# 4️⃣ 一键安装所有\nnpx mp-skills add TencentCloudBase/awesome-miniprogram-skills --all\n```\n\n命令需要在**小程序项目根目录**下执行（含 `project.config.json`）。安装后自动：\n\n- 拷贝 Skill 到 `miniprogram/skills/\u003cname\u003e/`\n- 更新 `miniprogram/app.json` 的 `agent.skills` + `subPackages`\n- 更新 `project.config.json` 的 `packOptions.include`\n- 写入 `skills-lock.json` 版本锁\n\n### 环境搭建\n\n安装 Skill 后，若有云开发依赖，运行一站式环境搭建：\n\n```bash\nnpx mp-skills setup\n```\n\n`setup` 会聚合云函数、创建数据库集合、检查所需服务，让项目快速就绪。\n\n---\n\n\n\n\n\n\n## 命令\n\n| 命令         | 描述                                                       | 层级 |\n| ------------ | ---------------------------------------------------------- | ---- |\n| `add`        | 从注册表/GitHub/URL/本地路径安装 Skill                     | ③ |\n| `find`       | 搜索远程仓库中的可用 Skill                                 | ③ |\n| `list`       | 列出已安装的 Skill                                         | ③ |\n| `remove`     | 移除已安装的 Skill                                         | ③ |\n| `update`     | 检查并更新已安装的 Skill                                   | ③ |\n| `create`     | 在已有项目中创建新的 Skill 骨架                            | ② |\n| `new`        | 创建新的小程序项目骨架                                     | ② |\n| `validate`   | 对项目中 Skills 进行静态校验                               | ② |\n| `execute`    | 执行 Skill 的原子接口                                     | ② |\n| `render`     | 渲染 Skill 的原子组件                                     | ② |\n| `setup`      | 一站式环境搭建：聚合云函数、创建集合、检查服务             | ② |\n| `eval`       | 对已有 Skills 项目启动端到端质量评估（需 wxa-skills-eval） | ② |\n\n---\n\n### add\n\n从注册表、GitHub 仓库、URL 或本地路径安装 Skill 到当前项目。\n\n```bash\n# 从注册表（交互式选择 Skill）\nnpx mp-skills add awesome-miniprogram\n\n# GitHub shorthand（指定单个 Skill）\nnpx mp-skills add TencentCloudBase/awesome-miniprogram-skills -s \u003cname\u003e\n\n# 安装全部\nnpx mp-skills add TencentCloudBase/awesome-miniprogram-skills --all\n\n# 本地路径\nnpx mp-skills add ./my-local-skill\n\n# 跳过确认\nnpx mp-skills add TencentCloudBase/awesome-miniprogram-skills -s \u003cname\u003e -y\n```\n\n| 选项                   | 说明                                                       |\n| ---------------------- | ---------------------------------------------------------- |\n| `-s, --skill \u003cname\u003e`   | 安装指定的 Skill                                           |\n| `--all`                | 安装仓库中所有 Skill                                       |\n| `-y, --yes`            | 跳过确认提示                                               |\n\n---\n\n### find\n\n跨注册仓库搜索可用的 Skill。不需要提前知道 Skill 来自哪个仓库，`find` 会自动查询所有注册源。\n\n```bash\n# 列出所有远程可用 Skill\nnpx mp-skills find\n\n# 按关键词搜索（中英文均可）\nnpx mp-skills find 咖啡\nnpx mp-skills find payment\nnpx mp-skills find 挂号\n\n# 搜索到后可以直接用 add 安装\nnpx mp-skills add TencentCloudBase/awesome-miniprogram-skills -s \u003cname\u003e\n```\n\n发现 Skill → 安装 Skill → 环境搭建，三步搞定。\n\n---\n\n### list\n\n列出当前项目已安装的 Skill。\n\n```bash\n# 列出已安装\nnpx mp-skills list\n\n# 列出远程可用的\nnpx mp-skills list --remote\n\n# 同时列出已安装和远程\nnpx mp-skills list --all\n```\n\n| 选项            | 说明                         |\n| --------------- | ---------------------------- |\n| `-r, --remote`  | 列出远程可用的 Skill         |\n| `--all`         | 同时列出已安装和远程         |\n\n---\n\n### remove\n\n移除已安装的 Skill。\n\n```bash\nnpx mp-skills remove \u003cname\u003e\nnpx mp-skills remove --all\nnpx mp-skills remove \u003cname\u003e -y\n```\n\n| 选项        | 说明               |\n| ----------- | ------------------ |\n| `--all`     | 移除全部 Skill     |\n| `-y, --yes` | 跳过确认           |\n\n---\n\n### update\n\n检查已安装 Skill 是否有更新。\n\n```bash\n# 检查所有\nnpx mp-skills update\n\n# 检查指定\nnpx mp-skills update \u003cname1\u003e \u003cname2\u003e\n```\n\n---\n\n### new\n\n创建一个新的小程序项目，含 AI Skill 支持的基础配置。\n\n```bash\nnpx mp-skills new my-app\ncd my-app\nnpx mp-skills add TencentCloudBase/awesome-miniprogram-skills -s \u003cname\u003e\n```\n\n---\n\n### create\n\n在当前小程序项目中创建一个新的 Skill。**默认走本地模板复制**；`--mode agent` 时调用 [opencode](https://github.com/sst/opencode) 让大模型分析项目并生成符合规范的 Skill 分包。\n\n```bash\n# 模板模式：拷贝模板到 \u003cminiprogramRoot\u003e/skills/\u003cname\u003e/\ncd ./my-miniprogram\nnpx mp-skills create my-skill\n\n# 指定项目目录\nnpx mp-skills create my-skill -p ./my-miniprogram\n\n# agent 模式：进入 opencode 多轮会话，生成并自校验\nnpx mp-skills create my-skill --mode agent \\\n  -s \"咖啡点单、订单管理\"\n\n# agent 模式 + 在已有 Skill 上迭代（同名再跑一次即可，agent 会做增量修改）\nnpx mp-skills create my-skill --mode agent \\\n  -q \"createOrder 接口缺少 amount 字段\"\n\n# agent 模式 + 不指定 name：扫描整个项目，agent 自决要生成哪些 Skill\nnpx mp-skills create --mode agent\n```\n\n| 选项                    | 说明                                                                 |\n| ----------------------- | -------------------------------------------------------------------- |\n| `-p, --project \u003cpath\u003e`  | 项目目录（默认当前目录）                                             |\n| `--mode \u003cmode\u003e`         | 运行模式：`template`（默认，走模板）\\| `agent`（大模型辅助生成）     |\n| `-s, --scenario \u003cdesc\u003e` | [agent] 业务场景描述，帮助模型聚焦（如：商品检索、订单管理）         |\n| `-q, --query \u003ctext\u003e`    | [agent] 本轮诉求；在已有产物上迭代时尤其有用                         |\n| `--provider \u003cname\u003e`     | [agent] LLM 提供方预设（deepseek / glm / kimi / minimax）            |\n| `-m, --model \u003cname\u003e`    | [agent] 模型名，覆盖 `--provider` 预设                               |\n| `-e, --env \u003cenvId\u003e`     | [agent] CloudBase 环境 ID（可选）                                    |\n| `--non-interactive`     | [agent] 非交互模式：一次性跑完，适合脚本 / CI                        |\n\n\u003e agent 模式需要 `opencode-ai` + 一组 OpenAI 兼容凭据。详见下方「LLM 凭证」。\n\n---\n\n### setup\n\n一站式环境搭建：聚合云函数、创建数据库集合、检查服务配置。\n\n```bash\n# 完整流程（云函数 + 数据库 + 服务检查）\nnpx mp-skills setup\n\n# 仅处理云函数\nnpx mp-skills setup --cloud-functions\n\n# 仅处理数据库\nnpx mp-skills setup --database\n\n# 仅检查服务\nnpx mp-skills setup --services\n\n# 预览模式，不实际执行\nnpx mp-skills setup --dry-run\n\n# 指定云开发环境\nnpx mp-skills setup --env-id your-env-id\n```\n\n| 选项                       | 说明                                                   |\n| -------------------------- | ------------------------------------------------------ |\n| `-f, --cloud-functions`    | 仅处理云函数                                           |\n| `-d, --database`           | 仅处理数据库                                           |\n| `-s, --services`           | 仅检查服务                                             |\n| `--dry-run`                | 预览模式，不实际执行                                   |\n| `--env-id \u003cid\u003e`            | 云开发环境 ID（未指定则从项目配置读取）                 |\n\n安装 Skill 后运行 `setup` 可自动完成所有云开发基础设施的部署。\n\n---\n\n### validate\n\n对项目中 Skills 进行静态校验。\n\n```bash\n# 校验当前项目\nnpx mp-skills validate\n\n# 校验指定项目\nnpx mp-skills validate ./path/to/project\n```\n\n---\n\n### execute\n\n执行 Skill 的原子接口。\n\n```bash\nnpx mp-skills execute --name getDrinkList\nnpx mp-skills execute --name createOrder --args '{\"drinkId\":\"123\"}'\nnpx mp-skills execute --name getDrinkList --project ./path/to/project\n```\n\n| 选项                      | 说明                     |\n| ------------------------- | ------------------------ |\n| `-n, --name \u003capi-name\u003e`   | 接口名称（必填）         |\n| `-a, --args \u003cjson\u003e`       | JSON 格式参数            |\n| `-p, --project \u003cpath\u003e`    | 项目路径，默认当前目录   |\n\n---\n\n### render\n\n渲染 Skill 的原子组件。\n\n```bash\nnpx mp-skills render --name drinkList\nnpx mp-skills render --name drinkList --project ./path/to/project\n```\n\n| 选项                      | 说明                     |\n| ------------------------- | ------------------------ |\n| `-n, --name \u003capi-name\u003e`   | 接口名称（必填）         |\n| `-p, --project \u003cpath\u003e`    | 项目路径，默认当前目录   |\n\n---\n\n### eval\n\n对**已安装 Skill 的**小程序项目启动端到端质量评估。需先安装 [wxa-skills-eval](https://github.com/wechat-miniprogram/ai-mode-skills)，并依赖微信开发者工具。\n\n```bash\n# 设置凭据\nexport WXA_SKILL_EVAL_LLM_BASE_URL=https://api.deepseek.com/v1\nexport WXA_SKILL_EVAL_LLM_API_KEY=sk-xxxx\nexport WXA_SKILL_EVAL_LLM_MODEL=deepseek-chat\n\n# 默认 official 模式\nnpx mp-skills eval -c 3\n\n# 使用 provider 预设\nnpx mp-skills eval --provider deepseek -m deepseek-v4-flash -c 3\n\n# 指定项目目录\nnpx mp-skills eval -p ./my-miniprogram -c 3\n```\n\n| 选项                         | 说明                                                                                 |\n| ---------------------------- | ------------------------------------------------------------------------------------ |\n| `-p, --project \u003cpath\u003e`       | 项目目录（默认当前目录）                                                             |\n| `-e, --env \u003cenvId\u003e`          | CloudBase 环境 ID。**BYOK 模式下可省略**——仅在需要透传给下游时填写                    |\n| `-c, --cases \u003cn\u003e`            | 生成的测试用例数（默认 1）                                                           |\n| `-s, --skill \u003cname\u003e`         | 只评估指定 Skill（默认评估全部）                                                     |\n| `--headless`                 | 无界面模式，适合 CI 环境                                                             |\n| `--mode \u003cmode\u003e`              | 评估模式，`official`（默认）或 `agent`                                               |\n| `--provider \u003cname\u003e`          | LLM 提供方预设（deepseek / glm / kimi / minimax），预填 baseUrl 与默认 model         |\n| `-m, --model \u003cname\u003e`         | 模型名，覆盖 `--provider` 预设与 `WXA_SKILL_EVAL_LLM_MODEL` 环境变量                 |\n| `--openai-api-key \u003ckey\u003e`     | OpenAI 兼容 API Key，覆盖对应环境变量                                                |\n| `--openai-base-url \u003curl\u003e`    | OpenAI 兼容 Base URL，覆盖 `--provider` 预设与对应环境变量                           |\n\n**两种评估模式**（实际评测都由官方 `wxa-skills-eval` CLI 执行）：\n\n- `official`（默认）：mp-skills 直接拼好命令行调用官方 CLI，参数固定、可预期，适合 CI。\n- `agent`：启动内置 coding agent（用 BYOK 凭证），让它读取 `wxa-skills-eval/SKILL.md` 后**自主调用官方 CLI** 发起评测，并按 SKILL.md 的续跑/排错指引自动重试。相比手敲命令更省心。\n\n```bash\n# agent 模式\nnpx mp-skills eval --mode agent -c 3\n```\n\n\u003e 两种模式都依赖微信开发者工具（官方 CLI 的硬性要求）。\n\n---\n\n## LLM 凭证（BYOK）\n\n`create --mode agent` 与 `eval` 共用**同一套** OpenAI 兼容凭证，通过环境变量配置：\n\n```bash\nexport WXA_SKILL_EVAL_LLM_BASE_URL=\u003cyour-endpoint\u003e\nexport WXA_SKILL_EVAL_LLM_API_KEY=\u003cyour-key\u003e\nexport WXA_SKILL_EVAL_LLM_MODEL=\u003cmodel-name\u003e\n```\n\n运行前还会自动加载当前目录的 `.env`（不覆盖已显式 `export` 的变量）。\n\n### 交互式向导\n\n若运行 `create --mode agent` / `eval` 时**未配置任何凭证**且处于交互式终端（TTY），会弹出交互式向导让你选择提供方：\n\n```\n? 请选择 LLM 提供方：\n  ❯ CloudBase（云开发 AI 网关，自动获取密钥）\n    DeepSeek\n    智谱 GLM\n    Kimi（Moonshot）\n    MiniMax\n    自定义（手填 endpoint / key / model）\n```\n\n#### 提供方详解\n\n**1. CloudBase（云开发 AI 网关）**\n\n自动完成整套凭证配置，无需手动管理密钥：\n\n1. **登录验证**：自动检测 CloudBase CLI 登录状态，未登录会提示先登录\n2. **选择环境**：列出你的所有 CloudBase 环境，选择其中一个\n3. **选择模型**：以表格形式展示可用模型（模型名、提供商、状态），已开启的排在前面的，未开启的会提示去控制台开通\n4. **API Key 管理**：选择已有 API Key（自动获取明文）或新建一个\n\n```\n┌─────────────────────┬────────────┬──────────┐\n│ 模型                │ 提供商     │ 状态     │\n├─────────────────────┼────────────┼──────────┤\n│ deepseek-v3         │ deepseek   │ 已开启   │\n│ glm-4               │ zhipu      │ 已开启   │\n│ moonshot-v1         │ moonshot   │ 未开启   │\n└─────────────────────┴────────────┴──────────┘\n```\n\n完成后自动拼接出 CloudBase AI 网关的 OpenAI 兼容凭证（Base URL 含环境 ID 和模型路径）。\n\n**2. 预设提供方**\n\n内置了常用 LLM 提供方的端点和默认模型，只需填写 API Key 即可：\n\n| 提供方          | 默认模型           | Base URL                              |\n| --------------- | ------------------ | ------------------------------------- |\n| DeepSeek        | `deepseek-v4-flash`| `https://api.deepseek.com/v1`         |\n| 智谱 GLM        | `glm-5.1`         | `https://open.bigmodel.cn/api/paas/v4`|\n| Kimi (Moonshot) | `kimi-k2.6`       | `https://api.moonshot.cn/v1`          |\n| MiniMax         | `minimax-m2.7`    | `https://api.minimaxi.com/v1`         |\n\n选择预设提供方后，只需输入：\n- **API Key**（必填）\n- **模型名**（可选，默认使用上表中的默认模型）\n\n**3. 自定义**\n\n完全手动填写 OpenAI 兼容接口的凭证：\n\n- **Base URL**：如 `https://api.openai.com/v1`\n- **API Key**（必填）\n- **模型名**（必填）\n\n### 凭证持久化\n\n选完的凭证会写入当前目录的 `.env` 文件，下次运行时自动加载，不再弹出向导。\n\n```bash\n# 写入的 .env 示例\nWXA_SKILL_EVAL_LLM_BASE_URL=https://api.deepseek.com/v1\nWXA_SKILL_EVAL_LLM_API_KEY=sk-xxxx\nWXA_SKILL_EVAL_LLM_MODEL=deepseek-v4-flash\n```\n\n\u003e ⚠️ **安全提示**：`.env` 含明文密钥，请注意保管，建议加入 `.gitignore`：\n\u003e ```\n\u003e echo \".env\" \u003e\u003e .gitignore\n\u003e ```\n\n### 非交互式环境（CI）\n\n在非交互式环境（如 CI/CD）下不会弹出向导，缺凭证时会打印所需环境变量并退出。需在运行前通过环境变量或 `.env` 文件配置好凭证。\n\n### URL 规范化\n\n`WXA_SKILL_EVAL_LLM_BASE_URL` 会自动规范化处理：\n\n- 去掉末尾的 `/`\n- 剥离 `/anthropic` 或 `/messages` 后缀\n- 补上 `/v1` 路径\n\n例如：\n- `https://api.deepseek.com` → `https://api.deepseek.com/v1`\n- `https://api.deepseek.com/anthropic` → `https://api.deepseek.com/v1`\n\n只需配置一组凭证即可同时驱动 `create --mode agent`（opencode）和 `eval`（wxa-skills-eval）。\n\n---\n\n## add 做了什么\n\n```\n项目目录/\n├── miniprogram/app.json      ← 自动注入 agent.skills + subPackages + lazyCodeLoading\n├── project.config.json       ← 自动注入 packOptions.include\n├── skills/\u003cname\u003e/            ← 拷贝 Skill 全套文件\n│   ├── mcp.json              ← API Schema\n│   ├── SKILL.md              ← 业务流程\n│   ├── index.js              ← 注册入口\n│   ├── apis/                 ← 原子接口\n│   └── components/           ← 原子组件\n├── skills-lock.json          ← 版本追踪\n└── .deployed.json            ← 部署状态（云函数/数据库/服务跟踪）\n```\n\n---\n\n## 安装\n\n```bash\nnpm install -g mp-skills\n# 或直接用 npx\nnpx mp-skills --help\n```\n\n---\n\n## 从源码使用\n\n```bash\ngit clone https://github.com/TencentCloudBase/mp-skills.git\ncd mp-skills\nnpm install\nnpm run build\nnpm link\nmp-skills --help\n```\n\n---\n\n## 技术栈\n\n- TypeScript + ESM\n- [commander.js](https://github.com/tj/commander.js) — CLI 框架\n- [opencode-ai](https://github.com/sst/opencode) — AI 模式 Skill 生成\n- GitHub Trees API — 远程 Skill 发现（无需 git clone）\n- `skills-lock.json` — 版本追踪 + 增量更新\n- `@cloudbase/cli` — 云开发环境管理\n\n---\n\n## 相关链接\n\n- [awesome-miniprogram-skills](https://github.com/TencentCloudBase/awesome-miniprogram-skills) — 完整 Skill 仓库\n- [wechat-miniprogram/ai-mode-skills](https://github.com/wechat-miniprogram/ai-mode-skills) — 微信官方 Skill 示例\n- [微信小程序 AI 开发模式文档](https://developers.weixin.qq.com/miniprogram/dev/ai/guide.html)\n\n---\n\n## 理解 mp-skills 的三层结构\n\n这个仓库包含**三种不同类型**的东西，容易混淆，先理清楚：\n\n### ③ 业务 Skill — 小程序里的 AI 能力\n\n安装到小程序项目中，为用户提供具体的 AI 功能。\n\n\u003e 例子：queue-skill（排队取号）、order-skill（点餐）、payment-skill（支付）\n\u003e\n\u003e 安装方式：`npx mp-skills add TencentCloudBase/awesome-miniprogram-skills --skill queue-skill`\n\n业务 Skill 存放在单独的 [awesome-miniprogram-skills](https://github.com/TencentCloudBase/awesome-miniprogram-skills) 仓库，本仓库不包含。\n\n### ② CLI 工具 — 你直接用的命令行\n\n管理业务 Skill 的安装、校验、评测和环境搭建。\n\n\u003e 例子：\n\u003e ```\n\u003e npx mp-skills find            # 搜索业务 Skill\n\u003e npx mp-skills add ...         # 安装\n\u003e npx mp-skills setup           # 初始化云开发环境\n\u003e npx mp-skills validate        # 校验业务 Skill 质量\n\u003e ```\n\n### ① 工具 Skill — 给 AI 读的引导文档\n\n本仓库 `skills/` 下的三个 SKILL.md 文件，**不安装到小程序中**。AI coding 工具读取后按步骤执行，帮你完成开发任务。\n\n\u003e 例子：\n\u003e - `wxa-find-skills` → AI 读完后知道怎么搜索安装业务 Skill\n\u003e - `wxa-create-ai-miniprogram` → AI 读完后知道怎么从零创建项目\n\u003e - `wxa-create-mp-skill` → AI 读完后知道怎么生成自定义 Skill 代码\n\n安装方式（和安装业务 Skill 一样）：\n\n```bash\nnpx mp-skills add TencentCloudBase/mp-skills --skill wxa-find-skills\nnpx mp-skills add TencentCloudBase/mp-skills --skill wxa-create-ai-miniprogram\nnpx mp-skills add TencentCloudBase/mp-skills --skill wxa-create-mp-skill\n```\n\n运行 `npx mp-skills --help` 底部也会显示这三个工具 Skill 的本地路径。\n\n也可通过 ClawHub 社区查看：\n\n- https://clawhub.ai/binggg/wxa-find-skills\n- https://clawhub.ai/binggg/wxa-create-ai-miniprogram\n- https://clawhub.ai/binggg/wxa-create-mp-skill\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftencentcloudbase%2Fmp-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftencentcloudbase%2Fmp-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftencentcloudbase%2Fmp-skills/lists"}