sekkeizulisted
Install: claude install-skill shikigami-ai-works/claude-html-skills
# 設計図を先に作る(業務フローとER図)
コードの前に、誰が何をする流れか(業務フロー)と、何をどんな形で残すか(ER図)を決めて、ユーザーが見て直せる形にする。
雛形はこの Skill のフォルダの `template/` にある。
- `template.html`: 見た目の正本
- `build_sekkeizu.py`: 入力の JSON から HTML を書き出す。検査に通らなければ書かずに止まる(Python 3.9 以上、標準ライブラリだけ)
- `shots.py`: 書き出した HTML を裏の Chrome で開き、3つの図の四角と線の数を入力と突き合わせて、4枚撮る(Chrome か Chromium 系のブラウザが要る)
- `sample.json`: 入力の手本(架空の図書館の貸出と予約)
## 他の手段との分担
- 出来た計画を読み解いて理解を確かめる: Skill explain-visually
- 一本道の流れが節目を共有する形: Skill rosenzu
- ユーザーが図を手で動かしたい: Figma の MCP 接続があれば FigJam へも出す(手順7)
## 手順
1. 聞き取る。誰が何をするか、何を残すか、数字を誰が入れるか、置き場を選択肢つきで聞く。管理画面の奥にある数字(ログインやパスワードが要る物)は、図に入れる前に取り方を公式の資料で確かめ、機械で取れない物は人の担当に割り振る。
完了: 担当ごとの動きと、残す物の一覧が決まっている。
2. 業務フローを先に描く。段は担当(仕組み、担当者、利用者など)、列は時間の順。四角1つは、その段の担当が実際に見る物(ファイル、画面)。四角の中には、そこに出る例の行を2〜3行入れる。
完了: すべての矢印に元と先があり、人の手が要る所が人の段に並んでいる。
3. ER図を描く。新しく作る表は2〜3個から始め、既存の物と外から来る物は別の印にする。増え続ける数字は上書きせず、測るたびに1行足す表にする(上書きすると伸び方が消える)。後から変えられる値(価格など)も、その測る表に置く。
完了: FK の列すべてに線があり、確かめていない列には「未確認」と書いてある。
4. 正本の md を案件の `docs/設計図_<件名>.md` に書く。ユーザーの決定、設計判断 `D-01`、未確認 `U-01`、Mermaid の2枚(業務フローと erDiagram)、「この図の読み方」の節を置く。読み方の節は、作り物の例の行を2〜3行の表で見せ、作り物だと書く。
完了: 図と表の中身が、聞き取りの答えと食い違っていない。
5. 入力の JSON を `docs/設計図_<件名>.json` に書く(形は `sample.json`)。`python build_sekkeizu.py 入力.json --selftest` を回してから、`python build_sekkeizu.py 入力.json` で書き出す。出力先は入力��� `out`(`--out` で上書きできる)。
完了: 自己試験が exit 0、書き出しが exit 0 で警告 0 件。
6. `python shots.py 入力.json 出力.html <撮影先フォルダ>` で撮る。3つの図の四角と線の札の数を入力と突き合わせ、4枚を撮る。
完了: 3つとも「合った」で exit 0。4枚を開いて見てから、ユーザーにも見せる。
7