Rule Creator 是一个用于创建和管理用户规则的技能。用户规则是自定义指令,用来修改 AI 助手的行为方式,可定义的范围包括:编码标准(风格、模式与约定)、语言偏好(回复语言、术语)、项目配置(框架选择、文件结构)、工作流指南(Git、测试、文档实践)。
主要能力与使用方式:该技能提供一个规则创建工作流。第一步,识别规则用途,向用户确认要修改的行为、属于项目规则还是个人偏好、是否存在例外。第二步,选择规则分类,常见分类有 coding-style、language、project、git、naming、security、testing、documentation。第三步,编写规则,遵循具体、可操作、包含示例、定义例外等原则。第四步,按固定格式组织规则:以“## [Category]: [Short Title]”开头,使用祈使句写明清晰指令,附上示例,必要时注明 Exception。第五步,对照校验清单检查规则是否清晰无歧义、有无明确定义的上下文、是否可操作、复杂规则是否含示例、例外是否记录、是否与现有规则冲突。
规则管理方面,支持添加规则(创建或追加到用户规则文件,按清晰标题分组)、更新规则(除非明确要求替换,否则保留现有规则)、组织规则(可按优先级如 security > performance > style、按分类、按作用范围组织)。
输出位置与结构:规则必须保存在 .agent/rules/ 目录中,按规则分类每个文件一个,例如 git-commit.md、coding-style.md、naming-conventions.md、security.md、testing.md。文件名使用 kebab-case,即 {rule-name}.md,名称应反映规则分类或用途。每个规则文件应包含带激活模式的 YAML frontmatter,后接规则内容。
激活模式有四种:manual(通过在输入中 @mention 激活,如 @git-commit)、always_on(始终应用于所有对话)、model_decision(模型根据 description 字段决定)、glob(应用于匹配 globs 模式的文件)。示例中给出了四种模式对应的 frontmatter 写法。
@Mentions 文件引用:规则中可用 @filename 引用其他文件,路径类型包括相对路径(相对规则文件位置)、绝对路径(先尝试真正的绝对路径,再尝试工作区相对路径)、工作区路径(相对工作区/仓库根目录)。用例包括引用共享文档、包含类型定义、链接相关规则。
创建规则时需检查 .agent/rules/ 目录是否存在、不存在则创建;检查该分类文件是否已存在:存在则追加新规则,不存在则以正确结构创建新文件。
适用场景:希望为用户或项目统一 AI 行为规范、固化个人偏好、组织规则文件时使用。限制:资料中未提供该技能的具体安装命令、收费或价格信息、以及可支持的具体平台,这些内容暂未提供。