rosenzulisted
Install: claude install-skill shikigami-ai-works/claude-html-skills
# 路線図の描き方
流れを路線、節目を駅として描く。
雛形はこの Skill のフォルダの `template/` にある。
見た目の正本は雛形とする。見た目を直すときは雛形を先に直し、案件にある写しを置き換える。
- `build_rosenzu.py`: 入力の JSON から HTML を書き出す。検査に通らなければ書かずに止まる(Python 3.9 以上、標準ライブラリだけ)
- `shot.mjs`: 書き出した HTML を幅と明暗を変えて4枚撮り、数を数える(Node.js 18 以上、Chrome か Chromium 系のブラウザ。依存パッケージは無い)
- `assign_colors.py`: 下の「色の選び方」の条件を満たす色の当て方を出す
- `sample.json`: 入力の手本(架空の題材)
## 路線図が合う形
- 流れがおおむね一本道で、いくつかの節目を複数の流れが共有している。
- 分岐と合流が多く、どこからどこへでも辺がある網には合わない。その場合は表か、ノードと辺の図にする。
- 流れが1本だけなら、番号つきの一覧で足りる。
## 見た目の決まり
| 描く物 | 意味 |
|---|---|
| 色の太線と記号札(V1) | 1本の流れ。記号は区分の頭文字1字と番号 |
| 白い丸 | 駅(流れの節目) |
| 黒い輪で囲んだ大きい丸 | 乗換駅(2本以上の路線が通る)。名札の下に乗り換え先の記号札を並べる |
| 名札「V1-3 #8」 | V1 線の3つ目の��で、元の番号が #8 |
| 破線の区間と日付札 | 新しくつないだ区間。札の語は入力の new_label(既定は「開通」) |
| 縁が破線の丸 | 節目そのものの動作が未確認 |
| 赤茶の枠の札 | 路線ごとの注意(始発駅が運休中など)。説明は凡例に出る |
- 上から、数の札(路線、駅、乗換駅、新しい区間)、区分ごとの記号の一覧、凡例、路線ごとの図とメモ、乗換駅の表、作り方の順に並べる。
- 記号の一覧では、起点と終点を路線名の下の行に置く。横に並べると、折り返した行が次の路線のものに見える。
- 幅 720px 以下では線を縦に回す。明暗は prefers-color-scheme で切り替える。
- 名札には要点だけを書き、詳しい説明はポインタを置くと出る title へ入れる。スマートフォンでは title が出ないので、判断に要る事実は路線のメモに書く。
## 記号の決まり
- 路線の記号は一度振ったら変えない。消した路線の記号は retired へ移して欠番にする。雛形は欠番の使い回しを止める。
- 駅の番号は、元の台帳の番号をそのまま使う。路線図のために振り直さない。
- 身元は記号札の文字が示し、色はその補助にとどめる。一度見せた路線の色は、他の路線を足し引きしても塗り替えない。
## 手順
1. 辺の一覧を用意する。辺は「A の出力を B が実際に読む」のような、実在を確かめたつながりに限る。台帳から機械で作れるなら、変換の script を案件の `tools/` に置き、手で辺を足さない。
完了: 路線に使う区間が、すべて一覧にある。
2. 雛形を案件の `tools/` へ複製する。写しは手で直さない。
- 入力を手で書く案件: `build_rosenzu.py` と `shot.mjs` をそのまま複製し、`sample.json` を手本に入力の JSON を書く。