..

scripts 文档工具脚本入口

目录用途

scripts/ 用于存放文档校验、导出、图表处理与治理辅助脚本。

常用脚本

  • doc-toolkit.sh:文档创建/校验/导出工具
  • check-marksman.shMarksman 环境检查
  • precommit-validate-markdown.sh:提交前 Markdown 逐文件校验
  • process-mermaid.shMermaid 图表处理
  • unified_export.shquick_unified_export.sh:统一导出

AI 治理脚本

  • check-ai-doc-governance.sh:检查目录索引、主文档元数据与 AI 维护资产完整性
  • generate-archive-tag-index.sh:生成 Archive 标签索引(来源、用途、可信级别)
  • ai-weekly-audit-diff.sh:生成 AI 抽检差异清单(口径与编号差异)

使用建议

  • 本地快速校验:make validate-file FILE=<目标文件>
  • 跨文档校验:make check-linksmake validate-mermaid
  • 提交前演练:pre-commit run --files <变更文件>