关于 nixie-fx-authoring
nixie-fx-authoring 是使用 NixieFX 命令行工具和编辑器创建、验证视觉特效项目的技能，涵盖源数据编辑、后端验证、导出与视觉检查，并强调保留无关项目文件。
主要功能
- 01通过命令行创建规范化特效
- 02验证修改并解决阻塞问题
- 03导出生成的游戏端数据
- 04在网页编辑器中检查特效
- 05保留项目文件与资源路径
适用场景
- 01根据项目清单创建特效
- 02导出前检查特效
- 03在编辑器中查看后端预览
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/nixie-fx-authoring确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
agents/openai.yamlassets/starter-project/vfx-editor.prj.template.jsonreferences/effect-workflow.mdproject-format.mdvalidation-and-export.md详细介绍
NixieFX 创作
使用生成的默认值创作项目数据，验证每次更改，并使用真实编辑器进行视觉评估。
工作流
-
在用户专属文件夹中找到目标
vfx-editor.prj。不要搜索或修改无关项目。 -
阅读 project-format.md。如果项目不存在，请从捆绑模板初始化其清单，并替换所有标记值。
-
编辑前检查已安装 CLI 的约定：
npx nixie-fx --help如果显示的命令或选项与实际不同，请遵循随附的帮助信息。如果软件包不可用，请报告公开发行版本不完整，而不要臆造替代格式。
-
阅读 effect-workflow.md，然后使用 CLI 创建规范化特效：
npx nixie-fx effect create --project . --name "Fire Burst" --profile pixi-ui-2d -
编辑生成的特效，而不是手动编写完整架构。保留无关的发射器和项目文件。
-
将引用的文件添加到已配置的资源根目录下，并确保特效引用使用带正斜杠的项目相对路径。
-
每次有实质意义的编辑后都进行验证：
npx nixie-fx validate . -
解决所有错误和阻塞项。根据目标后端检查部分支持警告。
-
阅读 validation-and-export.md，然后导出：
npx nixie-fx export . npx nixie-fx export-status . -
在兼容 Chromium 的浏览器中打开 nixiefx.com/editor，选择 Open Folder，并选取包含
vfx-editor.prj的文件夹。检查目标后端的预览，并优化特效。通过架构验证不代表视觉效果已获认可。
创作规则
- 将
vfx-editor.prj和源特效视为创作数据；将out/vfx视为面向游戏的生成数据。 - 切勿编辑生成的
out/vfx文件来修复特效。应修改源文件后重新导出。 - 生成唯一的项目、特效和发射器 ID。切勿仅通过复制文件来重复使用 ID。
- 将路径限制在其配置的根目录内。除非用户明确要求，否则不要启用外部输出。
- 有意选择
pixi-ui-2d、three-world-3d或portable。Portable 表示受支持的共同子集，而非自动实现一致性。 - 使用预先准备好的运行时网格资源；原始源格式不能作为运行时输入。
- 控制差异范围，并保留用户创建的资源、材质、设置和输出策略。
捆绑模板
仅当项目清单缺失时，才使用 vfx-editor.prj.template.json。将其复制为 vfx-editor.prj，替换所有 REPLACE-* 字符串，并在运行 effect create 前创建已配置的文件夹。
完成检查
vfx-editor.prj有效，且所有已配置路径都能安全解析。- 源特效验证通过，没有错误或阻塞项。
- 目标后端没有未说明的阻塞或部分支持行为。
- 导出会重新生成有效的清单、特效文件和引用的资源。
- 只有预期的源文件和生成文件发生更改。
- 已在真实编辑器中对特效进行视觉检查；否则请报告视觉检查仍待完成。