Codex Aholo 示例技能:同步 3D 场景元数据与运行器
EnglishCodex 安装步骤
- 从固定 GitHub 提交复制 `.codex/skills/aholo-examples/` 完整目录到项目 `.agents/skills/aholo-examples/`。
- 在 Codex 读取 `website/src/content.config.ts`、`website/src/client/render-runtime.d.ts` 和已有几何示例。
中文摘要
为 Aholo Viewer 的示例创建配对的 JSON 元数据与 TypeScript 运行器,验证列表和 Playground 的预期表现。
SKILL.md 中文导读
可复现示例
以 `3d-buffer-geometry` 为参考创建一个本地彩色三角形示例,配对 `<slug>.json` 与 `<slug>.ts`,检查在 Examples 与 Playground 显示。工作步骤
- 为示例写唯一名称、顺序和标签,按运行器接口处理异步加载与取消。
- 分别按修改范围运行内容或网站检查,验证可见位置与资源释放。
验收方法
元数据与运行器可一起加载,默认示例位置正确,本地检查能发现不匹配的文件。
GitHub 原文 · 更新日期
适用环境
需要 Aholo Viewer 本地工作区和项目 pnpm 环境。使用自己生成的几何体作为示例。
常见问题
只修改示例标签要运行整个检查矩阵吗?
根据仓库说明,元数据改动先运行 `pnpm.cmd check:content`。运行器与网站集成改动用 `pnpm.cmd check:website`。