用途:该技能用于衡量 SharePoint 文档库或列表的元数据质量,找出缺失、空白或占位值,并生成可执行的彩色 HTML 仪表板。它严格只读,只检查架构和读取条目,不会创建列、写入条目或修改列表。
主要能力:解析目标列表架构,确定需审计的必需列集合;逐条读取并评估每个审计列,将空值、纯空白、空多值/人员/托管元数据字段以及 N/A、TBD、pending 等占位值判为缺失;计算单条完整度、条目判定(Complete/Partial/Empty)、每列填充率、整体完整度(单元格级填充率)和按编辑者(回退作者)的分组汇总。
使用方式:当用户说“metadata audit”“metadata completeness”“missing metadata”“find blank columns”等触发语时激活。先确定范围(选中项所在库、指定库或当前库),用 get_list_schema 读取架构,用 list_items 分页读取全部条目,再生成自包含 HTML 报告并保存到当前站点合适文档库的 Metadata Reports 文件夹,文件名如 Metadata-Audit-<Library>-YYYY-MM-DD-HHMM.html,最后回复 Markdown 摘要和报告链接。
适用场景:需要检查 SharePoint 搜索、筛选、视图或保留策略失效原因时;需要按负责人分派元数据修复任务时;需要定期生成元数据健康报告时。
限制:严格只读,唯一写入是 HTML 报告文件及必要时创建 Metadata Reports 文件夹;不得编造条目、列或值;必须排除系统/内部列和标签列(如 ID、Title、LinkTitle、FileLeafRef、ContentType、Modified、Created、Author、Editor 等),除非用户明确要求,否则不将 Title/Name 计入完整度;必须分页读取整个库,工具失败时如实报告部分结果;HTML 报告必须完全自包含,无脚本、无外部资源,仅内联 CSS;完整度百分比以整数显示并保持一致。