用途:在目标 best-practice skill 目录内创建和强化 rules/*.md,针对具体 Bitrix 实体或分层编写规则文件,并保持与 rules/controller.md、rules/routing.md 相同的质量水平。不用于通用 Markdown 指南、Bitrix 代码指南或全部项目 skill 结构说明。
主要能力:为特定 Bitrix 实体或层写新 rule 文件;把已有 rule 文件强化为 AI-first 格式;避免在同一文件中混入相邻抽象;按规范章节组织内容,先写规则,再写示例,最后写二元(是/否)自检清单;为复杂主题补充多个 ## Example N,覆盖独立决策点、边界情况、兼容路径与例外。
使用方式:先确定目标目录(含 SKILL.md 与 rules/);若路径不明确且有多个候选,先向用户确认。创建或重写前需阅读目标目录的 SKILL.md、rule-file-standard.md、rule-file-example-minimal.md;复杂主题再读 rule-file-example-complex.md;若 SKILL.md 使用手动 router,读 skill-router-entry-example.md;若目标 rules/*.md 已存在则通读,并读 1-2 个同层相邻 rule 文件。随后界定该 rule 的实体与边界,区分应留在本文件与应留在相邻 rules 的内容,按 canonical sections 组织,默认用 minimal 示例形式,复杂主题用 complex 形式。若 SKILL.md 有“何时阅读 rules/...”的 router 块,需为新文件添加正确 trigger 块使其可被发现。
限制:不要更新 SKILL.md 或目标目录内其他 skill 文件,除非用户单独要求。不要猜测:当新 rule 同等程度横跨两个抽象、项目约定与框架最佳实践冲突且优先级不明、或用户实际想改 skill-router 或全局模板时,应停下并询问。规则须可操作,能导向具体代码或评审决策;示例须自包含并说明所演示的规范;优先以本 skill 的 reference 文件为标准来源,而非目标目录中随机的现有 rule 文件。