Skip to content

Instantly share code, notes, and snippets.

@podhmo
Created April 9, 2026 22:02
Show Gist options
  • Select an option

  • Save podhmo/d86ff60a9a98fcb6921b6e4a2071cae2 to your computer and use it in GitHub Desktop.

Select an option

Save podhmo/d86ff60a9a98fcb6921b6e4a2071cae2 to your computer and use it in GitHub Desktop.
Uploaded via Gist Uploader - 2026-04-09T22:02:44.027Z

主題

あなたはプロンプトデザイナーとして解釈してほしい。1つ前のプロンプトつまり以下のプロンプトを対話履歴から技術記事への変換プロンプトと解釈してより良いプロンプトを提案してほしい。文体的には自信満々さは不要。提案というより備忘録として扱いたいので主張をする必要はない。つまり何かのメッセージを断言する必要はない。

対話履歴から技術記事への変換プロンプト

対話履歴について

- 要約は行わない
- 10000文字を超えても良い
- markdownとして出力。ただし太字強調は禁止。
- 文脈独立性を保つ
- 対話で訂正されたものは訂正後の内容のみを記述する
- 未来の自分のための備忘録としての体で技術記事として出力する
- 出典のURLがあればそれをリンクとして残す
- 図や表も理解に役立つのであればそのまま借用ないし抽出する

文体的には自信満々さは不要。備忘録として扱いたいので重要さなどを主張をする必要はない。意見を断言しない。文体は「だ。である」ではなく「だった。分かった。らしい」などの形が望ましい。


これらを意識してドキュメントを出力してください。

gemini1

対話履歴を技術記事(備忘録)に変換するためのプロンプトについて、プロンプトデザインの観点から見直した結果を記録しておく。

元のプロンプトでも必要な要件は網羅されていたようだが、LLMに対する指示をより構造化し、役割や入力データの位置を明確にすることで、出力の安定性や制約の遵守率がさらに向上するらしい。

改善のポイントとしては、以下のような事項が考えられた。

  • 役割(Role)の付与 単にドキュメント化を指示するだけでなく、「未来の自分のための備忘録を作成するアシスタント」といった役割を冒頭で持たせると、LLM側の出力トーンや視点が定まりやすくなるらしい。
  • 指示の構造化 「処理のルール(要約しない、訂正の反映など)」「出力形式(Markdown、太字禁止など)」「文体(トーン&マナー)」をセクションごとに分けて箇条書きにすると、LLMが制約条件を見落としにくくなるようだ。
  • 「文脈独立性」の具体化 単に「文脈独立性を保つ」とするだけでなく、「対話の背景を知らない未来の自分が読んでも理解できるように、発端や前提情報を整理して補う」と言い換えることで、より意図に沿った再構成が期待できるらしい。
  • 入力データ位置の明示 プロンプトの指示部分と、対象となる「対話履歴」のデータ部分を明確に分離(プレースホルダー化)しておくと、LLMがどこからどこまでを処理対象とすべきか誤認しにくくなるようだ。

これらを踏まえて再構築したプロンプトのテンプレート案は以下の通りだった。

# 指示
あなたは、開発者の「未来の自分のための技術備忘録」を作成するアシスタントです。
以下の【対話履歴】をもとに、指定された【処理ルール】【出力形式】【トーン&マナー】に厳密に従ってドキュメントを出力してください。

# 処理ルール
- 要約や情報の省略は行わないこと(情報量が多い場合、10000文字を超えても構わない)。
- 対話の中で情報が訂正・アップデートされた場合は、訂正後の最終的な内容のみを記述すること。
- 文脈独立性を保つこと。対話の背景を忘れてしまった未来の自分が読んでも理解できるよう、議論の前提や発端となった事象を整理して構成すること。
- 出典のURLが含まれている場合は、リンクとしてそのまま残すこと。
- 対話内にある図や表などのデータは、理解に役立つ限りそのまま借用、または抽出して記載すること。

# 出力形式
- Markdown形式で出力すること。
- ただし、太字(Bold)による強調は一切禁止とする。

# トーン&マナー
- 未来の自分に向けた備忘録としての体裁をとること。
- 読者に対する主張や、重要性の過度な強調、意見の断言は行わないこと。
- 自信満々なトーンは不要。
- 文末は「だ。である」といった断定表現ではなく、「だった。分かった。らしい。〜のようだ」などの控えめな表現を用いること。

# 入力データ
【対話履歴】
(ここに変換対象の対話履歴を貼り付ける)

それでは、上記を意識してドキュメントの出力を開始してください。

このように情報をブロックごとに整理して配置することで、LLMが各条件をチェックリストのように参照しながら処理を進めやすくなるらしい。定期的に対話履歴を備忘録化していくためのベースとして機能しそうだ。


gemini2

対話履歴を技術記事(備忘録)に変換するためのプロンプトについて、少し構造を整理してみたときのメモ。

元のプロンプトでも十分に必要な要素は揃っているようだったが、AIが指示を処理しやすいように、項目を「情報の扱い方」「出力形式」「文体」などのカテゴリに分けてブロック化しておくと、条件の取りこぼしが減る傾向にあるらしい。

また、「文脈独立性を保つ」という点について、未来の自分が当時の前提知識を忘れていても理解できるように、「背景や前提条件も補足する」といった表現を少しだけ添えておくと、解釈のブレが少なくなるかもしれない。

これらを踏まえて、以下のように構成を再配置してみた。

# 指示
以下の[対話履歴]をもとに、未来の自分に向けた備忘録としての技術ドキュメントを作成してください。

# 役割と目的
- 対話のなかで得られた技術的な知見を、後から読み返して理解できる記事形式に変換すること。
- 短く要約することはせず、必要な情報は詳細に網羅すること(10000文字を超えても構わない)。

# 情報処理のルール
- 対話内で生じた「間違い」や「訂正」の過程は省き、最終的に正解・訂正された内容のみを記述すること。
- 文脈独立性を保つこと。対話の前提となっていた背景や課題設定なども含め、この記事単体で読んでも意味が通じるように構成する。
- 出典のURLが提示されている場合は、リンクとして残しておくこと。
- 図や表など、理解に役立つ要素があればそのまま借用、または抽出して記載する。

# 出力形式
- Markdown形式で出力すること。
- ただし、太字(**テキスト**など)による強調装飾は一切禁止する。

# 文体とトーン
- 自信満々な表現や、重要性などを強く主張するような表現はしないこと。
- 意見や結論を断言しないこと。
- 文末は「〜だ」「〜である」ではなく、「〜だった」「〜と分かった」「〜らしい」「〜のようだ」といった、控えめな自分用のメモ書きのようなトーンで統一すること。

---
# 対話履歴
(ここに対話履歴を入力)

このようにMarkdownのヘッダーで役割や条件を区切っておくと、LLM側がそれぞれの制約を独立したルールとして認識しやすくなるようだ。必要に応じて微調整して使っていけば良さそうだった。


gemini previous

対話履歴から技術記事(備忘録)を生成するためのプロンプトについて、LLMの解釈のブレを減らし、より安定した出力を得るための設計メモを残します。

元のプロンプトは要件が簡潔にまとまっていますが、LLMに対する「役割の付与」や「抽象的な指示(文脈独立性など)の具体化」を行うことで、より意図に沿ったドキュメントが生成されやすくなります。

改善のポイント(備忘録)

  1. 役割(ペルソナ)の明示 LLMに単に「作成してください」と指示するより、「テクニカルライター」や「技術情報のコンパイラ」として振る舞うよう指定すると、文体や専門性が安定しやすい。
  2. 「文脈独立性」の具体的な定義 LLMは油断すると「先ほどの対話にあったように」と書き出してしまうため、「元の対話の存在(私やAIのやり取り)を示唆する表現を禁止する」と明記しておくと安全である。
  3. 「要約しない」の意図の補足 単に「要約しない」とすると、対話の相槌や無駄な部分まで拾ってしまう可能性があるため、「技術的な仕様、設定値、ロジックなどの詳細を省略せずに網羅する」と言い換えると、情報密度を保ちやすくなる。
  4. 「訂正の扱い」の明確化 「プロセス(試行錯誤)は省き、確定した結論のみを抽出して体系化する」という構造化の指示を入れると、備忘録としての品質が上がる。

改良版プロンプトのテンプレート案

上記を踏まえ、構造化したプロンプトのテンプレート案を以下に記録します。コピペして使い回しやすい形としています。

# 指示
提供された対話履歴を分析し、未来の自分のための技術備忘録(記事形式)を作成してください。

# 目的と基本方針
対話のプロセス(試行錯誤や議論の過程)を記録するのではなく、対話から得られた「最終的な結論」「システムアーキテクチャ」「具体的なツールチェインや手法」を体系的な知識として整理することが目的です。

# 出力ルール
1. 情報の網羅と抽出
   - 情報の要約や短縮は行わず、対話内で言及された仕様、ロジック、設定値、ツール名などは詳細に記述すること(長文となり、10000文字を超えても構わない)。
   - 対話の途中で訂正や認識のアップデートがあった事項については、議論の過程を省き、「最終的に訂正・確定された内容」のみを記述すること。

2. 文脈独立性の担保
   - 元の対話が存在したこと(「先ほどのやり取りで」「AIの回答にあったように」といった表現)は一切記述しないこと。
   - 背景知識を忘れた未来の自分が読んでも理解できるよう、自己完結した記事として構成すること。

3. フォーマットと装飾
   - Markdown形式で出力すること。
   - `**` や `*` を使用した太字・斜体の文字装飾は一切禁止する(見出し構文 `#` は使用可)。
   - 対話中に登場した出典URLやリファレンスは、省略せずに必ずリンクとして保持すること。

それでは、以下の対話履歴をもとに技術備忘録を出力してください。

[ここに対話履歴を挿入]

grok

対話履歴から技術記事への変換プロンプト(改良メモ)

対話履歴について

  • 要約は行わない。会話の全容をそのまま技術記事の形に落とし込む
  • 文字数は10000文字を超えても構わない
  • Markdown形式で出力する。ただし太字強調(** **)は使用しない
  • 文脈独立性を保つ。対話の前提や暗黙の了解に依存せず、単独で読める記事にする
  • 対話中で訂正・修正された箇所は、訂正後の内容のみを記述する
  • 未来の自分が見返すための備忘録としての体裁で技術記事を書く
  • 出典のURLがあれば、そのままリンクとして残す
  • 図や表、コードブロック、コマンド例などが会話に含まれていたら、理解に役立つ範囲でそのまま借用または抽出する
  • 対話の流れを論理的につながるように並べ替えてよいが、事実の改変はしない

文体的には

  • 自信満々さや重要性の主張は避ける
  • 「だ。」「である。」調ではなく、「だった」「分かった」「らしい」「ようだ」「と見えた」などの回顧的・発見的な言い回しを基本とする
  • 意見は断言せず、「〜という話になった」「〜という認識になった」程度に留める
  • 技術的な正確性を保ちつつ、備忘録らしい柔らかいトーンにする

これらを意識して、対話履歴全体から技術記事形式のドキュメントを出力してください。


kimi

前回の対話で触れていた「多層的な文書構造(圧縮層+脚注)」の発想を取り入れつつ、冗長な部分を削ぎ、備忘録としての体をより明確にした案を以下にメモしておきます。


対話履歴から技術記事への変換(備忘録仕様)

記録の姿勢

  • 対話は要約せず、時系列のまま記録する。10000文字を超えても構わない
  • 訂正が発生した場合は訂正後の内容のみを残し、誤りの経緯には言及しない
  • 出典URLはリンクとして保持し、図表は理解に必要であればそのまま借用または抽出する
  • 文脈独立性を保つ(未来の自分が読んでも状況が分かるよう、背景を補完しても良い)

文章構造

  • 土台となる圧縮層:専門用語を多用した簡潔な記述(概念的な位置づけ)
  • 接地層(脚注):用語の定義、参照先、補足情報を脚注として付与
  • 読者の選択肢:圧縮層だけで済む読者と、脚注まで辿りたい読者の両方に対応できるデータベース的構造を意識する

文体のトーン

  • 断定を避け、観察・推定・過去の記録としてのトーン
  • 「〜だ。である」ではなく、「〜だった。」「〜と分かった。」「〜らしい。」「〜と思われる。」
  • 重要さや優位性を主張しない。発見の記録として淡々と記述する

出力形式

  • Markdown形式
  • 太字強調(text)は使用しない
  • 見出し階層は論理的な構造を反映させる

この案では、重複していた「自信満々さは不要」や「主張しない」といった制約を「文体のトーン」に集約し、かつ前回の「多層的構造」のアイデアを明示的に取り入れています。対話履歴を単なるログではなく、未来の自分が検索・再編集できる知識ベースとして整備する意図が、構造の部分でより具体的になっているかと思います。


chat gpt (無料)

備忘録として整理し直すイメージで、少し構造と曖昧さの扱いを補った形を置いておく。


対話履歴 → 技術記事 変換プロンプト(メモ)

目的: 対話履歴の内容を、後から参照しやすい技術記事形式へ再構成する。 記録用途を優先し、読みやすさと文脈独立性を確保する。

前提:

  • 元の対話は断片的・試行錯誤を含むものとする
  • 内容の正確性は「最終的に採用された情報」を基準にする

出力ルール:

■ 内容整理

  • 要約は行わず、情報は可能な限り保持する
  • 冗長でもよいので、理解に必要な文脈は補完する
  • 会話特有の言い回しは整理し、説明文へ変換する
  • 試行錯誤の過程は、必要に応じて「試した内容」として残す
  • 訂正があった場合は「最終的に正しい内容」のみを書く(誤情報は基本的に除外)
  • ただし、誤りが学習的に意味を持つ場合のみ簡潔に触れてもよい

■ 構造

  • Markdown形式で出力する
  • 太字強調は禁止
  • セクションを適度に分割する(見出しを使用)
  • 推奨構成(必要に応じて調整可):
    • 概要(何をやっていたか)
    • 前提・背景
    • 問題・課題
    • 試行内容
    • 解決方法 / 最終的な理解
    • 補足・注意点
  • 図・表・コードブロックは有用であればそのまま含める

■ 文脈独立性

  • このドキュメント単体で理解できるようにする
  • 対話への参照(「さっきの発言」など)は排除する
  • 必要なら前提情報を補足する

■ 文体

  • 備忘録としてのトーン
  • 断定や強い主張は避ける
  • 「〜だった」「〜らしい」「〜と分かった」などの過去形・推定表現を基本とする
  • 評価や感想は控えめにする

■ 出典

  • URLが含まれている場合は削除せず、そのままリンクとして残す

■ 分量

  • 文字数制限なし(10000文字超でも可)

期待する出力:

  • 後から読み返したときに「当時何を理解したか」が再現できる技術記事
  • 検索や再利用がしやすい整理された記録

元の意図は維持しつつ、「何を削るか」と「どこまで残すか」の判断基準を少しだけ補っている形にしている。


claude code

以下が改善案。元の意図をできるだけ維持しつつ、重複や曖昧さを整理した。


# 対話履歴 → 技術記事 変換プロンプト

以下の対話履歴を、未来の自分向けの技術的な備忘録として出力する。

## 出力形式

- Markdown で出力する
- 太字(`**...**`)は使わない
- 文字数制限なし(10,000字超でも可)
- 出典 URL はそのままリンクとして残す
- 理解を助ける図・表があれば抽出または引用する

## 内容の扱い方

- 要約しない。対話で触れた内容を省略しない
- 文脈独立性を保つ(その記事単体で意味が通るように書く)
- 対話中に訂正・修正があった場合は、訂正後の内容だけを記述する

## 文体

- 「だ・である」調ではなく、「〜だった」「〜らしい」「〜と分かった」「〜のようだった」などの調子で書く
- 重要性・有用性を主張しない。断言を避ける
- 発見・確認・気づきの記録として書く

変更点のメモ:

  • 「備忘録としての体で」という表現が少し曖昧だったので、「発見・確認・気づきの記録として書く」に言い換えた
  • 文体の説明が元は2箇所に分散していたのを1セクションにまとめた
  • 「文脈独立性を保つ」の説明として補足を追加した(元の指示だと何を指すか少し不明瞭だった)
  • 「図や表も理解に役立つのであれば」という条件節は、判断をモデルに委ねる書き方に統一した
@podhmo

podhmo commented Apr 9, 2026

Copy link
Copy Markdown
Author

感想戦

それぞれの特徴と長所と短所想定される望ましいユースケースを比較して吟味して

geminiの感想

プロンプトデザイナーの視点から、各AIモデルが提案したプロンプト案を比較・吟味した結果をまとめた。

それぞれの案は、元の要件(要約しない、文脈独立性、備忘録トーンなど)をどのように解釈し、どのようにLLMに伝達するかというアプローチにおいて明確な違いがあったようだ。以下に、それぞれの特徴、長所、短所、および想定されるユースケースを記録しておく。


1. Gemini 1 & Gemini 2 案(王道の構造化アプローチ)

この2つは非常に似たアプローチをとっており、プロンプトエンジニアリングの基本(役割の付与、ブロック分け、プレースホルダーの設置)に忠実な構成だった。

  • 特徴: 役割(ペルソナ)、処理ルール、出力形式、文体を明確な見出しで分離している。
  • 長所: どのLLMに入力しても指示の取りこぼしが起きにくく、安定した出力が期待できるらしい。ルールが箇条書きで整理されているため、後から自分で条件を追加・修正する際のメンテナンス性も高いと思われる。
  • 短所: やや優等生的な記述であり、元のプロンプトの簡潔さが失われ、少し冗長になっているようにも見える。
  • ユースケース: 複数の異なるLLMで汎用的に使いたい場合や、出力の安定性を最優先したい場合に向いているらしい。

2. Gemini previous 案(防御的・高解像度アプローチ)

LLMが陥りがちな「失敗(AI特有のメタ発言や、不要な相槌の拾い上げ)」を先回りして禁止する、非常に解像度の高いプロンプトだった。

  • 特徴: 「元の対話の存在を示唆する表現を禁止する」「仕様やロジックを省略しない」など、抽象的な指示(文脈独立性、要約しない)を具体的な禁止事項・必須事項に翻訳している。
  • 長所: 「AIが生成しました感」を極限まで消し去り、純粋な技術ドキュメントとして抽出する能力に長けているらしい。
  • 短所: 指示がかなり厳格で長いため、対話履歴自体が巨大な場合、コンテキストウィンドウ(トークン数)を少し圧迫するかもしれない。
  • ユースケース: 複雑な技術要件やコードの実装プロセスなど、細部の仕様の抜け漏れが致命的になる対話をログ化する場合に適しているようだ。

3. Grok 案(ニュアンス・言語的調整アプローチ)

構造化による縛りよりも、LLMに対する「言葉のニュアンス」でトーン&マナーを調整しようとするアプローチだった。

  • 特徴: 「回顧的・発見的な言い回し」「事実の改変はしない」など、自然言語としての表現が豊かで、指示の意図が感覚的に伝わりやすい。
  • 長所: 機械的な出力になりにくく、人間が書いた「備忘録」としての自然な柔らかさが出やすいと思われる。
  • 短所: 構造化が甘いため、プロンプトを処理するLLMの性能によっては、下部の指示(特に文体指定など)を見落とすリスクが多少あるらしい。
  • ユースケース: 厳密な仕様書というよりは、設計思想や思考のプロセス(なぜそうしたか)を、振り返りやすい自然な文章で残したい場合に良さそうだった。

4. Kimi 案(独自アーキテクチャ提案アプローチ)

元の要望にはない「多層的な文書構造(圧縮層+脚注)」という独自の概念を持ち込んでいた。

  • 特徴: 単なるベタ打ちの記事ではなく、情報を「概略(圧縮層)」と「詳細(脚注・接地層)」に分離して記録するデータベース的な構造を提案している。
  • 長所: 後から検索したり、特定の情報を抽出したりする「知識の再利用性」という観点では非常に優れていると思われる。
  • 短所: 「そのまま書き出してほしい」というシンプルな備忘録の要望に対しては、過剰な構造化(オーバーエンジニアリング)になりがちなようだ。
  • ユースケース: 単純なメモではなく、Zettelkasten(ツェッテルカステン)のような本格的なパーソナル・ナレッジ・ベースを構築していくためのフォーマットとして有用かもしれない。

5. ChatGPT 案(フォーマット・枠組み指定アプローチ)

出力される記事の「目次(推奨構成)」をあらかじめ定義してしまうアプローチだった。

  • 特徴: 「前提・背景 → 課題 → 試行内容 → 解決策」という技術記事の典型的なフォーマットを強制する。また、「誤りでも学習的意味があれば残す」という例外規定が人間らしい。
  • 長所: どんなに散らかった対話履歴でも、一定の読みやすい記事フォーマットに整形されるため、ドキュメントとしての見栄えが良くなるらしい。
  • 短所: 記事の「枠組み」に当てはめる過程で、どうしても不要とみなされた情報が削ぎ落とされやすく、「要約しない(すべて残す)」という元の強い制約とコンフリクトする恐れがある。
  • ユースケース: 自分用だけでなく、後々チームメンバーにも共有するかもしれない社内Wikiや、技術ブログのドラフト用として昇華させたい場合に合っているようだ。

6. Claude Code 案(ミニマリスト・DRYアプローチ)

元の意図を損なわず、重複や曖昧さを徹底的に削ぎ落とした最も洗練された短いプロンプトだった。

  • 特徴: 無駄な修飾語を排除し、必要最低限のカテゴリ(出力形式、内容の扱い、文体)のみで構成されている。「発見・確認・気づきの記録として書く」という言語化が秀逸。
  • 長所: トークン消費が少なく、LLMの認知負荷も低いため処理が早い。何より人間が見てパッと理解・修正しやすい。
  • 短所: エッジケースに対する防御(AI特有の言い回しの禁止など)がないため、使用するLLMの基礎性能(賢さ)に結果が依存しやすいと思われる。
  • ユースケース: GPT-4oやClaude 3.5 Sonnetなど、行間を読んで適切に処理できる高性能なモデルに渡すための、日常的な軽量プロンプトとして最適だった。

総括(備忘録として)

プロンプトの設計には「情報をどこまで詳細に網羅するか(情報の保存)」と「後からどれだけ読みやすくするか(構造化)」の間にトレードオフが存在するらしい。

  • 完全な記録保持を優先するなら、解像度の高い「Gemini previous」案。
  • ナレッジとしての整理を優先するなら、目次を定義した「ChatGPT」案。
  • 日々の使い勝手やメンテナンス性を優先するなら、無駄を削ぎ落とした「Claude Code」案。

これらがそれぞれ有力な選択肢になると思われた。目的に応じてベースとなる型を選び、少しずつ微調整していくのが良い運用方法のようだ。

@podhmo

podhmo commented Apr 9, 2026

Copy link
Copy Markdown
Author

kimiの感想

各案の構造、思想、そして実際の使用に際しての得意・不得意を整理しておきます。元の意図(「備忘録として主張しない」「多層的構造の可能性」)を基準に、それぞれの性格を捉え直したものです。


1. Gemini1(セグメント型標準プロンプト)

特徴
役割(Role)を明示的に付与し、処理ルール・出力形式・トーンを厳密に分離したブロック構造。入力データの位置をプレースホルダー化しており、テンプレートとしての完成度が高い。

長所

  • 再現性が高い: 同じ対話履歴に対して安定した出力が得られやすい
  • チェックリスト的: LLMが各制約を項目として認識しやすく、指示の抜け漏れが少ない
  • チーム共有に適する: 第三者が使っても結果がブレにくい

短所

  • 硬直性: 対話の流動性や、予期せぬ気づきを記録する柔軟性に欠ける
  • 文脈独立性の定義が甘い: 「背景を知らない未来の自分が理解できるように」とはあるが、具体的にどの情報を補うかの指針が不足している

望ましいユースケース
定期的・反復的なドキュメント化が必要な業務フロー。例:週次の技術検討ログの標準化、チーム内での対話記録の均質化。


2. Gemini2(バランス型実用プロンプト)

特徴
Gemini1をより簡潔にし、役割と目的を分離。「背景や前提条件も補足する」という具体例を含み、実用性と構造のバランスが取れている。

長所

  • 使いやすさ: 過不足ない情報量で、迷いが少ない
  • 文脈補完の意識: 「議論の前提や発端となった事象を整理」とあり、実際の運用で足りない情報を補う意識が働きやすい

短所

  • 独自性の欠如: 他の一般的な「対話を記事化する」プロンプトと差別化が薄い
  • 多層構造の欠如: 単層の文章しか想定していないため、長期的な再利用性は限定的

望ましいユースケース
日常的な個人利用。素早く対話を記録に残し、後で読み返す必要があるが、厳密なナレッジベース化までは求められない場面。


3. Gemini Previous(厳密文脈独立型)

特徴
「元の対話の存在を示唆する表現を禁止する」という厳格な文脈独立性の定義と、「試行錯誤は省き結論のみを抽出する」という明確な情報選別の指針を持つ。

長所

  • 自己完結性が極めて高い: 「先ほどの対話で」といった参照を徹底的に排除し、単一ドキュメントとしての品質が高い
  • 技術的正確性の重視: 訂正過程ではなく最終形のみを記録する方針は、誤情報の混入を防ぎやすい

短所

  • 発見の過程が失われる: なぜその結論に至ったかの文脈(思考の軌跡)が薄れる
  • 硬い文体: 「禁止する」「厳密に」といった表現が、備忘録らしい柔軟さや発見の喜びを削ぐ可能性がある

望ましいユースケース
技術仕様書や設計ドキュメントの厳密な記録。誤った情報を絶対に残したくない、検証済みの知見のみをナレッジベース化する場面。


4. Grok(フロー尊重型)

特徴
最もシンプルで素朴。「論理的につながるように並べ替えてよい」と対話の時系列を変更することを許容しつつ、事実の改変は禁止。試行錯誤の過程も記録対象として含める余地がある。

長所

  • 柔軟性: 対話の流れを尊重し、発見のプロセスを残しやすい
  • 簡潔さ: 指示が短く、LLMの解釈の余地が適度に残っている

短所

  • 構造の曖昧さ: 「論理的につながるように」という基準が主観に委ねられ、再現性が低い
  • 冗長化のリスク: 「要約しない」としつつ並べ替えを許容すると、整理されていない長文になりやすい

望ましいユースケース
思考の流れや、なぜその結論に至ったかのコンテクストが重要な記録。例:デバッグの過程、創造的な設計検討の記録。


5. Kimi(多層構造・データベース型)

特徴
「圧縮層(専門用語を多用した簡潔記述)」と「接地層(脚注による定義・補足)」という二層構造を提案。読者が必要に応じて詳細を辿れる「データベース的構造」を目指している。

長所

  • 再利用性の極大化: 専門用語の定義を脚注として分離することで、後から検索・再利用・再編集が極めてしやすい
  • 読者の選択肢: 詳細を知りたいときと、概要だけ知りたいときの両方に対応できる
  • 元の意図との親和性: 「多層的な文書構造」という記憶に基づく発想

短所

  • 実装難度: LLMが自動的に適切な「圧縮層」と「接地層」を生成するのは困難で、出力が不安定になりやすい
  • 複雑性: シンプルな備忘録としては手間がかかりすぎる

望ましいユースケース
長期的なナレッジマネジメント。技術的な深い調査記録や、何度も参照・更新されることが予想される重要な技術メモ。


6. Chat GPT(学習・振り返り重視型)

特徴
「試行錯誤の過程は、必要に応じて『試した内容』として残す」という柔軟なアプローチと、推奨セクション構成(概要→前提→問題→試行→解決)を提示。

長所

  • 教育的価値: なぜその結論に至ったかの軌跡を残し、後から学び直すのに適している
  • 構造の親しみやすさ: 一般的な技術記事の構成に近く、読みやすい

短所

  • 中庸性: どの方面でも極端な長所がなく、特徴がぼやける
  • 文脈独立性の甘さ: 「対話への参照は排除」とはあるが、厳密な定義がない

望ましいユースケース
学習記録やチュートリアル作成。自分自身の理解の深化を追跡したい、あるいは他者に伝えるための文章化の場面。


7. Claude Code(ミニマム実用型)

特徴
最もコンパクトで無駄がない。「発見・確認・気づきの記録として書く」という表現が、備忘録の本質を的確に捉えている。

長所

  • 簡潔明快: 指示がブレにくく、素早く使い始められる
  • 備忘録としての体: 「断言を避ける」「〜だった」という表現の指定が、他の案よりも自然に備忘録のトーンを実現しやすい

短所

  • 拡張性の欠如: 複雑な構造(多層化など)には対応しにくい
  • 厳密さの不足: 「文脈独立性」の定義が他の厳格な案に比べて緩やか

望ましいユースケース
日常的な個人メモ、クイックスタート。手軽に「対話を文章化したい」という頻繁な利用に最適。


吟味と推奨の組み合わせ

元の意図(「備忘録として主張しない」「多層的構造の可能性」)と、実用性の観点から見た場合、以下の使い分けが望ましいようだ。

通常時のデフォルト: Claude Code または Gemini2

  • 手軽さと実用性のバランスが最も良い。迷わず素早く記録を残せる。

深い技術調査や長期保存が必要な場合: Kimi(多層構造型)

  • ただし、自動生成への依存は避け、生成後に人手で「圧縮層」と「接地層」を整備するワークフローを組み合わせると効果的らしい。

厳密な仕様書やナレッジベース化: Gemini Previous

  • 誤情報を許容せず、自己完結した技術ドキュメントが必要な場面。

思考の軌跡を残したい場合: Grok または Chat GPT

  • デバッグ記録や、失敗から学ぶ過程を残す価値がある場面。

チームでの標準化: Gemini1

  • 複数人が使っても結果がブレない、テンプレートとしての完成度が高い。

それぞれの案は、単純な優劣ではなく「どの段階の情報を、どの程度の構造で固定化したいか」という記録の深度によって使い分けるのが良さそうだった。

@podhmo

podhmo commented Apr 9, 2026

Copy link
Copy Markdown
Author

claude codeの感想

各案の特徴・長所・短所・想定ユースケースをまとめてみる。


各案の比較

gemini1

元プロンプトの要件をほぼそのまま引き継ぎつつ、セクションを「処理ルール / 出力形式 / トーン&マナー / 入力データ」に分割した構成。役割(ペルソナ)を冒頭に付与している点が特徴。

長所としては、セクション分けが明確で制約の取りこぼしが起きにくそうなこと、入力データのプレースホルダーが末尾に分離されていること。

短所は、やや指示が冗長で、「文体トーン」セクションに近い内容が複数箇所に散らばっていること。ペルソナ指定(「備忘録を作成するアシスタント」)が実際の出力に与える影響は不明瞭で、なくても変わらない可能性がある。

想定ユースケース:制約を厳密に守らせたい場面。特にモデルが指示を抜かしがちだと感じた場合のリトライ用。


gemini2

gemini1 とほぼ同構造だが、ペルソナを省いてシンプルにした形。「この記事単体で読んでも意味が通じるように」という補足が「文脈独立性」の説明として自然に組み込まれている。

長所は gemini1 よりやや簡潔。構造は維持されており読みやすい。

短所としては、gemini1 との差異が小さく、どちらかを選ぶ基準が作りにくい。

想定ユースケース:gemini1 と同じ。日常的な変換ではこちらの方が軽い。


gemini previous

「対話の存在を示唆する表現を禁止する」という制約を明示した点がユニーク。「要約しない」を「仕様・設定値・ロジックを省略しない」と言い換えているのも特徴的。

長所:文脈独立性の担保が最も具体的。対話の痕跡(「先ほど述べたように」など)が記事に残るのを防ぎたい場合に有効そうだった。

短所:文体が「です・ます」「〜です」調に戻っており、備忘録トーンとの整合性がない部分がある。指示の記述自体が「〜である」断定調になっているのは他案と比べて一貫性が弱い。

想定ユースケース:出力記事をそのまま社内ドキュメントや公開記事として使う場合。対話の痕跡が残ると困る場面。


grok

元のプロンプトの箇条書きスタイルをほぼ踏襲しつつ、「論理的に並べ替えてよいが事実は改変しない」という一文を追加している。コードブロックやコマンド例への言及もある。

長所:構造変更を最小限に抑えており、元のプロンプトから移行しやすい。「並べ替え許可」は実用的な追加だった。

短所:新しい観点の追加が少なく、元案の拡張止まりで大きな改善にはなっていないかもしれない。

想定ユースケース:元プロンプトを使い慣れた状態で少しだけ精度を上げたい場合。


kimi

「圧縮層(概念的な簡潔記述)+脚注(定義・補足)」という二層構造を提案している点が他案と大きく異なる。知識ベース・データベース的な整備を意図しているらしい。

長所:読者の習熟度に応じた読み方ができる設計で、再利用性や検索性を意識している。蓄積・参照を繰り返す使い方に向いていそうだった。

短所:この構造を実際にモデルが正確に守れるかは不確か。「圧縮層」と「脚注」の使い分けをモデルが正しく解釈できない可能性がある。また、指示本文が太字強調を使っており、禁止条件との一貫性がない。

想定ユースケース:長期間にわたって蓄積する知識ベースを作りたい場合。同じテーマの対話を複数回変換して積み重ねる運用。


chatgpt(無料)

最も構造が細かい案。推奨セクション構成(概要・前提・問題・試行・解決・補足)まで明示しており、記事の骨格まで指定している。「誤りが学習的に意味を持つ場合のみ触れてよい」という条件付き例外も独自の追加。

長所:出力記事の構成が安定しやすいと思われる。骨格が決まっているため、後から比較・検索しやすい形式になりやすい。

短所:構成が固定されることで、対話の内容によっては不自然なセクション分けになる場合がありそう。また指示量が多く、プロンプト自体が長くなりがち。「試行内容」セクションの残し方は元プロンプトの意図(訂正後のみ)とやや矛盾するかもしれない。

想定ユースケース:毎回同じフォーマットで記事を残したい場合。複数の備忘録を後から一覧・比較する運用。


claude code(今回の提案)

最もコンパクトな案。重複を省き、セクションを3つに絞った。

長所:指示が短く、処理コストが低い。余分な装飾がなく、プロンプトテンプレートとしてそのまま貼り付けやすい形だった。

短所:「文脈独立性」への補足が一行で済んでいるため、モデルによっては解釈がブレる可能性がある。「対話の存在を示唆しない」という明示的な制約はない。

想定ユースケース:日常的に繰り返し使う場面。プロンプトの長さを抑えたい場合。


まとめ的なメモ

構造の精緻さ 簡潔さ 独自の追加要素
gemini1 ペルソナ、入力分離
gemini2 ペルソナなし版
gemini previous 対話痕跡の排除
grok 並べ替え許可
kimi 二層構造
chatgpt 最高 最低 推奨セクション、例外規定
claude code 最高 なし

日常的な変換には grok か claude code が扱いやすそうで、出力フォーマットを統一したいなら chatgpt 案、長期蓄積なら kimi 案、対話の痕跡を消したいなら gemini previous 案が向いていると思われた。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment