SuperAPI AI 工具集

assess-docs-links

写作与研究

查看项目

更新于 10-16 06:50

技能介绍

用途:检查文档之间的链接关系,识别坏链、孤立文档、循环与深链风险,输出一份可修复的链接健康报告,用于发布前链接巡检或文档迁移后的回归检查。

主要能力:扫描 Markdown/Wiki 链接并构建有向图;检测 broken/orphan/cycle/depth 四类问题;汇总风险等级与修复建议;报告包含 front-matter 及摘要、断链、孤儿文档、循环引用、深链路径等章节;末尾附带机器可读的 YAML 块,含 broken[]、orphans[]、cycles[]、deep_chains[]。断链条目含 source_path、target_ref、kind(404 / anchor_missing / external_unreachable);孤儿条目含 doc_path、inbound_count=0、suggested_link_target。

使用方式:输入 docs 根路径,可选路径过滤与深度阈值(默认 4)。技能按规范解析路径:若项目规范声明了 doc-link-health artifact_type 的 path_pattern,则使用项目值,否则回退到默认路径 docs/calibration/doc-link-health.md。

范围与限制:仅负责文档图健康,不负责规范合规、代码对齐与 SSOT 审计;不修改文档文件;不检查外部 URL 可达性,仅标记。具体调用命令、平台与收费信息暂未提供。