预制哨兵
  
MCP服务器，安全检查和编辑Unity/VRChat项目的Prefab/Shene/Aset。
Variant 的override冲突Broken PPtr 通过结构化响应诊断/missing fileID、Udon/ClientSim运行时异常，不经过手工YAML编辑进行修复。AI代理前提设计。
read-only 経路（validate_refs / inspect_* / find_* 等）不启动Unity，直接通过YAML读取完成。写入路径（patch_apply / set_property / editor_* 等）在与驻留编辑器Bridge的file-IPC中移动confirm=True + 非空 change_reason 缺少审计对的调用 CHANGE_REASON_REQUIRED 被拒绝。
本自述文件位于各专业文档的入口（文档映射 ），模板名称将采用不同的格式。规格的正本是专业文档群，运用规则的正本是 CLAUDE.md。
做的事/不做的事
要做的事
- 为Unity SerializedObject级提供安全的编辑基础，可跟踪Prefab Base/Variant/Shene实例的有效值
- 将参照解析（GUID+fileID）和完整性验证API化
- 将运行时验证（UdonSharp compile/ClientSim smoke/日志分类）管线化
- 明确分离需要人类判断的变更和可以机械执行的变更
- 将操作流标准化为Skills（适用于两台Claude Code/Codex CLI主机）
不做的事
- YAML字符串的直接置换不作为标准手段
- 不通过推测补充Unity内部参照
- 不进行无变更依据的自动优化
- 不擅自适用需要用户判断的规格变更
快速入门
作为插件导入。根据主机（Claude Code/Codex CLI）有两条路径。安装从marketplace取得，导入后的MCP服务器在运行时不进行网络通信而在本地完成。
克劳德代码（Claude Code内输入的斜线命令）：
/plugin marketplace add tyunta/prefab-sentinel
/plugin install prefab-sentinel@tyunta-prefab-sentinelCodex CLI（在壳牌上运行）：
codex plugin marketplace add tyunta/prefab-sentinel
codex plugin install prefab-sentinel@tyunta-prefab-sentinel部署后，从MCP客户端 activate_project(scope=..., project_root=...) 在中声明scope和Unity项目根目录validate_refs(scope="Assets/...") 时，broken GUID/fileID在JSON中返回。
每个路径的详细信息 安装，安装、直接从存储库启动MCP服务器的面向开发者的步骤是 贡献.md 来修改标记元素的显示属性。
安装，安装
前提条件
- Python 3.11 以上
- 紫外线（软件包管理器）—安装步骤为 uv官方指南 参考（不同于Windows/macOS/Linux）
- Unity 2022.3 + VRChat SDK 3.x（Worlds / Avatars）—Editor Bridge経由の书き込み・実行検证経路で必要
MCP服务器在Plugin内部 uv / uvx 由于是通过本地启动的，所以Plugin导入路径也需要Python/uv。主机（Claude Code/Codex CLI）和本工具在Windows/macOS/Linux上运行。
Claude代码插件
快速入门 中描述的相应参数的值。安装后MCP服务器和5个技能一并展开/prefab-sentinel:guide 等技能可以直接从Claude Code中调用。每个技能中的命令 ${CLAUDE_PLUGIN_ROOT} 在模板变量中从本地执行。
Codex CLI插件
快速入门 中描述的相应参数的值。MCP服务器是Plugin定义（.codex-plugin/plugin.json的，之 mcpServers 从条目自动注册，skill bundle也同时展开。更新Plugin后，重新启动Codex CLI会话。取消注册 codex plugin uninstall prefab-sentinel@tyunta-prefab-sentinel。
技能
技能｜调用｜说明｜ |--------|----------|------| |导游| /prefab-sentinel:guide MCP工具参考修补程序工具包设置 |变体安全编辑| /prefab-sentinel:variant-safe-edit 安全编辑Prefab Variant工作流 |预制参考修复| /prefab-sentinel:prefab-reference-repair 故障参照检测和修复工作流 |乌冬面日志分诊| /prefab-sentinel:udon-log-triage 运行时日志的三级工作流 |知识获取| /prefab-sentinel:knowledge-acquisition VRChat生态系统工具的知识调查和积累
团结大桥
写入系统的路径，例如补丁程序实际应用、运行时验证，在与驻留在Unity Editor中的Editor Bridge的file-IPC中移动。Bridge的设置步骤是 /prefab-sentinel:guide 为技能指定watch目录的环境变量 UNITYTOOL_BRIDGE_WATCH_DIR 啊 配置.md 中描述的相应参数的值。未设定的写入类工具 BRIDGE_WATCH_DIR_MISSING 中停止fail-fast（仅限read-only检查不需要设置）。
典型的MCP工具
所有MCP工具的正本目录 docs/tools.md、响应包络（success / severity / code / message / data / diagnostics）和错误代码的正本 docs/api-reference.md下表仅限代表工具。
工具｜说明｜ |--------|------| | activate_project 项目范围设置+高速缓存warm（会话开始时呼叫） | validate_refs ｜扫描损坏的GUID/fileID引用｜ | validate_structure | YAML内部构造の検证（fileID重复・Transform整合性）| | inspect_wiring 分析MonoBehaviour现场布线（带null参照分类） | inspect_variant Prefab Variant的override链分析 | find_referencing_assets 查找GUID/路径引用的资源 | patch_apply 补丁程序计划的验证和应用（带dry-run/confirm门） | validate_runtime UdonSharp编译+ClientSim执行验证 | editor_* | Editor Bridge経由のScene / Hierarchy / Component / BlendShape / Animation编集|
read-only検查（validate_* / inspect_* / find_*）不需要Unityeditor_* 系和 patch_apply 的confirm应用以Editor Bridge常驻为前提。
建议流程： validate_refs 中找到最佳实践 inspect_variant 将override冲突可视化为有效值→ patch_apply 的dry-run→ confirm=True + change_reason + out_report 中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。
VRChat生态系统知识
knowledge/ 在目录中以3级（L1概念/L2操作模式/L3SerializedProperty）积累ModularAvatar/liltoon/VRCFRy/AvatarOptimizer等域知识，在通常作业中自动读写。编辑条款为 知识/风格_GUIDE.md。
文档映射
规格分为专业文档。不同目的的入口如下表所示。
文档｜内容｜ |--------------|------| | 建筑.md ｜配置概览层责任服务规范数据模型词汇表｜ | docs/tools.md 全MCP工具的正本目录 | docs/api-reference.md MCP响应包络的形状和错误代码的正本 | docs/execution-reference.md 运行MCP服务器参考/smoke-batch/基准/patch架构/报告输出格式 | 测试.md 单元/集成/回归/mutation测试的执行步骤和测试策略 | 配置.md | UNITYTOOL_* 环境变数・ignore_guids.txt・scope config规约| | DEBUGGING.md Bridge封套/Unity Console/broken reference的调查步骤 | 贡献.md ｜开发环境・MCP服务器的直接启动・测试・提交规章・PR流程｜ | CLAUDE.md ｜运用规则和判断标准的正本｜ | AGENT_GUIDE.md 用于AI代理的onboarding（第一个参考点） | 更改日志.md | 変更履歴 |