75 lines
3.5 KiB
Markdown
75 lines
3.5 KiB
Markdown
# パーソナル図解
|
||
|
||
自分の仕事に特化した図解スキルを作るためのリポジトリです。
|
||
|
||
配布済みの図解ツールは、誰の仕事にも使える汎用ツールです。パーソナル図解スキルは、この汎用ツールに「読者は誰か」「どう伝えるか」を書き込んだものです。
|
||
|
||
## フォルダの中身
|
||
|
||
```
|
||
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 がエラーの内容を読み取り、次にやるべきことを教えてくれます。
|
||
|
||
解決しない場合は、ポータルの課題ページにあるトラブルシューティングを確認してください。
|