find-rules

查找规则

此技能可帮助你发现并了解适用于当前任务的具体规则、惯例和指南。它会系统地探索项目文档，确保符合项目标准。

说明

请遵循以下工作流，确定适用的规则：

1. 了解上下文

首先，分析任务以确定：

• 任务类型：PRD 编写、技术规范、功能实现、重构、Bug 修复等。
• 技术：React、Elysia、Tailwind、Drizzle 等。
• 关注方面：架构、测试、样式、命名等。

2. 基于模式进行发现

必须： 使用 Glob 和 Grep 工具进行本地代码发现，查找相关规则文件和指南。

执行策略： 为提高效率，首次操作时同时执行 3 个或更多工具。只要可以并行执行，就绝不要按顺序执行工具。

强制步骤：

1. 查找规则文件（并行运行）：同时使用多个 Glob 模式。

   # 主要规则
   Glob pattern=".cursor/rules/*.mdc"
   Glob pattern="**/CLAUDE.md"
   Glob pattern="**/AGENTS.md"
   
   # 次要规则
   Glob pattern="**/CONTRIBUTING.md"
   Glob pattern="**/ARCHITECTURE.md"
   Glob pattern="**/STYLEGUIDE.md"
   
   # 其他 AI 工具的位置
   Glob pattern=".windsurf/rules/*"
   Glob pattern=".cursorrules"
   Glob pattern=".copilot/*"
   
   # 配置文件
   Glob pattern="**/.eslintrc*"
   Glob pattern="**/tsconfig.json"
   Glob pattern="**/biome.json"
   

2. 按内容搜索：使用 Grep 查找提及特定技术或概念的规则。

   Grep pattern="react" path=".cursor/rules"
   Grep pattern="CRITICAL|MANDATORY" path=".cursor/rules" output_mode="content"
   Grep pattern="testing" glob="*.md"
   Grep pattern="must|should|never" glob="*.mdc" -i=true
   

3. 搜索位置优先级：

   • .cursor/rules/*.mdc - 特定技术的规则（优先级最高）
   • CLAUDE.md - 项目通用指南
   • AGENTS.md - Agent 专用说明
   • .windsurf/rules/、.cursorrules - 其他 AI 工具的规则
   • docs/ - 文档目录
   • 配置文件 - 工具配置中隐含的规则

3. 提取并分类规则

确定相关文件后：

1. 阅读：使用 Read 工具检查已识别规则文件的完整内容（例如 .cursor/rules/react.mdc）。

2. 分类每条规则： 对找到的每条规则，确定：

   • 类别：所属领域（例如身份验证、测试、安全、性能、样式、架构）
   • 内容：实际规则或指南文本
   • 源文件：找到该规则的文件路径
   • 强制级别：CRITICAL、MANDATORY、RECOMMENDED 或 SUGGESTED

3. 分析：

   • 优先查找 CRITICAL 或 MANDATORY 要求
   • 确定命名惯例、文件结构和必需模式
   • 留意与相关技术有关的冲突或具体说明
   • 检查关键词："must"、"should"、"never"、"always"、"required"、"forbidden"

4. 呈现发现结果

以清晰、可操作的格式总结找到的规则：

• 规则/指南：具体标准。
• 来源：定义该规则的文件路径和章节。
• 强制级别：CRITICAL、MANDATORY、RECOMMENDED。
• 适用性：说明该规则为何适用于此任务。

文档来源

主要规则位置

• .cursor/rules/*.mdc：特定技术的规则（React、后端、Tailwind 等）
• CLAUDE.md：AI 助手通用指南和项目背景
• AGENTS.md：Agent 专用说明和工作流

次要规则位置

• CONTRIBUTING.md：贡献指南和流程
• CODE_OF_CONDUCT.md：社区和代码规范
• ARCHITECTURE.md：架构决策和模式
• STYLEGUIDE.md：代码风格约定
• CODING_STANDARDS.md：编程标准

其他 AI 工具位置

• .windsurf/rules/：Windsurf 专属规则
• .cursorrules：Cursor 规则文件
• .copilot/：GitHub Copilot 配置
• .codeium/：Codeium 配置

配置文件（隐式规则）

• .eslintrc.*, .eslintrc.json：Lint 规则
• .prettierrc.*, .prettierrc.json：格式化规则
• tsconfig.json：TypeScript 编译器选项
• .oxlintrc.json：Oxlint 配置
• biome.json：Biome 格式化工具和 Lint 工具规则

文档目录

• docs/：项目文档
• .github/：GitHub 专属模板和工作流

强制级别

• 🚨 CRITICAL：必须严格遵守；违反将导致任务被拒绝。
• ⚠️ MANDATORY：必须遵守的标准，不应跳过。
• ✅ RECOMMENDED：适用时应遵循的最佳实践。
• 💡 SUGGESTED：锦上添花的指南。

常见规则类别

对规则进行分类时，请使用以下常见领域：

• 架构：设计模式、模块边界、依赖关系
• 测试：测试要求、覆盖率、模式
• 安全：身份验证、授权、输入验证
• 性能：优化要求、缓存、延迟加载
• 样式：CSS/Tailwind 约定、组件样式
• 命名：文件命名、变量命名、函数命名
• 代码质量：Lint、格式化、类型安全
• API：端点模式、请求/响应处理
• 状态管理：Redux、Context、hooks 模式
• 错误处理：异常处理、错误边界

示例

用户：“我需要创建一个新的 React 组件。” 技能操作：

1. 上下文：功能开发、React、组件结构。
2. 发现：
   • 使用 Glob：Glob pattern=".cursor/rules/*.mdc" 查找规则文件。
   • 使用 Grep：Grep pattern="react" path=".cursor/rules" 查找与 React 相关的规则。
   • 结果指向 .cursor/rules/react.mdc。
3. 提取：读取 .cursor/rules/react.mdc。
4. 发现内容：
   • 🚨 CRITICAL：只能使用函数组件。
   • ⚠️ MANDATORY：文件名必须采用 kebab-case.tsx。
   • ⚠️ MANDATORY：使用 hooks 管理状态。

用户：“如何编写后端端点？” 技能操作：

1. 上下文：后端、API、实现。
2. 发现：
   • 使用 Glob：Glob pattern=".cursor/rules/*.mdc" 列出可用规则。
   • 使用 Grep：Grep pattern="backend|endpoint|elysia" path=".cursor/rules" 查找后端规则。
   • 结果指向 .cursor/rules/elysia.mdc 和 .cursor/rules/data-fetch.mdc。
3. 提取：读取相关文件。
4. 发现内容：
   • 🚨 CRITICAL：遵循 Elysia 处理器模式。
   • ⚠️ MANDATORY：使用指定的数据获取封装器。