用途:为项目实际使用的 AI 编码工具生成一条新的记忆规则(项目指令、编码规范或工作流指南),按该工具真正读取的格式写入。它只创建记忆规则,不创建技能或命令(用 create-skill),也不搜索可安装的现有技能(用 find-skills)。
主要能力:先检测仓库中已有的工具约定——存在 CLAUDE.md 或 .claude/rules/.md 视为 Claude Code;仅有 AGENTS.md 视为 Codex/Cursor/Copilot/Gemini-CLI 风格;存在 .cursor/rules/.mdc 视为 Cursor 原生格式;多种约定并存时询问用户更新哪一个;都没有则先询问用户使用哪种工具/格式。随后按工具决定类型与作用域:Claude Code 可用模块化 .claude/rules/<name>.md 或 CLAUDE.md 条目,区分项目级与用户级(~/.claude/rules/),路径特定规则需 paths frontmatter;AGENTS.md 风格工具在根 AGENTS.md 追加新章节,无分文件与 frontmatter;Cursor 写 .cursor/rules/<name>.mdc,带 description/globs/alwaysApply frontmatter。
使用方式:/create-rule <名称> "<描述>",名称取自 $1 或参数首词,描述取自其余部分,缺失则询问用户。示例:/create-rule api-errors "Standard error handling for API routes" 在 Claude Code 仓库写入 .claude/rules/api-errors.md 并带 paths: src/api//*.ts;/create-rule --user preferences "..." 写入 ~/.claude/rules/preferences.md;仅有 AGENTS.md 的仓库会追加 ## Testing 章节;Cursor 仓库写入 .cursor/rules/react-components.mdc 并带 globs: ["/*.tsx"]。
限制与防幻觉要求:先核对真实代码库,不假设约定;规则须基于项目中真实代码而非编造标准;无既有约定时询问用户;新增前检查 CLAUDE.md / AGENTS.md / .claude/rules/.md / .cursor/rules/.mdc 是否冲突;paths frontmatter 仅用于 .claude/rules/.md,globs 仅用于 .cursor/rules/.mdc,绝不用于无 frontmatter 的 CLAUDE.md 或 AGENTS.md。参考文件:references/memory-hierarchy.md、references/rule-examples.md;Claude Code 记忆文档见 https://code.claude.com/docs/en/memory。