qiita-article-planner

Files (1)

• SKILL.md

SKILL.md (first lines)

# Qiita Article Planner

## いつこのスキルを使うか

- 「Qiitaに記事を書きたいが、**何を書くか・どう構成するか**を整理したい」とき。
- すでに「ざっくりしたテーマ」はあるが、**想定読者・ゴール・見出し構成**をクリアにしたいとき。
- ポエム〜体験談系の記事でも、**再現性のあるフレームと行動ステップ**まで落とし込みたいとき。

このスキルは、`qiita-writing-principles`もしくはユーザから提供された記事サンプルから抽出されたコツ・テンプレートを前提として動く。

---

## 対話トーンの方針

- 会話は **基本カジュアル** だが、要所（まとめ・注意点など）は丁寧に説明する「mixed」スタイルをとる。
- ユーザーの文体がカジュアル寄りならそれに合わせ、フォーマル寄りなら少しだけトーンを寄せるが、
  - 質問文は「〜してみましょう」「〜教えてください」レベルの丁寧さを保つ。

---

## 対話フロー

### ステップ0: コンテキスト確認（任意）

- もし同じVault内に関連しそうなメモやノートがありそうな場合でも、**自動探索は行いすぎない**。
- ユーザーが「このノートを元にしたい」と明示した場合のみ、そのノートを前提に進める。

### ステップ1: テーマの確認

1. 以下のような聞き方で、ざっくりしたテーマを1〜2文で引き出す：
   - 「今日はどんなテーマでQiita記事を書きたいですか？ざっくりで良いので、1〜2文で教えてください。」
2. テーマが曖昧な場合は、補助質問を行う：
   - 「最近ハマった技術的なトラブル」/「作ったツール・システム」/「キャリアや働き方で考えていること」など、どの軸に近いかを選んでもらう。

### ステップ2: 想定読者（ペルソナ）のヒアリング

以下の順に質問し、**属性×状態×悩み** を言語化する。

1. レベル感
   - 「この記事は、どんなレベル感の人に一番読んでほしいですか？（例: 初学者 / 実務1〜3年 / シニア / PdM志望のエンジニア など）」
2. 状態・状況
   - 「その人は今どんな状況にいますか？仕事や学習の状況を一言で教えてください。」
3. 今の悩み・モヤモヤ
   - 「その人が今抱えていそうな悩みやモヤモヤって、どんなものがありそうですか？」

ヒアリング結果から、以下の1文を一緒に整える：

> 想定読者：◯◯な状況にいて、△△でモヤモヤしている□□レベルの人

### ステップ3: 読み終えた後のゴール

1. 質問：
   - 「その読者がこの記事を読み終わったあと、どうなっていてほしいですか？できるだけ具体的に、1〜2文で教えてください。」
2. 例を提示してイメージを合わせる：
   - 「判断の基準が1つ手に入っていてほしい」
   - 「明日から試せる小さな一歩が1つでも決まっている」
   - 「自分の今の状態を言葉にできるようになっている」

3. ユーザーの回答を元に、**ゴール文**を一緒に整える：

> ゴール：この記事を読み終えた読者は、◯◯できるようになっている

### ステップ4: 著者の現在地・原体験

記事のトーンを決めるため、著者側の立ち位置を聞く。

1. 現在地
   - 「あなた自身は、そのテーマに関して『目指している途中』ですか？それとも『ある程度できていて振り返りを書きたい』感じですか？」
2. 原体験・トリガー
   - 「このテーマについて書こうと思ったきっかけの出来事はありますか？1つエピソードがあれば教えてください。」
3. 感情
   - 「そのとき、どんな感情がありましたか？（例: 焦り・不安・ワクワク・モヤモヤ など）」

これらを使って、**イントロのトーン（思考ログ寄り / 事例紹介寄り）**を決める。

### ステップ5: ロールモデル / ゴール像（任意だが強力）

1. 質問：
   - 「『こうなれたらいいな』と思うロールモデルや状態像はありますか？実在の人でも、抽象的な像でもOKです。」
2. なければプロンプト：
   - 「たとえば『コードも書けて事業も動かせる人』『自分のワークフローを自動化している人』のようなイメージです。」
3. あれば、その像を3〜5要素に分解する：
   - 例: 「売上を作れる」「経営層と話せる」「事業判断できる」「人脈がある」

### ステップ6: 記事全体のコアメッセージ

1. 質問：
   - 「この記事で一番伝えたいメッセージを、1〜2文であえて雑に言語化するとしたら、何になりますか？」
2. サポート：
   - 「〜だけでは◯◯できない」「〜を捨てずに□□する方法」「〜すると記事が書くのが楽になる」のような形を提案する。

このメッセージを、`qiita-writing-principles` における「方程式・フレーム」の核として使う。

### ステップ7: 記事プランの生成

ここまでの回答を元に、**記事見出し＋各セクションの要約** を生成する。

---

## 記事プラン出力フォーマット

出力は **日本語Markdown** で、以下のテンプレートを基本とする。
記事の種類（キャリア系/技術自動化系/純技術解説など）に合わせて、不要なセクションはスキップしてよい。

```markdown
## 想定読者

- （属性×状態×悩みを1〜3行で）

## この記事でわかること

- 箇条書き3〜5個

## はじめに（背景と問題提起）

- 著者の原体験・感情
- なぜこのテーマを書こうと思ったか
- 読者の今の状態との共通点

From tomyou666/skills, MIT.

More from tomyou666/skills