关于 miniapp-official-scaffold-alignment
miniapp-official-scaffold-alignment 是一项技能，用于在修改实现前检查微信小程序仓库是否符合官方脚手架要求。它会指出有效、缺失或有风险的结构，并建议最小的下一步调整。
主要功能
- 01检查仓库根目录与小程序代码根目录
- 02核对 project.config.json 和 app.json
- 03验证页面与组件文件组
- 04检查 TypeScript 配置是否明确
- 05报告风险与后续脚手架步骤
适用场景
- 01修改页面前审查小程序仓库
- 02核对页面路径与 app.json
- 03检查自定义组件结构
- 04规划首个脚手架修正
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/miniapp-official-scaffold-alignment确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/example-prompts.mdofficial-scaffold-baseline.md详细介绍
小程序官方脚手架对齐
概述
当脚手架正确性成为阻塞因素时，使用此技能。在更改页面、组件或构建设置之前，验证仓库结构。
快速开始
- 阅读
references/official-scaffold-baseline.md。 - 确定仓库根目录和小程序代码根目录。
- 检查
project.config.json、app.json、页面路径、组件文件集和 TypeScript 假设。 - 报告哪些部分已经有效、哪些不完整或存在风险，以及最小的下一步脚手架决策。
核心规则
- 规范性声明仅使用微信官方文档。
- 优先选择与项目结构匹配的最小可运行脚手架。
- 区分仓库根目录和小程序代码根目录。
- 如果仓库使用 TypeScript 编写，请明确编译器插件路径。
- 页面和组件需要路径和名称匹配的四文件组。
- 写“尚未指定”，而不是编造缺失的规范细节。
审查清单
project.config.json是否指向预期的小程序代码根目录？app.json.pages是否与真实的页面文件夹匹配？- 每个页面是否都有匹配的逻辑、结构、样式和配置文件？
- 自定义组件是否声明了
component: true并具有匹配的文件集？ - TypeScript 支持是否明确而非隐含？
- 仓库布局是否为
docs/、后端代码或工具等同级文件夹留有空间？
输出格式
回答时，保持结果简短且面向行动：
- 官方有效的部分
- 缺失或存在风险的部分
- 推荐的脚手架决策
- 首先要做的编辑
资源
references/official-scaffold-baseline.md：官方规则摘要及实际影响references/example-prompts.md：可复用的触发示例和评估说明
评论
支持 Markdown