菜单
Use when editing, creating, refactoring, formatting, especially Unreal C++ .h .cpp, ModuleRules .Build.cs, TargetRules .Target.cs, comments, includes, lambdas, naming, copyright headers, custom copyright header config, author/date header fields, CRLF, and Tab indentation.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | orion-code-style |
| description | Use when editing, creating, refactoring, formatting, especially Unreal C++ .h .cpp, ModuleRules .Build.cs, TargetRules .Target.cs, comments, includes, lambdas, naming, copyright headers, custom copyright header config, author/date header fields, CRLF, and Tab indentation. |
Use this skill for all code creation, refactoring, and formatting in this project. Before touching .h, .cpp, .Build.cs, .Target.cs, or other code files, read the detailed Simplified Chinese reference:
references/orion-code-style.zh-CN.md
Core rules:
.Build.cs, and .Target.cs..h files, keep trivial inline functions on one line when the body is a single simple expression or return; .cpp files do not need this one-line rule. Namespace definitions still use Allman braces on separate lines.PublicDependencyModuleNames must only contain "Core", "CoreUObject", and "Engine" unless the user explicitly authorizes otherwise. Put all other dependencies in PrivateDependencyModuleNames, and do not delete or rewrite existing business logic just to satisfy dependency placement.#include "CoreMinimal.h" to generated code. Include the actual minimal engine/project headers needed by the types used.#pragma once, #include, or any other code..generated.h include after all other includes, separated from the regular include block by a blank line; do not put any include after .generated.h.GENERATED_BODY() for USTRUCT; do not generate GENERATED_USTRUCT_BODY().GENERATED_BODY() for UCLASS; do not generate GENERATED_UCLASS_BODY()./** ... */), not // line comments.* with one space after the current Tab indentation: top-level lines use *, nested lines use \t *; never write \t*.Author, Date, Website, or other custom header lines when the header config template explicitly requests them; do not add ad hoc author lines.Source/GameCore style for naming, spacing, comments, includes, lambdas, long-call wrapping, and alignment.Optional validation:
powershell -NoProfile -ExecutionPolicy Bypass -File .agents\skills\orion-code-style\scripts\check-code-style.ps1 -Path Source\GameCore\Public\System\CoreAssetManager.h
scripts/check-code-style.ps1。../crlf-mechanical-formatting/SKILL.md。../orion-framework-skill-authoring/SKILL.md 和系统 skill-creator。Use when bulk-formatting or mechanically rewriting Windows text/code files in this repo with PowerShell, especially to preserve CRLF line endings, normalize Tab indentation, avoid LF-only output, protect copyright header blocks, and validate touched Unreal plugin/source files after formatting.
Use before creating, renaming, moving, importing, converting, validating, batch-editing, saving, or organizing Unreal Engine assets and Blueprint assets, including Materials, Material Instances, Physical Materials, Python phys_material edits, Blueprint classes, Blueprint Components, Blueprint Function Libraries, Blueprint Interfaces, Widget Blueprints, Animation Blueprints, Gameplay Ability assets, audio assets, cinematics, localization, movie files, Bink/Media assets, Splash startup images under Content/Splash, ProjectAcoustic or ProjectAcoustics content, system assets, UI assets, and GameFeatures plugin Content folders. Enforces Allar-style asset prefixes, Blueprint naming rules, folder naming rules, project Content taxonomy, save verification, and GameFeatures content layout.
Use when Codex works on Unreal Engine audio in this framework: Content/Audio assets, Content/Acoustics, SoundClass, SoundConcurrency, SoundSubmix, SoundControlBus, ControlBusMix, AudioModulation, AudioMixer, MetaSound, ProjectAcoustics, SteamAudio, OrionVoiceChat, voice chat, microphone input, audio output device switching, CoreAudioSettings, GameSettingRegistry_Audio, UAudioMixEffectsSubsystem, spatialization, reverb, occlusion, HDR/LDR audio, or DefaultEngine/DefaultGame audio configuration.
Use when working on the project-local OrionAudioSystem plugin, audio generation components, Blueprint audio playback APIs, runtime attenuation updates, USoundBase/USoundAttenuation playback, multiplayer replicated one-shot audio, Blueprint component visibility/loading issues, or VerifyImport failures for /Script/OrionAudioSystem in Plugins/Audio/OrionAudioSystem. Use for requests mentioning OrionAudioSystem, UOrionAudioGenerationComponent, UOrionFireAndForgetAudioGenerationComponent, 音频生成组件, 世界位置播放音频, 实时衰减, 多人都能听到声音, 组件消失, or 蓝图重新加载后才显示.
Use when implementing, modifying, debugging, packaging, or validating the OrionBrowser plugin, CEF browser kernel integration, OrionCEF3 third-party artifacts, OrionBrowserHelper subprocess, UOrionBrowserWidget, UGameUIWebBrowser, HTML popup browser content, browser cursor policy, mouse cursor hand/grab issues, H.264/AAC video playback, or browser runtime staging for Win64/Steam.
Use before Codex writes, modifies, fixes, refactors, reviews, designs, or changes Unreal or Orion gameplay code, Blueprint-facing APIs, plugins, assets, configuration, systems, or features. This Skill requires senior game-architecture analysis before any implementation or edit: translate the user request into use cases, modules/plugins, domain abstractions, architecture patterns, extension points, data/assets, communication, authority, validation, and project layers. Use for broad requests such as write code, change code, fix code, refactor code, add a feature, build a system, implement gameplay, design/refactor architecture, 写代码, 改代码, 修代码, 重构代码, 写功能, 加系统, 做玩法, 改架构, 架构分析, 解耦, 扩展, 抽象, or 蓝图逻辑.