SuperAPI AI 工具集

discover-docs-norms

写作与研究

查看项目

更新于 10-16 06:50

技能介绍

用途:在项目文档治理前,先发现并提案项目级文档规范(路径、命名、front-matter、生命周期),产出供团队评审的候选方案,不执行规范落盘。

主要能力:扫描 docs/(不存在则扫描仓库内 Markdown),提取 artifact_type、命名模式、日期模式与目录分布;推导 artifact_type 到 path_pattern 的候选映射、命名规则、front-matter 最小字段集;对规则打分(0-100),标记低置信度(<70)与冲突项,给出冲突裁决与迁移建议。

使用方式:输入项目路径(默认当前仓库),可选 docs 根路径与置信度阈值;输出 docs/calibration/docs-norms-proposal.md,含规则表(rule_kind:path/naming/lifecycle、pattern、evidence_files、confidence)、与现状差异、迁移建议、决策问题清单。提案确认后交给 define-docs-norms 落盘。

适用场景:首次治理前识别现有约定、规范争议时生成候选方案、多团队先统一候选规范再决定是否写入。

限制:不创建或更新 docs/ARTIFACT_NORMS.md,不整理或移动文件结构,不伪装成已生效规范,不做合规评估与健康评分。其他技能负责:define-docs-norms(规范落盘)、tidy-repo(结构整理)、assess-docs(合规与就绪评估)。示例:仅发现提案后由 define-docs-norms 固化;存在 docs/design/ 与 docs/design-decisions/ 等冲突目录时输出裁决建议与迁移清单。具体命令与安装方式暂未提供。