开发指南
AI 协作
规则真值源、八个仓库技能、分层实现与验证闭环。
规则与文档的分工
AGENTS.md：仓库架构、边界、任务路由和验证默认值的唯一真值源。README.md：给人的定位、安装、命令和部署入口。.agents/skills/*/SKILL.md：任务工作流、真实入口与完成条件。CLAUDE.md：工具/运行偏好，不复制另一套架构规则。tests/README.md与tests/e2e/SCENARIOS.md：测试环境与浏览器验收图。
任务路由
| Skill | 范围 |
|---|---|
musemvp-decide-next-step | 宽泛/混合任务和阶段排序 |
musemvp-configure-public-surface | 公开文案、页面、导航、定价展示、内容 |
musemvp-configure-saas-layout | 登录后 sidebar/header/profile 壳 |
musemvp-configure-saas-page-route | 仅 /app 首页路由 |
musemvp-build-product-behavior | 行为、数据、鉴权、计费和 API |
musemvp-testing-guidance | 测试层选择与覆盖 |
musemvp-review-risks | 合并/上线前风险审查 |
musemvp-generate-changelog | 从 commits 生成双语更新日志 |
技能由支持它们的工具读取，不能保证所有 IDE 自动加载。不要凭旧文档假定仓库包含通用技能大礼包或部署自动工作流。
实施闭环
- 先读拥有该行为的 route/module/config/query 与
AGENTS.md。 - 明确验收，浏览器流程更新
SCENARIOS.md。 - 包行为/schema/bug 修复先写失败测试。
- 按
queries → modules/lib → routes → api-client → UI实现；driver 在应用src/server，auth/API 接线在src/backend。 - 在真实应用手动验证，再固定自动断言；最后运行最窄必要测试。
- 回报通过、失败、未运行与延期路径，不以 type-check 或渲染替代验收。
包不能用应用 @/，模块不直连 DB，衍生消息只进 packages/i18n/src/translations/{en,zh}/mvp.json，页面/内容改动检查 pnpm apps:parity。Next.js 16 改动前读取安装包 node_modules/next/dist/docs/ 的相关指南，不套用旧 API 经验。
可直接使用的提示词
目标：在 src/modules/<feature> 完成具体行为。
先检查 AGENTS.md、拥有入口和对应 Skill，再列验收路径。
新增行为或 bug 先写失败测试，保持包与应用的分层边界。
同步 en/zh mvp.json 与需要保持一致的双应用页面。
手动验证错误/空态/权限后补最小 unit/API/E2E 覆盖。
运行相关检查，逐项报告真实结果和未验证路径。