# パーソナル図解

自分の仕事に特化した図解スキルを作るためのリポジトリです。

配布済みの図解ツールは、誰の仕事にも使える汎用ツールです。パーソナル図解スキルは、この汎用ツールに「読者は誰か」「どう伝えるか」を書き込んだものです。

## フォルダの中身

```
personal-visual-explainers/
├── .claude/skills/
│   ├── creating-skills/                  ← スキルの作り方ガイド
│   └── creating-visual-explainers/       ← 図解を生成するスキル（配布済みの図解ツールと同じもの）
├── sample/
│   └── majiai-diagram/                   ← 作成例（本気AIの図解スキル）
│       ├── .claude/skills/diagram-maji/  ← スキル本体
│       └── docs/charactor-images/        ← キャラクター画像
├── output/                               ← 図解の保存先
├── .gitignore
└── README.md                             ← この説明書
```

| フォルダ | 説明 |
|---------|------|
| `.claude/skills/creating-skills/` | スキルの作り方ガイド。設計原則・パターン集・チェックリストが入っています |
| `.claude/skills/creating-visual-explainers/` | 図解HTMLを生成するスキル。配布済みの図解ツールと同じものです |
| `sample/majiai-diagram/` | 図解の作成例。本気AIが実際に使っている図解スキルの構造がわかります |
| `output/` | 生成した図解の保存先 |

## まず作成例を見てみる

`sample/majiai-diagram/.claude/skills/diagram-maji/` の中にある SKILL.md と references/ フォルダを開いて読んでみてください。

- **SKILL.md** — スキルの全体設計（どんな順番で何をするかのワークフロー）
- **references/** — デザインガイド、用語辞書、キャラクター設定など
- **docs/charactor-images/** — 図解に使うキャラクター画像

「スキルの中身はこうなっているんだ」と全体像をつかんでおくと、この後の作業がスムーズです。

## パーソナル図解スキルの作り方

詳しい手順はポータルの課題ページに書かれています。ざっくりした流れは以下の通りです。

```
  ① ヒアリングシートを埋める
     「誰のどんな問題を解決するか」を言語化する
              ↓
  ② AIにスキルを作ってもらう
     ヒアリングシートをCursorに貼り付けて依頼する
              ↓
  ③ 生成されたスキルを確認・修正する
     作成例と見比べて、足りない部分を追加する
              ↓
  ④ 図解を作って試す
     「○○を図解して」と依頼して、出力を確認する
```

## 図解を作る

パーソナル図解スキルが完成したら、チャット欄で「○○を図解して」と依頼するだけです。

生成された図解は `output/` フォルダに保存されます。

## 図解を共有する

PDF での共有方法や URL での公開方法は、配布済みの図解ツールと同じです。
図解ツールの README を参照してください。

## 困ったとき

何が起きても、まずはチャット欄で AI に状況を伝えてください。
AI がエラーの内容を読み取り、次にやるべきことを教えてくれます。

解決しない場合は、ポータルの課題ページにあるトラブルシューティングを確認してください。