Progress report
Skill MasashiFukuzawa/agent-toolbox/plugins/toolbox/skills/progress-report
長時間作業や自律実行の進捗を、背景を知らない判断者向けに再構成して報告する。状況・現在地・次の判断を求められた時に使う。作業再開用の引き継ぎには context-handoff を使う。「今どうなってる」「どこまで進んだ」を正のトリガーとし、次の作業者がそのまま再開するための文書には context-handoff を使う。From its SKILL.md
npx -y skills add MasashiFukuzawa/agent-toolbox --skill progress-reportAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
5.5 KB, ~2.0k tokens by cl100k_base, as published. Nobody here has run it
Progress Report — EM が3層で読める進捗報告
読み手は「EM/PM との 1on1」を想像する。コードも経緯も知らないが、リソース配分と優先順位の判断を下す人である。
3層構造（このスキルの中核）
| 層 | 内容 | 読了目安 |
|---|---|---|
| L1 ヘッダ | ステータス行 + TL;DR + 要対応 | 10〜30秒。これだけで「状態と自分のタスク」が分かる |
| L2 全体マップ | 大元ゴール・マイルストーン表・現在地・次の一手 | 1分。これだけで「全体のどこにいるか」が分かる |
| L3 詳細 | やったこと・リスク・補足 | 読みたい人だけ |
冗長さは「削除」ではなく「L3 への降格」で解決する。 書くか迷った情報は消さずに L3 末尾の「詳細補足（読み飛ばし可）」へ落とす。逆に L3 を書いていて新しい結論・依頼が出てきたら L1 へ昇格させる。
ガードレール
- 視野を現在タスクに閉じない: 本作業が属する大元のゴール（計画ファイル・エピック・親Issue・マイルストーン）を必ず特定し、L2 で「全体の何番目のピースか」を示す。会話に情報がなければ痕跡（
~/.claude/plans/・Issue・コミット履歴）から再構築し、それでも不明なら「上位計画は痕跡から特定できず」と明記する - 推測を断定で書かない（詳細: references/writing-guide.md）。事実・推測（根拠つき）・不明を区別する
- 問題があるのに 🟢 に見せない。迷ったら悪い方の色
Step 1: 情報収集
- Mode A（自セッション報告）: 自分の作業コンテキスト＋痕跡で裏取り。記憶と痕跡が食い違ったら痕跡優先
- Mode B（痕跡からの再構築）: references/writing-guide.md の情報源チェックリストを上から確認。最初に上位計画・タスク体系を掘る（ガードレール1）
- コンテキスト圧縮後の再開は「帰属は Mode A・手順は Mode B」
掘る目安: (1) 大元ゴールと本作業の位置 (2) 本作業の目的 (3) 完了/残り (4) 順調か壊れているか、の4つに答えられたら十分。失敗テスト・revert 等の「うまくいっていない兆候」だけは原因まで掘る。
Step 2: テンプレート（この順で書く）
# 進捗報告: <作業の一言サマリ>（<日付>）
**ステータス**: 🟢/🟡/🔴 — <大元ゴール内の位置 + 定量の現在地を1行>
## 1. TL;DR ← L1
- <大元ゴールと本作業の位置づけ（1行）>
- <どこまで来たか（数字で）> / <いま何が起きているか>
- <読み手へのお願いが何件あるか → §2>
## 2. 要対応・要判断 ← L1
<読み手（人間）の対応が必要な事項のみ。各項目: 何をしてほしいか・なぜ・解消されないと何がいつから止まるか>
<なければ「なし — このまま続行できます」と明記>
## 3. 全体マップ ← L2（表を既定とする）
<大元ゴールの一言説明（初見向け・固有名詞に補足）>
| # | マイルストーン/タスク | 状態 | 検証レベル |
|---|---|---|---|
（✅完了 🔄作業中 ⬜未着手。本作業の行を太字。検証レベル=ローカル/ステージング/本番等）
<タスク間に依存関係・並行関係があり表で伝わらない場合のみ、ascii-diagram で小さく図解>
## 4. 現在地と次の一手 ← L2
<🔄 の中身: 何が終わり何が残るか（数字で）。次にエージェントが打つ一手>
## 5. やったこと（重要順・3〜7項目） ← L3
<各項目: 何をしたか + なぜ重要か + 参照(ファイル/コミット/PR)。軽微な修正は「他N件」と1行>
## 6. ネクストアクション ← L3
<優先度順・各項目に「誰が」を明示。§7 の問題には対応アクションを必ず置く>
## 7. リスク・想定外・学び ← L3
<なければ「特になし」と明記。取り繕わない>
## 8. 詳細補足（読み飛ばし可） ← L3・任意
<L1/L2 から降格させた背景・データ・ログ抜粋>
セルフチェック（書き終えたら読み手の椅子で）
- L1 だけで「今どういう状態で、自分は何をすべきか」が分かるか（30秒基準）
- L2 までで「大元の何のどこにいて、次に何が起きるか」が分かるか（1分基準）
- 網羅列挙していないか（20項目のリストからは何も判断できない — 絞って他は降格）
- 数字は検算したか・問題を隠していないか
執筆ルールの詳細・Good/Bad 例・矛盾する痕跡の扱い: references/writing-guide.md
出力
- チャット内に Markdown で出力（ファイル保存は明示的に求められた場合のみ）
- 言語は依頼者とのやり取りに合わせる（既定は日本語）
What ships with it: 2 files
20.3 KB alongside SKILL.md
evals/
- evals.json9.4 KB
references/
- writing-guide.md10.9 KB