shield_lock
金大哥
← 返回 Skill 列表
extension
分类: AI Agent 能力无需 API Key

rule-creator

为CLAUDE.md、AGENTS.md、.cursorrules、.clinerules或.windsurfrules创建有效的AI代理规则。当用户提到“创建规则”、“写规则”、“create rule”、“write rule”、“添加规则”、“更新规则”、“update rule”、“修改规则”、“规则模板”、“rule template”，或者想要定义编码标准、项目约定或AI行为指南时使用。

person作者: jakexiaohubgithub
open_in_new仓库download下载资源包

Rule Creator

为不同 IDE 工具创建有效的 AI 代理规则。

规则文件格式

| 工具 | 文件位置 | 格式 | |------|----------|------| | Claude Code | CLAUDE.md | Markdown | | Cursor | .cursorrules 或 .cursor/rules/*.md | Markdown + YAML frontmatter | | Cline | .clinerules/*.md | Markdown + YAML frontmatter | | Windsurf | .windsurfrules | Markdown | | Augment | .augment/skills/*/SKILL.md | 用于复杂工作流，简单规则用 CLAUDE.md | | 通用 | AGENTS.md | 纯 Markdown (跨工具兼容) |

规则类型 (Cursor/Cline)

始终应用:

---
alwaysApply: true
---
# 规则内容...

按文件匹配:

---
globs: ["src/components/**", "**/*.tsx"]
---
# 规则内容...

由 Agent 决定:

---
description: "React 组件开发指南"
---
# 规则内容...

写作原则

具体明确

❌ "写好异步代码" ✅ "所有数据库调用使用 async/await，禁止回调"

展示模式

❌ "遵循错误处理规范" ✅ "参考 src/utils/errors.ts 的错误处理模式"

关注结果

❌ "第一步打开文件，第二步..." ✅ "确保所有 API 响应包含 error code 和 message"

尽量量化

❌ "函数不要太长" ✅ "单个函数不超过 50 行"

规则模板

# [规则名称]

## 代码规范
- [具体规范 1]
- [具体规范 2]

## 架构约束
- [约束 1]
- [约束 2]

## 禁止事项
- [禁止 1]
- [禁止 2]

## 参考文件
- `path/to/example.ts` - [说明]

适合写成规则的内容

✅ 适合写成规则:

  • 代码规范 (命名、格式、风格)
  • 架构决策 (设计模式、依赖规则)
  • 团队约定 (PR 流程、分支命名、commit 格式)
  • 技术约束 (必须使用的库、禁用的 API)
  • 安全要求 (敏感信息处理、权限检查)

❌ 不适合写成规则:

  • 一次性指令 (直接在对话中说)
  • 复杂多步骤工作流 (用 Skill 或 Workflow)
  • 依赖运行时上下文的动态决策

工作流程

  1. 确认目标: 询问规则要解决什么问题
  2. 识别 IDE: 检查项目中已有的规则文件 (.cursorrules, .windsurfrules, CLAUDE.md 等)
  3. 选择格式:
    • 单一 IDE → 使用对应格式
    • 多 IDE 环境 → 优先 AGENTS.md (通用兼容)
    • 复杂工作流 → 建议使用 Skill 而非 Rule
  4. 起草规则: 使用模板，保持简洁具体
  5. 验证规则:
    • 规则是否可被检查遵守？
    • 是否有正确/错误示例？
    • 是否与现有规则冲突？
  6. 放置文件: 保存到正确位置，遵循命名约定

示例: Backend API 规则 (带 frontmatter)

---
globs: ["src/routes/**", "src/controllers/**"]
---

# Backend API 规范

## 路由处理
- 使用 async/await，禁止回调
- 请求体使用 Zod schema 验证
- 错误返回使用 `src/errors.ts` 中的类型

## 数据库访问
- 所有查询通过 `src/repositories/` 中的类
- 多表更新使用事务
- 禁止向客户端暴露原始数据库错误

## 测试要求
- 业务逻辑: `src/services/` 单元测试
- 路由处理: `src/routes/` 集成测试
- Mock 外部 API，不 mock 内部模块

条件规则 (Cursor/Cline)

限定规则只在特定文件生效:

---
globs:
  - "src/components/**"
  - "src/hooks/**"
---

# React 组件规范

使用函数组件和 hooks。可复用逻辑提取为自定义 hook。

提示

  1. 一个规则一个关注点: 避免规则过于庞大
  2. 可验证: 规则应该能被检查是否遵守
    • ✅ "函数不超过 50 行" (可检查)
    • ❌ "代码要简洁" (无法检查)
  3. 有示例: 包含正确和错误的代码示例
  4. 定期更新: 根据实际使用反馈迭代规则
  5. 团队共识: 规则应反映团队共识，而非个人偏好

Rule vs Skill

| 场景 | 使用 | |------|------| | 简单约定、代码规范 | Rule (本 skill) | | 复杂多步骤工作流 | Skill (skill-creator) | | 需要脚本/资源文件 | Skill | | 一次性指令 | 直接在对话中说 |