tomevault-io Codex Edit Stability Windows
役割
Windows 上での Codex 編集作業を安定させる。特に apply_patch 失敗、PowerShell 由来の文字化け、UTF-8 / BOM 問題、here-string 展開事故を避けるための作業手順を与える。
この Skill を使う場面
- Codex の編集で文字化けが起きやすい
apply_patchが頻繁に失敗する- PowerShell の
Set-Content/ here-string で内容が壊れやすい - 日本語を含む Markdown やテンプレートを安全に編集したい
- 編集後の検証手順を標準化したい
この Skill を使わない場面
- 通常の実装ノウハウだけで十分なとき
- Windows 特有の編集事故を扱わないとき
基本方針
- まず
references/edit-failure-analysis.mdを読む。 - 実編集前に
references/safe-edit-workflow.mdを読む。 - 文字化けしやすいファイルでは、PowerShell の安易な文字列置換より安全な手段を優先する。
apply_patchが通るなら最優先で使う。apply_patchが使えない場合だけ、UTF-8 を明示した安全な書き込みへ切り替える。- 編集後は必ず
references/verification-checklist.mdの確認を行う。
優先する編集手段
apply_patch- 既存の安全なテンプレートコピー
- UTF-8 を明示した最小限のファイル再書き込み
避けるもの
- PowerShell のバッククォート解釈が絡む複雑な置換
- 展開付き here-string 内での Markdown / URL / バッククォート混在
- 文字コードを明示しない
Set-Content - BOM 混入を意識しない C# / YAML 出力
- 編集後未検証のまま完了扱いにすること
典型フロー
- 失敗原因が
apply_patchか文字化けかを切り分ける。 - 対象ファイルが
.cs/.yaml/.mdのどれかを確認する。 apply_patchを試す。- 失敗したら、ファイル種別に応じた安全手段へ切り替える。
- 編集後に、置換文字、BOM、意図しない
?、未解決プレースホルダを確認する。 - その後にステージングや次作業へ進む。
Source: sechiro/VRCUdonSkills-for-Codex — distributed by TomeVault.