madamisu-skills
コンセプト・設定資料からマーダーミステリーの設定・プレイ資料を自動生成・ブラッシュアップする Claude Code スキルセット。元資料を渡すだけで、世界観・キャラクター・タイムスケジュール・GM資料・ハンドアウト・証拠資料まで複数エージェントが協調して仕上げる。
元資料はメモ書き・箇条書き程度でも動く。 「こういう雰囲気にしたい」レベルのコンセプトから詳細な設定資料まで幅広く対応。不足情報はヒアリングで補う。
⚠️ トークン消費について
このスキルは複数エージェントを並列・ループ実行するためトークンをかなり消費する。
デフォルトのループ数で全フェーズを通すと、Claude Pro プランの週制限の 20〜50% 程度を消費する可能性がある（2026年5月現在）。
トークンを節約したい場合は --loops 1 オプションを使用すること。
このスキルは個人制作であり、スキル作成にも Claude Code を利用している。
検証が十分できていないため、生成される資料が破綻していたり、そのままではゲームに使用できない可能性がある。
手直しなしでも最低限遊べるものを目指して回収を進める予定。
インストール
/plugin marketplace add kuro0107/madamisu-skills
/plugin install madamisu
導入後、任意のディレクトリから /madamisu:scenario と /madamisu:publish が使える。
詳細なリファレンス（全skill引数・出力構造・rubric一覧）は docs/reference.md を参照。
とりあえず使ってみる
設定を生成する
/madamisu:scenario <元資料のパス>
元資料（フォルダまたは .md ファイル）を渡すと、ヒアリングを経て世界観・キャラクター・タイムスケジュールを自動生成する。
完了まで各フェーズでユーザー確認が入る。
プレイ用資料を作る
設定生成が終わったら（または既存の設定資料があれば）:
/madamisu:publish
引数省略時は直前の /madamisu 出力を自動検出。GM資料・ハンドアウト・証拠資料・ルール・エンディングをまとめて作成する。
今後の展望
- スキルの微調整・品質改善
- デザインを含めた成果物ファイル（PDF・画像）の自動生成
使い方（詳細）
全フェーズを一括実行
/madamisu:scenario <元資料のパス> [--loops N] [--p1-loops N] [--p2-loops N] [--p3-loops N]
例:
/madamisu:scenario 設定資料/
/madamisu:scenario 元ネタ.md
/madamisu:scenario 設定資料/ --loops 1
/madamisu:scenario 設定資料/ --loops 1 --p2-loops 2
フォルダを指定するとフォルダ内の全Markdownファイルを読み込む。ファイルを指定するとそのファイルのみ読み込む。
--loops オプション（ループ回数の上書き）:
| オプション | 効果 |
|---|
--loops N | 全フェーズの最大ループ数を N に統一 |
--p1-loops N | Phase 1 のみ N に上書き |
--p2-loops N | Phase 2 のみ N に上書き |
--p3-loops N | Phase 3 のみ N に上書き |
優先順位: --p{N}-loops > --loops > フェーズ別デフォルト（P1:3, P2:4, P3:3）
実行フロー:
Phase 0: 要件整理（自動）
↓
Phase 0.5: 制作方針ヒアリング（雰囲気・ジャンル・舞台/時代・プレイ時間・PvP/協力型・エンディング構成・難易度・人数など最大13項目）→ output/_config.md に保存
↓
Phase 1: 骨子確立（世界観・キャラクター設定）→ ユーザー確認 [y/n/f]
↓
Phase 2: プロット精錬（トゥルーエンド・動機・秘密）→ ユーザー確認 [y/n/f]
↓
Phase 3: タイムスケジュール構築 → ユーザー確認 [y/n/f] → 完了
各フェーズ完了時の確認:
y: 次フェーズへ進むn: 中断（後で --base 指定で再開可能）f: フィードバック反映スキルを起動（次節参照）
フェーズ別に実行
特定フェーズだけ実行したい場合:
/madamisu:phase1 <元資料のパス> [--base <ベースバージョン>] [--loops N]
/madamisu:phase2 <元資料のパス> [--base <ベースバージョン>] [--loops N]
/madamisu:phase3 <元資料のパス> [--base <ベースバージョン>] [--loops N]
--base オプション:
| 指定 | 動作 |
|---|
| 省略 | 元資料から新規スタート |
--base output/v3 | そのバージョンを引き継いで実行 |
例: Phase 2だけ再実行してブラッシュアップ
/madamisu:phase2 設定資料/ --base output/v5
出力
output/ フォルダにバージョン管理して出力される。元資料は一切変更しない。
output/
_config.md 制作方針（ヒアリング結果。全フェーズ共通）
v1/ Phase 1 ループ1回目完了
v2/ Phase 1 ループ2回目完了
v3/ Phase 1 最終（ユーザー確認時点）
v4/ Phase 2 開始（v3をベースにコピー）
...
各バージョンに含まれるファイル:
| ファイル | 生成フェーズ |
|---|
ゲーム設定.md | Phase 1〜2 |
世界観.md | Phase 1 |
キャラクター.md | Phase 1〜2 |
タイムスケジュール.md | Phase 3 |
_meta.md | 全フェーズ（ループ回数・スコア記録） |
ループの仕組み
各フェーズは複数のエージェントがループを回して内容をブラッシュアップする。
初回ループ（発散）: 複数案を並列生成して最良案を統合
2回目以降（収束）: 前回レビューで低評価だった弱点を補強
自動停止条件（いずれかを満たすと停止）:
- 致命的な矛盾🔴=0 かつ 全レビューのスコアが品質閾値以上
- 最大ループ回数に到達（デフォルト: Phase1=3回、Phase2=4回、Phase3=3回）
品質閾値は output/_config.md の「品質閾値」セクションで編集可能（デフォルト: ゲーム性=6, 世界観=6, 制作方針=8）。
--loops N 引数でデフォルト最大ループ数を上書きできる。トークン節約したい場合は --loops 1 が有効。
停止後、スコアサマリーを表示してユーザーに確認を求める。
担当エージェント
| エージェント | 担当 |
|---|
| ゲーム性アイデア出し | ゲームとして面白い仕掛けを発案 |
| 世界観アイデア出し | 魅力的な世界観・キャラ造形を発案 |
| ゲーム性レビュー | ルーブリックのチェック項目で0〜10点採点 |
| 世界観レビュー | ルーブリックのチェック項目で0〜10点採点 |
| 制作方針レビュー | _config.md準拠度・人数キャラ数整合をチェック（_config.md存在時のみ） |
| 整合性チェック | 矛盾を🔴致命的/🟡軽微/🔵要確認で分類（ルーブリック観点付き） |
| 資料まとめ | 全意見を統合してMDファイルに出力 |
| 校正 | 誤字・表記揺れ・句読点を修正 |
評価チェックリスト（ルーブリック）は plugins/madamisu/rubrics/ に外出ししており、プロジェクト固有の評価軸を追加したい場合は該当ファイルを編集可能。
phase{N}-game.md: ゲーム性レビュー観点phase{N}-world.md: 世界観レビュー観点phase{N}-config.md: 制作方針レビュー観点consistency-phase{N}.md: 整合性チェック観点
フィードバック反映
フェーズ完了後の指摘・要望を専用スキルで反映できる。
起動方法
経路A: フェーズ完了時 f 入力
Phase X 完了 → [y/n/f] → f → フィードバック内容入力 → 適用後 [y/n/f] 再表示
経路B: 独立コマンド
/madamisu:feedback [--v N] [--light|--full] "<フィードバック内容>"
| 引数 | 効果 |
|---|
--v N | 対象バージョン指定（省略時は最新v） |
--light | 軽量フロー強制 |
--full | 重量フロー強制 |
軽量 / 重量フロー
判定エージェントがフィードバック内容を分類:
| フロー | 該当例 | 工程 | バージョン |
|---|
| 軽量 | 文言修正・追加情報・明示的な局所指示 | まとめ → 簡易整合性 → 校正 | 同一v上書き |
| 重量 | 抽象要望・根本変更・新規創作 | アイデア出し → レビュー3並列 → 整合性 → まとめ → 校正 | 新v作成 |
--light / --full 指定で自動判定を上書き可能。
クロスフェーズ警告
フィードバックが対象v以前のフェーズ要素を含む場合（例: Phase 3完了v にキャラ背景変更指摘）、警告と選択肢が表示される:
- フルやり直し推奨（
/madamisu:phaseX で再開）
- このvで全関連ファイル修正（重量フロー強制、整合性破綻リスクあり）
履歴記録
- 修正箇所に HTML コメント
<!-- Feedback YYYY-MM-DD HH:MM: 内容要約 --> 付加
_meta.md 末尾に「フィードバック履歴」セクション追記
プレイ用資料作成（madamisu-publish）
madamisu の設定資料生成後、実プレイに必要な全資料（GM資料・ハンドアウト・証拠資料・ルール・エンディング等）を作成するスキル群。
起動方法
/madamisu:publish [<入力ディレクトリ>]
