uni-app skills

这个仓库用于存放多个可复用的 uni-app skill。

仓库结构

.
├── README.md
├── skills.json
└── skills/
    └── <skill-name>/
        ├── SKILL.md
        ├── agents/
        └── references/

约定：

• 所有实际 skill 都放在 skills/ 下
• 每个 skill 使用自己的目录名作为稳定标识
• 仓库根目录的 skills.json 维护可被人或脚本读取的技能索引

当前包含：

Skill	路径
uniapp-subpackage-uni-modules	skills/uniapp-subpackage-uni-modules
uniapp-subpackage-node-modules	skills/uniapp-subpackage-node-modules

推荐使用方式

不建议把这些 skill 当成“只属于个人机器”的全局配置。

更推荐开发者按项目自行管理：把需要的 skill 目录直接放进自己的项目仓库，或以 git submodule / git subtree / vendor 目录的方式引入，这样更适合团队协作、版本锁定和代码评审。

推荐目录示例：

your-project/
└── ai/
    └── skills/
        └── uniapp-subpackage-uni-modules/
            ├── SKILL.md
            ├── agents/
            └── references/

如果你的团队已经有自己的 AI 工具目录规范，也可以放在项目内其他位置。重点不是目录名，而是让 skill 跟随项目一起版本化管理。

这些 skill 可以被不同的 AI 工具或模型消费。只要你的工作流支持读取目录化的 skill / prompt / reference 资源，就可以按自己的方式接入。Codex 只是其中一种使用方式，不是前提。

如果你只想引入单个 skill，直接复制对应目录即可，例如：

skills/uniapp-subpackage-uni-modules/

如果你想把整个仓库作为团队公共 skill 源使用，就按 skills.json 读取和分发需要的目录。

当前 Skill

uniapp-subpackage-uni-modules

用于诊断 uni-app 小程序分包场景下，分包使用的 uni_modules 为什么被错误打入主包。

适用范围：

• 只适用于 uni-app 已支持的小程序平台
• 重点检查 manifest.json、pages.json、uni_modules 目录布局、easycom 指向和 unpackage 编译产物
• 不用于泛化分析所有分包组件问题

如果你的 AI 工具支持按名称显式调用 skill，可参考下面的写法：

使用 $uniapp-subpackage-uni-modules 检查这个 uni-app 项目里，分包使用的 uni_modules 为什么被打进主包。

如果你的工具不支持 $skill-name 这种触发形式，也可以直接把 SKILL.md 作为项目内规则文档提供给模型读取。

uniapp-subpackage-node-modules

用于诊断 uni-app 小程序分包场景下，分包引用的 node_modules 依赖为什么仍被打进主包 common/vendor.js，而没有进入分包自己的 vendor.js。

适用范围：

• 只适用于 uni-app 已支持分包优化的小程序平台
• 重点检查 uni-app / HBuilderX 版本、manifest.json、pages.json、分包根目录 package.json 和依赖引用规划
• 只分析 uni-app 内置的分包依赖能力，不引导外部构建后脚本方案
• 不用于分析源码层 uni_modules 归属问题

如果你的 AI 工具支持按名称显式调用 skill，可参考下面的写法：

使用 $uniapp-subpackage-node-modules 检查这个 uni-app 项目在小程序分包场景下，为什么分包引用的 node_modules 依赖仍然被打进主包 common/vendor.js，而没有进入分包 vendor.js。

如果你的工具不支持 $skill-name 这种触发形式，也可以直接把 SKILL.md 作为项目内规则文档提供给模型读取。

License

本仓库使用 MIT License。

完整许可证内容见 LICENSE。