| name | codex-edit-stability-windows |
| description | Windows 環境で Codex がファイル編集を行うときに、文字化け、BOM 混入、PowerShell の here-string 展開事故、apply_patch 失敗、意図しないエンコーディング変換を避けたい場合に使う。Codex 自体の編集運用を安定させるための補助 Skill であり、実装対象ドメインではなく編集手段の選択、検証、復旧手順を整理したいときに使う。 |
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、意図しない
?、未解決プレースホルダを確認する。
- その後にステージングや次作業へ進む。
