Codexで技術変更をLinkedIn向けに説明

LinkedIn向けのCodex

エンジニアリングマネージャーがLinkedInで知りたいのは、他のチームがどのような判断をしたかであり、コード差分そのものとは限りません。技術変更の説明では、何が遅い、または失敗しやすかったのか、何を変えたのか、運用上の負担は何か、測定上どのような改善があったのかを示すことが大切です。Codexは変更そのものを読み、読者に合わせた言葉で説明できます。ここではジョブスケジューラーを移行したデータ基盤チームを例に、測定結果を超える主張を防ぐ確認と、最終的な文章を人が承認する手順を説明します。

例：データチームがスケジューラーの移行を説明

データ基盤チームがcronベースのスケジューラーからワークフローエンジンへ移行したとします。責任者はCodexにマージ済みのプルリクエスト、移行メモ、測定結果を渡します。測定結果は、夜間ジョブの失敗が週に約1回から月に約1回へ減ったというものです。Codexは旧システムの失敗要因、再試行だけでは足りなかった理由、採用した判断と運用コストを、マネージャー向けに約230語で説明します。新エンジンがすべての人の信頼性を改善したとする文は測定結果を超えるため、印を付けて書き直します。list_accountsでアカウントを確認し、create_draftsで下書きを保存します。責任者がTarenoで読み、火曜10:00の予約を依頼すると、承認待ちになります。

手順

1. 01

   Codexを一度接続する

   CodexのコマンドラインからTarenoをリモートMCPサーバーとして追加し、OAuthでログインします。これはカスタム接続であり、Codexの公開カタログへの掲載ではありません。ChatGPTにTarenoを追加してもCodexの設定は行われません。

2. 02

   変更内容と結果を渡す

   マージ済みのプルリクエスト、移行メモ、測定済みの結果を指定します。何をどの期間で測定したのかも伝えてください。Codexは資料と数字が実際に示す範囲だけを説明します。

3. 03

   読者の知識レベルを決める

   読者は自社の技術スタックを熟知している専門家ではなく、エンジニアリングマネージャーだと伝えます。内部用語は、技術的な意味を変えずに、その役割がわかる表現へ置き換えるよう依頼します。

4. 04

   根拠を超える主張に印を付ける

   一般的な信頼性の向上や未測定のコスト削減など、測定結果以上を主張する文をすべて指摘させます。根拠に合うよう書き直すか、確認できない文を削除してください。

5. 05

   下書きを保存する

   Codexはlist_accountsでLinkedInアカウントを確認し、create_draftsで説明文を保存します。投稿時間を考える前にTarenoで全文を読み、数字、内部名称、表現を確認します。

6. 06

   投稿時間を依頼し承認する

   日付、時刻、IANAタイムゾーンを指定します。依頼は承認待ちのアクションとなり、本人がダッシュボードで承認します。その後、Codexはget_action_statusで結果を確認できます。

コピーして使えるプロンプト

プルリクエスト[番号]とdocs/migration-notes.mdを読んでください。何が変わり、なぜ変わったのかを、私たちの技術スタックを知らないエンジニアリングマネージャーにもわかる言葉で5文にまとめてください。置き換えた内部用語と、それぞれの意味も一覧にしてください。

スケジューラーの移行をエンジニアリングマネージャーに説明する約230語のLinkedIn投稿を書いてください。使う結果は[直近の四半期に夜間ジョブの失敗が週約1回から月約1回に減った]という測定値だけにしてください。判断に伴う運用コストを含め、測定値を超える主張をする文にはすべて印を付けてください。

印を付けた各文を、測定結果が示す範囲だけを述べるよう書き直すか削除してください。原文と修正文を並べ、それぞれの修正が根拠に照らして適切な理由を1行で示してください。Tarenoに何かを保存する前に私の回答を待ってください。

Tarenoで私のLinkedInアカウント[名前]を確認し、最終文章を下書きとして保存してください。下書きIDと全文を返し、私が文章を確認して日付、時刻、タイムゾーンを指定するまでは予約を依頼しないでください。

避けるべき間違い

• 複数の原因がある結果を一つのツールだけに帰すること。同じ四半期に二つの変更があったなら両方を述べるか、因果関係の主張を削除します。
• 専門家だけに向けて書くこと。マネージャーの読者が知らない内部用語を使っている場合は、保存前にわかりやすく書き直します。
• 結果を曖昧にすること。単に信頼性が上がったと言うより、失敗が週1回から月1回になったという測定値のほうが具体的です。
• ChatGPTへのTareno追加でCodexも設定されると思い込むこと。Codexには別の接続とログインが必要です。