qshanx/docs-governance

qshanx/docs-governance · AGENTS.md

qshanx/docs-governance · CLAUDE.md

qshanx/docs-governance · skills/documentation/agent-entrypoints/SKILL.md · 创建、优化或审查项目及模块级 AGENTS.md / CLAUDE.md 等 Agent 入口文档时使用。根据项目事实精简规则、设置按需读取指针，支持模块两入口布局，并检查规则是否可执行、入口是否冲突。

qshanx/docs-governance · skills/documentation/agent-workflow-governance/SKILL.md · 用户要求整体检查项目治理规则的承载位置、精简常驻约束，或判断散落资料能否沉淀为 Skill、脚本或 Hook 时使用。只读识别主源、重复工作流与自动化缺口，给出证据和最小建议；单项文档维护直接使用已有专项 Skill。

qshanx/docs-governance · skills/documentation/architecture-docs/SKILL.md · 判断项目是否需要架构文档，或生成、完善、审查 ARCHITECTURE.md 及已有架构说明。用于模块分工、状态归属、依赖关系或核心流程需要梳理时；依据项目证据记录结构，区分当前实现与已确认设计。

qshanx/docs-governance · skills/documentation/context-and-decisions/SKILL.md · 兼容旧 context-and-decisions 调用；领域术语与 ADR 的形成和修改统一转交随插件提供的 domain-modeling。

qshanx/docs-governance · skills/documentation/docs-audit/SKILL.md · 只读审计现有项目文档，检查资料散乱、入口难找、断链、内容过时、重复主源及当前与历史混用。用于用户要求“审计文档”“检查文档是否过时”“看看文档哪里乱”，或阶段交接前检查文档体系时。

qshanx/docs-governance · skills/documentation/docs-governance/SKILL.md · 作为面向长期 AI 协作项目的知识、决策与验证治理总入口，把优秀 Agent 的一次性工作沉淀为可继承、可验证、可持续演进的项目集体能力；根据用户意图把任务路由到活文档、领域上下文与…

qshanx/docs-governance · skills/documentation/docs-maintenance/SKILL.md · 每轮任务结束时同步本次变化涉及的文档。由项目收尾约定或用户要求“同步文档”“收尾”“准备交接”时调用；也用于处理已发现的文档与项目事实冲突。

qshanx/docs-governance · skills/documentation/docs-retro/SKILL.md · 从对话、文档变更及审计记录中复盘文档管理的问题和经验，减少资料难找、同步遗漏、重复维护和旧说明误用。用户要求“复盘文档管理”“为什么文档总漏更新”“总结文档治理经验”，或项目约定文档管理阶段复盘时使用；默认只读，输出有证据、适用条件和落点的…

qshanx/docs-governance · skills/documentation/docs-structure/SKILL.md · 规划、整理或只读审查项目文档结构时使用。按职责聚合同类资料，明确当前主源、历史归档与按需读取入口。

qshanx/docs-governance · skills/documentation/domain-modeling/SKILL.md · Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a CONTEXT.md…

qshanx/docs-governance · skills/documentation/living-docs-governance/SKILL.md · 为新项目或尚未建立文档管理体系的已有项目，规划并建立文档入口、资料分工和维护方式。 用户要求“建立文档管理体系”“首次配置文档治理”时使用；暂保留只读文档审计、日志统计与归档。 单独优化 Agent 入口、日常同步或执行复盘，交给对应…

qshanx/docs-governance · skills/documentation/module-governance/SKILL.md · 为新业务模块建档、补齐已有模块约定或维护模块边界变化。用户提出新建核心模块、补齐模块文档或调整模块职责时可按意图选择，无须点名 Skill；区分项目级与模块级 AGENTS，关联 CONTEXT、接口与决策，复用现有治理…

qshanx/docs-governance · skills/documentation/product-evolution/SKILL.md · 在 docs 下建立或维护产品管理入口，登记材料来源，统一需求编号、状态与修订，连接需求池、单需求、版本及验收复盘，并只读审查需求演变是否可追溯。用于产品文档管理员、PRD…

qshanx/docs-governance · skills/documentation/writing-for-agents/SKILL.md · Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

qshanx/docs-governance · skills/engineering/change-impact/SKILL.md · 在改代码、数据、接口或治理文档前做有证据的影响分析，并在实施后把计划影响与实际 diff 对照；覆盖代码调用、数据/Schema、API 契约、测试、文档、ADR、部署、迁移和回滚。用于跨模块修改、高风险变更、数据库迁移、认证、公共接口、用…

qshanx/docs-governance · skills/engineering/contract-first/SKILL.md · 也适用于同一进程内存在明确消费者、提供者和公共接口且有漂移风险的业务模块；按实际边界验证公开签名与行为，无网络边界时不要求序列化证据。 分前端/后端（或多个服务）多端开发的项目，用 CONTRACT.md…

qshanx/docs-governance · skills/engineering/loop-design-check/SKILL.md · 把一个任务"写成"一个目标导向的 loop，并"检查"这个 loop 写得对不对、会不会跑飞——防止空转烧钱 / Goodhart 作弊 / 把错的干到底。两个动作：① 写 loop（先做减法判该不该建 → 定可判定目标 → 选回路类型…

qshanx/docs-governance · skills/engineering/module-regression/SKILL.md · 大项目模块间联动回归——一份 REGRESSION.md 回归台账登记"每个模块的下游消费者 + 可执行的回归验收命令"，每次改动后照台账跑回归审计，防"改一个模块悄悄弄坏其他模块"。判决靠退出码，不靠 AI…

qshanx/docs-governance · skills/engineering/test-collaboration/SKILL.md · 盘点并维护项目测试资产，把需求、业务规则、风险、Bug 和跨端接口契约转成 TEST-ID 与可验证证据，生成或更新 TESTS.md。用于测试资产盘点、测试缺口分析、单元/集成/契约/E2E/冒烟分类、Bug…