用途:保持 OpenVMM Guide(Guide/src/)与代码库同步,适用于新增、删除或移动 Guide 页面,新增需要文档覆盖的设备 crate 或 CLI 参数,以及审计文档是否过时。
主要能力与用法: 新增页面时按内容类型选择路径,例如模拟设备参考用 reference/emulated/<DeviceCategory>/<device>.md,VMBus 设备用 reference/devices/vmbus/<device>.md,Virtio 设备用 reference/devices/virtio/<device>.md,设备后端用 reference/backends/<category>.md,架构深入用 reference/architecture/openvmm/ 或 reference/architecture/openhcl/,CLI/管理用 reference/openvmm/management/,开发者工具用 dev_guide/dev_tools/<tool>.md,测试框架用 dev_guide/tests/。页面需遵循 .github/instructions/guide-docs.instructions.md 风格,包含简要概述、关键概念和 rustdoc 链接,crate 名用反引号,代码路径用仓库根相对路径,并在 Guide/src/SUMMARY.md 对应章节登记。
删除或移动页面时更新 SUMMARY.md,grep 旧路径检查交叉引用,移动后确保链接指向新位置。新增 vm/devices/ 下的 crate 时,用户可见设备或后端需要页面,内部管道 crate(如 _resources、_protocol)通常只需在父设备页提及。修改 openvmm/openvmm_entry/src/cli_args.rs 时更新 Guide/src/reference/openvmm/management/cli.md,新参数应包含标志语法、描述、默认值及与其他标志的交互。
审计新鲜度:扫描 Guide/src/ 页面,核对 crate 名、结构体/枚举名、行为描述和 rustdoc 链接是否仍有效;检查 SUMMARY.md 中的空链接占位主题,优先处理代码活跃区域。可用命令:grep -r "crate_name" Guide/src/ 和 grep '()\s*$' Guide/src/SUMMARY.md。
限制:资料未提供该技能的具体安装方式、运行环境、收费或效果信息。