doc-arch-rules
Installation
SKILL.md
doc-arch-rules — 文档架构规则与域 skill 生成器
定位
meta skill:把本仓库持有的模板(rule 模板 + skill 模板)同步为目标项目可被规则引擎/opencode 消费的产物。单一功能 = 生成/更新两类产物(触发即全量同步,见「何时使用」):
| 产物 | 来源(SSOT) | 落位(目标项目) | 更新语义 |
|---|---|---|---|
| omo rule(CONSTITUTION + 19 模板) | references/rule-templates/ |
.omo/rules/docs/(目录结构与模板树同构) |
按版本指纹:--check-meta 对比 → 需更新的才重生成,最新的跳过;"重建 " 强制重生成单个 |
| 域 skill(test-ops / deploy-ops / docs-align / test-tools / contract-export) | references/skill-templates/<name>/(薄壳单文件或整目录) |
.opencode/skills/<name>/ |
整目录落地(test-ops/docs-align 为薄壳单文件逐字落地;deploy-ops / test-tools / contract-export 为多文件模板:SKILL.template.md→SKILL.md + references/ + assets/ 原样复制,不探测上下文、无占位符填充);已有产物逐文件 diff 项目侧手工改动列给用户确认后再覆盖 |
不承载(完全独立):文档-代码对齐/漂移修复/文档初始化/globs 目录同步由 docs-align skill 承担——用户需要对齐文档、处理漂移、初始化文档、更新globs 时直接调 docs-align,不经本 skill、本 skill 不路由。docs/** 文档本体也不由本 skill 生成——项目无 docs/ 时由 docs-align 的初始化分支按 rule 从代码建文档,已有文档的维护由 rule 触发后的 AI 按 rule 内容生成/更新。
rule 工厂的输入输出:
- 输入:
references/rule-templates/下模板(1 个全局 Rule 源 + 19 个模板,清单见 §文件清单) - 输出:
.omo/rules/docs/下的 rule(一个模板对应一个 rule,目录结构与references/rule-templates同构) - 除 DEEP-DIVE/RESEARCH/CONTRACT/ADR/DOMAIN(globs:
docs/L2/domain/*.md目录级通配)目录级通配,及 INTEGRATION(globs 含docs/L3/integration-contracts/**)主文档(说明书)+目录通配混合外,其余 1:1 同构;目录级模板按 globs 通配覆盖,详见表 - 只生成 rule,不生成文档:宿主项目
docs/**由 rule 触发后的 AI 按 rule 内容生成/更新