名称: 规则创建器描述: 为Claude Code框架创建规则文件。规则是.claude/rules/目录下的Markdown文件，由Claude Code自动加载。版本: 1.0.0 模型: sonnet 调用方式: 两者用户可调用: 是工具: [读取, 写入, 编辑] 参数: ‘–name <规则名称> --content <规则内容> [–category <类别>]’ 最佳实践:

规则是简洁的指南（非详细工作流程）
使用Markdown格式以提高清晰度
将相关规则分组到章节中
除非需要详细指导，否则规则保持在50行以内错误处理: 优雅流式处理: 支持输出位置: .claude/rules/ 已验证: 否最后验证时间: 2026-02-19T05:29:09.098Z

规则创建器

在.claude/rules/中创建规则文件。规则由Claude Code自动发现并加载到代理上下文中。

步骤0: 检查现有规则

创建前，检查规则是否已存在：

test -f .claude/rules/<规则名称>.md && echo "存在" || echo "新建"

如果存在 → 调用Skill({ skill: "artifact-updater", args: "--type rule --path .claude/rules/<规则名称>.md --changes '...'" })

如果新建 → 继续步骤0.5。

步骤0.5: 配套检查

创建前，运行生态系统配套检查：

使用.claude/lib/creators/companion-check.cjs中的companion-check.cjs
调用checkCompanions("rule", "{规则名称}")以识别配套工件
检查配套清单 — 注意哪些必需/推荐的配套缺失
计划在创建完成后创建或验证缺失的配套
在创建后集成笔记中包含配套发现

此步骤为信息性（不阻止创建），但确保考虑完整的工件生态系统。

何时使用

创建项目特定的编码指南
记录框架约定
建立团队标准
定义工作流协议

规则文件格式

规则是简单的Markdown文件：

# 规则名称

## 章节1

- 指南1
- 指南2

## 章节2

- 指南3
- 指南4

示例: testing.md

# 测试

## 测试驱动开发

- 新功能和错误修复使用TDD（红-绿-重构循环）
- 先写失败的测试，然后写最小代码通过，再重构
- 从不编写没有失败测试的生产代码

## 测试组织

- 为工具和业务逻辑添加单元测试
- 为API边界添加集成测试
- 保持测试确定性和隔离（无共享状态）
- 将测试文件放在`tests/`目录中，镜像源代码结构

创建工作流

步骤1: 验证输入

// 验证规则名称（小写，仅允许连字符）
const ruleName = args.name.toLowerCase().replace(/[^a-z0-9-]/g, '-');

// 验证内容非空
if (!args.content || args.content.trim().length === 0) {
  throw new Error('规则内容不能为空');
}

步骤2: 创建规则文件

const rulePath = `.claude/rules/${ruleName}.md`;

// 将内容格式化为Markdown
const content = args.content.startsWith('#')
  ? args.content
  : `# ${ruleName.replace(/-/g, ' ').replace(/\b\w/g, l => l.toUpperCase())}

${args.content}`;

await writeFile(rulePath, content);

步骤3: 验证自动发现

.claude/rules/中的规则由Claude Code自动加载。无需手动注册。

// 验证文件已创建
const fileExists = await exists(rulePath);
if (!fileExists) {
  throw new Error('规则文件创建失败');
}

步骤4: 运行创建后集成

const {
  runIntegrationChecklist,
  queueCrossCreatorReview,
} = require('.claude/lib/creator-commons.cjs');

await runIntegrationChecklist('rule', rulePath);
await queueCrossCreatorReview('rule', rulePath, {
  artifactName: ruleName,
  createdBy: 'rule-creator',
});

创建后集成

规则创建后，运行集成清单：

const {
  runIntegrationChecklist,
  queueCrossCreatorReview,
} = require('.claude/lib/creator-commons.cjs');

// 1. 运行集成清单
const result = await runIntegrationChecklist('rule', '.claude/rules/<规则名称>.md');

// 2. 排队跨创建者审查
await queueCrossCreatorReview('rule', '.claude/rules/<规则名称>.md', {
  artifactName: '<规则名称>',
  createdBy: 'rule-creator',
});

// 3. 检查影响报告
// 检查result.mustHave中的失败 — 在标记完成前处理

集成验证：

[ ] 规则文件在.claude/rules/中创建
[ ] 规则由Claude Code自动发现
[ ] 规则内容清晰且可操作
[ ] 无与现有规则的冲突

使用示例

创建代码标准规则

Skill({
  skill: 'rule-creator',
  args: `--name code-standards --content "# 代码标准

## 组织
- 偏好小、内聚的文件而非大文件
- 保持接口窄；按功能分离关注点

## 风格
- 优先不可变性；避免就地突变
- 验证输入并显式处理错误"`,
});

创建Git工作流规则

Skill({
  skill: 'rule-creator',
  args: `--name git-workflow --content "# Git工作流

## 提交指南
- 保持变更范围化和可审查
- 使用约定提交：feat:, fix:, refactor:, docs:, chore:

## 分支工作流
- 从主分支创建功能分支
- 永不强制推送到main/master"`,
});

内存协议（强制）

开始前： 读取.claude/context/memory/learnings.md

完成后：

新规则模式 → .claude/context/memory/learnings.md
规则创建问题 → .claude/context/memory/issues.md
指南决策 → .claude/context/memory/decisions.md

假设中断：如果未在内存中，则未发生。

生态系统对齐合同（强制）

此创建者技能是协调创建者生态系统的一部分。在此创建的工件必须对齐并验证相关创建者：

agent-creator 用于所有权和执行路径
skill-creator 用于能力打包和分配
tool-creator 用于可执行自动化表面
hook-creator 用于执行和防护栏
rule-creator 和 semgrep-rule-creator 用于政策和静态检查
template-creator 用于标准化脚手架
workflow-creator 用于编排和阶段门控
command-creator 用于用户/操作员命令UX

跨创建者握手（必需）

完成前，验证所有相关握手：

工件路由存在于.claude/CLAUDE.md和相关路由文档中。
发现/注册条目已更新（目录/索引/注册表如适用）。
配套工件已创建或明确豁免并附理由。
validate-integration.cjs 对创建的工件通过。
技能索引在技能元数据更改时重新生成。

研究门（优先Exa，备用arXiv）

对于新模式、模板或工作流，研究是强制的：

优先使用Exa用于实现和生态系统模式。
如果Exa不足，使用WebFetch加arXiv参考。
在工件参考/文档中记录决策、约束和非目标。
保持更新最小化并避免过度工程。

回归安全交付

对行为更改遵循严格的RED -> GREEN -> REFACTOR。
对更改模块运行针对性测试。
对更改文件运行代码检查/格式化。
按关注点（逻辑/文档/生成工件）保持提交范围化。

规则创建器Skill rule-creator