Skip to content
Back to search

understand-mode

SkillWorks with Claude CodeGitHub

Claude Code skill (/understand): explore Claude's output, PRs, code and diffs on a sticky-note whiteboard (Japanese UI). Based on fkubota/understand-mode.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/poska-lab--understand-mode/badge.svg)](/listings/poska-lab--understand-mode)

HTML

<a href="/listings/poska-lab--understand-mode"><img src="/api/listings/poska-lab--understand-mode/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 115 lines
  1. # understand-mode(/understand)
  2. Claude Code の出力を、付箋のホワイトボードで寄り道しながら理解するためのスキルです。
  3. わからない文を選ぶと、その場に付箋が生えます。付箋の中では、メインの文脈を引き継いだ分身が答えます。メインの会話は汚れません。
  4. ## できること
  5. - 本文(Claudeの出力・コード・未コミットの差分)の文や行を選ぶと、質問・詳しく・用語・図・データ・レビューの付箋が生えます
  6. - コードと差分は行番号付きで表示し、選んだ行番号をClaudeに伝えます
  7. - 説明に載るコードの抜粋には、ファイル名と実際の行番号が付きます
  8. - 付箋の中でも会話でき、回答の文を選べば子付箋になります
  9. - 図は Mermaid、グラフは Vega-Lite で描きます。本文にも付箋にも入ります
  10. - データの付箋では、提案されたSQLの「実行のしかたを確かめる」を押すと、あなたの Claude がいつものやり方での呼び出し(命令か MCP の道具と入力)を、実行せずに返します。それを見て「この呼び出しで実行」を押したときだけ実行し、結果の表・グラフ・SQLを並べて見られます
  11. - Claude Code を確認なしのモード(`bypassPermissions`)で使っているときは、アプリも聞き返しません。提案されたSQLはそのまま実行されます
  12. - 付箋が「本文への影響」を見つけたら、「本文に反映」で直し案を作れます。差分を見て承認したときだけ本文を直し、元の文は取り消し線で残します。直したことはメインにも届きます
  13. - 「理解を終える」で、本文に影響ありの付箋からメインに返す文を下書きし、送ったら寄り道の記録は破棄します
  14. ## 必要なもの
  15. - Claude Code(`claude` コマンド)
  16. - PRを対象にする場合:`gh` コマンド(なければブランチの差分で代わりにします)
  17. - Node.js 18 以上
  18. - データの付箋でSQLを実行する場合:あなたの Claude が普段データを取れていること(psql でも Redash の MCP でも、いつものやり方のままで構いません)
  19. - PRモードは `gh` があれば使いますが、作者の環境では GitHub につなげなかったため、ブランチ差分での代替手順でしか試していません
  20. 追加の npm パッケージは不要です。図とグラフのライブラリは同梱しています(ネット接続がなくても描画できます)。
  21. 動作を確認しているのは macOS と Linux です。Windows では試していません。
  22. ## インストール
  23. ```bash
  24. git clone https://github.com/poska-lab/understand-mode.git
  25. cd understand-mode
  26. bash install.sh
  27. ```
  28. `~/.claude/skills/understand/` にコピーされます。Claude Code を開き直すと `/understand` が使えます。
  29. ## 使い方
  30. 1. Claude Code で調査や実装をしてもらう
  31. 2. わからないと思ったら `/understand`
  32. - やりたいことを書く:`/understand このPRを理解したい`、`/understand #128のPR`、`/understand 認証の流れを理解したい`
  33. → メインのClaudeが調べて、概要→変更のまとまり→必要な分だけのコード抜粋→読むときのポイント の順に説明文書を作ってから開きます
  34. - 図を挟む:`/understand -1 このPRを理解したい`(**本文はそのまま**、段落の合間に図とグラフが入ります)
  35. - 図解に寄せる:`/understand -2 このPRを理解したい`(図を主役に、本文も組み替えます)
  36. - 直前の回答:`/understand`
  37. - ファイル:`/understand src/report.py`
  38. - 未コミットの変更をレビュー:`/understand diff`(ブランチとの差分は `/understand diff main`)
  39. 3. ブラウザでホワイトボードが開くので、わからない箇所を選択して付箋を作る
  40. 4. 理解できたら「理解を終える」→ 返す付箋を選ぶ →「メインに送って閉じる」
  41. 5. Claude Code に戻って「終わった」と伝える。メインのClaudeが内容を受けて、元の回答や成果物を直します(指摘が違う場合は理由を示して押し返します)
  42. ### 操作
  43. | 操作 | やり方 |
  44. | --- | --- |
  45. | 付箋を作る | 本文や付箋の回答の文を選択 → メニュー |
  46. | 続けて質問 | 付箋の入力欄で ⌘/Ctrl + Enter |
  47. | 付箋を動かす | 付箋の見出しをドラッグ |
  48. | たたむ・開く | 「たたむ」ボタン/たたんだタブをクリック。まとめて片付けたいときは上の「すべてたたむ」 |
  49. | 付箋の大きさを変える | 右の辺で横、下の辺で縦、右下の角で両方をドラッグ(ダブルクリックで元に戻ります) |
  50. | ボードを動かす | 背景をドラッグ、またはスクロール |
  51. | 拡大・縮小 | ⌘/Ctrl + スクロール、または下のツールバー |
  52. | グラフの値を質問 | グラフの点や棒をクリック |
  53. 設定ファイルはありません。モデルも道具もSQLの書き方も、分身がメインのセッションから引き継ぎます。
  54. 変えられるのは待ち時間だけです。重い調べものに時間がかかるようなら、`UNDERSTAND_TIMEOUT_SEC=600` のように環境変数で伸ばせます(既定は300秒)。
  55. ## しくみ
  56. - 質問のたびに `claude -p --resume <メインのセッション> --fork-session` を実行します。メインの文脈を引き継いだ分身が答えるので、メインの会話は汚れません
  57. - 付箋の続きの質問はその付箋のセッションに、子付箋は親の付箋のセッションから分岐します
  58. - 閉じると、このアプリが作った分岐セッションの記録(`~/.claude/projects/` の該当ファイル)だけを削除します。メインのセッションには触れません
  59. ## 注意
  60. - 質問1回ごとに、メインの会話全体を読み込みます。会話が長いと費用がかかります(2回目以降はキャッシュが効きます)
  61. - 分身はメインと同じモデルのまま、思考量(effort)だけ `low` で動きます。寄り道を軽く回すためです
  62. - グラフの値は、Claudeが取得して返した結果の表から描いています。アプリがデータベースに直接つないでいるわけではありません
  63. - このアプリは接続先も道具も持ちません。承認のときに「いつものやり方で実行して」と頼むだけです。トンネルや認証の用意は、普段どおり先に済ませておいてください
  64. - 実行できるのは `select`(または `with`)で始まる1文だけです。書き込みや複数文はアプリ側で弾きます
  65. - 付箋の分身が使えるのは、読む道具(Read・Grep・Glob など)だけです。コマンドの実行、ファイルの編集、外への検索や取得、MCP の道具は止めています
  66. - 実行するときに通すのは、あなたが画面で確かめて承認した呼び出しと同じものだけです(命令の前後の空白と改行コードのほかは、一字も違えば止めます。サンドボックスを外すなどの指定を足したものも止めます)。それを動かすかどうかは、あなたが普段 Claude Code に与えている許可のままです。アプリが許可を足すことはありません
  67. - 承認を挟むかどうかは、メインのセッションの権限モードに合わせます
  68. - アプリのURLには合言葉が入っています。この合言葉がないと操作できないので、**URLを人に見せないでください**。同じマシンの別のページやプロセスからの操作を、これで防いでいます
  69. - 付箋の内容は、ブラウザのタブを閉じるまでそのタブの中だけに保存されます
  70. - 送らずにタブを閉じても、30分たつとアプリは自分で片付けて閉じます。本文に反映した直しがあれば、メインに届くように残します
  71. ## アンインストール
  72. ```bash
  73. rm -rf ~/.claude/skills/understand
  74. ```
  75. ## 開発する人へ
  76. 続きの開発は `CLAUDE.md` と `docs/architecture.md` から読んでください。`npm run mock` で、費用をかけずに画面を動かせます。
  77. ```bash
  78. npm run mock # 偽の claude で起動(費用ゼロ)
  79. npm run test:sql # SQL実行まわりの確認(ClaudeもDBも使わない)
  80. npm i && npm run test:e2e # mock を動かしたまま、画面を一通り自動操作
  81. ```
  82. ## 由来
  83. [fkubota/understand-mode](https://github.com/fkubota/understand-mode) のコミット `89ebc91`(2026-11-21 時点の main)を取り込み、独立して改善しています。元のリポジトリとは同期しません。取り込んでからの改善は、まとめてこのリポジトリの最初のコミットにしています。どう直したかは `docs/改善候補.md` にあります。
  84. ## ライセンス
  85. MIT(`LICENSE` を参照)。元の作者の著作権表示を `LICENSE` に残し、このリポジトリでの改変分の表示を足しています。同梱しているライブラリは `skill/understand/app/public/vendor/LICENSE-*` を参照してください。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.