用途：评估文档信息架构是否便于读者找到所需内容、理解所处位置并高效导航。输出的是架构评估与具体重构建议，不是新写内容。适用于重构文档、新增章节或文档类型、用户反馈“知道有文档但找不到”、文档自然膨胀需梳理、在文档完整性审计后补缺前确认结构可容纳新内容，以及定期复查导航与可发现性。
工作流分五阶段：阶段0确定文档集主要1-3个读者画像并记录冲突；阶段1绘制现状结构，包括文件树、导航方式、入口点与链接图；阶段2按七项启发式评分——可发现性、层级一致性、渐进披露、交叉链接质量、模式一致性、关注点分离、维护负担，其中机械部分由链接图JSON驱动确定性打分，判断密集型部分由子代理按启发式分派评估；阶段3对比结构与用户心智模型（任务型、功能型、角色型、时间型），识别不匹配信号；阶段4产出评审报告，含按画像的评分表与总分、架构等级及逐画像发现。
必要用法：分析链接图可运行 python3 skills/doc-architecture-review/scripts/link_graph.py --scope all --json > graph.json，或去掉 --json 输出可读格式；脚本给出孤立页、死胡同、互链比例、枢纽页与断链。评估时加载 references/personas.md 与 references/ia-heuristics.md，使用 find 生成文档文件树。
限制：评分依赖文档集实际内容与结构；部分启发式对参考类文档可用 N/A；跨画像需求冲突只显式提出而不做平均；具体文档路径与命令须按实际仓库调整。未提供关于安装、收费、平台或其他使用步骤的信息。