情報整理・可視化

draw.io図面生成・公式XSD検証

drawio-generatorは、自然言語・Markdown・装置/ノード/エッジ情報から新規の編集可能な.drawioを生成する独立スキル。非圧縮XMLを公式XSDと参照整合性で検証し、エージェントが最大3回修正・再検証する。コネクタは既定で両端矢印なし、明示された矢印は保持する。

$drawio-generator
制御装置、スイッチ、センサーを順にEthernetで接続した装置構成図を作成してください。

Python 3.10以上とpython -m pip install -r .agents/skills/drawio-generator/requirements.txtが必要。同梱XSD・参照資料とインストール済みlxmlでオフライン利用できる。依存をオフライン導入する場合は対象OS/Python向けのwheelを事前取得し、pip install --no-index --find-links -r .agents/skills/drawio-generator/requirements.txtを使う。draw.ioエディターは表示・編集確認時だけ必要。

• 検証器（python .agents/skills/drawio-generator/scripts/validate.py --json）
• XSDの固定版・配布条件・再取得手順
• 正常系・異常系・修正再検証と編集確認の手順

XSDと追加検査の合格は、図の意味・可読性・描画品質を保証しない。既存図面の差分編集、MCP、独自GUIは本スキルのPhase 1対象外。

情報整理スキル

雑多な入力を整理し、適切な表現とその選択根拠を出力するスキル。スライドのフォーマットは、整理した情報を理解しやすく配置するキャンバスの一候補。

画像や既存図に説明を追加する依頼では、原図を保持し、Draw.ioの別レイヤーに番号・引出線・吹き出し・強調・説明文を置く。画面キャプチャも対象とし、観測できる情報と推定を区別する。PlantUMLはNative／SVG／PNGを環境と用途に応じて選ぶ。

• main: 基準となる版。
• dev: スキルの改善と情報整理。

通常のスキル利用はoutputへの保存だけで完了し、Gitの確認・add・commit・pushは行わない。スキル定義・版管理サンプルの改修は別の作業としてdevで管理する。

未指定は高速モード。入力の意味・条件、ファイル構造・接続参照を確認し、線の見え方・重なり・余白などの詳細な目視検査を省く。精密モードでは全ページを表示点検し、問題を修正して再確認する。個別の検査追加・省略も指定できる。モードの範囲を参照する。

使い方

$information-structuring
以下の情報を整理・可視化してください。
目的・読み手: 設計レビューに参加する開発者
素材: ここに文章・メモ・仕様・表などを貼る

出力はMarkdownを優先する。補足図はシーケンス図にPlantUML、構造・配置図にDraw.ioを使い、大きな表・マトリクスはMarkdown表ではなくTSV（優先）／CSVにする。これらを主文書にリンクして組み合わせる。未指定時はこの構成を推奨して希望を質問し、HTMLスライドやテーブル中心、その他の明示指定にも従う。

比較・対応・分岐・全体と詳細などを含む情報は、カタログの型と配置を照合し、図の種類に応じてPlantUMLまたはDraw.ioで可視化する。小さな階層・構造・処理順にはASCII図も使える。整理根拠は質問原文・入力時刻（取得できない場合は記録時刻と区別）を含む別の補足Markdownとして添え、成果物はoutput/YYYYMMDD_HHMMSS_約20文字の日本語概要/にまとめて保存する。目的が未指定の場合も仮定を示して整理を進める。

構成

既存のoutput成果物は、ユーザーの明示指示がない限り参照しない。今回新規作成する成果物はoutput内で制作・検査・修正してよい。Draw.io生成用のスクリプトと依存ファイルも保存する。表示検査の範囲は選択したモードに従い、未実施項目を根拠資料へ残す。

整理目的 → 情報の意味と軸 → 基本表現 → 必要な専門手法 → 読み手に合う説明 → キャンバス。

• スキル
• 16目的・19軸・12基本表現
• 選択規則
• 整理根拠の補足様式
• 条件付き依存・状態モデルなどの適用例
• 可視化の選び方とASCII図の型
• カタログ照合から図制作までの選択手順
• Draw.ioの10テーマ・意味記号・配置規則
• Draw.ioネイティブ機能・図形カタログ・検索とID検証
• 既存図・PlantUML・画面キャプチャへの説明追加
• 61構造の配置参考
• Draw.io出力サンプルと更新手順
• 分野横断の図解75例・検索・再利用ライブラリ
• 図解の参照URL58件
• 図解ボキャブラリーの選択手順

体系と既存カタログはいずれも閉じた選択肢にしない。新しい軸・整理方法・複合表現を、入力に必要な意味と関係から選べる。専門手法299項目は重複を含む候補索引であり、各手法の正式な分析手順を実装したものではない。

検証

以下はスキル定義・版管理サンプルの改修時に使う検査であり、通常のスキル利用では実行しない。

Python標準ライブラリで整理体系・構造カタログを生成し、網羅性と整合性を検査する。Draw.ioの図形カタログSchema検証にはrequirements-native.txtのjsonschemaを使用する。

python -X utf8 .agents/skills/information-structuring/scripts/build_framework.py
python -X utf8 .agents/skills/information-structuring/scripts/validate_framework.py
python -X utf8 .agents/skills/information-structuring/scripts/build_catalog.py
python -X utf8 .agents/skills/information-structuring/scripts/validate_catalog.py
python -X utf8 .agents/skills/information-structuring/scripts/validate_themes.py
python -X utf8 .agents/skills/information-structuring/scripts/shape_catalog.py validate
python -X utf8 .agents/skills/information-structuring/scripts/test_shape_catalog.py
python -X utf8 sample/information-structuring/scripts/check_samples.py
python -X utf8 sample/information-structuring/diagram-vocabulary/scripts/package_vocabulary.py validate
python -X utf8 sample/information-structuring/diagram-vocabulary/scripts/check_delivery.py

初回抽出は89610da、一般化したスライド案出し版はef2ad6dに保存済み。参考ページはsource.mdに由来情報としてのみ記載し、スキルの利用に参照を必要としない。