同じことを二度と言わないための「スキル定義ファイル」：プロンプトを再利用可能な資産にする
この記事は、Growth Lab編集部 が Skill Definition / Prompt Engineering / Asset Management の観点から検証結果を整理したものです。
読了前に全体像を掴み、その後に目次から必要な節へ進める構成を想定しています。
目次を表示
TL;DR
- プロンプトのコピペ管理は限界。リポジトリで「スキル」として資産化すべき
.agents/skills/配下の Markdown ファイルでバージョン管理と再利用を実現view_fileツールによる動的なスキルロードが自律的エージェントの鍵
The Pain: コピペプロンプトの限界
「このタスク、先週もChatGPTにお願いしたな…」 そう思って、過去のログからプロンプトを探し出し、コピペして微調整する。 これは非効率ですし、チームで共有することも困難です。なにより、その場しのぎの「使い捨て」になってしまいます。
The Solution: Skill Definition (スキル定義)
プロンプトを「チャット画面に入力するテキスト」ではなく、「実行可能なファイル（Skill）」として定義し、リポジトリで管理します。
Skillファイルの構造
.agents/skills/ ディレクトリ配下に、Markdownファイルとして保存します。
---
name: code-review-checklist
description: 厳しいテックリードとしてコード品質をチェックするスキル
version: 1.0.0
---
あなたはシニアエンジニアです。以下の観点でコードをレビューしてください。
## 1. Security
- SQLインジェクションの可能性はないか？
- APIキーがハードコードされていないか？
## 2. Performance
- N+1問題が発生していないか？
...
The Implementation: view_file によるロード
エージェントを使う際は、長文のプロンプトを打ち込む代わりに、こう言うだけです。
"code-review-checklist スキルを使って、このファイルをレビューして。"
エージェントは自律的に .agents/skills/code-review-checklist/SKILL.md を読み込み（view_file）、その中の指示に従って振る舞いを切り替えます。
The Takeaway: プロンプトは資産である
プロンプトをファイル化することで、以下のメリットが生まれます。
- Version Control: Gitで変更履歴を追える。
- Reusability: 誰でも同じ品質でタスクを実行できる。
- Modularity: 他のスキルから参照したり、組み合わせたりできる。
次回は、単なるチェックリストを超えて、エージェントに「思考の手順（アルゴリズム）」を教え込む方法について解説します。
References
Growth Lab編集部
Skill Definition / Prompt Engineering / Asset Management
AIエージェント開発、記事制作フロー、デザインシステム運用の接続を実装ベースで検証し、再現可能な手順へ落とし込むことを目的に運営しています。
あわせて読む
同じテーマや近い文脈の記事を続けて読めるようにする。
プロンプトエンジニアリングの終焉：「スキル定義ファイル」でAIを即戦力にする
プロンプトエンジニアリングは「魔法の言葉探し」から「資産管理（スキル定義）」へ。AIを即戦力にするための新しいエンジニアリング手法を体系化したシリーズです。
デザインツールを開くな：Mermaid記法とプロンプトだけで「映える図解」を自動生成する
『図解もコードで書く』。MermaidやNano Banana Pro（Prompt SDK）を使い、記事内容に連動した高品質なインフォグラフィックを自動生成し、読者の理解を劇的に高める手法を公開します。
継続接点
更新を追いかける
新着記事、特集、検証ログをまとめて追える入口として使う。メール購読導線の本実装前でも、継続接点を切らさない。
- 新着記事をまとめて確認できる
- 関連記事や特集ページへつながる
- 実験ログを継続的に追える
本実装ではメール購読や通知機能へ差し替え可能。