К основному содержанию
плагин

figure-docs — плагин для Claude Code: документы с диаграммами

Плагин figure-docs для Claude Code создаёт документы, где основную мысль передают диаграммы. Он подключает скилл к просьбам подготовить отчёт, бизнес-материал или объяснение разработки.

MIT ★ 65 обновлён 2026-11-16

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add u-ichi/agent-plugins
/plugin install figure-docs@u-ichi
Открыть на GitHub

Что делает figure-docs

figure-docs подключает скилл, который строит документ вокруг диаграмм: сначала формулирует тезис раздела, затем выбирает подходящий тип схемы и добавляет к ней короткое пояснение. Внутри есть образцы 112 бизнес-диаграмм и 38 диаграмм разработки, а также правила оформления и выбора формата.

Для бизнес-материалов скилл создаёт HTML-страницу или Artifact, если среда умеет его создавать. Объяснения разработки для GitHub оформляет в Markdown с Mermaid; при большом числе схем — в HTML. Документы Word или PDF создаёт, когда запрошен именно такой формат. Разработческие схемы Mermaid подходят для GitHub Markdown и Artifact.

Какие задачи решает

  • подготовить бизнес-отчёт с диаграммами вместо набора таблиц
  • показать структуру системы и связи между компонентами
  • описать последовательность событий в разработке
  • сравнить варианты и наглядно обосновать решение

Примеры запросов агенту

  • Подготовь HTML-отчёт о рынке и покажи ключевые выводы диаграммами.
  • Объясни устройство сервиса для GitHub в Markdown с диаграммами Mermaid.
  • Сравни варианты миграции и оформи результат в PDF.

Как установить figure-docs

Через маркетплейс плагинов

/plugin marketplace add u-ichi/agent-plugins
/plugin install figure-docs@u-ichi

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о figure-docs

Как установить figure-docs в Claude Code?

Выполни команды по порядку: /plugin marketplace add u-ichi/agent-plugins, затем /plugin install figure-docs@u-ichi.

Что делает figure-docs?

Плагин добавляет скилл для подготовки документов, в которых главную мысль каждого раздела показывают диаграммой. Он охватывает бизнес-материалы и объяснения разработки.

В каких форматах figure-docs создаёт документы?

Бизнес-материалы и отчёты оформляются как HTML-страница или Artifact. Объяснения разработки для GitHub — как Markdown с Mermaid; для Word или PDF нужно запросить соответствующий формат.

Исходный текст

figure-docs · MIT
# figure-docs

人に読ませる資料を、図を中心に作り切るための skill。言いたいことごとに図の形を先に決めて描き、文章は図ごとの要点1行にする。事業の資料(事業企画、マーケティング、市場調査、事業計画)と、開発の説明(設計書、PR の説明、障害の報告、移行の計画)の両方に使う。

## 何が出るか

同じ依頼(「ペット保険市場に参入すべきかを判断する資料を作って」、数値は架空)で、figure-docs を読ませない場合と読ませた場合に Claude が作った資料の先頭部分。

![figure-docs を読ませない場合と読ませた場合に作った同じ資料](images/before-after.png)

| | figure-docs なし | figure-docs あり |
|---|---|---|
| 節の見出し | 「市場の大きさと伸び」のような題 | 「市場は年11%で伸びている」のような言いたいこと1文 |
| 図 | 1つ(ほかは横棒と表) | 7つ(節ごとに1つ。散布図、ガント、因果の矢印の図など) |
| 表 | 4つ | 0 |
| 見えている文字 | およそ1,770字 | およそ490字(詳細は畳む) |

## 動き

skill を読んだエージェントは、資料の節ごとに次の順で進める。形から先に決めず、文章は図の後に足す。

```mermaid
flowchart LR
  A["言いたいことを1文に決める"] --> B["何を比べるかで分類を決める"]
  B --> C["見本からその分類の形を選ぶ"]
  C --> D["描き方を選んで図を描く"]
  D --> E["要点1行を添え、詳細は畳む"]
  E --> F{"文章を消し、図の中を名前と値だけにしても分かるか"}
  F -- "分からない" --> C
```

描き方は、次の順で最初に当てはまるものを使う。

1. Artifact の側にその形の描き方があればそれを使う(Artifact の tool が作れる種類と、artifact-design、artifact-diagramming、dataviz などの skill)。
2. 開発の図で、置き場所が Mermaid を表示できる(GitHub の Markdown、Artifact)なら Mermaid で書く。
3. どちらも無ければ、見本の svg を写して描く。位置の計算が要る図(Sankey、Treemap など)と地図は、d3 などで位置を計算した結果を svg にして埋め込む。

## 出す資料の形

| 資料 | 形式 |
|---|---|
| 事業の資料、報告、判断の資料 | 1つの HTML のページ。Artifact を作れる環境では Artifact |
| GitHub に置く開発の説明(PR、issue、設計書) | Markdown に Mermaid の図を入れる。図が多いときは HTML のページ |
| Word、PDF などを名指しされたとき | その形式 |

日本語はゴシック体にし、HTML では Google Fonts の Noto Sans JP を読み込む。図の中の文字は部品の名前と値と数語の注記にし、文は図の下の要点1行か、畳んだ詳細に置く。

## 図の分類と見本

見本は、図ごとに名前、形(何を、どの軸や位置や線や色で描くか)、使う場面、最小の svg を持つ。開発の図には、描ける Mermaid の種類も添えてある。

### 事業の図(112種)

数のある図の分類と名前は Financial Times Visual Vocabulary(MIT)による。見本の全体は [references/business.html](skills/figure-docs/references/business.html)。

| 分類 | 使う場面 | 図の例 |
|---|---|---|
| 差(6) | 0、目標、平均などの基準からの上下 | Diverging bar、Bullet chart、Tornado chart |
| 相関(6) | 2つ以上の値の関係 | Scatterplot、Bubble、BCG matrix |
| 順位(7) | 並びの中の位置 | Ordered bar、Slope、Pareto chart |
| 分布(9) | 値がどこにどれだけあるか | Histogram、Boxplot、Football field |
| 時間での変化(17) | 傾向の変わり方 | Line、Fan chart、Cohort retention heatmap、S字の普及曲線 |
| 内訳(12) | 全体を部品に分ける | Stacked column、Treemap、Waterfall、Marimekko、KPIツリー |
| 大きさ(10) | 数えた量の比較 | Bar、Paired bar、Isotype |
| 地理(8) | 場所や地域の違い | Basic choropleth、Flow map、Scaled cartogram |
| 流れ(4) | 状態や場所の間を動く量 | Sankey、Chord、Network |
| 数が無い論点(33) | 位置づけ、枠組み、手順、関係、因果、判断、前と後 | 2x2、ロジックツリー、スイムレーン、フィッシュボーン、SWOT、ビジネスモデルキャンバス |

![事業の図の見本112種](images/figures-business.png)

### 開発の図(38種)

見本の全体は [references/dev.html](skills/figure-docs/references/dev.html)。分類は C4 model、UML、arc42、DDD、STRIDE、SRE の定番から取った。

| 分類 | 見せること | 図の例 |
|---|---|---|
| 構造(9) | 何がどの部品でできていて、依存の向きはどうか | System Context、Container diagram、Layer diagram、Class diagram |
| やりとり(3) | 誰が誰にどの順で何を頼むか | Sequence diagram、Dynamic diagram、Event storming |
| 状態と手順(5) | 状態の変わり方、処理の分かれ | State machine、Flowchart、Screen flow |
| データ(5) | 何がどこに入り、どう流れるか | ER diagram、Data flow diagram、脅威モデルの DFD |
| 配置(3) | どこで動き、どの境界をまたぐか | Deployment diagram、クラウドの構成図、信頼の領域 |
| 時間(4) | いつ何が起き、どの順で進むか | 障害のタイムライン、Git graph、CI/CD pipeline |
| 変更(3) | 前と後の違い、移す順 | 変更の前と後、段階ごとの連作、段階的な公開 |
| 性能と信頼性(4) | どこで時間を使い、どれだけ失敗してよいか | Trace のタイムライン、Flame graph、エラーバジェットの消費 |
| 判断(2) | 案の比べ方と選んだもの | 設計案の比較表、Requirement diagram |

スイムレーン、ガント、判断の木、なぜの木、Sankey は、事業の図の見本にある形を使う。

開発の図は次も守る。四角は1枚に6つまでにし、つながらない四角は描かない。矢印には何を渡すかを書く。部品が3つ以上増える構成や3段階以上の移行は、段階ごとに1つずつ足す連作にする。変更の前と後は同じ配置で並べ、足すものを緑、消すものを赤の点線、変えるものを太線にする。

![開発の図の見本38種](images/figures-dev.png)

## 使われる場面

skill の説明文(SKILL.md の description)は「人に読ませる資料を作るとき」で、報告、草案、比較や判断の資料、事業の資料、開発の説明を、HTML のページ、Artifact、Markdown のどれで作るときも当たる。この説明文に当たる依頼のとき、エージェントがこの skill を読む。

## ファイル

```
plugin.json                          Agent Plugins の manifest
.claude-plugin/plugin.json           Claude Code の manifest
skills/figure-docs/SKILL.md          skill の本文(選ぶ順、資料の形式、分類、描き方の決まり)
skills/figure-docs/references/business.html  事業の図の見本
skills/figure-docs/references/dev.html       開発の図の見本
LICENSES/FT-Visual-Vocabulary.txt    FT Visual Vocabulary の著作権の表示
images/                              この README の画像
```

入れ方はリポジトリの [README](../../README.md#入れ方) にある。

## ライセンス

MIT。事業の図の分類と名前は Financial Times Visual Vocabulary(MIT)による。著作権の表示は [LICENSES/FT-Visual-Vocabulary.txt](LICENSES/FT-Visual-Vocabulary.txt)。

© u-ichi · MIT · u-ichi/agent-plugins

Похожие плагины

Все плагины по теме «Тексты и документация» →
diagram-design cathrynlavery Скилл diagram-design для Claude Code генерирует архитектурные схемы и графику в виде автономных HTML-файлов с инлайновым SVG. Создаёт 51 тип визуализаций с единым стайлгайдом проекта. CX Codex +1 30 900установок dashmotion csthink Скилл dashmotion для Claude Code генерирует тёмные анимированные SVG-диаграммы в одном HTML-файле. Визуализирует архитектуру и процессы светящимися точками запросов и бегущими линиями. CX Codex +1 ★ 205звёзд репо coco-diagram coco-research Скилл coco-diagram для Claude Code превращает описание системы или процесса в диаграмму и перерисовывает источники .drawio и Mermaid. Показывает схему визуально, а не только текстом. CX Codex +1 ★ 328звёзд репо diagram-to-image sugarforever Скилл diagram-to-image для Claude Code переводит диаграммы Mermaid и таблицы Markdown в PNG-файлы. Создаёт изображения для постов в X/Twitter и платформ без поддержки разметки. CX Codex +1 515установок mermaid-diagrams hoodini Скилл mermaid-diagrams для Claude Code и пяти других платформ — учит агента писать диаграммы Mermaid: блок-схемы, sequence, классы, ER, Gantt прямо в markdown. CX Codex +1 409установок mermaidjs-v11 mrgoonie Учит агента писать диаграммы на синтаксисе Mermaid.js v11 и рендерить их в SVG, PNG или PDF. Закрывает задачу «нарисовать схему по описанию». CX Codex +1 376установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой