用途
Framework Expert 是一个统一框架专业知识包，面向 AI 消费，优化供 Claude 在执行期间阅读。它的核心目标是在检测到项目所用技术栈后，按需加载对应框架的参考模式，避免一次性加载全部框架知识。
主要能力
该技能通过项目依赖文件自动检测技术栈，检测规则如下：
- web-frontend：检测 react、vue、angular、nextjs，依据 package.json 依赖。
- web-backend：检测 nodejs、python、laravel、go，依据 package.json、requirements.txt、composer.json、go.mod。
- mobile：检测 react-native、flutter，依据 app.json（expo）或 pubspec.yaml。
- typescript：检测 typescript，依据 tsconfig.json 或 .ts 文件。
检测到框架后，可读取对应的参考文件获取常见陷阱和决策表：
- React：refs/react.md
- Vue：refs/vue.md
- Angular：refs/angular.md
- Next.js：refs/nextjs.md
- Node.js：refs/nodejs.md
- Python：refs/python.md
- Laravel：refs/laravel.md
- Go：refs/go.md
- Flutter：refs/flutter.md
- React Native：refs/react-native.md
- TypeScript：refs/typescript.md
每个框架的深度内容（常见陷阱、决策标准、代码示例）位于 refs/<framework>.md 中。该知识包不再委托给独立的 <name>-expert 技能，而是在检测到技术栈后按需读取匹配的 ref 文件。完整库文档建议使用 Context7。
Svelte 和 Godot 曾被列出但没有自己的参考文件，因此检测到它们时会导致模型寻找不存在的深度内容，应改用 Context7。
核心模式（适用于所有框架）
- 文件组织：按功能分组，而非按类型。
- 命名：组件使用 PascalCase，函数使用 camelCase。
- 错误处理：优雅降级并提供用户反馈。
- 状态：尽量减少全局状态。
- API 设计：遵循 RESTful 或 GraphQL 约定。
- 测试：单元测试 + 集成测试 + 端到端测试。
- 性能：懒加载 + 代码分割。
- 安全：输入验证 + 净化。
使用方式
在检测到框架后，按需读取 refs/<framework>.md 以加载框架特定模式。该技能为 AI 消费的参考材料，人类可读说明可参见 docs/architecture/HIERARCHICAL_PLANNING.md 或 docs/getting-started/（取决于主题）。
适用场景
适用于需要根据项目技术栈提供框架特定指导的 AI 辅助开发场景，例如在 Claude 执行过程中识别到 React、Vue、Angular、Next.js、Node.js、Python、Laravel、Go、Flutter、React Native 或 TypeScript 项目时。
限制
Svelte 和 Godot 没有自己的参考文件，检测到它们时应使用 Context7。完整库文档不在本技能范围内，需使用 Context7。