What Am I Doing

---
name: what-am-i-doing
description: 「これ何してたっけ」への答え。いま居るセッションで何が起きたかを、その場に居なかった人でも同じ所まで追いつける形で説明する。並行して開いたセッションを切り替えて戻ってきたときに使う。特定の PR / issue に戻るのは /catchup、open 全件の棚卸しは /whose-turn。
allowed-tools: Bash, Read
---
## 到達点

**読む人は過去のやり取りを遡らない。** この 1 つの返答だけで、その場に居た人と同じ所まで追いつける
必要がある。同時に、**読む気が起きる形**でなければ読まれない——戻ってきた人は疲れていて、目に入れた
最初の 3 秒で読むかどうかを決める。

判定は両向きに 1 つ——**読んだ人が、次にやることを自分で実行できるか。** 出来ないなら足りない情報が
ある。逆に、**消しても次にやることが変わらない要素は、落とす。** 落とした中身は記録の在りかで示す。

## 内部の事情は書くな

自分がどうやって思い出したかは、読む人の用ではない。

- **このスキルの文書の語（「材料」「スクリプト」「道具」「型」）を出力に持ち込むな**
- **レビュー工程の記号（U9・P2・round-1・「判定役」「阻害」）を出力に持ち込むな。** 中身を言え
  ——「U9」ではなく「未検証の穴 1 件（strict を固定する改変が検知されない）」。工程の語は
  会話の中で決めた呼び名で、戻った人は持っていない（実測: 3 人中 3 人が「U9 が何か分からない」）
- **スクリプトの立場判定は、いま居るブランチや貼られた文中の番号から引くので、本題と別の PR を
  拾うことがある。** 会話と食い違ったら会話の側を信じて書き、**食い違ったこと自体は書くな**
- **題（`aiTitle`）は序盤で決まったまま更新されない。** 会話と食い違っていたらそちらを信じる。
  題は読む人にも見えているので、古い旨だけは書いてよい
- **スクリプトの出力は貼らない。** 往復の並びそのものを見せる用があるときだけ、
  `<details>` に畳んで末尾に添える
- スクリプトにも会話にも無いことを断定するな。確かめていないことは、確かめたことと区別がつく書き方にしろ

## やること

**subagent・Agent・Workflow を立てるな。** 材料は script 1 本と手元の会話で足りる。並列化は起動の
overhead で分単位を失い、結果待ちを誤ると 10 分止まる（実測 2026-09-02）。

1. `bash "${CLAUDE_PLUGIN_ROOT}/scripts/run-python.sh" "${CLAUDE_PLUGIN_ROOT}/scripts/what-am-i-doing.py" --out` を実行し、返ってきたパスを
   **Read で**読む（`${CLAUDE_PLUGIN_ROOT}` は Claude Code がこのプラグインのルートのフォルダに置き換える
   変数。以下「機械」はこのスクリプトとその出力）。出力に「間の N 往復は省いた」と出たら `--full --out` で取り直せ。`--out` は報告をファイルへ
   書いてパスだけ返す——出力は Claude Code の Bash の 1 回あたりの上限（約 30,000 バイト。上限は
   バイトで測るので、日本語はおよそ 1 万文字で当たる）を越えることがあり（実測 2026-09-16:
   長めのセッションで 50,006 バイト）、越えるとツール側で退避されて走らせ直しになる。`--out` は
   値を取らないので、`--topic "<語句>"`（その語句が出た往復だけに絞る）などの後ろに置く。**`cat` で読むな**——同じ量が再び
   Bash の出力に乗って、また退避される。`--out` はセクションごとの行番号も返すので、
   長い回は `経過` のセクションから読んで、`いま手元に残っているもの` のセクションはその行番号から読めばよい。出るのは**依頼と、それに対して何をしたかの対**、区切りになった操作
   （コミット・push・テスト実行）、ツールの使用、このセッションの間に入ったコミット、
   未コミットの残り。**あなたが読むための材料で、そのまま貼るものではない。**
2. **会話が手元に残っていれば、そちらを主な材料にしろ。** スクリプトは、要約で前半が消えた
   ときに背骨を補うためのものだ。補って書いた部分は、会話から直接ではないと読む人に分かるようにしろ
   （上の「内部の事情は書くな」に従い、どう補ったかの内部語は出さない）。
3. 下の**型**で書く。

## 型

**同僚に口で話すときの散文**で、**太字の 1〜2 文で始める**。段落の順は固定で、段落は短く。
コードブロック・表・ラベル列・箇条書きの入れ子を使わない。下の例は書き方の一つで、文言を写す型ではない
——決まった言い回しは場面に関係なく毎回出て雑音になる。

```
**attention の /catchup と /what-am-i-doing を直し終えました。残っているのは、
コミットして push するかどうかの判断です。**

きっかけは、あなたが「使い勝手が悪い」「すっと頭に入らない」と言った 2 つの
出力です。原因は 2 つありました。自分の push を別人のものとして数えていた
せいで「最後に触った日」が 1 か月前に出ていたこと。返答が答えを末尾に置く
並びだったこと。
両方直して、初見の読み手 3 人に読ませて通るところまで持っていきました。
テストは 261 件緑です。

push すれば、次にセッションを起動したときから新しい形で出ます。いまの
セッションは古い版のままです。

却下した案と根拠の照合は scratchpad/research-record.json に置きました。次に
やることには関係しません。
```

- **1 段落目（太字）**: 何をしていて、読む人に何が要るか。判断待ちなら、何を決めてほしいかを
  **選択肢の名前まで**（複数の判断があれば①②で全部）、私が続けるなら次の一手、終わったなら
  終わった旨。**ここだけ読んで用が足りるように書く**——実測: 判断が 150 行の末尾にあった
  返答は、本人が「結局どういう判断をしてほしいのかだけ教えて」「初見にもわかりやすく」と 2 回聞き直した
- **2 段落目（状況）**: **読む人が知っていることから始める**（あなたが頼んだ・言ったこと）。何のための
  何を・何が起きて・いまどこか。3〜5 文。番号と題名だけ書くな——何が問題で、何をしようとしているのか。
  不具合は**現象で書く**（「集計がずれていた」ではなく「最後に触った日が 1 か月前に出ていた」——
  抽象語は像を結ばない。実測: 3 人が二度読んだ）。
  **1 段落目に出した番号は、ここで 1 回中身を説明する**（何の PR か・誰のものか・本題との関係）
- **3 段落目（止めている理由と選択肢）**: なぜ人の判断が要るのか。選択肢は「A. 何をする——利点か欠点を
  1 句」を 1 案 1 行、推奨を明記。各案は**「何をする」を主語述語で**、初見が読める言葉で（「最小で
  締める」「固める」のような仲間内の語を使うな）。判断待ちでなければこの段落は無い
- **4 段落目（次にやること）**: 読んだ人がそのまま実行できる具体度で。選択肢があるなら案ごとに 1 文
- **最後の 1 行（記録の在りか）**: 却下した案・作ったものの位置と数・レビューの記録は、**中身を書かず
  ファイルや番号で指す。いま読む必要が無いことが分かるように**（分からないと、読む人は読むべきか迷う
  ——実測）。詳しく求められたら、そこから出す
- **全体で 15 行前後、400 字前後。** 段落は 5 文以内。変更の勘所が次にやることに効くときだけ、
  「変更前 → 変更後」を 2〜3 行足してよい
- **手元に未コミットの変更が 3 file 以上あるときは、機械の `いま手元に残っているもの` のセクションにある「木」
  （変更したファイルの木）を ```diff の枠でそのまま貼る**
  （この枠だけ、コードブロックを使わない規則の例外）。行頭 `+` が新規で緑になり、`~` が変更。
  周辺の既存も薄く並んでいるので「全体のどこを触っているか」が名前の列より早く読める。
  組み直さない、私の言葉を書き込まない。1〜2 file なら「記録の在りか」の行で名前を言えば足りる
- **中身（変更したコード）を求められたら、貼る前に別ファイル [references/contents.md](references/contents.md)
  を Read で開いて読む**（このファイルには無い。中身は、機械の「変更の中身」の枠の貼り方・言語名・帯・飛び先・`--frame`）
- **文体は です・ます**。読む人に話しかける文で書く
## 書き方

- **人称を固定しろ。**「私」＝このセッション。あなたの代理で動いているので、GitHub 上の
  立場（PR の作者・レビュー依頼の宛先）も「私」で書く。「あなた」を使うのは、読んだ人に
  判断や実行を求める文だけ。同じ事実を「私」と「あなた」で言い換えるな
- **初出の語を説明せずに使うな。** この会話の中で決めた呼び名（ツールの名前・略号・「例の件」）は、
  そこで一度説明する。**「この会話の最初の件」「さっきの」のように会話の位置で指すな**——読む人は
  会話に居ない。「先に頼まれていた〜」のように中身で指す
- **番号はリンクで書け。** 機械の「扱っている件と、私の立場」に URL が出ている番号だけ
  `[#番号](URL)` の形（対応する端末では番号だけが表示されてクリックで開ける）。URL の無い番号は
  `#番号` のままで、組み立てない
- **数と場所を省くな。** 追いつくとは、次に自分で触れる状態になることだ。ただし数と場所は記録の
  在りかに寄せ、本文は動作に要るものだけ
- **却下した案を落とすな**——ただし本文ではなく記録の側に。名前の無い「ほか N 件」は、同じ提案が
  来たときに検討済みと言えない
- **削ってよいのは、読む人が要らない話だけ**——経緯の実況、自分の作業の narration、
  どのファイルを何回読んだか
- **言葉づかい**は、この作業を知らない同僚に説明するときのもの。断りなしの GitHub / CI の語・
  コンサル英語・直訳横文字を使うな。どうしても要る語は、初出で「中身 → 記号」の順に書く
- **枠の中は 1 行 60 桁以内（日本語は 2 桁）。** 注釈は行の上に、右に日本語を置かない——折り返した
  瞬間に行の形が壊れる。図と表の絵も対象で、`figure-check.py` で確かめる（図の別ファイルの手順）。
  見出しと散文は対象外
- **図**: 部品が 2 つ以上あって関係（呼ぶ・渡す・分岐・前後・同居）が言えるなら、図を足すかを決める。**決める前に別ファイル [references/figures.md](references/figures.md) を Read で開いて読む**（このファイルには無い。中身は、描く基準・ラベルと線と記号の決まり・`figure-check.py` での確かめ方・例）