用途：在受管理的技能库工作区中，将工作区文档与技能目录保持同步，适用于新增、删除或整理技能之后重新生成 README.md 和 WORK_AREAS.md。
主要能力：通过 CLI 重新生成文档；支持 --dry-run 预览将要发生的变更；支持 --format json 输出结构化结果，便于自动化流水线使用，其中包含 currentlyInSync 字段，用于判断文档是否已是最新。
使用方式：先预览变更，运行 npx ai-agent-skills build-docs --dry-run；确认后重新生成，运行 npx ai-agent-skills build-docs；验证输出可运行 npx ai-agent-skills build-docs --dry-run --format json。
运行时机：在 add、catalog、vendor 或 curate 等会改变技能目录的命令之后；从远程库批量导入之后；将工作区变更提交到 git 之前。
限制与注意事项：只能在已初始化的库工作区中运行，即包含 .ai-agent-skills/config.json 的目录；在工作区之外运行会报错，需先用 init-library 创建工作区。不要手工编辑 README.md 或 WORK_AREAS.md 的生成部分，CLI 会覆盖它们。生成的文档使用 HTML 注释标记（<!-- GENERATED:...:start/end -->）作为边界，不要从模板部分移除这些标记。