本仓库不再把项目规则直接堆在 AGENTS.md 中，而是改为按 skill 组织。
使用方式：
- 如果需要的话，先根据任务选择最相关的 skill。
- 读取对应
skills/<skill-name>/SKILL.md。 - 按 skill 中的触发条件和执行规则完成工作。
- 如果多个 skill 同时相关，可以组合使用，但只加载当前任务真正需要的内容。
- 不要主动移除项目中的注释，也不要在没有明确指令的情况下修改、删除或翻译
@note注释。
当前项目内 skills：
-
testing-strategy路径：skills/testing-strategy/SKILL.md用于决定当前任务应该看热加载报错、跑单测、跑 UI 截图测试，还是避免误跑构建。 -
readme-reference路径：skills/readme-reference/SKILL.md用于在修改代码、测试、流程或文档前，先从仓库内 README 中提取仍然有效的项目上下文。 -
glossary-alignment路径：skills/glossary-alignment/SKILL.md用于把开发者口头说的组件、视图、状态、面板、模式等术语，快速对齐到具体代码归属。 -
file-modularization路径：skills/file-modularization/SKILL.md用于在新增或重构前端功能时约束文件长度、入口文件职责和模块拆分，避免继续把大量实现堆进App.tsx、页面根组件或单个大文件。 -
frontend-runtime-guardrails路径：skills/frontend-runtime-guardrails/SKILL.md用于在新增、重构或审查前端运行时行为时约束高频动画、useMotionValueEvent、requestAnimationFrame、ResizeObserver和 React state 更新频率，避免 visualizer 等路径引入高 CPU 或时序错位。 -
reuse-project-utilities路径：skills/reuse-project-utilities/SKILL.md用于在实现、重构或审查时提示优先复用仓库已有公共工具和常用库，例如 pretext 文本测量、visualizer runtime、歌词时序 helper、字体/颜色 helper、i18n、lucide 图标和虚拟列表，避免重复造轮子。 -
settings-feature-integration路径：skills/settings-feature-integration/SKILL.md用于新增或调整设置项时判断接入位置：视觉相关设置必须进入视觉配置导入导出，功能性设置和可执行动作必须注册到 command palette。 -
kugou-provider-alignment路径：skills/kugou-provider-alignment/SKILL.md用于开发阶段根据docs\ku-go-api-docs.md、.env.local中的真实 KuGou 服务和test-results\.dev-credentials对齐酷狗 provider 的请求与响应，禁止猜测接口结构。
全局沟通规则：
- 不需要使用skills的时候，不要读取它们。
- 回答用户问题时，直接给出结论，不添加无关的辅助性评价措辞。
- 如果用户指出的是潜在 bug 或不合理设计，需要直接指出问题并给出建议，不回避。
- 如果创建了新的文件，在导入行结束后插入当前文件的注释
- 如果创建了复杂的函数，写出简短的注释，说明函数功能