Madamisu

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 にキャラ背景変更指摘）、警告と選択肢が表示される:

1. フルやり直し推奨（/madamisu:phaseX で再開）
2. このvで全関連ファイル修正（重量フロー強制、整合性破綻リスクあり）

履歴記録

• 修正箇所に HTML コメント <!-- Feedback YYYY-MM-DD HH:MM: 内容要約 --> 付加
• _meta.md 末尾に「フィードバック履歴」セクション追記

---

プレイ用資料作成（madamisu-publish）

madamisu の設定資料生成後、実プレイに必要な全資料（GM資料・ハンドアウト・証拠資料・ルール・エンディング等）を作成するスキル群。

起動方法

/madamisu:publish [<入力ディレクトリ>]

• 引数省略時: output/v*/ の最新vを自動検出（madamisu出力）
• 引数指定時: 任意のディレクトリを入力（独自に整備した資料）
• _meta.md 検出で madamisu 出力認識、_config.md から方針継承

7工程構成

工程	内容	スキル
0	前提資料の存在確認	/madamisu:publish-step0
1	要望ヒアリング（難易度・時間・書き口）	/madamisu:publish-step1
2	ルール設計（フェーズ構成・情報開示マトリクス）	/madamisu:publish-step2
3	設計案ユーザー確認 [y/n/f]	/madamisu:publish-step3
4	資料作成（GM資料・ハンドアウト・証拠・イントロ等）	/madamisu:publish-step4
5	四段階レビュー（プレイアビリティ・整合性/網羅性・ストレステスト・校正）	/madamisu:publish-step5
6	修正反映（軽微/資料は自動、設計はユーザー確認）	/madamisu:publish-step6
7	最終確認・納品	/madamisu:publish-step7

出力

publish/
├── v1/
│   ├── 01_requirements.md
│   ├── 02_game_design.md
│   ├── 02_info_disclosure_matrix.md
│   ├── 04_gm.md
│   ├── 04_handout_<キャラ名>.md   (キャラ数分)
│   ├── 04_evidence_<連番>.md       (証拠数分)
│   ├── 04_intro.md
│   ├── 04_rules.md
│   ├── 04_endings.md
│   ├── 04_postgame.md
│   ├── 05_review_report.md
│   └── _meta.md
└── ...

レビューの特徴

• プレイアビリティ: 視点別シミュレーション（max5並列、6人以上バッチ分割）。各プレイヤー視点で「見える情報のみ」を渡して手詰まり・見せ場欠如を検出。
• ストレステスト: メタ読み・暴走・消極的プレイヤーの3種を並列実行。設計の堅牢性を検証。

難易度連動

plugins/madamisu/rubrics/publish-difficulty.md で難易度別の指針を定義（フェーズ数・手がかり数・ミスリード密度・時間配分等）。初心者向けは手がかり冗長、上級者向けはミスリード強化。

---

中間ファイルのクリーンアップ

全フェーズ完了時に中間 v の _working/ は自動削除される。 最終 v の _working/ も含めて完全削除するには:

/madamisu:clean

確認プロンプトで y を入力すると output/v*/ 配下のすべての _working/ を削除する。最終納品物（ゲーム設定.md・世界観.md・キャラクター.md・タイムスケジュール.md）は残る。

---

ライセンス

MIT License — 改造・再配布・商用利用OK（著作権表示の保持が必要）。詳細は LICENSE と NOTICE.md を参照。