AIにCSVの確認を頼むたび、列名や空欄の扱い、報告の形式を説明し直す場面があります。こうした繰り返し使う一つの作業手順をまとめ、必要なときに呼び出すために使えるのがスキルです。

CodexやClaude Codeのスキルでは、SKILL.mdに手順を書き、必要に応じて参照資料やスクリプトを添えます。モデルに社内知識を再学習させる仕組みとは異なります。まずはコードを書かず、短いCSVを点検する手順から作ってみます。

共通ルールから、一つの作業を取り出す

「原本は変更しない」は作業フォルダ全体の共通ルールにできます。一方、「CSVの列を仕様と照合し、問題のある行を一覧にする」は、入力・順序・出力を持つ作業手順です。今回は後者をスキルにします。

要素 この例で決める内容
使う場面 指定した一つのCSVについて、入力条件を確認する依頼
必要な入力 CSVと、その列名・型・空欄の扱いを定めた仕様
出力 問題なし/要確認/未実行の項目と、元の行ID
作業の境界 合否判定、統計計算、欠測の補完は行わない
終了条件 全行を確認したか、不足情報で止まったかを報告する

手順をまだ一度も書き出していない場合は、まず生成AIへの依頼文として試します。入力や期待結果が変わるたびに説明が大きく変わるなら、その違いを整理してから再利用する方が確認しやすくなります。

SKILL.mdには「いつ使うか」と「何をするか」を書く

Codexのスキル公式資料では、スキルの名前と説明を先に参照し、選んだスキルの本文を読み込む仕組みを説明しています。必須のファイルはSKILL.mdで、冒頭にnameとdescriptionを記載します。descriptionには、用途と対象範囲を具体的に書きます。

Claude Codeのスキル公式資料も、関連する依頼に応じた利用と、スキル名を指定する呼び出しを扱っています。ただし、配置や呼び出し方、追加設定は製品ごとに確認します。

プロジェクト内の配置例は次のとおりです。自分の利用環境に合う方へ置き、最初から両方へ複製する必要はありません。

Codex:
  .agents/skills/practice-csv-check/SKILL.md

Claude Code:
  .claude/skills/practice-csv-check/SKILL.md

次は、架空の入力を使う練習専用のSKILL.md例です。

---
name: practice-csv-check
description: 架空CSVの入力条件を、指定された列仕様と照合する。CSV確認の依頼で使う。合否判定、統計計算、データ補完には使わない。
---

# 架空CSVの入力確認

1. 対象CSVと列仕様のパスを示す。原本は変更しない。
2. 仕様にある必須列がCSVにそろっているか確認する。
3. 列が足りなければ不足列を報告し、行の検査は未実行とする。
4. 列がそろったら、各行を仕様の型・空欄・ID重複の条件と照合する。
5. 指摘は行IDと列名を付ける。IDが空欄ならデータ行番号で示す。
6. 「検査項目・状態・対象行・理由」の表を出す。
7. 状態は問題なし、要確認、未実行を分け、確認した行数を付ける。

仕様が不足するときは質問へ戻す。
欠測の補完、行の削除、数値の修正は行わない。
入力条件に問題がないことを、製品の合格と表現しない。

この例では「列の意味」をスキルへ埋め込まず、入力に添える仕様で決めています。見本の列名や単位が、別の作業へ無条件に持ち込まれるのを避けるためです。毎回同じ仕様を扱う業務なら、版を決めた参照資料として分ける方法もあります。

答えを先に決めた、小さな入力で試す

練習用の仕様は次のように定めます。これは一般的な測定データの規格ではありません。

  • 必須列はidとvalue_mm。
  • idは空欄にせず、ファイル内で重複させない。
  • value_mmは空欄、または有限の数値。空欄は値不明として報告する。
  • 数値0は記録された値として残す。寸法の良否は判定しない。
id,value_mm
P01,10.2
P02,
P03,0

この入力では、確認するデータ行は3行、IDは空欄・重複なし、P02のvalue_mmだけが値不明です。P03を空欄と取り違えたり、P02を0に変えたりした回答は、この仕様に合いません。

Codex CLIではスキルを$practice-csv-checkで指定する方法、Claude Codeでは/practice-csv-checkで呼び出す方法があります。製品のスキル一覧に表示されることを確認したうえで、次の内容を依頼へ加えます。

練習用CSVと列仕様を照合してください。原本は変えず、検査項目・状態・対象行・理由を表にしてください。読み取れなかった入力があれば未実行としてください。

出力を読むときは「問題ありません」という一文だけで済ませず、3行を確認したこと、P02を特定したこと、0が残ったことを照合します。この記事の入力と結果は期待値を設計した例であり、製品の実行結果ではありません。

正常な入力だけでなく、不足と対象外も試す

一つの見本に合っただけでは、手順を再利用できるかは分かりません。入力の一部を変え、人が決めた期待結果と比べます。

試験 入力・依頼の変更 期待する結果
別の正常入力 IDと数値を別の値にする 前のP01〜P03を混ぜず、今回の行だけを報告する
列不足 value_mm列を取り除く 列不足を報告し、行検査を未実行にする
型違い 数値欄を「未入力」にする 文字を指摘し、空欄や0へ直さない
ID重複 P01を二行にする 重複を報告し、片方を勝手に削除しない
対象外 Cpkの計算を依頼する このスキルの範囲外とし、計算条件の整理へ戻す

対象のCSVで手順を使えたかに加え、対象外の依頼で同じ手順を適用しなかったかも確認します。「データに関する作業で使う」のようにdescriptionを広げると、計算やグラフ作成まで同じ手順で扱う原因になりかねません。

スクリプトを付けるのは、検査条件が決まってから

行数が増えた場合、必須列や重複の確認をスクリプトへまとめる方法があります。その場合も、AIに検査結果を言わせるだけでなく、実行したファイル・入力・終了状態・出力を残します。スキルに「検査する」と書いたことと、検査が実行されたことは区別します。

実装を依頼する前に、上の試験表と期待値を固定してください。生成されたプログラムが通るように期待値を変えると、不具合を見逃しやすくなります。AIに任せるファイル操作の範囲については、コーディングエージェントの使い分けも参照できます。

スキルを改訂したら、変更理由、対象の仕様の版、通った試験と未実行の試験を残します。手順が単純でExcelのフィルターや既存の検査処理で足りるなら、その方法を続けても構いません。AIは仕様の不明点の整理や報告文の下書きだけに使う選択もあります。

自分の作業をどこまで一つの手順にまとめるか迷う場合は、XのS1N_seigitechへ概要をDMでお知らせください。機密資料や個人情報は送らず、DMが使えない場合はお問い合わせページをご利用ください。

公式資料の確認日:2026年10月28日。ここで示したスキルは練習用の設計例で、Codex・Claude Codeへの登録と実行は未実施です。