메뉴
在已有小程序项目中创建新的 AI Skill。当用户想在现有项目中添加自定义 AI 能力（而非安装现成的社区 Skill）时触发。完整流程：理解需求 → 设计接口 → 调用 wxa-skills-generate 生成代码 → wxa-skills-validate 校验通过。
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/TencentCloudBase/mp-skills --skill wxa-create-mp-skill명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SOC 직업 분류 기준
SKILL.md 표시 중
| name | wxa-create-mp-skill |
| description | 在已有小程序项目中创建新的 AI Skill。当用户想在现有项目中添加自定义 AI 能力（而非安装现成的社区 Skill）时触发。完整流程：理解需求 → 设计接口 → 调用 wxa-skills-generate 生成代码 → wxa-skills-validate 校验通过。 |
| metadata | {"author":"TencentCloudBase"} |
| compatibility | ["mp-skills CLI","Node.js 18+","微信开发者工具"] |
| version | 0.2.0 |
在已有小程序项目中创建新的 AI Skill。
wxa-create-ai-miniprogram）wxa-find-skills）skills/{skill-name}/ 完整分包 + app.json 注册skills/{skill}/apis/{name}.jsskills/{skill}/components/{name}/| 来源 | 用途 | 加载时机 |
|---|---|---|
npx mp-skills --help | 获取 <generate-dir> 和 <validate-dir> 路径 | Step 3 前 |
<generate-dir>/SKILL.md | wxa-skills-generate 的完整阶段式工作流 | Step 3 代码生成 |
<generate-dir>/references/CODE_TEMPLATES.md | mcp.json / index.js / 接口实现代码模板 | Step 2/3 编写时 |
<generate-dir>/references/ATOMIC_COMPONENT_DESIGN.md | 原子组件设计规范 | Step 3 组件生成 |
<generate-dir>/references/JSAPI_WHITELIST.md | wx API 白名单完整清单 | Step 3 代码生成时 |
<validate-dir>/SKILL.md | 校验规则和修复详细流程 | Step 4 校验 + Step 5 修复 |
<validate-dir>/references/VALIDATE_RULES.md | V001~V016 规则详情 | 校验报错需定位 id 时 |
<validate-dir>/references/CLI_AGENT_REFERENCE.md | execute/render 脚本用法 | Step 4 执行 |
<project>/SKILL-DEV-GUIDE.md | 项目开发规范和 WeCard 视觉基线 | Step 2 设计时 |
<mode-dev-dir>/SKILL.md | AI 开发模式开发规范（content 写法、description 模板、禁令集） | Step 2 设计时 |
<mode-dev-dir>/references/BEST_PRACTICES.md | content 文本写法、三段式 description 模板、常见禁令 | Step 2/3 编写 content/description 时 |
<generate-dir>、<validate-dir>和<mode-dev-dir>在 Step 3 中通过npx mp-skills --help获取。
| 条件 | 说明 |
|---|---|
必须是已有的 mp-skills 项目（存在 skills/ 目录） | 否则无法创建独立分包 |
项目已执行过 npx mp-skills setup | 确保云开发环境已就绪 |
| 不要覆盖已有的 Skill 目录 | 如已存在同名目录，提示用户换名 |
| 规则 | 说明 |
|---|---|
| 接口命名 camelCase | searchItems、placeOrder，不要用 search_items |
| 接口粒度适中 | 每个接口职责单一，一个 skill 建议 3-6 个接口 |
| description 含前置条件 | "调用前置条件：用户已进入下单页面" |
| description 含严禁场景 | "【严禁场景】不要用于修改已支付的订单" |
| mcp.json ≤ 24000 字符 | 去除 outputSchema 后的体积限制 |
components/{name}/index（相对路径，不带分包前缀）_meta.ui.componentPath| 阻断情况 | 处理方式 |
|---|---|
| 用户描述的功能在现有社区 Skill 中已存在 | 建议先搜索安装，不要重复创建 |
| 需求过于宏大（超过 6 个接口） | 拆分为多个独立的 Skill |
| wxa-skills-generate 无法处理 | 告知用户能力限制，提供替代方案 |
| 连续 3 轮校验仍未通过 | 标记为疑难问题，请求用户确认后继续 |
与用户对话明确功能需求。接口划分遵循以下原则：
searchItems、getDetail、placeOrder 各管各的输出接口清单，用户确认后再进入下一步。
在 skills/<skill-name>/ 下创建：
SKILL.md（业务路由说明，≤ 16KB）：
mcp.json（模型可调用能力声明，去除 outputSchema ≤ 24000 字符）：
{
"apis": [
{
"name": "searchItems",
"description": "搜索商品列表。\n调用前置条件：...\n【严禁场景】...",
"inputSchema": { "type": "object", "properties": {...}, "required": [...] },
"_meta": { "ui": { "componentPath": "components/item-list-card/index" } }
}
],
"components": [
{ "path": "components/item-list-card/index", "relatedPage": "/pages/index/index" }
]
}
产出后让用户确认设计。确认前不得进入下一步。
先获取官方技能路径并记录到变量：
npx mp-skills --help
输出底部会显示：
工具型 Skill 路径（供 AI 模型引用）:
wxa-skills-generate: /Users/xxx/.mp-skills/skills/wxa-skills-generate/SKILL.md
wxa-skills-validate: /Users/xxx/.mp-skills/skills/wxa-skills-validate/SKILL.md
记录两个路径（去掉末尾的 /SKILL.md）：
<generate-dir> = wxa-skills-generate 所在目录<validate-dir> = wxa-skills-validate 所在目录然后读取 <generate-dir>/SKILL.md，按它的阶段式工作流执行代码生成。
按它的指引走即可，不需要在这里重复每一步。
注意：wxa-skills-generate 会自动处理 wx API 白名单检查、原子组件约束、分包配置。不要绕过这些约束。
使用 Step 3 中记录的 <validate-dir> 路径。
4.1 静态校验
node <validate-dir>/scripts/validate.mjs <project-path>
通过条件：summary.errors === 0 且 summary.buildStatus === "pass"。
4.2 接口执行 + 组件渲染
静态校验通过后，对每个带 _meta.ui.componentPath 的接口：
# 执行原子接口
node <validate-dir>/scripts/execute.mjs \
--project <project-path> --name <api-name> --args '{}' \
--output ./cli-agent-run/execute-result.<name>.json
# 渲染组件
node <validate-dir>/scripts/render.mjs \
--project <project-path> \
--from-execute ./cli-agent-run/execute-result.<name>.json \
--output ./cli-agent-run/render-result.<name>.json
如果有校验失败，按 wxa-skills-validate/SKILL.md 的修复流程处理：
| 类型 | 特征 | 修复范围 |
|---|---|---|
| T1 命名拼写 | 字段大小写/拼写错 | 单文件单行直接改 |
| T2 Schema 不一致 | structuredContent 与 outputSchema 不匹配 | apis + mcp.json 对齐 |
| T3 组件绑定不一致 | WXML 与 setData 字段对不上 | components JS/WXML 对齐 |
| T4 组件取值路径错 | result.structuredContent.xxx 路径错 | 修组件 JS |
| T5 合规性违规 | 非白名单标签/CSS | 用白名单替代 |
| T6 注册缺失 | mcp.json 声明的 name 未 registerAPI | 补 index.js 注册 |
| T7/T8 链路/粒度 | storage key 或接口划分问题 | 跨文件调整 |
| T9 能力无法实现 | 所有候选都违反硬约束 | ⛔ 终止，告知用户 |
| T-build 编译失败 | stage=compile + FAIL | 先检查集成配置，再动源码 |
修复后重跑校验，直到全部通过。
确认 app.json 的 agent.skills[] 中已包含新 Skill。
提示用户运行 npx mp-skills setup 完成环境配置。
安装：npx skills add TencentCloudBase/mp-skills -s wxa-create-mp-skill