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

【プロンプト公開】ハルシネーションと文字数オーバーをゼロにする!「Agent Skills」と「レビュー検証エージェント」の指示書設計術

    こんにちは!くるみです。

    この記事はこれと連動企画です

    この記事でも少しふれてましたが、
    「AIに長文記事やSNSの投稿を書かせると、適当な嘘(ハルシネーション)を言ったり、文字数をオーバーしたりして、結局人間が手直しするのに時間がかかってしまう問題」についての深堀りです。

    実はわたしも、システムを作り始めた当初はまったく同じ壁にぶち当たっていました。

    「2,000文字のブログと、140文字のX投稿を作って!」と1発のプロンプトでお願いしても、ブログは途中で息切れしてペラペラになるわ、X投稿は平気で180文字くらい書いてくるわ、元記事にない適当なスペックをでっち上げるわで、もう大混乱だったのです。

    でもね、試行錯誤を繰り返す中で気づいたんです。
    「1発のプロンプトで全部やらせようとするから無理があるんだ!」と。

    思いついたらやってみる。やってみたなら検証する。
    これがわたしのモットー。

    今回は、AIのハルシネーションやフォーマット崩れを極限までゼロにする「Agent Skills(専門指示書)」の書き方と、AIが自ら間違いを正す「レビュー&検証エージェント」の全貌をガッツリ大公開しちゃいます!


    ■なぜ「1発のプロンプト」は失敗するのか?わたしの仮説

    そもそも、人間でも「リサーチしながら、同時に2,000文字のブログを書き、さらに同時にSNS用のキャッチコピーを10本考え、誤字脱字や文字数制限までリアルタイムで完璧にチェックする」なんて芸当、絶対に無理ですよね。脳みそがパンクします。

    それなのに、なぜかAIに対しては「1回の指示で全部完璧に出して!」と無茶振りをしがちなんです。

    そこで、わたしは次のような仮説を立てました。

    「書く役(ライターAI)と、直す役(編集長AI)に完全に役割を分担させ、別の指示書(プロンプト)でバトンリレーさせれば、人間が手直しする必要はゼロになるんじゃない?」

    こうなればいいなぁ(仮説)→
    やってみるかぁ(実証)→
    うまくいかんねぇ(評価)→
    違う切り口かなぁ(改善)→
    もっかいやってみよう(実証)→
    お?いいんじゃね(結果)→
    もすこし続けよう(継続)

    このPDCAサイクルを回して完成したのが、今回ご紹介する「2段階の指示書設計」です!


    ■武器①:専門指示書「Agent Skills」の設計ノウハウ

    本システムでは、Pythonプログラムの中にプロンプトをベタ書きしていません。そもそもわたしはPeyton言語はまったくの未知の世界。

    Google Antigravityの仕様に沿って、独立したマークダウンファイルとして指示書を管理しています。(といってもなんだかわからないですよね。わたしもです。ここもAntigravityのまったくの受け売り。)

    こうすることで、プログラムの知識がなくても、マークダウンをちょこっと書き換えるだけで文体や出力ルールをいつでも自由にカスタマイズできるんです!(だそうです)

    実際に使用している指示書のテクニックをいくつかご紹介しますね。


    □ 自分の文体をAIに完全インストールする記述術

    AIに「親しみやすい文章で書いて」と指示しても、機械的でよそよそしい敬語になりがちです。
    そこで、指示書では以下のようにルールを細かく言語化して叩き込んでいます。

    ・一人称は必ず「わたし」を使うこと
    ・読者に親身に語りかけるような明るい口調(「〜ですよね!」「〜してみてね」「〜って感じです」「〜なのだ」「〜しなきゃ。です。」)
    ・実験・検証マインド(「思いついたらやってみる。やってみたなら検証する。」)を取り入れる
    ・擬音語(「ポチポチ」「ササッと」「ズラリと」など)を自然に交える
    ・見出しの記法:大見出しは「■ 」、小見出しは「□ 」で統一すること
    ・結びには必ず「それじゃ、またね。」を入れること

    ここまで具体的にルール化して渡すと、AIはまるでわたしが書いたかのようなリズムとテンポでスラスラと長文を執筆してくれるようになります!


    □ プラットフォームごとの「刺さる切り口」のテンプレ化

    SNS投稿も、ただ「要約して」と頼むと無難でつまらない投稿しか生まれません。
    そこで、媒体ごとの特性に合わせて明確な役割(切り口)を指示書に定義しました。

    ・X用(全10パターン):
    ハッシュタグは一切付けず、スマホで読みやすい改行テンポを最優先。
    「要約型」「問題提起型」「Tips箇条書き型」「数字重視型」「ストーリー型」「逆張り型」「スレッド導入型」など、重複しない10種類の切り口を指定し、末尾は必ず「続きはnoteで読めます」という強い引きで締めくくらせます。

    ・Threads用(全3パターン):
    Xより少し長めの300〜400文字程度に設定。
    「ぶっちゃけ〜」「正直これ言っちゃうと…」といったスレッズ民が好む親近感ある書き出しにしつつ、検証データや実績をサラリと混ぜて権威性をプラス。
    「これを知らずに進めると後で損するかも…」という見逃し不安をくすぐってnoteへ誘導する仕掛けを指示書に組み込みました。


    ■武器②:AI編集長「レビュー&検証エージェント」の自動校正システム

    ライターAIがドラフト(下書き)を書き上げたら、次は「レビュー&検証エージェント(AI編集長)」の出番です!

    ここが今回の仕組みの最大のキモかも。
    AI編集長には、ライターAIが書いたドラフトだけでなく、「最初にスクレイピングして作成したObsidianの元ノート」を一緒に渡します。


    □ 100点満点の評価基準シートを組み込む

    AI編集長には、以下の4項目(各25点満点、合計100点)で厳格に採点させます。

    1. トーン&マナー・文体(25点):
      一人称が「わたし」になっているか、親しみやすい語り口か、結びの挨拶が含まれているか。

    2. 構成と見出しフォーマット(25点):
      大見出し「■ 」、小見出し「□ 」が正しく使われ、話の流れが論理的か。

    3. SNS投稿の仕様適合性・導線(25点):
      X投稿にハッシュタグが付いていないか、Threads投稿が300〜400字でnoteへの引きがあるか。

    4. 元情報との整合性・ファクトチェック(25点):
      元のObsidianノートに書かれていない嘘(ハルシネーション)を勝手に創作していないか。


    □ 指摘するだけでなく「自ら直して完成原稿を出す」

    普通のレビューAIだと「〇〇が間違っています」「文字数が多すぎます」とダメ出しをして終わってしまいますよね。でも、それだと結局人間が直さなきゃいけない。

    そこで指示書では、
    「不備や改善点がある場合は、エディターとして自ら完成原稿に修正・ブラッシュアップを適用して出力すること」
    という強力な命令を入れています。

    これにより、万が一ライターAIがハッシュタグを付けてしまったり、文字数が長すぎたり、事実と違うことを書いてしまっても、AI編集長がその場でササッと直して「校正済みの100点満点原稿」を出力してくれるのです!


    ■ 実際に運用してみて分かったビフォーアフター

    この2段階エージェントシステムを導入してから、コンテンツ制作の世界が劇的に変わりました。


    □ 人間の手直し作業が「ほぼゼロ」に!

    以前は生成された文章を読んで「あ、ここ嘘書いてる」「文字数削らなきゃ」「見出し直さなきゃ」と15〜20分くらい手直ししていました。
    今では、出力されたテキストをそのままnoteやX、Threadsにポチッとコピペするだけで投稿できるクオリティに仕上がります。


    □ 途中で起きた「429エラー」も最新AIで克服!

    実は開発中、Geminiの無料枠制限(429エラー)に引っかかって処理が止まるトラブルがありました。
    「うわっ、止まっちゃった!」と焦ったのですが、Google Geminiの最新高速モデル(Gemini 3.6 Flash / 3.5 Flash)を優先的に呼び出し、万が一のときは自動待機・自動切り替え(フォールバック)するコードを組み込むことで完全解決!
    今では1記事あたりわずか十数秒という超爆速で、ブログ+X10本+Threads3本+校正レポートが完成するようになりました。
    (これもAntigravity側で勝手にデバッグしてくれたんだけどね)


    ■まとめ

    今回の実験を通して強く感じたこと。
    それは、「AIはプロンプト1発で完璧を目指すのではなく、小さな専門家たちを並べて役割分担させるのが一番強い」ということです。

    ・ライターAIには「文体と読者への引き」に全力投球させる
    ・編集長AIには「元情報との突き合わせと厳格な校正」に専念させる

    この2人のAIチームを作るだけで、あなたのAI活用レベルは一気にプロの領域へと進化しますよ!
    ぜひ、みなさんのプロンプト設計にも取り入れてみてくださいね。

    次回は、このAIチームを「ブラウザのお気に入りからワンクリックで動かせるようにしたWebアプリ開発の全手順」をお届けします!
    プログラミング知識ゼロのわたしがどうやってFastAPIとTailwind CSSを操ったのか、その裏話をたっぷりお話ししますね。

    ときどきのぞきにきてみてね!

    それじゃ、またね。

    あなたへのおすすめ