# Human Briefing

> 人間への依頼・相談・報告を、背景・課題・目的・相談事項の4行で書く型の正本。チャット・HTML・ゴールのページのどこでも、人に判断や作業を頼む時と結果を報告する時に使う。「報連相の形で書いて」「この依頼を分かりやすく書き直して」「何の話か分かるように説明し直して」を正のトリガーとする。HTMLの見た目にはhtml-artifact、ゴールを受け入れまで進める管理にはautopilot、次の作業者への引き継ぎにはcontext-handoffを使う。

- Skill: `masashifukuzawa/human-briefing` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add masashifukuzawa/human-briefing`
- Raw SKILL.md: https://api.skillmd.com/api/skills/masashifukuzawa/human-briefing/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: MasashiFukuzawa (https://skillmd.com/u/masashifukuzawa)
- Updated: 2026-11-16
- Page: https://skillmd.com/skills/masashifukuzawa/human-briefing

---

# Human Briefing — 人に伝える型

読み手が聞き返さずに「何の話か・何が困るのか・どうなれば終わりか・自分は何をすればよいか」を答えられる状態にする。人への依頼・相談・報告の型はここだけで定め、媒体ごとのスキルは置き場所と見た目を定める。

## 4行

この順に、この行名で書く。1行は1〜2文、80字程度まで。

| 行 | 読み手の問い | 書くこと |
|---|---|---|
| 背景 | 何の話で、どこの話か | 対象（利用者から見た機能・画面・工程）と、読み手が知らない前提・用語 |
| 課題 | 放っておくと何が困るか | きっかけになった事実と、誰に・何が・どれだけ起きるか。数字と期日で書く |
| 目的 | 何が満たされれば終わりか | 到達したかを確かめられる状態 |
| 相談事項 | 自分は何をすればよいか | 決めてほしいことと推奨、または頼みたい作業（次節） |

- 頼むことが無い報告では、4行目の行名を「実施事項」に替える。最初に「依頼なし」と書き、済ませたことと次に行うことを続ける。
- 1つの事実は1つの行にだけ書く。対象と前提は背景、困りごとは課題に置く。経緯は書かない。
- 書き終えたら行ごとに読み手の問いを当て、その行だけで答えられるまで書き直す。

| 行 | 聞き返される書き方 | 答えられる書き方 |
|---|---|---|
| 背景 | 通知の再送が未決 | 予約確認メールは、予約の直後に利用者へ届く通知。送信に失敗した分は、今は再送されない |
| 課題 | 早めに決めたい | 先週は送信の失敗が1日平均40件あり、予約できたか分からない利用者からの問い合わせが1日12件来ている |
| 目的 | 通知を安定させる | 失敗から10分以内に再送され、この問い合わせが週10件未満になる |
| 相談事項 | 再送方法を決める | 再送を自動にするか決めてほしい。推奨は自動再送（3回まで）。決め手は人手の作業が無くなること |

## 相談事項の中身

### 判断を頼む

- 1つの依頼で決めてもらうことは1つ。切り離せない場合でも2つまでにし、それを超える分は別の依頼（ゴールのページなら別の番号のカード）に分ける。
- 選択肢の番号か「はい／いいえ」で答えられる問いにし、返信例を添える。
- 推奨を1つに決める。決め手は、推奨案だけが持ち他案に無い理由を1つ選ぶ。選択肢ごとの良い点と欠点は比較に回す。
- 期限は日付・時刻・タイムゾーンで書き、決めない場合に起きることを添える。
- 回答によって次の動きが変わるなら、回答後に起きることを書く。
- 図を1つ添える。前後の比較か、選択肢の比較を選ぶ。選択肢より前に置き、折りたたまない。チャットではascii-diagramの小図か短い比較表、HTMLではhtml-artifactの「図で語る」に従う。

### 作業を頼む

番号付きの手順、入力値、所要時間、返してほしいこと、やらない場合に起きること、返信例を書く。

### 外に出る操作・戻せない操作の承認を頼む

案件の外に、ものを作る・変える・消す操作（投稿、送信、設定の変更、削除）と、戻せない操作は、流し読みでも取り違えない形で聞く。目的の達成に要らない操作は、聞かない。

- 見出しと相談事項の最初の文を、目的ではなく操作そのものにする。「外部への問い合わせ」ではなく「公開の場への投稿」と書く。
- 何を・どこに・誰の名義で行うか、誰から見えるか、取り消せるかを書き、全文か差分を見られる場所を添える。
- 行う方を推奨するなら、行わない場合に何が達成できなくなるかを決め手に書く。書けないなら、聞かない。
- 1つの依頼は、宛先1つ・内容1つにする。「今後も同じ種類は任せる」を混ぜない。

```text
相談事項：外部のサービス（<名前>）の<項目>を、あなたのアカウントで<今の値>から<新しい値>に変えてよいですか。推奨は「変える」。決め手は、受け入れの条件3が今の値では満たせないこと。
誰から見えるか：管理者<人数>人の画面と変更履歴。<通知先>に通知が1通届きます。
戻せるか：値は戻せます（数分）。届いた通知は取り消せません。
返信例：「変える」／「変えない」
```

## 先回りの確認

読み手が返信の前に聞き返す定番の4つ。当てはまるものを、相談事項のすぐ後に1行ずつ書く。

| 確認 | 書くこと |
|---|---|
| 変更の大きさ | 何がどれだけ変わるか。画面・設定・対象の利用者・手順の数など、読み手に見える単位で書く |
| 日々の使い勝手 | 利用者や開発者の毎日の操作・待ち時間・手順が増えるか減るか。変わらなければ「変わらない」と書く |
| 戻せるか | 戻せるかどうかと、戻す方法、戻すのにかかる時間 |
| 待ち時間の根拠 | 待つ期間や制限を置く理由と、短くできる条件。理由を書ける待ちだけを計画に入れる |

## 書き方

- 読み手に見える効果を先に書く。「何をしたか」より「何ができるようになるか」。
- Issue・PRの番号、作業中に付けた呼び名、略号は、内容を言葉で書いた後の括弧に入れる（例「取り込みの再試行（#412）」）。
- 表のセルは1行にする。文になるなら、表をやめて箇条書きか図にする。
- 見出しと図の数字は、本文を数え直して一致させる（「6つとも」と書く前に数える）。
- 数字・期日・条件は入力にあるものを使う。推定は「推定」、確かめられないものは「未確認」と書く。
- 文末には、何をどう変えるかを書く。「整理する」「対応する」「検討する」で終えた文は書き直す。

## チャットで使う

人に判断や作業を頼むメッセージと、作業結果の報告は、チャットでも行名を付けた4行で書く。

```text
背景：予約確認メール（予約の直後に利用者へ届く通知）の再送の話です。
課題：送信の失敗が1日平均40件あり、問い合わせが1日12件来ています。
目的：失敗から10分以内に再送され、この問い合わせが週10件未満になること。
相談事項：再送を自動にしてよいですか。推奨は「はい」（3回まで自動再送）。決め手は人手の作業が無くなること。
戻せるか：設定1か所で止められます（数分）。
返信例：「はい」
```

- 直前のやり取りで背景と課題を共有済みなら、相談事項（または実施事項）だけでよい。話題が変わった、時間が空いた、読み手が別の作業から戻る、のどれかに当たれば4行に戻す。
- 依頼が複数あれば、依頼ごとに番号を振り、それぞれを4行で書く。
- 手順や入力値が長い依頼は、ゴールのページか資料に置き、チャットには相談事項とリンクを書く。

## 媒体ごとの役割

| スキル | 担当 |
|---|---|
| human-briefing | 4行、相談事項の中身、先回りの確認、書き方 |
| html-artifact | 一枚物HTMLの構成（結論ブロックに4行を置く）、見た目、図の描き方、保存先 |
| autopilot | ゴールのページ。合意・現在地・あなたに残ること・決めたこと・成果と証拠 |
| progress-report | 報告に載せる事実の選び方（目的・現在地・残る条件・次の判断） |
| context-handoff | 次の作業者向けの再開文書。冒頭の要約を4行で書く |
| ascii-diagram | チャット内の図 |

## 出す前の確認

1. 初見の人が、4つの問いに各行だけで答えられるか。
2. 1つの依頼で頼む判断は1つ（多くて2つ）か。返信例のとおりに答えられるか。
3. 判断の依頼に図があり、選択肢より前に、開かなくても見えるか。
4. 当てはまる先回りの確認を書いたか。理由を書けない待ちが残っていないか。
5. 番号や呼び名が主語になっていないか。見出しの数字は本文と一致するか。
6. 外に出る操作・戻せない操作の承認なら、最初の文が操作そのものか。名義・誰から見えるか・取り消せるかを書いたか。

