show-me-your-work

作業内容を記録する

GitHub Copilot では、このスキルを実行する前に、スキルごとの注記も含めてプラットフォーム対応表を読んでください。

Muse では、このスキルを実行する前に、スキルごとの注記も含めてプラットフォーム対応表を読んでください。

正本となるログは1つに保ってください。

形式

1つのTSVファイルに、判断1件につき1行を記録します。各セルは1行に収めます。証拠には説明文ではなく参照先を記載します。

新しいログを作るには、references/decision-log-template.tsv のヘッダー行をコピーします。列は次のとおりです。

• ts. ISO8601形式のタイムスタンプ。
• phase. フェーズまたは作業ストリーム。
• decision. 選択または実施した内容を1行で記載します。
• why. 平易な言葉で理由を記載します。原則に基づいている場合は、専門用語のタグではなく、分かりやすく説明します。
• evidence. その判断を裏付けるリンクまたはパス。コミットSHA、PR番号、file:line、成果物、トレース、スクリーンショットのパスなどを記載します。段落は不可です。
• result. 結果または判定状態：tests green、reverted、pixel-diff 0、INCONCLUSIVE、open。

レビュー担当者が一目で読めるよう、率直な言葉で書いた例です。

ts	phase	decision	why	evidence	result
2026-05-24T09:02:00Z	frame	counted the work first, about 100 components and roughly 75 hours	wanted to know the size before starting a long run	commit 3a9f1c2	found 5 things to sort out before starting
2026-05-24T09:40:00Z	harness	took screenshots of the old version before changing anything	so we can compare old against new and catch any visual change	scripts/snapshot.sh, baseline/	saved 120 reference screenshots
2026-05-24T11:15:00Z	widget	moved the widget styles over without changing how it looks	keep the change small and the result identical	commit 7c21e0a, pixel-diff 0	looks identical, tests pass
2026-05-24T12:30:00Z	widget	threw out a helper's work because its screenshots were blank	checked the real files instead of trusting its summary	worktree reset	reverted, tightened the instructions for next time

行の記録

各項目は、チームメイトに実施内容を伝えるように記述します。平易な言葉で具体的な作業を記し、AIらしい言い回しや抽象的な専門用語は避けてください（ログの文章にも unslop スキルを適用します）。

すべての作業ではなく、判断点やチェックポイントを記録します。方針の選択、検証結果を伴う単位作業の完了、きっかけを明記した方針転換や取り消し、表面化したブロッカー、修正したゲートなどです。ループ実行では、反復ごとに1行記録します。些細なことや自明なことは省きます。

1回の実行とは、後続のターンやその要約も含む、エージェントとの1つの会話です。作業の引き継ぎ、別のエージェントへの交代、新しいチャットは、新しい実行の開始となります。既存の行があるログに実行内容を追加する場合、その実行の最初の行の phase は start とし、別の実行の start 行に続く最初の行も同様に start とします。そのため、後のターンでログに戻ってきた実行は、別の実行がその後に書き込んでいないか確認するため、最初にログの末尾の行を読みます。start 行には、この実行が記録したものではない、それより前の行の ts の範囲を記載し、証拠にはエージェントIDなど、この実行を特定できる情報を記載します。start 以外の用途に start フェーズを使ってはいけません。

保存場所

デフォルトでは、ログは作業用成果物であり、コミットしません。作業ディレクトリの decisions.tsv、または複数の作業を並行して進める場合は .audit/<task-slug>.tsv に保存し、git の対象から除外します。

レビュー担当者が結果を信頼するために記録が必要なほど大規模な作業の場合に限り、コミットします。

ルール

• 追記のみ。判断を誤った場合は、新しい行で以前の判断を置き換えます。履歴を編集または削除してはいけません。
• 手作業で一度きりのものより、コミット済みスクリプトが生成した証拠を優先します（encode-lessons-in-structure の原則スキル）。

ログをトランスクリプトと照合して監査する

実行の最後に、引き渡す前に、ログが事実を記録しているか確認します。この実行のトランスクリプトを、Claude Code のプロジェクトごとのトランスクリプトディレクトリ ${CLAUDE_CONFIG_DIR:-$HOME/.claude}/projects/<encoded-cwd>/ で読みます。このディレクトリは node <plugin>/skills/reflect/scripts/claude-project-dir.mjs を実行すると表示されます。${CLAUDE_CONFIG_DIR:-$HOME/.claude}/projects/ 全体を glob で検索しないでください。無関係な個人のチャットまで読み込んでしまいます。この実行の行を、実際に起きたことと照らし合わせて確認します。各まとまりは、この実行の start 行のいずれかから、またはこの実行でログが作成された場合は先頭行から始まり、別の実行の次の start 行で終わります。

• 各行が、実際の判断または行動に対応していることを確認します。
• 各行の根拠を確認でき、行の主張を裏付けていることを確認します。
• 作業に影響した分岐、方針転換、または断念したアプローチが記録されていなければ、欠落として追加します。

修正するのはログであり、物語ではありません。監査では、作り上げられた行であっても、行を編集したり削除したりすることはありません。ある行が実際の判断も行動も記録していない場合、または主張や根拠が誤っている場合は、実際に起きたことと、参照先を確認できるポインターを記した行を追加し、その行を置き換えます。この監査では、この実行の範囲外の行は確認しません。この実行の作業を通じて範囲外の行に誤りがあると分かった場合は、誤った判断と同様に置き換えます。

トレイルのクロスモデルレビュー

引き渡す前に、作業を行ったモデルファミリーとは異なるモデルファミリーのサブエージェントを起動します。自己レビューで代用することはできません。サブエージェントは監査トレイルとこの実行のトランスクリプトを読み、ユーザーが注意すべき点を指摘します。作業をやり直すのではなく、最適でない点やリスクのある点を確認します。Subagents セクションに従い、タスクに応じた推論レベルを各サブエージェントに設定します。

• 根拠が弱い、または根拠がないまま記録された判断。
• トランスクリプトに証拠がないのに、実施したと主張されている、または省略されている検証手順。
• 後から見るとリスクがある選択（拙速、スコープの拡大、症状の取り繕い）。
• 軽く目を通しただけではユーザーが見落とす欠落。

トレイルを作成した実行では、すべての返信の末尾に「Attention」セクションを付けます。最初にレビュー担当モデル名を単独の行に記載し（reviewed by <model>）、その後、該当する行または時点を具体的に示しながら、指摘事項を列挙します。「No flags」も有効な記載です。モデル名は必ず記載してください。

トレイルを確認する

上から順に読み、根拠のポインターをたどり、抜き取りで確認します。GitHub では、コミット済みの TSV は表として表示されます。ターミナルでは column -s$'\t' -t decisions.tsv で表示できます。

このスキルの作成

他のスキルが監査トレイルを独自に作るのではなく、ここに回すようにします。名前で参照し、形式についてはこのスキルに任せます。列の内容を繰り返さないでください。