用途:为 Unity 项目(面向 Meta VR 与 Horizon OS)建立并维护 .agent-docs/ 知识库,以 Markdown 形式记录项目结构,便于 AI 智能体理解与后续维护。
主要能力:支持四种模式。模式1首次全量扫描(.agent-docs/ 或 index.md 不存在时触发);模式2增量更新(用户要求更新或智能体做了结构性改动时,默认模式,且属于实现的一部分,需在同一次操作中更新对应文档);模式3全量重扫(用户明确要求时);模式4摄取(用户询问项目结构或某系统如何工作时,只读,不修改文档)。
使用方式:全量扫描先收集项目概览(README、CHANGELOG、Documentation/、Packages/manifest.json、场景、asmdef、prefab、ProjectVersion.txt),若 Editor 可达可用 unity status --format json 及 get_scene_hierarchy、find_assets、package_list --scope installed、get_*_settings 等命令;若有头显可用 metavr device list 与 metavr device info <id> 记录测试设备基线。随后就不明确处提问,再按类别生成 project-overview.md、scenes/、systems/、prefabs/、assets/、scripts/ 等子文档,构建 index.md 与 _config.md。增量更新只改受影响文档并清理失效引用。摄取模式按问题只读相关子文档。
适用场景:Unity VR 项目文档化、AI 智能体上下文维护、项目结构问答。
限制:文档面向 AI 智能体,单篇建议 200 行内;脚本只记用途与用法,不重复代码;第三方包只记项目如何使用,不记内部实现;文件名用小写 kebab-case,流程/索引文件加下划线前缀;每篇顶部标注 Last updated 日期。具体收费、价格与平台支持等资料暂未提供。