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 内容生成/更新
Installs
22
Repository
syllr/skills
First Seen
Aug 25, 2026