AI 协作指南
Skills
Skills 负责给 AI 注入稳定的工程流程，减少“回答看起来对、执行却跑偏”的情况。
这里分两层理解：
skills/*：公开分发给用户的通用技能，适合安装到自己的 Codex / Claude 环境。.claude/skills/*：这个项目仓库内附带的本地附加技能，通常跟本仓库工作流或本地工具链强绑定。
如果你是直接使用公开技能仓库，先安装：
bash
npx skills add sonofmagic/skills如果你正在这个 monorepo 里开发，优先把仓库自带技能链接到本地环境：
bash
pnpm skills:link只想预览链接结果而不改本地环境时：
bash
pnpm skills:link:dry公开 skills（skills/*）里当前常用的有：
text
$weapp-vite-best-practices
$docs-and-website-sync
$github-issue-fix-workflow
$release-and-changeset-best-practices
$weapp-devtools-e2e-best-practices
$weapp-vite-wevu-performance-best-practices
$weapp-vite-vue-sfc-best-practices
$wevu-best-practices
$native-to-weapp-vite-wevu-migration
$weapp-ide-cli-best-practices项目本地附加 skills（当前位于 .claude/skills/*）按需通过 pnpm skills:link 一起同步。
当前仓库内的本地附加 skill 示例：
text
$playwright-cli建议：
- 面向用户公开分发的流程优先沉淀到
skills/*。 - 仅对本仓库有效、依赖本地工具链或本地 agent 能力的内容，更适合放到
.claude/skills/*。 - 项目架构、分包、构建编排问题优先用
weapp-vite-best-practices。 - 根据现有代码同步
website、skills、AI 指南时优先用docs-and-website-sync。 - GitHub issue 修复、
e2e-apps/github-issues复现、PR 闭环优先用github-issue-fix-workflow。 - changeset、发布、
create-weapp-vite联动和提交规范优先用release-and-changeset-best-practices。 - WeChat DevTools runtime e2e、automator 复用、
reLaunch方案优先用weapp-devtools-e2e-best-practices。 - 卡顿、掉帧、白屏、内存告警优先用
weapp-vite-wevu-performance-best-practices。 .vue宏、模板兼容、v-model/usingComponents问题优先用weapp-vite-vue-sfc-best-practices。wevu生命周期、状态、事件、store 问题优先用wevu-best-practices。- 原生小程序迁移到
weapp-vite + wevu + Vue SFC优先用native-to-weapp-vite-wevu-migration。 - DevTools 自动化、
preview/upload/automator/config命令治理优先用weapp-ide-cli-best-practices。 - 先让 AI 明确使用哪个 Skill，再开始具体任务。
MCP
MCP 负责把仓库真实能力暴露给 AI（读代码、搜代码、执行受限命令、调用 weapp-vite CLI）。
默认行为：
weapp-vite默认启用 MCP 能力。- 默认不会自动启动 MCP 服务（
autoStart: false）。
手动启动（推荐）：
bash
weapp-vite mcp需要 HTTP 连接时：
bash
weapp-vite mcp --transport streamable-http --host 127.0.0.1 --port 3088 --endpoint /mcp可选：不在仓库目录执行时，再加 --workspace-root /path/to/weapp-vite。
示例：驱动 weapp-vite screenshot 做验收
前置条件：
- AI 客户端已接入
weapp-viteMCP。 - 微信开发者工具已登录，并开启「设置 -> 安全设置 -> 服务端口」。
可直接复制的提示词：
text
你现在连接的是 weapp-vite MCP。请帮我完成一次小程序截图验收：
1. 构建 e2e-apps/auto-routes-define-app-json（platform=weapp）。
2. 执行 weapp-vite screenshot，参数如下：
- project: e2e-apps/auto-routes-define-app-json/dist/build/mp-weixin
- page: pages/home/index
- output: .tmp/mcp-screenshot.png
- 使用 --json 返回结果
3. 检查 .tmp/mcp-screenshot.png 是否存在：
- 存在输出 screenshot-ok
- 不存在输出 screenshot-missing
4. 最后汇总：执行命令、关键输出、最终结论。期望结果：
- AI 输出
screenshot-ok。 - 工作区产出
.tmp/mcp-screenshot.png。
llms.txt
llms.txt 负责给模型稳定喂上下文，减少遗漏与误判。
可用资源：
/llms.txt：轻量索引。/llms-full.txt：完整语料。/llms-index.json：结构化索引。
推荐喂给顺序：
- 先
/llms.txt建立目录语义。 - 再按需读取
/llms-full.txt。 - 最后结合
/llms-index.json做结构化定位。