预置 Skills
01MVP 模板内置的 Agent Skills 清单和使用建议
Skills 解决什么问题
.agents/skills 是 repo-local 的 AI 工作流目录。它们不是页面功能，而是给 AI 编码工具加载的专项能力：遇到 Next.js、Better Auth、Zeabur、Cloudflare、文档收录、UI 审查等任务时，AI 可以先读取对应 Skill，再按项目约定做事。
这类能力适合封装三种东西：
- 容易记错的命令、配置和版本差异
- 需要长期遵守的项目工作流
- 不适合每次都重新解释的领域经验
当前预置清单
| 分组 | Skills | 主要用途 |
|---|---|---|
| 模板初始化 | 01mvp-template-initializer | 把 01MVP 模板改成一个具体产品网站 |
| Next.js / React | next-best-practices、vercel-react-best-practices、vercel-composition-patterns | 路由、RSC 边界、组件组合、性能和 React 结构 |
| UI 审查 | web-design-guidelines | 检查界面可用性、可访问性和基础设计质量 |
| 认证 | better-auth-best-practices、better-auth-security-best-practices、email-and-password-best-practices | Better Auth、密码登录、会话、安全加固 |
| 数据库 | AGENTS.md + .agents/references/database-drizzle.md | Drizzle schema、migration、数据库连接和生产迁移流程 |
| Monorepo | turborepo | Turbo 任务、缓存、过滤、包边界和 CI 运行方式 |
| 部署与云服务 | zeabur-deploy、zeabur-variables、zeabur-domain-url、workers-best-practices、wrangler | Zeabur 部署、环境变量、域名，以及 Cloudflare Workers 代码和 Wrangler 命令 |
| 文档与内容 | shoulu、jta | 资料收录进 01MVP 文档、JSON i18n 翻译 |
| 视觉产物 | html2png | 把 HTML 渲染成 PNG 截图或发布素材 |
这个清单来自当前仓库的 .agents/skills 目录。以后新增、删除或升级 Skill 时，以仓库内容为准。
怎么让 AI 使用它们
通常不需要手动打开 Skill 文件。你可以直接描述任务：
用 01mvp-template-initializer 帮我把这个模板初始化成一个面向独立开发者的 AI 工具站。帮我改 Drizzle schema 并生成迁移，注意先读仓库里的数据库 reference。帮我部署到 Zeabur，使用现有服务，不要创建重复服务。如果任务里出现明确的技术栈或工作流，AI 会优先读取相关 Skill，再做代码或文档修改。
什么时候新增一个 Skill
新增 Skill 的判断很简单：如果一段工作流会重复出现，而且每次都要解释同一批约束，就值得沉淀。
适合新增 Skill 的例子：
- 01MVP 模板初始化
- 付费文档发布流程
- 会员权益和支付联调
- 某个固定部署平台的排障流程
- 特定内容格式的多平台发布流程
不适合新增 Skill 的例子：
- 只用一次的临时需求
- 普通代码风格偏好
- 已经写在
AGENTS.md里的通用项目规则 - 可以直接从官方文档查到、且不会反复用到的单条命令
维护建议
- Skill 的
description要写清触发场景，否则 AI 不容易自动选中。 SKILL.md保持短，复杂细节放到references/。- 不要在 Skill 里塞用户看不懂的内部记录；它应该指导工作流，不是保存过程日志。
- 升级外部 Skill 后，至少做一次真实任务或小型验证，确认新规则没有和 01MVP 项目约定冲突。