# doc-studio
> PDF/PPTX/DOCX/XLSX/HTML の資料を「プロジェクト把握→ヒアリング→構成合意→案件用テンプレ作成→生成→preflight/目視チェック」まで再現可能に行うスキル。提案書/報告書/ホワイトペーパー/スライド/ダッシュボード作成に使う。
- Author: Aero123421
- Repository: Aero123421/doc-studio
- Version: 20260131005943
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/Aero123421/doc-studio
- Web: https://mule.run/skillshub/@@Aero123421/doc-studio~doc-studio:20260131005943
---
---
name: doc-studio
description: PDF/PPTX/DOCX/XLSX/HTML の資料を「プロジェクト把握→ヒアリング→構成合意→案件用テンプレ作成→生成→preflight/目視チェック」まで再現可能に行うスキル。提案書/報告書/ホワイトペーパー/スライド/ダッシュボード作成に使う。
metadata:
short-description: Generate pro docs
---
# Doc Studio
このSkillの目的は「テンプレを埋める」ことではなく、**案件・プロジェクトの中身に合わせて資料を設計し、再現可能に仕上げる**ことです。
※ コマンド例は `doc-studio/` を作業ディレクトリにして実行する前提です（リポジトリ直下から実行する場合は `doc-studio/` を前置）。
## 想定ユースケース（広め）
### 1) プロジェクト理解 → 資料化
- リポジトリを読んで、**プロジェクト概要**（目的/機能/構成/依存/運用）をまとめる
- 既存ドキュメントや設計情報を拾って、**アーキテクチャ説明資料**（PDF/PPTX）を作る
- `docs/` や `README` を元に、**社内向けオンボーディング資料**（DOCX/PDF）を作る
### 2) 依頼内容に合わせた資料作成
- 提案書/企画書（DOCX/PDF）
- 報告書/ホワイトペーパー（PDF）
- スライド（PPTX / Reveal.js HTML）
- 指標ダッシュボード（XLSX）
### 3) 既存成果物の更新
- 既存資料（DOCX/PPTX/PDF）の章立て・数値・表現を更新し、体裁を保って再生成する
- 章の差し替え/追加/削除、トーン変更、社外向け表現への変換
## 最優先ルール（テンプレ依存を断つ）
1. **生成前ゲート**: まず「プロジェクト把握」→「ヒアリング」→「構成合意」。ここを飛ばしてテンプレ選定/生成に入らない
2. **テンプレは表現・レイアウトの参考**。章立て・主張・根拠・数値・用語は案件に合わせて設計する
3. **テンプレ文言のコピペ禁止**（プレースホルダ/汎用文章を納品物に残さない）
4. 既存テンプレ（短い名前）をそのまま使うのは **ラフ用途のみ**（「ラフ」と明示し、納品前に必ず差し替える）
5. 原則として **案件用カスタムテンプレを作る**（コピーして編集する）
## Step 0: プロジェクト把握（必須）
まず「どんなプロジェクトか」「既存資産は何か」を短時間で掴む。
推奨コマンド:
```bash
python scripts/project_inspect.py --path . --depth 3
```
ここで見るもの（最低限）:
- 既存ドキュメント: `docs/`、`README*`、`*.md`、`*.docx`、`*.pptx`、`*.pdf`
- ブランド/デザイン資産: `brand/`、`design/`、`assets/`、`logo*`、色/フォント指定
- 仕様・制約: 用語集、禁止表現、コンプラ/法務注意
このStepの成果物（テキストでOK）:
- **Project Snapshot**（5〜15行）: 目的/対象ユーザー/主要機能/制約/利用技術/既存資産/トーン
## Step 1: ヒアリング（最初に聞く5問）
生成に入る前に、最低限これを確認する（ユーザーが「任せる」と言っても(1)(2)(3)は必須）。
1) **用途/読者/意思決定**
- 誰が読む？（役員/営業/技術/顧客/採用など）
- 読んだ後に何をしてほしい？（承認/購入/採用/理解/合意など）
2) **形式とボリューム**
- 形式: pdf / pptx / docx / xlsx / html
- 量: ページ数 or スライド枚数 or 文字数目安
3) **結論（先に）**
- 最も伝えたい結論は？（1行）
- サブメッセージは？（2〜5個）
4) **素材**
- 必須で入れる情報（箇条書きでOK）
- 既存資料/URL/数値/図/ロゴ/ブランドガイドの有無
5) **制約**
- トーン（硬め/カジュアル/社外向け）・NG表現・法務/コンプラ注意点
- 締切とレビュー回数
## Step 2: 構成合意（生成しない）
必ず先に **構成案** を出して合意を取る。
出すもの:
- 目次（章立て）
- 各章の狙い（1行）+ 箇条書き（3〜8点）
- 「不足している情報」と「仮定一覧（明示）」
ここで合意が取れたら、初めて生成へ進む。
## Step 3: 案件用カスタムテンプレを作る（推奨）
### 原則
- `templates/` の既存テンプレは叩き台。**そのまま使わずコピーして編集**する。
- 生成コマンドでは、短いテンプレ名よりも **テンプレファイルパス** を優先して使う。
テンプレをコピー（clone）:
```bash
python scripts/template.py clone --from whitepaper --to custom_acme_whitepaper.py
```
生成（パス指定）:
```bash
python scripts/generate.py pdf templates/custom_acme_whitepaper.py acme_whitepaper --data-file data.json
```
テンプレの必須インターフェース:
- `--output ` と `--data-file ` を受け取り、指定の出力ファイルを作成する
- 失敗時は終了コード != 0 で落ち、原因が分かるメッセージを stderr に出す
## Step 4: 生成 → preflight → 目視チェック
生成:
```bash
python scripts/generate.py