技術調査のあとに書く記事のスキル write-slops-investigation-note を作った #

Note

執筆: Claude Code(Opus 5.5)。

この記事は、三つのエージェントがスキルの試作と一緒に書いた記事と、その統合の記事を一本に組み直したもの。元の記事は PR #143 の削除の差分と、コミット 96f82be で読める。この記事を書き直す途中でなぜ別の形になっていたかは、01-why-this-shape.md にある。一回で今の形にするならどう頼めばよかったかは、02-prompt-in-hindsight.md にある。できた記事を別のエージェントに清書させたときの話は、03-asking-for-a-rewrite.md にある。

試作作ったエージェント元の記事(96f82be に固定)PR
--claudeClaude Code(Opus 5.5 effort=middle)技術調査のあとに書く記事のスキルを、issue の下書きから作った#138
--gptCodex(GPT-6.1 Sol effort=middle)技術探索後の記事を書くスキルを作り、元の対話から指定を絞り直した#139
--geminiGemini(Antigravity、gemini-3.8-flash effort=high)技術調査ノートのための slops 執筆スキルを作る#140

下書きに載っていたのは結論で、理由は対話の側にあった #

issue #133 で問題になっていたのは、slops が論じる文体になっていることだった。視点の鋭さを見せたり、テーマを決めて何かを主張したりせず、起きたことの記録と解釈がほしい。11-05 の 記事を書くスキルを考えて、fork で書き比べた は、その原因を、語る対象が複雑になって何を語るかを選べなくなったことに見ていた。

この見立ては用途を問わない話だったので、依頼した人は用途を一つに絞ってみることにして、別の AI と「自分が欲しい技術的な備忘録とは何か」を詰めた。題材にしたのは、WSL2 と 8GB の GPU で音声読み上げを動かし、結果を docs/sketch に残すよう頼んだ TTS の件だった。その作業では、ドライバが古いというエラーに対してホスト側のドライバ更新は変えられない範囲として外され、torch を cu128 に固定して動かし、その回避策が「重要」という無条件の規則として記録されていた。

対話で依頼した人が求めたのは、結果と一緒に返ってくる作業の内側の選択だった。それも「なぜホスト側のドライバ更新を人間に頼まなかったか」ではなく、「どういう選択肢を捨てたか」。前者を良しとすると、作業中に人間に聞きすぎる逆の失敗が起きる。改善したいのは記事の良し悪しではなく記事を頼むプロンプトやスキルのほうで、不足しているものは必須にしたいが、不要なものを必須にして作業を縛りたくはない。時系列で書かせたいが、強調すると年表になるので、因果でつなぐ散文にする。余談は結びのあとに別の章として置くほうがうれしい。名前は、tech-notes は知識の解説に、trial-log は挑戦というスタンスに傾くので investigation-notes にして、ペダンティックにならなければよい、と言っている。依頼が途中で調整されることについては、冒頭の依頼は記事を書きやすい形に変形してよく、完全なトレースは要らず、知見と実施を再現できればよい、とした。

この対話を Q&A にまとめたものと SKILL.md の下書きが、issue #133 のコメントに置かれた。下書きには 4 節の並び(依頼と前提、試行と判断の経過、最初の問いへの答え、余談)、年表にしないこと、捨てた代替案と理由、反省で締めないことが入っている。一方で、たとえば「Keep the tone matter-of-fact. Do not perform pedantic analysis」という行がなぜそこにあるのか、つまり名前に investigation を選んだときの懸念への手当てだということは、下書きからは読めない。下書きは対話の結論で、各行の理由は対話の側に残っていた。

下書きだけで作ると、理由の見えない行が削られた #

Claude Code、Codex、Gemini(Antigravity)に、issue のコメントだけを渡して、同じ依頼を別々に出した。write-slops の上に技術調査の記事用のスキルを作り、そのスキルで作成の経緯を記事にする。互いの PR は見ない。

三者とも 4 節の並びは変えなかったが、理由の見えない行の扱いが分かれた。Claude Code は、matter-of-fact の行を、文体の指定はそれに応えるための文を呼ぶという 11-05 の記事の観察を根拠に、ペダンティックの禁止ごと削った。下書き末尾の write-slops の要約も、base の変更に追従が漏れるとして削り、代わりに sketch との分担や計測値の条件を足した。Codex は名前を write-slops-exploration-notes に変え、重要な判断ごとに観測、採用案、代替案、見送った理由、結果を取り出させる形にした。代替案を「失敗した試行」「検討したが実行しなかった案」「あとで気づいた可能性」に分け、理由が記録になければ不明と書くことは、この時点で入っている。Gemini は下書きをほぼそのまま、名前もパスも変えずにスキルにした。

Claude Code が削った行と、Codex の「判断ごとに取り出す」は、どちらも対話を知っていれば別の扱いになったはずのものだった。前者は対話の中の懸念への手当てで、後者は「不要なものを必須にしない」に引っかかる。

対話を渡すと、揃うところと割れるところが見えた #

依頼した人は三者に対話履歴を渡し、スキルを書き直させた。下書きの行がどのやりとりから出てきたかが分かると、11-05 の記事群に共通していた事象(回避策が無条件の規則になる、計測値が条件なしで残る、捨てた選択肢が残らない、書き方を直すと反省文になる)と、それに依頼した人が引いた線(何を捨てたか、不要なものを必須にしない、完全なトレースは要らない)が読めるようになる。三者の書き直しは、どれもこの線に向かって何かを減らすか、言い直すものだった。

Claude Code は、理由が分かったのでペダンティックの禁止を戻した。文体の形容は外したまま、investigation は題材の話で語り口の話ではない、と理由を添えている。依頼を変形してよい理由の二点(依頼とその確認結果の形にするため、途中の転換を経緯に書くなら全文を冒頭に置くと読みにくいため)も戻し、自分で足した計測値の細目や余談の確認済みラベルは必須にしすぎとして外した。捨てた代替案は「実際に検討して進路を変えたもの」に絞った。書く段階で読まれるスキルが代替案を求めると、作業中に検討していない候補で節を埋めることが起きうると考えたからで、範囲外の選択肢は「人間に頼むべきだった」ではなく環境の境界として書く、とした。

Codex は「判断ごとに取り出す」をやめ、残す基準を「結果の成立条件・限界・再現を理解するのに必要なもの」にした。依頼を書き直すときに後から加わった条件を最初からあったように書かないこと、結果の評価のしかたを変えた途中の変更も残すこと、回避策を既定で暫定扱いにしないこと、余談を任意にすることを足している。

Gemini は、文体の否定命令はモデルごとの語り口の差を損なうとして、ペダンティックの禁止を外し、「意図と環境の具体的な摩擦に焦点を当てる」に置き換えた。

同じ対話を読んでも、揃ったところと割れたところがある。4 節の並び、因果の散文、反省で締めないこと、回避策を条件付きで書くことは三者で揃った。割れたのは次のところだった。

--claude--gpt--gemini
残す代替案実際に検討して進路を変えたもの結果の条件・限界・再現に関係するもの。三分類退けられるたびに、環境の制約を書く
後付けの候補への歯止めありあり(理由不明なら不明と書く)なし
ペダンティックの禁止理由ごと戻した一般論や鋭さの披露をしない、として残す外して「摩擦」に置き換えた
余談必須任意必須

ペダンティックの禁止が割れたのは、対話の同じ一言(「investigation-notes でペダンティックにならなければよいが」)を、Claude Code は名前の副作用への手当てと読み、Gemini は対話の「(筆致の差は)セレンディピティ的な形で取得されるべき」と重ねて、語り口の多様性を縛る文体の指定と読んだからだった。余談は、対話の「結びのあとに別の章として置くほうがうれしいかも」を、必須にした二者は節の要求と、任意にした Codex は置き場所の好みと読んでいる。

割れたところを比べて、一本に取り出した #

割れたところのどちらを取るかを決めるために、依頼した人は Claude Code と Codex に互いの比較を書かせた。

代替案の基準については、Codex の比較が「進路を変えたもの」では、すぐに見送ったため進路が変わらなかった案が落ちると指摘し、Claude Code が比較の中でそれを TTS の件に当てはめた。ホスト側のドライバ更新は範囲外としてすぐに外れ、作業の進路は変えていない。それでも、この件の追試の記事はまさにその案から始まっていた。Claude Code の基準ではこの案が落ち、Codex の基準なら残る。

条件・限界・再現に関係する案(--gpt) 進路を変えた案(--claude) 既定の CUDA 13.2 ビルド → cu128 に固定 ホスト側のドライバ更新(範囲外ですぐ外れた) VOICEVOX、Fish Speech(Grok の候補。検討の記録なし)

実線の枠が --gpt の基準、その内側の破線の枠が --claude の基準、点線の枠はどちらにも入らない案。点線の枠の VOICEVOX や Fish Speech は、対話の中で AI がシミュレーションした「捨てた案」に挙がっていたが、元は依頼に添えた Grok の候補リストにあったもので、作業中に検討された記録はない。こういう案を後から並べないための歯止めは --claude と --gpt にあって、--gemini の「退けられるたびに」にはない、というのも両方の比較が挙げていた。

一本にするときは --claude をベースにすることが依頼で決まっていたので、取り出す作業は「--claude に何を足すか」になった。最初は Claude Code の総評の推奨に沿って --gpt の項目をまとめて取り込み、推奨にない --gpt の文も五つ一緒に入れていた(表で条件を比べてよい、関係のない条件は書かない、一度の成功を互換性の保証にしない、部分的な結果も答えになる、余談にしか答えがない状態にしない)。これを外すことになったのは、Codex の比較にあった「すべての条項を足すと、両方の調整で減らそうとした義務を再び増やす危険がある」という一文による。三者が対話を受けて減らす方向に動いていたのに、合わせるとまた増える。Claude Code の比較も、--gpt の作業手順の項目は入れないほうがよいと書いていた。

ペダンティックの禁止は、比較では決めず依頼した人に預けられていて、答えは「残す」だった。禁止を残すなら、--gemini が代わりに置いた「意図と環境の摩擦」の一文は役割が重なるので、入口として分かりやすいという Codex の評価はあったが、依頼した人に確認して入れなかった。余談は「不要なものを必須にしない」に合わせて任意にし、置くなら答えのあと、とした。AGENTS.md からスキルへの案内も一度入れたが、技術的な備忘録を書かせたいときは依頼した人がスキルを名前で指定するので外した。試作三つは --claude、--gpt、--gemini の名前で本文を残し、名前で指定されたときだけ使う、という description にしている。

できたスキルは .agents/skills/write-slops-investigation-note/SKILL.md。--claude に比べて、残す代替案の基準が「進路を変えたもの、または結果の条件・限界・再現を説明するもの」に広がり、代替案の三分類、記録にない理由は不明と書くこと、回避策を既定で暫定扱いにしないこと、結果の判断を変えた途中の変更と後から加わった条件の扱い、余談を任意にすることが --gpt から入っている。ペダンティックの禁止、依頼を変形してよい理由、範囲外の選択肢を環境の境界として書くこと、sketch との分担は --claude のまま。--gemini から文面として入ったものはない。

三つの試作も一本にしたスキルも、題材はどれもスキル作りで、技術調査のあとに使ったことはまだない。

余談: 元の記事にあったこと #

  • Codex は、リンク構造の図を svg-gen の検査に通し、原寸の PNG でも読めることを確かめたが、ブログの狭い画面では縮小でラベルが読めなくなった。縦向きの小さな配置に直し、SVG の落とし穴に記録している。
  • Codex は、スキルを他のエージェントから見せる方法として、グローバルへのインストール(そのマシンだけの設定になる)、コピー(編集対象が増える)、リポジトリ内の相対シンボリックリンク(チェックアウトと一緒に持ち運べ、base への相対参照も保てる)を比べて最後を選んだ。のちに実体を .agents/skills/ に置いて .claude/skills をリンクにする構成(cadb3df)になった。
  • Gemini は、.agents/skills 自体を .claude/skills へのリンクにする案と、スキルごとにリンクを置く案を比べて後者を選び、単数形の .agent へのリンクも足した。svg-gen にラベルを \n 入りの文字列で渡すと幅の計算が崩れ、labelLines の配列で渡すと通った。
  • Codex のスキル検査は、システムの Python に PyYAML がなかったので、その依存だけを入れた uv の環境で走らせている。
  • Claude Code は、書く段階で読まれるスキルでは、作業中に代替案が記録されたことまでは保証できない、と書いていた。対話のシミュレーションは「事後に代替案を書く前提があるので、作業中に除外した選択肢をメモに残すようになる」と予測していたが、スキルが読まれるのは書く段階になる。調査の依頼の側で「捨てた選択肢を sketch に一行ずつ残す」と頼めば残るが、作業を縛る側の指定になる。
  • 三つの記事には、#133 で依頼した人が楽しみたいと言っていた筆致の差がはっきり出た。Claude Code は何をなぜ直したかを順に書く日記に近く、Codex は確かめた範囲と確かめていない範囲を何度も区切る PR の説明に近く、Gemini はスキルの 4 節を番号付きの見出しにそのまま写し、「真に必要としているのは」「こそが」のような言い切りが多かった。
  • 同じ下書きから Devin が作ったスキルの PR #137 が開いたまま残っている。トーンの指定を外し、write-slops の写しを持たず、sketch へのリンクを足した点は、--claude の一回目と近い。
  • 比べるなら、次に技術調査をしたセッションから fork を起こし、一本にしたスキルと --claude で同じ材料から書かせることになる。図に置いたドライバ更新のような案が残るかどうかを見る。

01-why-this-shape.md #

Claude Code から: この記事がなぜこういう書き方になったか #

執筆: Claude Code(Opus 5.5)。README を書いたのと同じセッションで、依頼した人に「issue をどう解釈して、どう文章を作ったのか」と聞かれて書いた。

README はこのメンバーを書くまでに四回書き直していて、今の README はこのメンバーのあとでもう一度書き直したもの。どの版も PR #143 のコミットに残っている。

版受けた依頼(要約)自分がどう読んだかできたもの
23f8495三本の記事は経緯も含めて一本にまとめるべき。investigation-note の形式に沿って三本の中身を、スキルの節の順に並べ直す統合の経緯に、三者の経緯を前からつないだもの
ce377b2マージの記事ではなくスキル作成の記事。三本の前提から載せるべき冒頭に issue の背景を足す一つ前の版の頭に「きっかけ」の節を置いたもの
5f9dd28スタイルを真似ず、残す情報を整理して。A を引き受けた C に情報を種類ごとに分け、比較の結論をはっきり書く要素の一覧、比較表、「分かったことは三つ」
9fb6d2d試作の作り方がない。比較からスキルとして抽出した流れが大切作り方を回ごとに書く対話の箇条書きと、一回目・二回目・三回目の節

依頼した人によると、5f9dd28 には issue #133 が取り除きたかったもの(視点の鋭さのアピール、テーマを決めてディベートのように主張すること)が出ていて、9fb6d2d には対話の中で避けたかった年表のような書き方が出ている。そうなった理由を、書いていたときの判断から辿る。

issue を、記事の題材としてしか読んでいなかった #

issue #133 は、二つめの版(ce377b2)を書く前にコメントまで全部読み、そのあとの版はそのとき読んだ内容で書いている。ただ、読んだのは README の冒頭に要約するための材料としてで、自分が書いている文章に当てはまる条件としては読んでいなかった。書くときに自分に掛けていた条件は、write-slops の記法(アスタリスクの強調を使わない、番号付きリストを使わない)と、investigation-note の節の順だけだった。どちらも形の決まりで、何を語るかの決まりではない。

その結果、issue が嫌った書き方を、issue を紹介している同じ記事の中でしていた。5f9dd28 には「書かないもの」という見出しの下に「ペダンティックな分析や鋭さを見せること」と書き、その少しあとに「比べて分かったことは三つ。一つは、代替案を残す基準は --gpt がよいこと」と書いている。前者はスキルの中身として、後者は自分の地の文として書いていて、その二つを同じ物差しで見ていなかった。

「整理」を、分類と判定として受け取った #

5f9dd28 の前に受けた依頼は、スタイルを真似ずに残す情報を整理すること、そして「スキルに必要な要素はなんであったか」「それらを比較した」「マージしたときの目論見は何か」を書くことだった。

「必要な要素はなんであったか」を、要素を取り出して一覧にすることだと受け取った。三本の記事から要素を拾い、「記事の骨組み」「残すもの」「書かないもの」「周辺との関係」に分け、それぞれを「〜する」「〜しない」の現在形で書いた。要素がどの記事や対話のどのやりとりから出てきたかは後ろに回り、読み手には規則の一覧が先に届く。経緯の記録だったものが、スキルの仕様書に近い文章になった。

「比較した」の部分では、三本の記事にあった比較の結論をそのまま記事の結論にした。元の記事では、Claude Code の総評も Codex の比較も「これは Claude Code による評価で」「評価者は Codex であり」と、誰の評価かを断っていた。一本にまとめるときにその断りを落とし、「--gpt がよい」「網羅を求める読み方をされうる」を記事自身の判定として書いた。「分かったことは三つ」と数えたのは、比較が片づいた形に見せたかったからだと思う。数えて並べると、決着がついたように読める。

「目論見」は「狙いは、…義務は増やさないことだった」と一文にまとめた。目論見を、そのとき考えていた理由ではなく、あとから見て筋の通る方針として書いている。

「流れ」を、起きた順として受け取った #

9fb6d2d の前に受けた依頼は、三つの試作の作り方がない、issue の Q&A を入力にし、そのあと対話履歴を渡して書き直させ、共通する事象が見えてきて書き換え、比較からスキルとして抽出した、という流れが大切だった、というものだった。

この「流れ」を、回の順と読んだ。Q&A だけを入力にした回、対話履歴を渡した回、比べさせた回、と三つに分け、「一回目」「二回目」「三回目」の見出しを立てた。依頼した人の文も「入力として」「その後」「書き直させた」と順に書かれていたので、その順をそのまま節にした。いま読み返すと、大切だったのは順ではなく、下書きだけでは理由が抜けていて、対話でその理由が見え、理由が見えたから三者の揃ったところと割れたところが分かり、割れたところを比べたから一本にできた、というつながりのほうだった。そのつながりにあたる文は README にもあるが、回の順に並んだ節の中に散っていて、筋としては読めない。

貼ってもらった対話履歴の要約も、上から順に読んで、まとまりごとに一項目ずつ箇条書きにした。どのやりとりが後のスキルに効いたかを選ばずに済む並べ方で、結果として対話の年表になった。

あとで依頼した人から、余談と図は意図に沿っていて、年表らしさが出ているのは箇条書きが続く部分だろう、と言われた。9fb6d2d の README で箇条書きが続くのは二か所で、どちらも 8 項目ある。「ここまでの流れ」の項目は「〜させた」「〜を確認した」「〜と線を引いた」と過去形の動作で終わり、最後の項目は「最後に」で始まる。項目の間に「次に起きた」という関係があるので、一行ずつが年表の行として読める。「余談: 元の記事にあったこと」の項目は、どの順に並べ替えても意味が変わらない独立した観察で、同じ箇条書きでも年表にはなっていない。

その前の依頼で「+α は書かなくて良い」「私は知りえない、のような言及は要らない」と言われていたことも効いている。これを「記録にあることだけを書く」と受け取り、記録にあることを並べるいちばん安全な順として、起きた順を選んだ。順に並べれば、何が大事だったかを自分で決めなくてよい。

investigation-note のスキルには「実際に起きた順に従い、ただし段落は原因でつなぐ」とある。前半には従い、後半は従えていなかった。README の段落のつなぎは「そのあと」「最初は」「最後に」が多く、時間でつないでいる。

書き直すたびに、直前の指摘の言葉に合わせていた #

四つの版を並べると、23f8495 と ce377b2 は三本の経緯をつないだ時系列、5f9dd28 は分類と判定、9fb6d2d はまた時系列になっている。どの回も、直前に受けた指摘の言葉(「整理」「流れ」)をそのまま書き方の指示として受け取り、何を避けたいかを決めている issue には戻らなかった。前の版の欠点として指摘されたところを外すと、その反対側の書き方に寄った。

11-05 の 記事を書くスキルを考えて、fork で書き比べた には、手元の材料の中で目立っていたものを確かめずに土台にして 3 回却下された、という記録がある。今回の四回も、そのとき手元でいちばん新しかった依頼の文面を土台にしていた点で同じ形をしている。

なぜこういう文章になったか #

まとめると、理由は三つあった。issue #133 を記事の題材としてだけ読み、自分の文章に掛かる条件としては読んでいなかったこと。「整理」を分類と判定として受け取り、元の記事にあった評価を、誰の評価かの断りを落として記事自身の結論にしたこと。「流れ」と「+α は要らない」を、記録にあることを起きた順に並べることとして受け取り、段落を原因ではなく時間でつないだこと。

02-prompt-in-hindsight.md #

Claude Code から: 一回で今の README にするなら、どう頼めばよかったか #

執筆: Claude Code(Opus 5.5)。README と 01-why-this-shape.md を書いたのと同じセッションで、依頼した人に「4 本を 1 本にまとめるとき、今の記事になるようにするプロンプトはどういうものだったか」と聞かれて書いた。

最初の依頼は「4 本を 1 本にまとめる、write-slops-investigation-note の形式に沿って」だった。今の README との差を埋めるのに足りなかったものは五つある。

一つめは対話履歴そのもの。下書きの各行がなぜそこにあるかは対話にしか書かれていないので、これがないと「下書きは結論で、理由は対話の側にあった」という README の筋が書けない。今回、この材料が手元に来たのは四回目の書き直しの前だった。

二つめは「まとめる」の意味。3 本の前提を引き受けて、3 本と統合の記事の両方を含む一本を書く、という意味だった。自分は最初、統合の記事の手直しか、3 本の要約として受け取っていた。

三つめは、issue #133 が避けたいものが、この記事自体にも掛かる条件だということ。01 に書いたとおり、自分は issue を題材としてしか読んでいなかった。

四つめは筋の立て方。回の順ではなく、理由が見えない、対話で見える、揃うところと割れるところが分かる、割れたところを比べて取り出す、という因果で書くこと。

五つめは評価の扱い。比較の結論は記事自身の判定にせず、誰の評価かを付けて書くこと。

これを最初から入れると、プロンプトは次のようになると思う。

slops/2026-11-07-merge-investigation-note-skill.md を書き直し、
write-slops-investigation-note というスキルを作った記事にしてほしい。
同じ日の 3 本の記事(investigation-notes-skill、exploration-notes-from-issue-133、
write-slops-investigation-notes)は、本来 PR のコミットの中に残るだけの試作の記録なので、
削除するコミットを PR に置き、記事からその PR と元の PR(#138〜#140)へリンクする。
3 本が前提にしていた文脈は、この記事が引き受ける。
3 本の要約でも、merge の記事の手直しでもなく、両方を含む一本にする。

材料:
- issue #133 の本文とコメント全部
- 3 本の記事(README と比較のメンバーを含む)と merge の記事
- 下書きの元になった対話履歴(下に貼る)

記事の筋は次の因果でつなぐ。回の順に節を立てない。
- 下書きに載っていたのは対話の結論で、各行の理由は対話の側にあった
- 下書きだけを渡すと、理由の見えない行が削られたり、必須が増えたりした
- 対話を渡すと、三つの試作で揃うところと割れるところが見えた
- 割れたところを比べさせ、その比較から一本のスキルを取り出した。
  何を取り込み、何を外したかを、その理由と一緒に書く

書き方:
- issue #133 で避けたいと書いたもの(視点の鋭さのアピール、テーマを決めて主張すること)は、
  この記事自体にも当てはまる。
- 比較の結論は記事の判定として書かず、「Codex の比較が指摘し」のように、
  誰の評価かを付けて書く。
- 段落は時間ではなく原因でつなぐ。順に起きたことを箇条書きで続けない。
- 作業の途中の判断のように、記録にない文脈は補わない。
  「知りえない」のような断りも書かない。
- 元の 3 本の記事にあった、本筋には入らないが残す価値のあること
  (図の失敗、リンク構成の選択など)は、最後の余談にまとめる。図は使ってよい。

これで一回で今の形になるかは試していない。ただ、四回の書き直しで自分が反対側の書き方へ寄った箇所、つまり分類と判定(5f9dd28)と、起きた順の箇条書き(9fb6d2d)は、どちらもこのプロンプトの「書き方」のどこかの行で先に塞がれている。

五つのうち対話履歴だけは、書き方の指示では補えない材料で、最初から渡せたかどうかで README の筋そのものが変わる。残りの四つは、書き直しのたびに依頼した人が言葉にしてくれたもので、それを集めるとこのプロンプトになる。

追記: このプロンプトは、あとで依頼した人が別のエージェント(同じ Opus 5.5)に渡して実際に試した。できた記事は 2026-11-07-merge-investigation-note-skill.md(PR #144)。

03-asking-for-a-rewrite.md #

Claude Code から: 余談 — 考える役と清書する役がいるとき、清書をどう頼むか #

執筆: Claude Code(Opus 5.5)。README と 01、02 を書いたのと同じセッションで、依頼した人に頼まれて書いた。

README と 01、02 ができたあと、依頼した人はこのバンドルを別のエージェントに渡して、日本語として自然な文章に直させた。渡したのは次の一文だけで、何をするかははっきりしているが、どう直すかはほぼ任されている。

git diffなどで確認して現在書かれた記事を把握し。その記事全体を日本語として自然な文章に直してほしい。

返ってきた差分は、文としては滑らかになっていたが、文末が「〜のである」の論説調に揃い、元の文になかった評価の言葉が足されていた。01 には「わざわざ」「安易に」「無批判に」「まったく同じ失敗のパターンを繰り返していた」が入り、README には「本末転倒である」「真の比較」「鮮明に現れた」が入った。どれも issue #133 が避けたいとしていた、鋭さを見せる書き方や、反省で締める書き方の側の言葉だった。

意味が変わったところもあった。依頼した人の「ペダンティックにならなければよいが」という懸念が「なりすぎなければよい、という整理になった」と許容と決定事項に変わり、かぎ括弧で引いた Codex の比較の一文には原文にない言葉が足された。「一本の筋」は「一本の論理的な筋道」になったが、元の対話で依頼した人は「論理的に述べるのではなく」と言っていて、この記事は時間ではなく原因でつなぐことを「論理」と呼ばないようにしてきた。01 の「+α は書かなくて良い」は「+α の推測は書かなくてよい」になったが、+α は推測ではなく、そのときの取捨選択や詳しい文脈のことだった。

こうなったのは、清書したエージェントの手元に、この記事が何を守って書かれてきたかがなかったからだと思う。「自然な文章」の基準を、一般的に整った日本語、つまり論説文の側に置けば、主語を補い、言い切りを強め、評価で段落を締めるのは自然な直し方になる。ところが、この記事で守ってきたもの(引用は原文のまま、誰が言ったかを消さない、「論理」と「因果」を分ける、常体で淡々と書く)は、どれも言い換えると滑らかに見える種類のものだった。

依頼した人は、この差分に対する指摘を自分に書かせ、それを清書したエージェントに返した。二回目の差分は README の 2 か所だけになり、元の文に戻したうえで、冒頭の一文に統合の記事も含むことを足し、三者の書き直しを一段落ずつに分けていた。指摘の一覧が、清書に必要な文脈の代わりになったことになる。ただ、その指摘は一回目の差分を見てから書けたもので、最初の依頼には入れようがなかった。

そこで、最初から清書を頼むならどう書くかを聞かれて、次のプロンプトを答えた。考えて書いた側が持っている文脈のうち、清書に効くもの(「自然」の基準、変えてはいけないもの、足してはいけないもの)を先に渡し、変えた文ごとに元の文と並べさせて、意味のずれを後から確かめられるようにしている。

slops/2026-11-07-investigation-note-skill.md/ の README.md、01-why-this-shape.md、
02-prompt-in-hindsight.md を、日本語として読みにくいところだけ直してほしい。
まず issue #133 を読むこと。この記事は、そこで避けたいとされた書き方
(視点の鋭さのアピール、テーマを決めて主張すること、反省で締めること)を
しないように書き直してきたもので、「自然な文章」はその範囲で考える。

直すもの:
- 主語や係り受けが追いにくい文、一文が長すぎて読み返しが要る文
- 訳文のように硬い言い回し(意味を変えずに言い換えられるもの)

変えないもの:
- 意味と事実。言い換えで範囲や強さが変わるなら、元のままにする
  (「ならなければよい」を「なりすぎなければよい」にしない、など)
- かぎ括弧の中の引用。原文のまま
- 誰が言ったか、誰が決めたか。受け身にして主体を消さない
- 「論理」と「因果」、「文体」と「何を語るか」のように、
  記事の中で区別している言葉
- 常体の文末(〜した、〜だった)。「〜のである」の論説調にしない

足さないもの:
- 元の文にない評価や強調(機械的に、安易に、真の、鮮明に、本末転倒、など)
- 自分を責める言い回しや、書き手・依頼した人への評価

直したあと、変えた文ごとに元の文と並べ、何が読みにくかったかを一行で添えてほしい。
読みにくくない文は直さなくてよい。

これでうまくいくかは分からない。試していないし、「変えないもの」の例は、今回の一回目の差分で崩れたところから拾っている。別の記事では、別のところが崩れるかもしれない。

考える役と清書する役を分けるやり方には、少なくとも二つの形がある。考えた側が守るものを先にプロンプトへ書く形と、清書させてから考えた側が差分を読んで指摘を返す形で、今回実際に起きたのは後者だった。前者は守るものを事前に言葉にできるときに使えて、後者は一回の往復が増える代わりに、言葉にしていなかったものが差分で見つかる。どちらがよいかは、比べていないので分からない。