init-rulebook

初始化规则手册

帮助用户在 ~/.agents/AGENTS.md 中维护自己的 Agent 指令，并可选择链接其他规则。设置期间可采用现有规则手册，也可创建新的规则手册。用户可以选择其他文件夹，包括项目文件夹。将其规则保存在此技能之外，以便技能更新时保留个人配置。

默认路径是此技能约定的路径。每个宿主都需要配置一条指向该路径的启动指令；请参阅宿主设置。保留宿主的指令层级和规则手册声明的适用范围。

模式

如果指定了模式，则使用指定模式。否则，启动、压缩恢复或明确的重新加载请求均推断为 load；只有请求与其他模式匹配时，才推断为其他模式。在执行设置或维护时，说明推断出的模式。这些是技能模式，不是 shell CLI。

模式	使用场景	完成条件
init-rulebook: setup	采用或创建默认规则手册；可选择自定义文件夹	已配置启动指针，并已检查新会话发现流程
init-rulebook: load	开始会话、压缩后恢复，或重新加载规则	已完整读取索引和所有当前适用的规则
init-rulebook: fine-tune	改进现有索引、分组、触发条件或规则措辞	已验证商定的编辑内容和具有代表性的加载场景
init-rulebook: link-dot-files	将存储在点文件中的规则手册连接到宿主或稳定的用户路径	链接或直接指针可解析到预期索引，且未替换其他文件
init-rulebook: update	刷新已安装的技能或由 Git 管理的规则手册	请求的源已更新，保留了本地更改，且 status 检查通过
init-rulebook: status	诊断发现流程、损坏的链接、缺失的规则或加载范围	已报告索引路径、清单、选中的规则和未解决的错误

对于 setup、fine-tune、link-dot-files 或 update，请阅读入门与维护。仅当用户需要规则集示例时，才阅读公开规则手册示例。启动和重新加载都不需要这两个参考文档。

解析索引

1. 使用当前请求中明确指定的路径；否则使用宿主的启动指针。接受 AGENTS.md 路径或包含该文件的文件夹。相对指针路径相对于声明该路径的文件解析；直接请求中的相对路径相对于其工作目录解析。明确请求仅为本次调用选择路径，不会改写持久指针。
2. 否则，使用 ~/.agents/AGENTS.md。展开主目录路径，解析符号链接，并检查可读性。load 期间绝不创建索引。
3. 如果索引缺失、相对路径的基准目录不明确，或存在互相冲突的持久指针且未明确指定路径，则报告问题并询问预期路径。不要搜索任意文件夹，也不要用仓库中的 AGENTS.md 替代。

在本次会话中保留选定的路径；压缩后或指针发生变化时重新解析。根据宿主的优先级，将项目指令与选定的规则手册一并应用。

加载并重新加载

首先阅读完整索引。遵循索引声明的结构，不要把此技能的示例标题套用到其他用户的规则上。

清单检查使用路径列表和文件系统元数据来检查文件是否存在、可读以及身份是否一致。打开规则内容之前，先根据索引选择适用规则；不要仅为验证清单而读取暂缓加载的规则内容。此读取边界同样适用于 status 和设置过程中的状态检查。

1. 如果索引要求枚举目录，或将发现的文件与索引中的链接进行比对，就执行该清单检查。无需出现“完整清单”这一措辞。报告缺失、孤立、重复或不可读的文件；不要悄然省略。使用索引指定的路径，并保持该路径原样。当索引指定 ~/.agents/rules/*.md 时，~/.agents 就是要检查的目录树。比较目录树身份时，应先展开主目录和相对路径并解析符号链接，再使用规范目录路径；不要只比较字面路径写法。例如，若 ~/.agents -> ~/.dotfiles/agents，则这两个目录树路径等价：通过写明的 ~/.agents/rules/*.md 路径枚举，不要改写路径。只有当解析后的清单目录树与所选索引的解析目录树不同时，才报告不匹配；不要扫描替代的 rules/ 目录或仓库中的 AGENTS.md。如果任一条路径无法解析或读取，就报告该错误，而不是假定二者相同或不匹配。如果索引未要求完整清单，则验证所有选定加载的引用规则路径，不要将无关文件视为错误。
2. 使用索引自身的适用性标签。加载“始终启用”组中的所有规则，以及每项文档所述触发条件与当前任务、环境或预期工具相符的条件规则。每个条件触发都必须有肯定证据；不要从某项操作的名称推断相关活动。例如，仅发布并不能证明涉及生产运维。如果索引定义了“始终启用”“激活”和“操作门控”等标题，就以这些标题作为分类方案；其他索引可能使用不同标签。遵循索引顺序。如果索引未分组，则遵循其加载说明；若规则手册只有一个文件，则完整读取。
3. 记录操作门控规则及其触发条件，但只有在即将执行匹配操作时才读取相应规则。更广泛的请求中提及未来操作，不会开启其门控。
4. 确认每个选定文件都已完整读取。加载规则与应用规则是两回事：遵守索引及规则所声明的范围和指令优先级。若清单检查或读取出错导致无法继续，应报告阻塞错误，不要声称已完整加载。

在会话开始时及上下文压缩后，重新执行此加载流程。将压缩前记住的文件内容视为已过期。用户任务发生变化时，重新评估条件标题，并在需要时即时打开新匹配的操作门控。除非用户要求查看状态、需要处理错误，或宿主要求显示技能使用通知，否则静默加载。

状态

应用与 load 相同的适用性选择和内容读取边界，然后报告所选索引、指针来源、清单错误、选中和暂缓的规则数量，以及是否实际测试了新会话发现。status 只读取文件，不修改文件。

行为评估

**仅供作者／审阅者使用：**使用场景目录评估此技能。正常使用规则手册时跳过此项。在全新的临时目录中准备每个案例，隐藏断言和路由标签，并记录文件读取和更改情况以供评分。该目录涵盖全部六种模式、加载失败、操作门控和模拟上下文压缩；预期断言不能作为运行通过的证据。虚拟主目录和宿主环境夹具绝不能更改真实用户的设置。