用途:该技能用于向 XR Blocks SDK 提交完整改动,覆盖实现、运行时接线、公开导出、证明、构建输出、示例与规范文档,使每个受影响层讲述同一套当前行为。
主要能力与流程:
- 冻结工作区与变更契约:阅读 ../../AGENTS.md,记录当前状态与 diff,将已有改动视为用户所有;检查实现、相邻测试、公开入口与最近的可执行示例;把变更分类为 internal、root-public 或 addon-public,列出受影响的配置、运行时所有者、生命周期、清理、导出、声明、构建输出、测试、示例与人工所有者,未用到的接缝元素标记为不适用。
- 追踪生产接缝:阅读所选分支的 references/seam-map.md,追踪配置到构造、注册表解析、生命周期调用、销毁、公开入口与产出路径;以 ../../src/xrblocks.ts 和 addon 公开入口为导入权威,不因内部辅助函数存在就将其暴露。
- 实现窄接缝:遵循相邻 TypeScript 与模块扩展约定,使用已声明依赖与注册表获取运行时服务;保持可选功能默认惰性,在 XR 启动前配置权限,先初始化所有者再初始化依赖者;编辑源输入并重新生成构建输出,不手工编辑 build/。
- 通过真实边界添加证明:添加或调整最小的同位置测试,使其在无此改动时失败;覆盖新条件、禁用或不支持行为、失败行为、清理与边界接线;先运行窄测试再运行更广检查。
- 对齐唯一教学所有者:阅读 references/developer-surfaces.md;当开发者需要可复制模式时更新最小的可执行示例或模板;更新拥有该概念的唯一手册页;仅当改动改变某任务技能的流程或分支选择时才更新该技能,不因新增能力而单独创建技能。
- 收尾:按 AGENTS.md 要求按改动比例运行仓库检查;核心 SDK 输出使用 npm run build:sdk,涉及 addon 输出或完整打包时运行完整构建;手册、TypeDoc 输入、侧边栏或文档组件变更时构建文档;检查生成改动并将最终工作区与初始快照对比。
适用场景:需要跨实现、运行时、导出、测试、构建、示例与文档一致地修改 XR Blocks SDK 时。
限制:资料未提供具体平台、收费、价格或效果信息;步骤中的路径与命令需按仓库实际结构执行,未提供时暂未说明。