创建规则文件

规则文件格式

规则文件必须放在 rules/ 目录下，使用 .md 扩展名。每个规则文件的 frontmatter 必须包含以下字段：

---
description: [必填] 规则的简要描述，说明规则的作用和触发场景
alwaysApply: [必填] true 或 false，表示是否总是应用此规则
enabled: [必填] true 或 false，表示规则是否启用
updatedAt: [必填] ISO 8601 格式的更新时间，如 2026-06-13T16:35:00.000Z
provider: [可选] 规则提供者，可为空
---

Frontmatter 字段说明

字段	类型	必填	说明
`description`	string	是	规则描述，用于 AI 判断何时应用此规则
`alwaysApply`	boolean	是	`true` 表示每次对话都应用，`false` 表示仅在匹配时应用
`enabled`	boolean	是	`true` 启用，`false` 禁用
`updatedAt`	string	是	ISO 8601 格式时间戳，每次修改规则时更新
`provider`	string	否	规则提供者名称，可留空

创建流程

第一步：收集信息

向用户确认以下内容：

规则名称：简洁明了，使用 kebab-case（如 writing-pipeline）
规则描述：一句话说明规则的作用和触发场景
alwaysApply：是否每次对话都应用？
- true：全局规则，始终生效（如编码规范、审查流程）
- false：条件规则，仅在特定场景生效
enabled：是否立即启用？
规则内容：具体的规则指令

第二步：生成规则文件

在 rules/ 目录下创建 {rule-name}.md 文件，格式如下：

---
description: {规则描述}
alwaysApply: {true/false}
enabled: {true/false}
updatedAt: {当前时间 ISO 8601}
provider:
---

# {规则标题}

## 规则

{规则的具体内容和指令}

## 执行

{规则的执行方式和流程}

## 例外

{不需要应用此规则的情况}

第三步：分发规则文件

规则文件创建后，手动复制到目标项目的 rules/ 目录即可生效。安装器（skill-install.sh）仅管理 skill 的安装与同步，不再支持规则文件的自动分发。

# 手动复制到目标项目
cp rules/new-rule.md /path/to/your-project/rules/

如需批量管理规则，可参考 skill-install.sh 的 --file 配置文件机制自行编写同步脚本，或将规则纳入目标项目的版本控制。

规则编写最佳实践

1. 描述要精准

✅ 好的描述：文档或代码编写完成后，自动调用 auto-review skill 进行质量审查和修复闭环
❌ 差的描述：一些规则

2. 内容要结构化

使用清晰的章节划分：

# 规则标题

## 规则
规则的核心定义和要求

## 执行
规则的执行步骤和流程

## 例外
不需要应用此规则的特殊情况

3. 保持简洁

规则文件应控制在 100 行以内
避免冗长的解释，直接给出指令
使用表格、列表等结构化格式

create-rules

SKILL.mdskills/create-rules/SKILL.md