Agent skill

Docs Governance

by qshanx in qshanx/docs-governance

作为面向长期 AI 协作项目的知识、决策与验证治理总入口,把优秀 Agent 的一次性工作沉淀为可继承、可验证、可持续演进的项目集体能力;根据用户意图把任务路由到活文档、领域上下文与 ADR、变更影响、接口契约、测试资产、模块回归或闭环设计能力,并在大型变更中组织正确顺序。用于用户只说“文档治理”“项目治理”“帮我整理项目知识”“改完怎么收尾”而未指定具体…

MITAuto-check passedDevelopment

Install Docs Governance

skills CLI
$ npx skills add qshanx/docs-governance --skill docs-governance -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install qshanx/docs-governance docs-governance --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/qshanx/docs-governance.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/docs-governance .claude/skills/docs-governance && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
docs-governance
GitHub stars
134
Token cost
~485 tokens
SKILL.md length
112 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

作为面向长期 AI 协作项目的知识、决策与验证治理总入口,把优秀 Agent 的一次性工作沉淀为可继承、可验证、可持续演进的项目集体能力;根据用户意图把任务路由到活文档、领域上下文与 ADR、变更影响、接口契约、测试资产、模块回归或闭环设计能力,并在大型变更中组织正确顺序。用于用户只说“文档治理”“项目治理”“帮我整理项目知识”“改完怎么收尾”而未指定具体…

  • Works in 6 steps: 用 change-impact 形成有证据的影响清单。 → 若涉及难回退的架构、数据库、认证或部署决策,先用… → 若影响跨端接口,先用 contract-first 更新唯一契约源。 → …
  • Tasks that involve Architecture decision records
  • SKILL.md covers 定位, 单项路由, 大型变更顺序 and 边界
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Docs Governance is an agent skill from qshanx/docs-governance. 作为面向长期 AI 协作项目的知识、决策与验证治理总入口,把优秀 Agent 的一次性工作沉淀为可继承、可验证、可持续演进的项目集体能力;根据用户意图把任务路由到活文档、领域上下文与 ADR、变更影响、接口契约、测试资产、模块回归或闭环设计能力,并在大型变更中组织正确顺序。用于用户只说“文档治理”“项目治理”“帮我整理项目知识”“改完怎么收尾”而未指定具体 Skill,或需要跨多项治理能力时。English triggers: docs governance router, project knowledge governance, documentation workflow, governance workflow.

Its SKILL.md is about 490 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Architecture decision records. The repository describes itself as: Claude Code、Codex 与 ChatGPT 的文档驱动开发治理插件:防文档腐烂、维护上下文与决策、契约协作、测试与回归证据。 The licence is MIT.

When your agent uses it

  • Tasks that involve Architecture decision records

Example prompts

  • “帮我整理项目知识”
  • “改完怎么收尾”
  • “/docs-governance”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. 用 change-impact 形成有证据的影响清单。
  2. 若涉及难回退的架构、数据库、认证或部署决策,先用 context-and-decisions 建立或更新 ADR。
  3. 若影响跨端接口,先用 contract-first 更新唯一契约源。
  4. 实施后用 test-collaboration 将成功标准、Bug 或风险关联到 TEST-ID 与证据。
  5. 用 module-regression 执行本模块与下游命令。
  6. 用 living-docs-governance 做阶段同步,再运行只读文档审计。

What it can do on your machine

Read from SKILL.md and the folder at commit 520696e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Docs Governance loads about 485 tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 112 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~83
When it runs · the whole SKILL.md, loaded when a task matches
~485

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from qshanx/docs-governance at commit 520696e, republished under its MIT licence (© qshanx). 112 words, ~485 tokens.

Download SKILL.mdSave it as .claude/skills/docs-governance/SKILL.md (or your agent's skills folder).
name
docs-governance
description
作为面向长期 AI 协作项目的知识、决策与验证治理总入口,把优秀 Agent 的一次性工作沉淀为可继承、可验证、可持续演进的项目集体能力;根据用户意图把任务路由到活文档、领域上下文与 ADR、变更影响、接口契约、测试资产、模块回归或闭环设计能力,并在大型变更中组织正确顺序。用于用户只说“文档治理”“项目治理”“帮我整理项目知识”“改完怎么收尾”而未指定具体 Skill,或需要跨多项治理能力时。English triggers: docs governance router, project knowledge governance, documentation workflow, governance workflow.

文档治理总路由

定位

把优秀 Agent 的一次性工作,沉淀为项目可继承、可验证、可持续演进的集体能力。

本插件不是让 Agent 多写文档,而是治理长期 AI 协作中的项目知识、关键决策与验证证据:让后续 Agent 能恢复上下文、沿用已确认约束、复核结果,并把新的有效做法继续沉淀回项目。

先判断意图,再读取并执行对应 Skill。不要在本路由复制各 Skill 的方法论。

单项路由

用户意图路由到
生成、精简或审查 AGENTS.md / CLAUDE.md,明确项目规范和产品读取入口agent-entrypoints
产品文档管理员、来源登记、需求池/编号/版本、十阶段管理与产品审查product-evolution;Claude Code 可由 product-docs-manager 执行
新项目、讨论后项目或已有项目首次配置产品文档包与 Agent 入口living-docs-governance 的“统一 setup”模式;Claude Code 使用 /governance-setup,/governance-init 是兼容别名
维护、阶段同步、LOG 管理或复盘living-docs-governance
当前 Module 权责、状态归属、依赖图或核心流转图living-docs-governance 的 ARCHITECTURE.md 路线
领域术语、CONTEXT.md、架构或数据库决策、ADRcontext-and-decisions
修改前判断牵连面、迁移、回滚、实施后对照change-impact
前后端或服务间接口contract-first
测试资产、成功标准证据、Bug→TEST-IDtest-collaboration
修改后验证本模块及下游module-regression
只读文档审计、链接完整性、孤儿文档living-docs-governance 的审计模式
设计可判定目标和反馈回路loop-design-check

大型变更顺序

需求不清、基线冲突或需要产品过程管理时,先进入 product-evolution,明确已确认范围与成功标准,再进入工程变更。

按需执行,未触发的步骤直接跳过:

  1. 用 change-impact 形成有证据的影响清单。
  2. 若涉及难回退的架构、数据库、认证或部署决策,先用 context-and-decisions 建立或更新 ADR。
  3. 若影响跨端接口,先用 contract-first 更新唯一契约源。
  4. 实施后用 test-collaboration 将成功标准、Bug 或风险关联到 TEST-ID 与证据。
  5. 用 module-regression 执行本模块与下游命令。
  6. 用 living-docs-governance 做阶段同步,再运行只读文档审计。

边界

  • 让 CLAUDE_MAP.md 管项目知识位置,让 ARCHITECTURE.md 管当前 Module 结构;本 Skill 只管插件能力路由。
  • 让 Spec/Issue 管业务成功标准,Issue Tracker 管任务状态和排期;不要复制进路由或数据库。
  • 不因为用户说“治理”就一次性创建所有可选文档和目录。先发现现有事实载体,再按预警信号懒创建。

© qshanx, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/docs-governance of qshanx/docs-governance.

Open the folder on GitHubat commit 520696e

Compare with similar skills

Docs Governance next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Docs Governance compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docs Governance this skillqshanx/docs-governance134—~485Automated safety check: PassMIT
Create Vibe Featuremistralai/mistral-vibe5.1k—~1.2kAutomated safety check: PassApache-2.0
Grill With Docsmeain/dotfiles28520 repos~875Automated safety check: PassMIT
Rememberantonio-orionus/Arroxy391—~571Automated safety check: PassMIT
Grounding A Designandrew-blake/melcloudhome142—~1.1kAutomated safety check: PassMIT
Plan TreeSeemSeam/claude_codex_bridge3.6k—~6.3kAutomated safety check: PassCustom licence

Similar skills

  • Create Vibe Feature

    mistralai/mistral-vibe

    Official

    Guides feature work in the Mistral Vibe Python CLI so each change lands in the right module and matches the project's architecture decision records.

    5.1k GitHub stars~1.2k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Grill With Docs

    meain/dotfiles

    Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise.

    285 GitHub starsUsed in 20 repos~875 tokens
    DevelopmentAuto-check passed
  • Remember

    antonio-orionus/Arroxy

    Persists a durable Arroxy lesson — a gotcha, user preference, workflow rule, or design decision — to the right tracked file (project memory, AGENTS.md, CONTEXT.md, dev-docs, or an ADR) so any coding…

    391 GitHub stars~571 tokensUpdated today
    DevelopmentAuto-check passed
  • Grounding A Design

    andrew-blake/melcloudhome

    A skill your agent uses when about to propose, brainstorm, review or revise a design, fix approach or plan for a feature or behaviour change in this repo, including "brief" or "quick" design…

    142 GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Plan Tree

    SeemSeam/claude_codex_bridge

    Maintain a structured planning document tree made of roadmap/status files, implementation status or handoff TODO files, topic notes, decision records, open questions, ideas/inspiration pools, and…

    3.6k GitHub stars~6.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Brainstorming

    feiskyer/claude-code-settings

    Explore user intent, requirements, and design options through collaborative dialogue before implementation.

    1.7k GitHub stars~985 tokensUpdated 12 days ago
    DevelopmentAuto-check passed

More from qshanx/docs-governance

All 10 skills in this repo
  • Agent Entrypoints

    qshanx/docs-governance

    根据项目事实与已确认讨论生成、精简或审查 AGENTS.md / CLAUDE.md,明确共享规则主文件、可执行约束、PRD / Spec 读取路标和验证入口。用于项目入口只有空模板、规范含糊、双入口冲突或需要设置 Agent 项目说明时。English triggers: AGENTS.md, CLAUDE.md, project instructions, agent entrypoint…

    134 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Module Regression

    qshanx/docs-governance

    大项目模块间联动回归——一份 REGRESSION.md 回归台账登记"每个模块的下游消费者 + 可执行的回归验收命令",每次改动后照台账跑回归审计,防"改一个模块悄悄弄坏其他模块"。判决靠退出码,不靠 AI 看着没问题。中文触发:模块回归、回归台账、回归审计、改A坏B、模块联动检查、影响面检查、模块牵连、下游验证、大项目改动检查。English triggers: module…

    134 GitHub stars~811 tokensUpdated today
    Auto-check passed
  • Contract First

    qshanx/docs-governance

    分前端/后端(或多个服务)多端开发的项目,用 CONTRACT.md 指向的唯一机器契约,各端只照它各做各的,防止字段漂移导致集成时白屏。支持单会话多 agent 和多终端各自跑两种模式。只要项目有前后端/多服务、接口字段老对不上、各端联调卡住、某端改了字段忘了通知别人、或前端为渲染一个页面要调一堆接口拼数据,就用这个…

    134 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Living Docs Governance

    qshanx/docs-governance

    把长期项目的文档当成一个小系统来维护,防止文档腐烂——四份各司其职的脊柱文件(CLAUDE.md 共享章程 / CLAUDEMAP.md 地图 / PROJECTSTATUS.md 健康仪表盘 / PROJECTLOG.md 流水账)+ Codex 的 AGENTS.md 入口桥接 + 固定读序,并按需连接 ARCHITECTURE、CONTEXT、ADR、契约、测试、回归和 Issue…

    134 GitHub stars~4.1k tokensUpdated today
    Auto-check passed
  • Loop Design Check

    qshanx/docs-governance

    把一个任务"写成"一个目标导向的 loop,并"检查"这个 loop 写得对不对、会不会跑飞——防止空转烧钱 / Goodhart 作弊 / 把错的干到底。两个动作:① 写 loop(先做减法判该不该建 → 定可判定目标 → 选回路类型 → 选骨架)② 体检 loop(过五个崩法 + 可判定性 + 边界 + 降级 + judge 独立 + 判断留人红线)。中文触发:写 loop、设计…

    134 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Product Evolution

    qshanx/docs-governance

    在 docs 下建立或维护产品管理入口,登记材料来源,统一需求编号、状态与修订,连接需求池、单需求、版本及验收复盘,并只读审查需求演变是否可追溯。用于产品文档管理员、PRD 版本混乱、产品进展难以理解、已确认决定未回写或需要产品文档审查时。English triggers: product documentation manager, product evolution, PRD…

    134 GitHub stars~2.1k tokensUpdated today
    Auto-check passed

Questions about Docs Governance

What does Docs Governance do?

作为面向长期 AI 协作项目的知识、决策与验证治理总入口,把优秀 Agent 的一次性工作沉淀为可继承、可验证、可持续演进的项目集体能力;根据用户意图把任务路由到活文档、领域上下文与 ADR、变更影响、接口契约、测试资产、模块回归或闭环设计能力,并在大型变更中组织正确顺序。用于用户只说“文档治理”“项目治理”“帮我整理项目知识”“改完怎么收尾”而未指定具体…. Docs Governance is an agent skill from qshanx/docs-governance. 作为面向长期 AI 协作项目的知识、决策与验证治理总入口,把优秀 Agent 的一次性工作沉淀为可继承、可验证、可持续演进的项目集体能力;根据用户意图把任务路由到活文档、领域上下文与 ADR、变更影响、接口契约、测试资产、模块回归或闭环设计能力,并在大型变更中组织正确顺序。用于用户只说“文档治理”“项目治理”“帮我整理项目知识”“改完怎么收尾”而未指定具体 Skill,或需要跨多项治理能力时。English triggers: docs governance router, project knowledge governance, documentation workflow, governance workflow.

When should I use Docs Governance?

Docs Governance fits situations like: tasks that involve Architecture decision records.

How do I install Docs Governance in Claude Code?

Run `npx skills add qshanx/docs-governance --skill docs-governance -a claude-code`. Or copy the skill folder (skills/docs-governance in qshanx/docs-governance) into .claude/skills/docs-governance in your project. Claude Code loads it when a task matches its description.

How do I install Docs Governance in Codex?

Run `npx skills add qshanx/docs-governance --skill docs-governance -a codex`. Or copy the skill folder (skills/docs-governance in qshanx/docs-governance) into .agents/skills/docs-governance in your project. Codex loads it when a task matches its description.

Can I use Docs Governance in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add qshanx/docs-governance --skill docs-governance -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/docs-governance, .gemini/skills/docs-governance, .github/skills/docs-governance and .opencode/skills/docs-governance in your project.

What does Docs Governance need to run?

SKILL.md names no scripts, command-line tools or credentials: Docs Governance is instructions for the agent only.

Does Docs Governance access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Docs Governance safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Docs Governance use?

Docs Governance is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Docs Governance use?

About 485 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Docs Governance?

Skills that share tags, products or a category with Docs Governance: Create Vibe Feature (mistralai/mistral-vibe, 5.1k stars), Grill With Docs (meain/dotfiles, 285 stars), Remember (antonio-orionus/Arroxy, 391 stars) and Grounding A Design (andrew-blake/melcloudhome, 142 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docs Governance?

qshanx (a GitHub user) maintains it in qshanx/docs-governance, which has 134 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 9, 2026.

Source: qshanx/docs-governance on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.