Codexで毎回同じ指示を書かない方法|繰り返し作業をSkill化する
この記事には現在、アフィリエイトリンクを掲載していません。
記事の確認日・広告情報
目次を表示
- 結論:入力・確認・停止条件を分けて再利用する
- この記事で確認した範囲
- 先に決める5項目
- 検証の設計例:公開前QAを同じ条件で見る
- 小規模な手順比較:確認漏れをどう扱うか
- Ainavora編集部実践表
- 読者がそのまま使える最小骨子
- 公式情報
- 次に読む
結論:入力・確認・停止条件を分けて再利用する
毎回「対象フォルダを確認し、テストを実行し、機密情報を検査する」と書くなら、同じ仕事の型ができています。Skill化では、入力、処理、出力、停止条件を分けます。公式ドキュメントでも、Skillは指示・リソース・任意のスクリプトをまとめる再利用可能なワークフローです。
この記事で確認した範囲
公式のSkill仕様を確認し、Ainavoraの公開前QAを固定条件で3回実行しました。ここで扱う秒数は検査コマンドの時間で、Codexの推論時間や読者の作業時間ではありません。
先に決める5項目
- 入力:対象のファイルや目的
- 処理:読む順番と確認項目
- 出力:レポートや修正案
- 停止条件:テスト失敗、情報不足、権限不足
- 検証:何をPASSとするか
例外が多い仕事は、無理に固定しません。まず手作業で工程を見直し、繰り返す部分だけを再利用します。これは編集部の運用方針であり、公式が回数を指定しているわけではありません。
検証の設計例:公開前QAを同じ条件で見る
編集部では、次の課題を比較検証用に固定しました。
| 項目 | 固定した内容 |
|---|---|
| 入力 | 21記事を含むAinavoraのローカル静的サイト |
| 確認 | ビルド、メタデータ、内部リンク、重複slug、機密情報、日次候補監査 |
| 出力 | 6項目のPASS/FAILと例外 |
| 停止条件 | ビルド失敗、リンク切れ、機密情報検出 |
| 評価 | 同じ入力・環境・評価表で実行する |
小規模な手順比較:確認漏れをどう扱うか
編集部では、通常の品質コマンドだけを実行するA手順と、`regression-gate` の確認順を適用するB手順を、それぞれ3回実行しました。Aは7項目、Bは生成HTMLの外部リンク記号チェックを加えた8項目です。全6回で終了コードは0でした。
| 手順 | 試行 | 確認範囲 | 追加の対話指示 | 所要時間 |
|---|---|---|---|---|
| A: 通常の品質コマンド | 3回 | 7/7 | 0回 | 1.522〜1.760秒 |
| B: Skillの確認順を適用 | 3回 | 8/8 | 0回 | 1.686〜1.773秒 |
Bで8項目を確認できたのは、手順の中に外部リンク記号の検査を入れたためです。この結果は、Skillが自動的に品質を向上させたこと、一般的な時間短縮があることを示すものではありません。測定条件と全結果は、公開前の編集部記録で管理しています。
この比較はQA手順の確認範囲に限ります。Skillの有無による優劣、改善率、時間短縮率、読者の業務成果は未測定です。記事内では「A/Bテスト」ではなく「編集部の小規模な手順比較」と表記します。
Ainavora編集部実践表
この表は、Ainavora編集部がローカル環境で行った公開前QAの記録です。OpenAIの公式仕様や、すべての利用環境での効果を示す数値ではありません。
| 記録項目 | 編集部で確認した値 |
|---|---|
| テストID | TEST-CODEX-QA-PROCEDURE-2026-09-04-001 |
| 対象 | 21記事、26ルート、404を含むローカルサイト |
| 実行回数 | A手順3回、B手順3回 |
| A手順の確認範囲 | 7/7項目(外部リンク記号は未検査) |
| B手順の確認範囲 | 8/8項目(外部リンク記号を含む) |
| 終了コード | 6回とも0 |
| 検査コマンド時間 | A: 1.522〜1.760秒 / B: 1.686〜1.773秒 |
| 未測定 | モデルの消費トークン、推論時間、執筆時間、読者の作業時間 |
数値は、検査の対象・端末・依存関係が変われば変動します。B手順の項目数が多いのは、確認する項目を追加したためです。速度や品質の一般的な優劣を示す表ではありません。
読者がそのまま使える最小骨子
たとえば「公開前QA」をSkill化するなら、本文を長く書くより、次の骨子から始める方が検証しやすくなります。
```text
入力: 公開候補のサイト
処理: ビルド → リンク → 機密情報を確認
出力: PASS/FAILと例外
停止: 1項目でもFAILなら公開候補にしない
検証: 同じ評価表で結果を残す
```
この骨子を書いても、確認内容そのものが正しいかは別途見直します。Skillは判断を代替するものではありません。
公式情報
- OpenAI:Build skills(最終確認:2026年9月4日)