AgentSkillsCN

system governance

当您需要明确权限归属、解决冲突、追踪 governed_by 链条,或验证某一文档的治理规则时,可使用此工具。

SKILL.md
--- frontmatter
name: system governance
description: Use when you need to understand authority, resolve conflicts, trace governed_by chains, or validate what governs a document.

Purpose

Navigate and apply the documentation governance system to ensure edits respect authority chains and SSOT principles.

Scope

Covers the governed_by DAG, authority model, conflict resolution, and validation procedures. Does not cover runtime-specific mechanics (see system-context-mechanics) or task state (see system-objective-state).

Minimal Path

  1. Before editing any doc, check its governed_by frontmatter to identify constraints.
  2. Run just docs-index to visualize the governance DAG if relationships are unclear.
  3. If a conflict exists between docs, apply docs/system/procedure/resolving-conflicts.md.
  4. If creating a new doc, ensure it declares governed_by per the appropriate model doc.
  5. Run just docs-validate to verify all linkages are correct.

Validation

  • just docs-validate passes with no errors.
  • Every doc has a valid governed_by chain to a root authority.
  • No circular references exist in the DAG.

Failure Modes

  • Editing a doc without checking what governs it (authority violation).
  • Creating orphan docs with no governed_by declaration.
  • Duplicating content instead of linking (SSOT violation).

References

  • docs/system/governance.md: Master governance definition
  • docs/system/authority-model.md: Authority layer definitions
  • docs/system/procedure/resolving-conflicts.md: Conflict resolution procedure
  • docs/system/procedure/validating-doc-contracts.md: Validation procedure