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` オプション（ループ回数の上書き）:

優先順位: --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` オプション:

例: 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をベースにコピー）
  ...

各バージョンに含まれるファイル:

ループの仕組み

各フェーズは複数のエージェントがループを回して内容をブラッシュアップする。

初回ループ（発散）: 複数案を並列生成して最良案を統合 2回目以降（収束）: 前回レビューで低評価だった弱点を補強

自動停止条件（いずれかを満たすと停止）:

• 致命的な矛盾🔴=0 かつ 全レビューのスコアが品質閾値以上
• 最大ループ回数に到達（デフォルト: Phase1=3回、Phase2=4回、Phase3=3回）

品質閾値は output/_config.md の「品質閾値」セクションで編集可能（デフォルト: ゲーム性=6, 世界観=6, 制作方針=8）。

--loops N 引数でデフォルト最大ループ数を上書きできる。トークン節約したい場合は --loops 1 が有効。

停止後、スコアサマリーを表示してユーザーに確認を求める。

担当エージェント

評価チェックリスト（ルーブリック）は 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] "<フィードバック内容>"

軽量 / 重量フロー

判定エージェントがフィードバック内容を分類:

--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工程構成

出力

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 を参照。