メインコンテンツへスキップ
見出し画像

12-3 DeepSeekの対話を「資産」に変える — プロンプトを育てる3つのレベル

    なぜ「資産化」が必要なのか

    第12章の最終課題に向けて、ここまでで自分のユースケースを整理してきました。しかし、整理しただけでは不十分です。同じような場面で毎回ゼロからプロンプトを考えるのは、時間の無駄であり、品質も安定しません。

    プロンプトを資産化するとは、一度うまくいった対話の設計を、再利用可能な形で保存し、改善し続けられる状態にすることです。これは単なる「テンプレート集め」ではありません。自分の思考の型を外在化し、育てていく行為です。


    資産化の3つのレベル

    プロンプトの資産化には段階があります。いきなり完璧を目指さず、まずはレベル1から始めましょう。

    レベル1:コピペ可能な断片として保存する

    最も基本的な形です。うまくいったプロンプトをテキストファイルやメモアプリに保存します。

    保存すべき単位:

    • 指示文そのもの(文脈・役割・制約・出力形式を含む)

    • どんな場面で使ったか(1行のメモ)

    • 結果の評価(良かった点・改善点)

    やってはいけないこと:

    • 思いつきで保存する(使った場面がわからなくなる)

    • 結果を検証せずに保存する(悪いプロンプトが混ざる)

    レベル2:変数化して再利用できるようにする

    断片をそのまま使うと、毎回少しずつ書き換える必要があります。そこで、変わらない部分と変わる部分を分離します。

    例:文書要約プロンプトの変数化

    # 役割
    あなたは{対象読者}向けの技術文書を編集するプロフェッショナルです。
    
    # 文脈
    以下は{文書の種類}です。{目的}のために要約してください。
    
    # 制約
    - {文字数}字以内
    - {トーン}で
    - 専門用語は{扱い方}
    
    # 出力形式
    {箇条書き/段落/表}
    
    # 入力
    {本文}

    このようにしておけば、{対象読者}や{文字数}を変えるだけで、様々な場面に対応できます。

    レベル3:ワークフローとして組み込む

    さらに進むと、単発のプロンプトではなく複数のプロンプトを連携させた流れとして資産化します。

    例:調査→整理→執筆の流れ

    1. 探索プロンプト:テーマについて複数の視点を列挙させる

    2. 深掘りプロンプト:各視点について反証を探させる

    3. 整理プロンプト:得られた情報を構造化する

    4. 執筆プロンプト:構造化された情報から文章を生成する

    この流れ自体を保存し、テーマだけ差し替えて使います。

    画像
    資産化の3レベル詳細

    保存の形式と場所

    何で保存するか

    画像

    おすすめはMarkdownファイルをGitで管理する方法です。変更履歴が残り、差分がわかり、バックアップも容易です。

    どこに保存するか

    prompts/
    ├── README.md          # このフォルダの説明
    ├── 01_要約/
    │   ├── 技術文書要約.md
    │   └── 会議議事録要約.md
    ├── 02_調査/
    │   ├── 比較検討.md
    │   └── 反証探索.md
    └── 03_執筆/
        ├── ブログ記事.md
        └── 社内文書.md

    このように用途別にフォルダを分けると、探しやすくなります。


    各プロンプトに含めるべきメタ情報

    保存する際は、プロンプト本体に加えて以下の情報を必ず添えましょう。

    markdown

    # プロンプト名:技術文書要約
    
    ## 用途
    社内の技術文書を、非エンジニア向けに要約する
    
    ## 最終更新
    2024-XX-XX
    
    ## 使用回数
    約15回
    
    ## うまくいった点
    - 専門用語を「やさしい日本語」に置き換える指示が有効
    - 出力形式を「箇条書き3点」と指定すると安定する
    
    ## 失敗した点
    - 文字数を指定しないと長すぎる要約が返る
    - トーンを指定しないと硬すぎる表現になる
    
    ## 改善メモ
    - 「読者は{部署名}の{役職}」と具体的に指定すると精度が上がる
    - 反例を1つ入れるよう指示すると、理解度が上がる
    
    ## プロンプト本体
    (ここに実際のプロンプト)

    このメタ情報があることで、数ヶ月後に見返しても使える資産になります。


    資産を育てる — バージョン管理の考え方

    プロンプトは一度作ったら終わりではありません。使うたびに改善していきます。

    改善のサイクル

    1. 使う:実際の業務で使う

    2. 記録する:うまくいった点・いかなかった点をメモ

    3. 修正する:プロンプトを書き換える

    4. 比較する:修正前と修正後で結果を比べる

    画像
    改善サイクル(PDCAループ)

    バージョンの残し方

    技術文書要約_v1.md  # 初版
    技術文書要約_v2.md  # 文字数指定を追加
    技術文書要約_v3.md  # 読者指定を追加
    技術文書要約.md     # 最新版(v3へのリンク)

    Gitを使えば、この管理は自動化できます。コミットメッセージに「なぜ変更したか」を書くのがコツです。

    画像
    バージョン管理フロー

    共有と再利用 — チームへの展開

    個人の資産からチームの資産へ。

    共有する際の注意点

    • 文脈依存の情報を除く:社外秘の情報、個人情報、特定のプロジェクト名など

    • 前提条件を明記する:どのモデルで、どのくらいの長さの入力で、何を期待するか

    • 失敗例も共有する:うまくいかなかったパターンこそ価値がある

    チームでの運用例

    • 月1回のプロンプトレビュー会:お互いのプロンプトを見せ合い、改善点を出す

    • プロンプトの命名規則を決める:{用途}_{対象}_{バージョン} など

    • 使ったログを残す:誰がいつ使って、どうだったか


    やってはいけない資産化

    1. 溜め込むだけ

    保存しても使わなければ意味がありません。定期的に見返し、使うことが重要です。

    2. 完璧を目指す

    最初から完璧なプロンプトは作れません。使いながら育てるものです。v1は粗くて構いません。

    3. コピペで済ませる

    他人のプロンプトをそのまま使っても、自分の文脈に合いません。自分の言葉に翻訳する工程が必要です。

    4. モデルの変化を無視する

    DeepSeekはアップデートされます。定期的に動作確認し、必要なら修正します。


    演習:自分のプロンプトを1つ資産化する

    この記事を読んだら、以下の手順で実際にやってみてください。

    1. 最近うまくいった対話を1つ選ぶ

    2. プロンプト本体を抽出する

    3. メタ情報を書く(用途・うまくいった点・失敗した点・改善メモ)

    4. 変数化できる部分を探す

    5. Markdownファイルとして保存する

    6. 1週間後、もう一度使ってみる

    この演習を3回繰り返すと、自分なりの資産化の型が見えてきます。


    API連携への橋渡し

    12-4では、いよいよAPI連携に進みます。そこで重要になるのが、ここまでで作った資産です。

    APIで自動化する際、ゼロからプロンプトを考えるのではなく、資産化したプロンプトを呼び出す形にします。つまり、この12-3は、API連携の準備段階なのです。

    API化しやすいプロンプトの特徴:

    • 変数が明確に定義されている

    • 出力形式が安定している

    • 失敗パターンが把握されている

    • メタ情報が整っている

    逆に、API化しにくいプロンプトは、毎回文脈が大きく変わるもの、出力が不安定なものです。まずはブラウザで資産化し、安定したものからAPIに移行しましょう。


    まとめ

    • プロンプトの資産化は3つのレベルで考える

    • メタ情報を必ず添えて保存する

    • バージョン管理で育てる

    • チームで共有して価値を高める

    • API連携を見据えて、安定したプロンプトから資産化する

    プロンプトは、使えば使うほど価値が上がる資産です。今日から1つ、資産化を始めてみませんか。

    画像
    プロンプト資産化システムのアーキテクチャ

    ▼ この連載の元になった書籍
    『DeepSeek 対話の設計 ― ブラウザで試す、考える、深める』

    あなたへのおすすめ