---

name: content-studio-draft description: Content Studioのアイデアまたは現在のセッション内容からドラフト記事を作成する metadata: {"version":"1.6.0","author":"keita","tags":["content-studio","draft","writing","session"]}

Draft Writer Skill

概要

2つの入力モードでドラフト記事を作成する：

1. アイデアモード（従来）— Content Studio の ideas/*.md からドラフトを作成
2. セッションモード（新規）— 現在のセッションのやりとりからドラフトを作成

どちらのモードでも、プラットフォームに応じた「読まれる記事」のドラフトを生成する。

🎯 ターゲット読者を最初に設定する

記事を書く前に必ず決める：

• 誰に向けて書くか（エンジニア？初心者？マネージャー？）
• 読者の課題は何か（何を解決したいと思ってこの記事を開くか）
• 読んだ後どうなってほしいか

🔑 記事の力点をすり合わせる（必須）

ドラフトを書き始める前に、必ずユーザーと記事の力点を確認する。 同じ素材でも力点の置き方で記事の価値が変わる。AIが独断で書き始めない。

• 記事の核（一番伝えたいこと）の候補を2〜3個提示する
• 各候補にタイトル案と方向性を添える
• ユーザーが選択・修正してからドラフト作成に進む

---

📡 セッションモード

セッション中にユーザーから「このスキルで記事を書いて」と指示された場合、現在のセッションの会話履歴そのものを入力ソースとしてドラフトを作成する。

起動条件

以下のいずれかの指示でセッションモードとして動作する：

• 「このセッションの内容で記事を書いて」
• 「今の会話から記事にして」
• 「draft-writer でこのセッションをドラフト化して」

セッション分析の手順

Step 1: セッション全体を俯瞰する

会話履歴から以下を抽出する：

抽出項目	具体的に何を見るか
テーマ	セッション全体で何に取り組んだか（1行で）
起点	最初の課題・目的は何だったか
展開	途中で方針転換・追加課題が発生したか
ハマりポイント	エラー、試行錯誤、想定外の事態
解決策	最終的にどうやって解決したか
学び・知見	汎用的に使える教訓（読者にとっての価値）
成果物	何ができあがったか（コード、設定、設計 etc.）

Step 2: 記事の核を決める

セッション全体を記事にするのではなく、読者にとって価値がある軸を1つ選ぶ：

• 技術的なハマりと解決策 → Zenn向き
• 開発プロセスの試行錯誤やワークフロー改善 → note向き
• ツール・ライブラリの実践的な使い方 → Zenn向き
• AI活用の体験談・気づき → note向き

1セッションから複数記事が書ける場合は、ユーザーに候補を提示して選んでもらう。

Step 2.5: 記事の力点をユーザーとすり合わせる（必須）

ドラフトを書き始める前に、必ずユーザーに記事の力点を確認する。同じセッション内容でも、どこに力点を置くかで記事の印象は大きく変わる。AIが勝手に判断せず、ユーザーの意図を反映させる。

確認する内容：

• この記事で一番伝えたいことは何か（技術的な解決策？気づきにくい因果関係？ワークフローの改善？）
• 読者にどんな印象を持ってほしいか（「役に立った」「自分も気をつけよう」「面白い」等）
• タイトルのトーン（淡々とした技術記事？惹きのあるストーリー調？）

提示の仕方：

• Step 2で抽出した記事の核をもとに、力点の候補を2〜3個提示する
• 各候補について、タイトル案と記事の方向性を簡潔に示す
• ユーザーが選択・修正した力点に沿ってドラフトを作成する

Step 3: 不要な情報を削ぎ落とす

セッションのやりとりをそのまま記事にしない。以下は削除する：

• 試行錯誤の逐一再現（読者に価値がない詳細）
• ツールの操作ログ・ファイル読み込みの羅列
• セッション固有のパス・環境情報（汎用化する）
• 「ありがとう」「お願いします」などの会話的やりとり

Step 4: プラットフォーム別スタイルガイドに従ってドラフト作成

プラットフォームに応じたスタイルガイドを参照してドラフトを作成する：

• Zenn → references/style-guide-zenn.md
• note → references/style-guide-note.md

セッションモードでプラットフォームが未指定の場合

ユーザーに確認する。判断材料：

• コード・エラー・設定が中心 → Zenn を提案
• プロセス・体験・ワークフローが中心 → note を提案

---

プラットフォーム別スタイルガイド

• Zenn向け: references/style-guide-zenn.md — 技術リファレンス向け。結論先行・簡潔・コードブロック重視。構造テンプレート付き
• note向け: references/style-guide-note.md — 事実ベース・一人称・感情控えめ。構造テンプレート付き

---

使い方

アイデアモード（従来）

アイデアファイル /Users/satokeita/dev/content-studio/ideas/<NNN>-<slug>.md を読み込み、ドラフトを /Users/satokeita/dev/content-studio/drafts/<slug>.md に保存する。

セッションモード

セッション中に以下のように指示する：

• 「draft-writer で、このセッションの内容をZenn記事にして」
• 「今の会話からnote記事のドラフトを書いて」

エージェントは会話履歴を分析し、同じ drafts/ ディレクトリにドラフトを保存する。

フロントマター形式

フロントマターの詳細と各モードの例は references/config-frontmatter.md を参照。

ドラフト作成後の必須アクション（push + URL表示）

ドラフトはあくまで下書きなので、作成後は常に content-studio リポジトリにpushする。ユーザーに確認は不要。

pushスクリプト: scripts/save-draft.sh

# 手動実行する場合
cd /Users/satokeita/dev/content-studio
git add drafts/<ファイル名>.md
git commit -m "draft: <記事の要約>"
git push origin main

push完了後、Web UIのURLを表示する： https://content-studio-kt.vercel.app/draft/<slug>

注意: URLパスは /draft/（単数形）。/drafts/ は一覧ページ。

（Content StudioはGitHub Contents API経由でファイルを読み込むため、pushしないとWeb UIに反映されない）

データ保存先

• ディレクトリ: /Users/satokeita/dev/content-studio/drafts/
• リポジトリ: ksato8710/content-studio
• Web UI: https://content-studio-kt.vercel.app
• 形式: Markdownファイル（YAMLフロントマター付き）
• ステータス: writing → review → ready

⚠️ よくある落とし穴

• 力点の確認なしにドラフトを書き始める: 同じ素材でも力点の置き方で記事の価値が変わる。必ずユーザーに記事の核の候補を2〜3個提示し、選択・修正してからドラフト作成に進む
• セッションのやりとりをそのまま記事にする: 試行錯誤の逐一再現、ツール操作ログ、セッション固有のパス等は読者に価値がない。不要な情報を削ぎ落とし、汎用化してから記事にする
• Zenn記事にドラマチックな感情表現: 「結果は予想外でした」「問題はこの後です」等のつなぎ文は Zenn では不要。読者は結果を見に来ているので、結論先行・簡潔に書く
• push せずに完了とする: Content Studio は GitHub Contents API 経由でファイルを読み込むため、push しないと Web UI に反映されない。ドラフト作成後は常に push する
• URL パスの単数/複数形の間違い: Web UI の個別ドラフトは /draft/<slug>（単数形）。/drafts/ は一覧ページ。ユーザーに表示する URL を間違えない