【第3回】AI時代に問い直すドキュメンテーション——「主張」から「伝達」へ

前回はエントリーキャリアの方に向けて、在宅勤務における「他人を思いやる力」を具体的な行動レベルで深掘りしました。

連載第3回となる今回は、対象を少し広げ、中堅(ミドルキャリア)のQAエンジニアの皆様に向けてお話ししたいと思います。テーマは、実務とエンジニアの「心(マインドセット)」を照らし合わせた、「コミュニケーションに重点を置いたドキュメンテーション」 についてです。

記事一覧:AI時代だからこそ「あなたにお願いしたい」と頼まれるQAエンジニアになろう

AIにお任せしてコミュニケーションを放棄していませんか?

本題に入る前に、少し今の時代背景を振り返ってみましょう。
ChatGPTをはじめとするLLM(大規模言語モデル)の登場により、私たちの文章作成のあり方は劇的に変わりました。仕様書のたたき台、コードのドキュメント、日々のメールまで、AIは驚くほど流暢なテキストを瞬時に生成してくれます。

その一方で、AIが生成した文章に対して「AIっぽいな…」「なんだか人間味がないな」と感じた経験はないでしょうか?
ここ最近では、「AIが出力しがちな語彙」というトピックが結構目に入るようになってきました。私自身も日頃から生成AIを活用していますので、「おっ、この言い回しは自分がいつも見ている回答にも使われがちだな」と思うことは多々あります。他人に向けた文章として引用する場合は、わざわざAIの回答から仰々しすぎるような記載を削除することもあります。

しかし、「AIっぽさ」の正体は単なる語彙力や表現力の問題とは限りません。もっと根本的な 「コミュニケーション」 にあると思います。AIを使いこなす時代だからこそ、エンジニアとして、一人の人間として、私たちが本当に磨くべきスキルについて考えてみませんか。

AIの文章が見抜かれる本当の理由

結論から言うと、AIが生成した文章に人間味が感じられない根本的な原因は、「誰に、何を伝え、どう行動してほしいか」という意図や目的が込められていないからです。

これは、プロンプトエンジニアリングのテクニック以前の、もっと本質的なことです。どんなに優れた技術や事実も、それを伝える「目的と意図」がなければ、相手には届きません。目的のない文章は、単なる事実の羅列、つまり一方的な「主張」で終わってしまうのです。

「主張」と「伝達」の決定的な違い

コミュニケーションにおける「主張」と「伝達」の違いを、日常の「地図アプリ」の例えで考えてみましょう。

AIが書きがちな「主張」

「この地図アプリは、高解像度の地図データと高精度ルーティングエンジンを搭載しており、オフラインでも動作します」

これは単なるスペックの提示であり、事実の「主張」です。

人間が設計すべき「伝達」

「この地図アプリがあれば、初めての街への出張でも乗り換えに迷わず、約束の5分前に余裕をもって到着できます」

こちらは、「初めての街に向かうビジネスパーソン」というターゲットに、「迷わず到着し、時間に余裕が生まれる」という未来(メリット)を届けることで、インストールや有料プランへの登録といった行動を促す、明確な目的と意図を持った「伝達」になっています。

これはマーケティングの世界で言われる「ドリルと穴」 の話と同じです。「顧客が求めているのは『4分の1インチのドリル』ではなく、それによって開けられる『4分の1インチの穴』である」という、手段(ドリル)よりも目的または価値(穴)の重要性を説く有名な格言です。

この差は、エンジニアの日常業務にも当てはまります。仕様書やドキュメントは、単なる機能の「主張」に終わっているかもしれません。読み手(他のエンジニアや企画職)が「何をすべきか」を明確に理解できる「伝達」になっているでしょうか。

QAエンジニアのドキュメンテーションでは伝達力も大事な要素

QAエンジニアが作成するドキュメント群においても同じことが言えます。これらは単なる「事実の列挙」ではありません。プロジェクトを健全な方向に導くための「意思決定支援のためのツール」であるべきです。ここで求められるのが、事実を並べるだけの「主張」を超えた、相手を動かすための「伝達力」です。

なぜQAにとって伝達力が重要なのか、3パターンの成果物からその本質を深掘りします。

1. テスト計画・QA戦略: 品質の「定義」を共有し、目線を合わせる

テスト計画書やQA戦略を策定する際、単に「どの機能を、いつまでに、どうテストするか」というスケジュールや手法を羅列するだけでは不十分です。
大切なのは、「今回私たちが守るべき品質とは何か?」という目的を言語化し、関係者に伝達させることです。

  • 主張: 「全機能を網羅的にテストし、重大なバグがないことを確認します」
  • 伝達: 「今回のリリースでは新機能のUX向上に注力するため、決済導線の安定性を最優先事項として定義し、そのためのエッジケース検証を重点的に実施します」

続きを読むにはログインが必要です。
ご利用は無料ですので、ぜひご登録ください。

SHARE

  • facebook
  • twitter

SQRIPTER

北村 駿(きたむら しゅん)

記事一覧

元バンドマン・元バーテンダーのQAエンジニア。現在はとあるQA組織の内製化とQAテックリードを担いながら、ピープル・ワーク両面でマネジメントも奮闘中。

Xアカウント: https://x.com/max_qae
Zenn: https://zenn.dev/max_qae

RANKINGアクセスランキング
#TAGS人気のタグ
  • 新規登録/ログイン
  • 株式会社AGEST
NEWS最新のニュース

Sqriptsはシステム開発における品質(Quality)を中心に、エンジニアが”理解しやすい”Scriptに変換して情報発信するメディアです

  • 新規登録/ログイン
  • 株式会社AGEST