AIに書かせた技術記事は「本人にしか価値が分からない」状態になる|冒頭3行の前提ブロックで直した

AIに書かせた技術記事は「本人にしか価値が分からない」状態になる|冒頭3行の前提ブロックで直した

🧭 この記事の前提 AIエージェント(Claude Code)に記事を書かせている個人サイトで、実際に運用中に起きた失敗を題材にした記事を7本書きました。一般論を避けて、自分の環境の具体だけで書いたものです。
困ったのは、尖らせるほど「本人にしか価値が分からない」状態になっていたこと。内容が間違っているのではなく、書き手が当然と思っている状況設定が読者に共有されていませんでした。
持ち帰れるもの:実体験ベースの記事を書いている人向けに、冒頭3行の「前提ブロック」の中身と、それを足すべき理由を出します。一般向けの解説記事だけを書いている人には不要です。

結論:足すのは「やさしさ」ではなく「前提」

📌 先に結論 ① 尖った内容そのものは正しい。当たり障りのない記事は読まれない ② 壊れているのは読者が「自分に関係あるか」を判断できないこと ③ 直し方は内容を易しくすることではない。 冒頭に前提を3行足すだけ

① 実際に壊れていた書き出し

指摘を受けたとき、7本のうち1本はこう始まっていました。

画像の生成だけを別のAI(Codex)に頼む分業をしています。

事実としては正しい一文です。ところが、なぜAIを2つに分けているのかが一言も書かれていません。

読者の側からこの文を読むと、こうなります。

  • なぜ1つでは駄目なのか分からない(実際の理由は「Claude側は画像を生成できないから」ですが、書いていない)
  • 自分が同じ状況にいるのか判断できない(AIを1つしか使っていない人には、そもそも関係が無い話かもしれない)
  • 読み進める理由が立たない

書き手にとっては毎日やっていることなので、説明が要るという発想自体が出てきません。尖った記事ほど、この穴が開きます。 一般論なら誰でも前提を共有していますが、自分の運用の話は自分にしか見えていないからです。

② 足した3行の中身

7本すべての冒頭に、次の3項目からなるブロックを置きました。

#書くこと実例
1どんな状況の話か(誰が、何をしていて)「記事の執筆はClaude Code、画像の生成は別のAIという分業をしています」+なぜ分けているかの理由
2何に困ったか「納品物を原寸で検品していたので、実際の表示幅では文字が潰れていた」
3持ち帰れるもの=誰に効いて、誰には今は不要か「AIに画像を作らせている人向け。自分で撮っている人には不要です」

3行目が最も重要です。 ここには「この記事が不要な人」を明示的に書きます。

⚠ 覚えておく一行 合わない読者が、冒頭で離脱できる書き方にする。 全員に読ませようとして内容を薄めるより、対象を名指しで絞るほうが良い記事になります。

③ 「易しくする」との違い

指摘を受けたとき、最初に思いつく直し方は「専門用語を減らす」「もっと基礎から説明する」でした。これは間違いです。

直し方結果
内容を易しくする具体が削れて、他のサイトにも書いてある記事になる。尖りが消える
前提を足す具体は1つも減らないまま、読者が自分に関係あるか判断できるようになる

削るのではなく足す。レベルを下げるのではなく、立っている場所を共有する。 この区別が分かるまで、記事を薄める方向に直しかけていました。

専門用語については、易しく言い換えるのではなく、初出で括弧に一言だけ添える運用にしました。

  • サブエージェント(=別枠で動く子AI)
  • PreToolUseフック(=ツールが実行される前に割り込む設定)

言い換えると精度が落ちますが、括弧一言なら原語のまま残しつつ、初めての人も止まらずに読めます。

④ 同じ穴は画像にも開いていた

この指摘の後に画像を見直したら、まったく同じ構図の問題が見つかりました。AI活用カテゴリの記事画像が、**6記事12枚すべて「机にノートPC」**だったのです。

  • 記事ごとの主張の差が、絵から完全に消えていた
  • サムネイル一覧を見ても、どれがどの記事か判別できない

文章の側で「前提が共有されていない」ことと、画像の側で「記事ごとの差が絵に出ていない」ことは、同じ原因です。書き手にとっては当然の区別が、外から見えていない。

直し方も同じ構造でした。絵を綺麗にするのではなく、記事ごとに別の物のメタファーを割り当てる(並列化の記事=同じ砂時計を5つ横一列、常設の指示書の記事=色の違う付箋が貼られたノート)。詳細は記事ごとに物のメタファーを割り当てた話にまとめました。

⑤ AIに書かせると、この穴は塞がらない

前提ブロックが抜けたのは、AIが手を抜いたからではありません。AIには、書き手の状況設定のうちどれが「読者に共有されていないか」が分からないからです。

セッションの中では、分業していることも、なぜ分けているかも、全部文脈に入っています。文脈に入っているものは、説明すべき対象として立ち上がってきません。 人間が同じ話を毎日していると説明を省くのと、まったく同じことが起きます。

だから対処は、指示の側で固定しました。「この記事は誰に効いて、誰には不要か」を必ず冒頭に書くと決めておかないと、次に書いた記事でも同じ穴が開きます。この種の「毎回守らせたいこと」を指示ファイルへ落とす考え方はAIへの引き継ぎ設計に書いています。

自分でやる手順

  1. 自分の記事の1行目だけを抜き出して並べる。 本文は読まない
  2. その1行に対して「なぜ?」を1回問う。 答えが本文のどこにも書いていなければ、前提が抜けています
  3. 3行を書く。 ①状況(+なぜその状況なのかの理由)②困ったこと ③誰に効いて誰には不要か
  4. 3行目に「不要な人」を必ず書く。 ここを省くと、対象がぼやけて内容を薄める方向に引っ張られます
  5. 専門用語は初出で括弧一言。 言い換えない
  6. 内容は1文字も削らない

やりがちな失敗

失敗何が起きるか直し方
指摘を受けて内容を易しくする具体が削れて、どこにでもある記事になる削らずに前提を足す
「誰に不要か」を書かない対象がぼやけ、全員向けに薄める圧力がかかる3行目を必ず入れる
専門用語を言い換える精度が落ちる原語+括弧一言
状況だけ書いて理由を書かない「分業しています」だけでは、なぜ分けるかが伝わらない状況には理由をセットで書く
文章だけ直して画像を放置する一覧で記事の差が消えたまま画像にも記事固有の物を割り当てる

まとめ

  1. 尖らせるほど前提が抜ける。 内容の正しさとは別の問題
  2. 足すのは前提であって、やさしさではない。 具体を削ったら意味が無い
  3. 3行目(誰には不要か)が効く。 合わない読者を冒頭で離脱させたほうがよい
  4. 同じ穴は画像にも開く。 記事ごとの差が絵に出ていないなら、それは文章の前提抜けと同じ症状

キーワードの選び方まで含めた量産全体の反省はAIに74本書かせた結果、読まれている記事に出口が無かった話は読まれているクラスタに収益リンクが1本も無かったにあります。