自定义指令与规则

自定义指令用于约束回答方式、编码风格、测试要求与工作流程。既可以在界面配置所有模式共享的指令，也可以把规则保存为可审查、可版本控制的文件。规则是给模型的指导，不是强制安全边界。

什么是自定义指令

例如“修改前检查现有测试”“公开函数补充文档”“不要输出密钥”“先解释方案再编辑”。写明可以验证的要求，避免重复、冲突和含糊的口号。敏感凭据不应写入规则。

设置方法

所有模式共享的指令

在 AiGo123 的模式或提示配置入口找到所有模式的自定义指令，填写并保存。特定模式的要求应放在该模式的自定义指令或规则目录中。

全局规则目录

全局规则自动应用于所有项目。Linux/macOS 使用用户主目录下的 .aigo123/rules/，Windows 使用 %USERPROFILE%\.aigo123\rules\。模式规则位于 .aigo123/rules-{modeSlug}/。目录位置由扩展确定，不通过文档中的配置自定义。

目录结构

用户目录/.aigo123/
  rules/
    01-coding-standards.md
    02-security.md
  rules-code/
    typescript.md
项目目录/.aigo123/
  rules/
    01-project.md
  rules-code/
    tests.md

设置全局规则

1. 在用户主目录创建 .aigo123/rules/。
2. 创建 01-coding-standards.md，写入通用规范，例如先检查项目约定、新功能补测试、不得提交凭据。
3. 创建 .aigo123/rules-code/，写入只对代码模式生效的规范。
4. 在项目 .aigo123/rules/ 中补充项目专属要求，打开新任务核对指令是否加载。

# 通用编码规范
1. 先阅读项目约定和相关测试。
2. 为新增功能编写回归测试。
3. 不修改任务范围之外的文件。
4. 对未执行的验证明确说明。

可用规则目录

rules/ 对所有模式生效；rules-code/、rules-architect/、rules-debug/ 分别用于相应内置模式；rules-{slug}/ 用于任意自定义模式，目录后缀必须匹配模式标识。

规则加载顺序

先加载全局规则，再加载项目规则。按文件名排序，数字前缀方便表达顺序。项目要求在语义冲突时优先，但规则文本是组合发送，不是配置对象合并；避免互相矛盾。模式专属规则只在对应模式使用。

项目级指令

项目共享规则首选 .aigo123/rules/，模式专项规则首选 .aigo123/rules-{modeSlug}/。将项目规则纳入版本控制以便团队共享，不要将个人密钥或私有路径提交。

兼容旧规则文件

本地实现仍兼容旧 .roorules、.roorules-{modeSlug} 及部分 .clinerules 回退路径，这些是历史文件名而不是新品牌目录。新配置使用 .aigo123 目录；不要机械改成扩展不读取的新单文件名。

模式专属指令

例如在 .aigo123/rules-code/testing.md 规定测试命令，在 rules-architect/ 中规定设计文档格式。更改模式 slug 时同步规则目录，否则规则可能不再加载。

指令如何组合

系统角色、模式指令、所有模式共享指令和文件规则共同影响任务。通用规则与模式规则可以同时存在。保持内容短而具体，说明冲突解决方式；不依赖规则去绕过工具审批。

规则文件约定

• 优先采用规则目录；若目录中加载到规则，则不会再重复加载对应旧单文件回退。
• 使用清晰文件名，避免把生成产物、二进制文件或无关长文放入规则目录。
• 目录遍历与子目录规则行为以当前扩展设置为准，不保证所有任意子目录自动成为规则。
• 规则管理的创建和删除直接操作磁盘；保存前备份重要文件。

AGENTS.md 支持

启用相应支持后，可通过项目 AGENTS.md 提供团队约定。与 .aigo123 规则保持一致；项目根目录和祖先目录的适用范围应根据实际工作目录核对。不要把重复说明写入多个文件后相互覆盖。

示例

回答使用简体中文。
修改前说明涉及文件与风险。
遵守已有代码风格，不进行无关重构。
完成后列出实际运行的测试及未验证项。
不要输出或提交凭据。

结合自定义模式

角色负责说明“做什么”，工具组限制“可以用什么”，规则描述“如何完成”。三者组合才能形成清晰工作流程。参见 自定义模式 与 使用模式。