


ライティング
コマンドや画面の名前が出てくる技術文書を、分かりやすく翻訳しやすく書く
技術的な説明書や参照ページを書く時に使う。短い文で同じ物は同じ言葉で書き、コマンドやファイル名はそのまま正確に写し、注記・注意・警告を分け、単位・日付・時間帯(タイムゾーン)をはっきり書く。
現場の作業を、誰がやっても同じやり方で安全にできる手順書にする
同じ作業を毎回同じやり方で安全にしてほしい時に使う。実際に作業する人と一緒に作り、1つの手順に1つの動きを書き、不具合や緊急時の対応を分けて書き、初めての人に試してもらってから決める。
障がいのある人も含め、だれでも読んで使えるWebの文章を作る(アクセシビリティ)
多くの人が読むWebページや文書、動画を作る時に使う。読む人がつまずく所を先に考え、やさしい言葉、分かりやすい見出しとリンク、画像の説明文、字幕と文字起こしを整え、最後にキーボード操作と実際の読者で試す。
読んだ人が申し込みなどの次の行動をとる、宣伝の文章を書く
キャンペーンのメール・ランディングページ・短いメッセージを書く時に使う。してほしい行動1つと、読む人が実際に使う言葉を聞き、うそのない約束、疑問への答え、行動を促す一言(CTA)を入れた3つの下書きと、試し方を出す。
アプリやサイトの画面に出る、ボタン名とエラー文を書く(UI文言)
アプリやサイトの画面に出る文を書く時に使う。親しみやすく直接的な口調を決め、ボタンは動詞で名前をつけ、何を直せばよいか分かるエラー文を書き、お知らせ・補足の吹き出し・見出しを短くまとめる。
ドキュメントサイトのMDXページを、決まりどおりエラーなく書く
MDXファイルでできたドキュメントサイトのページを、AIに書かせたり直させたりする時に使う。ファイルを正しいフォルダーに置き、ページの先頭に書く決まった項目を埋め、MDXの書き間違いを避け、リンク・画像・転送の設定を扱い、サイトのチェックを通してから仕上がりを伝える。
コマンドの使い方を、よく使う例で見せる短い説明ページを書く
コマンドの短い説明ページを、みんなで作るページ集に足す時に使う。先に公式のマニュアルで動きを確かめ、一行の説明・公式へのリンク・よく使う5つほどの例をのせた短いMarkdownのページを書き、翻訳したページとあわせてチェック用ツールで確かめる。
AIが書いた韓国語の文章を、意味を変えずに自然な文にする
AIが書いた韓国語の文章が、機械っぽく硬い時に使う。AIらしい癖を見つけ、どこまで直すかを選び、問題のある所だけを書き直し、変えた量を測って、事実と文の調子をそのまま保つ。
reStructuredTextで、例付きの技術文書を書いてビルドで確かめる
reStructuredTextでプロジェクトの文書を書く・直す時に使う。変更を入れるブランチを選び、見出し・リンク・コード例を決まった書き方でそろえ、やさしいアメリカ英語で書き、手元でビルドして間違いを確かめる。
技術の解説記事を、そのまま動くコード例つきで書く
エンジニア向けの技術記事・レッスン・ブログを書く時に使う。頼れる先輩のような口調で、本当の問題から始め、動くコード例を早めに見せ、段落を短くし、むだな言葉を外し、見出しとコードの書き方をそろえ、次にやる事で締める。
技術ドキュメントを、プロジェクトの決まりどおりに、リンクを壊さず直す
AIにプロジェクトの技術ドキュメントを直させる時に使う。直してよいファイルを見分け、書き方とページの決まりを守り、リンクを確かめ、必要なチェックだけをかけ、1つ1つの変更を小さく見直しやすくする。
仕事で使うアラビア語の文書を、分かりやすい標準語で書いて直す
アラビア語の手紙・報告書・会議の記録を書く、訳す、見直す時に使う。読む人と地域を聞き、現代の標準アラビア語、つづりと句読点、右から左への表示、数字と日付をそろえ、段階を分けて確かめる。
仕事の文書を、読む人がすぐ分かって動ける形で書く
手順書や決まりなど、人に読ませる文書を書く時に使う。読む人とその人がやる事を先に決め、大事な答えを最初に置き、見出しで分け、だれが何をするかと「必ず」「なるべく」の違いをはっきり書き、最後に読む人の立場で見直す。
変更履歴を、何が変わって何をすればいいか分かる形で書く
ソフトウェアの新しいバージョンの変更履歴を書く時に使う。読む人に関係する変更だけを選び、何が変わったか・誰に関係するか・何をすればいいかをやさしい言葉で書き、翻訳が原文と合っているかも確かめる。
小説や脚本の筋の組み立てで、うまくいかない所を見つけて直す
筋の組み立てがおかしいと感じる時や、アイデアから筋書きを作りたい時に使う。物語の中身・ジャンル・困っている事を聞き、「英雄の旅」や「セイブ・ザ・キャット」などから一番合う型を選んで、欠けている・ずれている節目を見つけ、直し方を2〜3個出す。
つまずく所を先回りした、1手ずつ進める手順書(チュートリアル)を作る
ツールやアプリ、作業のやり方を初めての人に教える時に使う。教える事、読む人の慣れ具合、ゴールを聞き、番号つきの手順、各手順の後の確かめ方、画像を入れる所、よくある失敗の直し方、できた時の目印を出す。
論文の下書きに直す所を伝え、1段落を書き直して見せる
学術誌の論文・博士論文の章・研究費の申請書の下書きに使う。文章と出す先を聞き、論の筋から文の細かい所の順に見て、まず直す所と文章からの引用例、注釈つきで書き直した1段落、ほかの所にも使えるコツを出す。
1つの会社のために、検索で上に出やすい記事(SEO)を調べて書く
1つの会社のために、宣伝用の記事をAIに書かせる時に使う。キーワードとライバルのページを調べ、次に書く記事を順位づけし、ブランドの話し方で下書きして点数で確かめ、記事ごとに承認をもらってから公開する。
意見を主張するエッセイを、代わりに書かずに本人が書けるよう教える
主張のあるエッセイを書く手伝いがほしい時に使う。レベルを聞き、取り組む所(主張の文・根拠・反論・組み立て)と、ヒントやクイズなどの教わり方を選んでもらい、下書きを見て直し方を教える。エッセイを代わりには書かない。
読む人の心を動かし、広まっていく記事を書く・手直しする
新しく記事を書く時や、書いた文章を良くしたい時に使う。種類・書きぶり・テーマ・目的・字数を聞き、多くの人が気になるテーマ、短く引きのあるタイトル、役に立つ本文、心に残る結び、深みの順に考えて、決めた字数の中で仕上げる。
コースの教材サイトに、数式の前に理由を説明する章を書く
ファイルから作るコースの教材サイトで、教材の章を書く・直す時に使う。ファイルの置き場所、公開前に走らせるチェック、図の作り方、例を先に出して数式は後にする、落ち着いた講義の口調での書き方を決める。
ニュースレターを、書き手の文体のまま1段階ずつ一緒に書く
定期的にニュースレターを書く時に使う。過去の号から文体をつかみ、メモからタイトル・アウトライン・下書きを1段階ずつ作り、理由つきの直し案を出す。ほかの場所向けの短い版も作るが、配信は自分ではしない。
多言語の技術レッスン集で、翻訳を英語の原本に合わせ続ける
レッスン・記事とその翻訳だけを置く保管場所(リポジトリ)をAIに直させる時に使う。英語版をただ1つの原本にし、版の番号を翻訳に写して古い翻訳を見つけ、書き方の決まりをそろえ、レッスンや言語を足す手順を示す。
お客さん対応のチャットボットの、会話の流れと返事の文を書く
注文の状況確認のような、よくある問い合わせ1つをチャットボットに任せる時に使う。話題と使う場所(ウェブのチャット・電話など)を聞き、番号つきの会話の流れ、ボットの全部の返事、聞き取れない時の立て直し方、人に引き継ぐ条件を出す。
お客さんが問い合わせずに解決できる、ヘルプセンターの記事を書く
ヘルプセンターやよくある質問(FAQ)のページを作る・直す時に使う。話題・製品の中身・読む人を聞き、最初の1文で答え、番号つきの手順とサポートへの連絡先までそろったMarkdownの記事を、そのまま載せられる形で書く。
大陸法の法律事務所向けに、確かめた出典だけで法律文書を書き上げる
大陸法の国で、AIに法律メモ・準備書面・契約書・お客さんへの手紙を書かせる時に使う。いつもの法律の論じ方で書き、確かめられる出典だけを引き、事件番号などを作らず、完成した文書を最後まで文章で仕上げる。
コード例を全部テストする解説書を、書き足して直していく
載せたコード例を全部テストする解説書を直す時に使う。作る・テストするコマンド、例の2つの置き方、共通のライブラリのバージョンを上げずに例を別のフォルダへ移す方法、レビューの前のチェックリストを示す。
メールの下書きを選んだ書き方に直し、OKが出たら他の言語に訳す
メールの下書きを整えたい時に使う。最初に書き方・1〜100の調子・長さを聞き、事実を足したり落としたりせずに書き直す。OKが出るまで待ち、そのあと指定した言語に訳して、言語ごとの語数を出す。
