whitepaper

プロフェッショナルな PDF ジェネレーター

このスキルは、pandoc と typst を使って Markdown ファイルをプロフェッショナルな組版の PDF ホワイトペーパーに変換します。

アセット

このスキルには、プラグインのルートディレクトリに以下が含まれています。

• Typst テンプレート：templates/whitepaper.typ
• Source Sans 3 フォント：fonts/ — すべてのウェイトに対応する可変フォント（Google Fonts のオープンソースフォント）
• Source Code Pro フォント：fonts/（Regular、Bold、Italic、Bold Italic）— コードブロックとインラインコードに使用

プラグインルート： プラグインルートは動的に決定されます（以下のステップ 2.5 を参照）。

タイポグラフィの階層

要素	ウェイト	スタイル
見出し（H1）	Black（900）	大きく、字間を詰める
セクション見出し（H2）	Bold（700）	青いアクセントライン
小見出し（H3、H4）	Bold（700）	中程度のサイズ
本文	Regular（400）	両端揃え、読みやすい行送り
コード	Source Code Pro	等幅

重要：完全自動実行

このスキルは完全に無人で実行されます。以下のことはしないでください。

• PDF を生成する前に「続行しますか？」と尋ねる
• クリーンアップの前に「これらのファイルを削除しますか？」と尋ねる
• いずれかのステップで「これでよいですか？」と尋ねる
• ステップの間にユーザーの確認を待つ
• 中間結果を表示するために処理を一時停止する
• ファイル操作の許可を求める

必須の動作：

• 停止せず、すべてのステップを順番に実行する
• 呼び出されたら直ちに PDF を生成する
• PDF の作成直後に、すべてのソースファイルを削除する
• すべてが完了した後にのみ、ユーザーに連絡する
• 最終結果を報告する：「PDF を作成しました：[path]」

PDF の生成またはクリーンアップ中にユーザーへ質問しようとしていることに気づいたら、そこで止めて、代わりにその操作を実行してください。

使用方法

ユーザーから PDF の作成を依頼されたら、以下の手順に従います。

1. 入力と出力を決定する

• $ARGUMENTS を解析して、入力 Markdown ファイルと任意の出力 PDF パスを特定します
• 出力パスが指定されていない場合は、入力ファイルと同じ名前で拡張子を .pdf にします
• 入力が指定されていない場合は、変換する Markdown ファイルをユーザーに尋ねます
• ファイルの YAML フロントマターを確認します（以下の「フロントマターのリファレンス」を参照）。title がない場合は、続行する前にユーザーにタイトルを尋ねます。date がない場合は、今日の日付を使用します。

2. 依存関係をインストールする（不足している場合）

不足しているツールごとに実行します — スクリプトがプラットフォームを自動検出します。

OS=$(uname -s)
# pandoc
command -v pandoc >/dev/null 2>&1 || {
  [ "$OS" = "Darwin" ] && brew install pandoc || sudo apt-get update && sudo apt-get install -y pandoc
}
# typst
command -v typst >/dev/null 2>&1 || {
  [ "$OS" = "Darwin" ] && brew install typst || {
    curl -fsSL https://github.com/typst/typst/releases/latest/download/typst-x86_64-unknown-linux-musl.tar.xz \
      | tar xJ --strip-components=1 -C /usr/local/bin/ typst-x86_64-unknown-linux-musl/typst
    chmod +x /usr/local/bin/typst
  }
}

2.5 プラグインのルートディレクトリを特定する

重要：アセットをコピーする前に、プラグインルートを特定してください。

プラグインルートには templates/ と fonts/ ディレクトリが含まれます。以下の単一コマンドを使用します。

PLUGIN_ROOT=$([ -d ".claude/plugins/project-management" ] && echo ".claude/plugins/project-management" || echo "$CLAUDE_PLUGIN_ROOT")
echo "Using plugin root: $PLUGIN_ROOT"
ls "$PLUGIN_ROOT/templates/whitepaper.typ" || echo "ERROR: Template not found!"

想定される場所： .claude/plugins/project-management

3. テンプレートを出力ディレクトリにコピーする

Typst テンプレートを、出力 PDF と同じディレクトリにコピーします。

PLUGIN_ROOT=$([ -d ".claude/plugins/project-management" ] && echo ".claude/plugins/project-management" || echo "$CLAUDE_PLUGIN_ROOT")
cp "$PLUGIN_ROOT/templates/whitepaper.typ" <output-directory>/whitepaper.typ

<output-directory> を PDF の生成先ディレクトリ（例：project-guides/）に置き換えます。

4. Pandoc を実行する

以下の正確なフラグを指定して変換を実行します。テンプレートが見つかるように、出力ディレクトリから実行します。

cd <output-directory> && \
PLUGIN_ROOT=$(if [ -d "../.claude/plugins/project-management" ]; then echo "../.claude/plugins/project-management"; elif [ -d ".claude/plugins/project-management" ]; then echo ".claude/plugins/project-management"; else echo "$CLAUDE_PLUGIN_ROOT"; fi) && \
TYPST_FONT_PATHS="$PLUGIN_ROOT/fonts" pandoc <input.md> \
  -o <output.pdf> \
  --pdf-engine=typst \
  -V template="whitepaper.typ" \
  -V mainfont="Source Sans 3" \
  -V fontsize=10pt \
  -V papersize=a4

project-guides/ADMIN-GUIDE.md の例：

cd content && \
PLUGIN_ROOT=$([ -d "../.claude/plugins/project-management" ] && echo "../.claude/plugins/project-management" || echo "$CLAUDE_PLUGIN_ROOT") && \
TYPST_FONT_PATHS="$PLUGIN_ROOT/fonts" pandoc ADMIN-GUIDE.md -o ADMIN-GUIDE.pdf --pdf-engine=typst -V template="whitepaper.typ" -V mainfont="Source Sans 3" -V fontsize=10pt -V papersize=a4

注：--toc は渡さないでください — テンプレートが適切なスタイルの目次ページを独自に生成します。

5. クリーンアップする（必須 — 省略しないでください）

重要：PDF の生成直後に、必ずクリーンアップを実行してください。残すのは PDF のみです。

# Remove ALL intermediate files in one command
rm -f <output-directory>/whitepaper.typ <input.md> <input-without-extension>.plain.html <input-without-extension>.html

project-guides/AUTHOR-GUIDE.md のクリーンアップ例：

rm -f project-guides/whitepaper.typ project-guides/AUTHOR-GUIDE.md project-guides/AUTHOR-GUIDE.plain.html project-guides/AUTHOR-GUIDE.html

クリーンアップ後は、project-guides/AUTHOR-GUIDE.pdf のみが存在する必要があります。.md、.html、.plain.html ファイルは残さないでください。

6. 結果を報告する

"PDF created: [output.pdf]"

フロントマターのリファレンス

テンプレートは Markdown ファイルの pandoc YAML フロントマターを読み取り、タイトルページとフッターに反映します。フロントマターブロックは、ファイルの先頭に --- の行で囲んで記述する必要があります。

必須フィールド

フィールド	用途	例
title	表紙の見出し、PDF メタデータ	"AEM Code Sync for Edge Delivery Services"

推奨フィールド

フィールド	用途	例
subtitle	表紙のアクセントラインの下に表示する2行目	"Technical Architecture and Security Documentation"
date	表紙とページフッター	"January 29, 2026"

任意のフィールド

フィールド	用途	例
author	表紙の著者一覧	下記の構造化された例を参照

最小限の例

---
title: "AEM Code Sync for Edge Delivery Services"
subtitle: "Technical Architecture and Security Documentation"
date: "January 29, 2026"
---

著者を含む完全な例

---
title: "AEM Code Sync for Edge Delivery Services"
subtitle: "Technical Architecture and Security Documentation"
date: "January 29, 2026"
author:
  - name: "Jane Smith"
    affiliation: "Edge Delivery Services"
  - name: "John Doe"
    affiliation: "Security Engineering"
---

テンプレートのレンダリング内容

• タイトル：表紙に大きな太字で表示されます
• サブタイトル：アクセントの区切り線の下に、より軽い書体で表示されます
• 日付：表紙とページフッターに表示されます
• 著者：任意の所属先とともに表紙に記載されます

よくある間違い

• フロントマターを見出しや空行の後に置く（ファイルの先頭に記述する必要があります）
• コロンを含む文字列を引用符で囲まずに記述する（例：title: AEM: A Guide）。引用符で囲んでください
• フロントマターにfontsizeやpapersizeなどのpandoc変数を追加する。代わりにpandocに-Vフラグを渡してください（このスキルが自動的に処理します）

テンプレートのデザイン

このテンプレートは、プロフェッショナルな文書形式を提供します。

• Source Sans 3（Google Fontsのオープンソースフォント）を使用したプロフェッショナルなタイポグラフィ
• セクションの区切りとリンクに青のアクセントカラー（#0066cc）
• タイトル／サブタイトルを含むすっきりしたヘッダー（区切り線なし）
• 日付とページ番号を含むフッター（タイトルページでは非表示）
• コードブロックとインラインコードにSource Code Pro
• 自動目次ページ
• アクセントの区切り線を含むタイトルページ

テンプレートの機能

機能	説明
タイトルページ	タイトル、サブタイトル、日付、著者を含むすっきりしたデザイン
目次	2ページ目に自動生成
H1見出し	太字、見出しの前で改ページ
H2見出し	青のアクセントラインを含む太字
コードブロック	グレーの背景、角丸
引用	青の左罫線、薄い青の背景
表	薄い罫線、太字のヘッダー行
リンク	青色（#0066cc）

文書のカスタマイズ

-V key=valueを使って、pandoc変数を上書きできます。

変数	デフォルト	説明
papersize	a4	ページサイズ（a4、us-letterなど）
fontsize	10pt	基本フォントサイズ
template	whitepaper.typ	Typstテンプレートファイル
mainfont	Source Sans 3	本文のメインフォント

要件

• pandocとtypstをインストールする必要があります（不足している場合、このスキルが自動的にインストールします）
  • macOS：Homebrew（brew）経由
  • Linux：pandocはapt-get経由、typstはGitHubリリースのバイナリ経由
• Source Sans 3フォントは、プラグインのfonts/ディレクトリに含まれています

トラブルシューティング

typstでフォントが見つからない場合は、TYPST_FONT_PATHS環境変数が正しく設定されていることを確認してください。

export TYPST_FONT_PATHS=${CLAUDE_PLUGIN_ROOT}/fonts

問題	解決策
フォントが見つからない	TYPST_FONT_PATHSがプラグインのfonts/ディレクトリを指していることを確認してください
テンプレートが見つからない	whitepaper.typが出力ディレクトリにコピーされていることを確認してください
表が改ページされない	テンプレートが自動的に処理します
タイトルページがない	フロントマターにtitleフィールドがあることを確認してください