AI時代のテクニカルライティング、人間が書く意味とは

AI時代のテクニカルライティング、人間が書く意味とは

AI時代のテクニカルライティング、人間が書く意味とは

テクニカルライティングの需要が大幅に減少している。CSS-Tricksの編集長Geoff Graham氏が公開した同サイトのトラフィック統計によれば、2020年から2025年にかけてアクセス数は明確な下降線を描いている。Stack Overflowの質問数減少と同様の傾向であり、業界全体に共通する構造変化だ。

スタンフォード大学の「2025 AI Index」によると、企業のAI導入率は2024年に急速に上昇した。開発者がドキュメントを読まずにIDE内のチャットで回答を得る時代において、従来型のリファレンス執筆の価値は再定義を迫られている。

しかしである。だからといって人間による技術記事が不要になったわけではない。むしろ、AIが生成する「正解」では届かない領域にこそ、書き手の存在意義がある。本記事ではCSS-Tricksの見解を踏まえつつ、AI時代のテクニカルライティングが目指すべき方向性を考察する。

テクニカルライティングはなぜ必要とされ続けるのか

テクニカルライティングはなぜ必要とされ続けるのか
AIが得意な領域
リファレンス プロパティ定義と基本コード例の提示
MDNや仕様書の情報を要約して即答する
人間が輝く領域
実体験 試行錯誤のプロセスと失敗からの学び
コードの背後にある思考と判断の文脈を共有する

AIは人間の欲望や努力なしには新しいことを学べない。ボットが動くのは与えられたプロンプトに対してだけであり、技術を前進させるのは依然として人間の動機だ。Graham氏は「AIをテクニカルライティングの新たな主要読者と見なすつもりはない」と明言している。学習意欲のある実在の人間こそが、この営みを支え続ける存在である。

仕様書と人間のあいだを埋める役割

CSS-Tricksに掲載されているCSSアルマナック(リファレンス集)は2009年から継続的に更新されてきた。一見するとAIチャットで代替可能に思える領域だが、Graham氏はこの役割を「技術的な話題をきわめて人間的な説明で伝えること」と定義する。向かいの席に座る開発者とコーヒーを飲みながら話すような距離感だ。

仕様書はブラウザ実装の正確性を担保するために意図的に緻密に書かれている。CSS-Tricksはその厳密さを崩さずに、アクセスの敷居を下げる翻訳者の役割を担ってきた。この「技術と人間のあいだを埋める」機能は、AIが要約を生成できるようになった現在でも、体験に根ざした説明という点で差別化される。

AI時代の書き手が立つべき場所

AI時代の書き手が立つべき場所
従来の執筆対象(Before)
CSSプロパティの基本構文とサンプル
ブラウザ対応表の転載
公式ドキュメントの要約
※いずれもAIが数秒で生成可能
これからの執筆対象(After)
クライアント案件で遭遇した実問題の解決録
失敗と修正を経た思考プロセスの共有
特定の制約下でのクリエイティブな回避策
※AIが真似できない「経験の質」が価値になる

Graham氏はテクニカルドキュメントを書く価値が以前より下がったと率直に認める。仕様書やMDNは充実しており、開発者の素朴な疑問はIDE内チャットで即時に解決される。しかしCSS-Tricksは2007年の開設当初から「アイデアの共有プラットフォーム」として機能してきた。ゲスト執筆者748名が蓄積してきた知見は、単なるドキュメントの代替ではない。

新たな執筆指針〜AIにできないことを書く

新たな執筆指針〜AIにできないことを書く

実体験を軸にすえる

AIはCSSプロパティの定義と簡単なコード例を提示するのが得意だ。既存の技術ドキュメントから引っ張ってくるだけなので、その領域で競うのは得策ではない。Graham氏が推すのは「クライアントから求められた未経験の要件に挑んだ話」のような、実体験に根ざした記事である。

人間は課題に直面したときにもっとも深く学ぶ。初心者から理解者に至るまでの過程そのものが、読者に使えるメンタルモデルを提供する。たとえそのモデルが最終的にAIプロンプトの作成に使われるとしても、思考の枠組みを共有する価値は揺るがない。

権威であろうとしない

CSS-Tricksは「正しいやり方」を保証するサイトではない。CSSには複数のアプローチがあり、書き手自身のメンタルモデルにもっとも馴染む方法が最善であるという立場だ。単なるアイデアの種を共有することにも価値があるとGraham氏は強調する。

「経験はあっても冷笑的になるな」というのが同サイトの指針だ。専門家であることと経験者であることは同じではない。まだ未解決の疑問があっても、試したことの報告には意味がある。

引用を惜しまない

優れた記事は先人の知恵の上に成り立つ。すべてを独自の知見として見せようとする誘惑は強いが、Graham氏は「私たちは互いの仕事の上に構築している」と明言する。ハイパーリンクによる健全な引用文化こそ、ブログの原点である。

検索エンジン最適化よりも読者最適化を

検索エンジン最適化よりも読者最適化を
SEO重視の罠
キーワードを詰め込んだ不自然な文章
クリックベイト型の誇張された見出し
検索エンジン向けに整形された構成
※検索トラフィック自体がAI回答に奪われている
人間向けの執筆
特定の読者層に刺さるトピック選定
一貫した声とトーンを保つ文体
異なる学習スタイルに配慮した説明
※かつてGoogleが評価していた本質的な品質基準

CSS-Tricksは数年前にSEOに軽く手を出したものの、本格的に注力することはなかった。キーワードの詰め込みもクリックベイト的な見出しも避け、人間のための文章、適切な構造、一貫したトーンに集中してきた。皮肉なことに、これらはかつてGoogleが重視すると表明していた要素そのものだ。

Graham氏は検索トラフィックがAI生成回答に奪われている現実を直視しつつも、CSS-TricksがAI回答の参照元として表示されるかどうかにさえ「関心があるか確信が持てない」と率直に述べる。状況は流動的であり、考え方も進化させなければならない段階だ。

AIを執筆に使うなら補助領域に限定する

AIを執筆に使うなら補助領域に限定する

Graham氏は執筆そのものへのAI利用に否定的だ。理由は二つある。第一に、AIの出力は常に正確とは限らない。第二に、AIは書き手個人の声を希釈してしまう。どちらも執筆という営みにとって致命的な欠陥である。読者がすでにIDEで得られるAI説明と変わらない内容を記事で提供する意味はない。

ただしGraham氏はAIを全面否定しているわけではない。スペルチェックやMarkdownからHTMLへの変換、公開スケジュールの管理といった「執筆とは直接関係のない低負荷な作業」には積極的に活用している。これは今日「AI」と呼ばれる機能の多くが、ブーム以前は単に「自動化」と呼ばれていたものだという冷静な視点に立っている。

この記事のポイント

  • テクニカルライティングの需要はAIの普及により構造的に減少しているが、人間による記事の価値が消えたわけではない
  • 実体験に基づく試行錯誤のプロセス共有が、AIとの差別化における最大の武器になる
  • SEOやAIOに過度に依存せず、特定の読者に向けて明確に書くという基本に立ち返るべき
  • AIはスペルチェックやフォーマット変換など執筆周辺の自動化に限定して使うのが現実的
海田 洋祐

・ 複数業界における17年間のデジタルビジネス開発経験 ・ ウェブサイト開発のためのHTML、PHP、CSS、Java等の実用的知識 ・ 15ヶ国語対応の多言語SaaSの開発経験 ・ 17年間にも及ぶ、Eコマース長期運営経験 ・ 幅広い業界でのSEO最適化の豊富な経験

メッセージを残す