Module Governance 是一个编排型技能,用于将模块级工作规则连接到已有的领域语言、契约和决策。它本身不是第二套领域驱动设计(DDD)方法论,也不是自动文档生成器。
用途: 该技能用于在实现新业务模块、记录现有模块,或处理已确认的职责变更时,建立或维护模块本地的智能体指令、领域上下文链接和接口归属。它帮助确保模块级规则与项目整体知识体系一致,并复用已有的知识来源。
主要能力:
- 在创建文档前发现模块边界:读取适用的项目及祖先级工作指令、现有地图、需求、相关代码和契约,识别模块的职责、非职责、状态归属和实际消费者。仅凭目录名称不能确立限界上下文。
- 区分项目级规则与局部规则:项目级指令源负责全局约束、模块导航和跨模块协作;局部 AGENTS.md 仅负责额外的模块约束,如职责、状态归属、公共接口指针和验证入口。局部规则不能豁免项目级约束。
- 复用现有知识所有者:将稳定术语和概念关系交由 context-and-decisions 管理,难以逆转的决策交由 architecture-decision-records,跨边界机器可检查接口交由 contract-first,文档导航和生命周期交由 living-docs-governance,受影响的消费者和边界变更证据交由 change-impact。按需加载相应技能,不重复其方法。
- 仅维护经授权的记录:在用户请求的模块工作范围内,更新最小的缺失局部规则和已确认的上下文条目。使用 living-docs-governance 处理受影响的导航和生命周期更新,并保留其对新的顶层产物的审批要求。不创建空文件以满足配额。
- 验证语义和链接:将每个声称的所有者、接口和约束与代码、规范契约和可执行证据进行比对。报告矛盾以供所有者解决,而不是仅为了匹配偶然实现而重写规则。从每个引用文档的目录解析相对链接,并运行 docs-governance 技能的只读链接检查:python3 <docs-governance-skill>/scripts/audit-docs.py --root <repository> --scope modules --module <module-directory>。确认审计扫描了更改的本地指令、上下文和导航,检查链接结果和退出码,修复损坏的引用并重新运行。
使用方式: 当用户要求实现新的业务模块、记录现有模块或维护已确认的职责变更时,技能会被激活。它首先发现边界,然后分离项目级与局部规则,复用现有知识所有者,仅维护经授权的记录,最后验证语义和链接。对于设计讨论或仅审计,只进行检查和报告,不创建文件。基于意图的选择不是后台钩子,不授予对无关代码、提交、推送或业务选择的权限。
适用场景:
- 实现新的业务模块(例如:“实现一个库存模块”):检查现有边界;仅为真正新的约束添加局部规则;复用领域术语表和 API 契约;从现有导航链接它们;验证代码和源相对链接。
- 记录现有模块或维护已确认的职责变更。
- 授权模块变更需要本地指令和规范知识指针时。
限制:
- 不适用于普通 bug、样式变更、边界不变的内部重构,或仅继承父约定的新目录/UI 组件。
- 不适用于单独的设计讨论或审计:只检查并报告,不创建文件。
- 不生成完整的 DDD 转换,不自动生成文档,不重复全局约束、术语表定义、契约或 ADR 理由。
- 不安装钩子或声称自动加载嵌套文件,除非有真实的工作框架接线。
- 交付内容为工作规则和知识入口,而非完整的领域驱动设计实现。