mcpField
C
content-research-writer

content-research-writer

github.com/nicepkgクリエイティブ・メディア288105 回インストール40 週間前に更新
リポジトリ

content-research-writer について

content-research-writer は、記事やチュートリアル、技術文書などを書く人向けのライティングスキルです。調査や引用の管理、段階的なフィードバックを通じて、書き手の文体を保ちながら原稿を整えます。

主な機能

  1. 01共同でのアウトライン作成
  2. 02引用付きの調査
  3. 03導入部の改善
  4. 04セクションごとのレビュー
  5. 05文体とトーンの維持
  6. 06原稿の反復的な推敲

活用シーン

  1. 01記事やニュースレターの構成
  2. 02アウトラインへの出典追加
  3. 03記事の導入部の改善
  4. 04技術チュートリアルの原稿確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/nicepkg/ai-workflow --skill content-research-writer

インストール後、Claude Code で/content-research-writerを入力して読み込まれたか確認します。

詳細

コンテンツ調査ライター

このスキルは、あなたの文章作成パートナーとして、独自の声やスタイルを保ちながら、コンテンツの調査、構成案の作成、執筆、推敲を支援します。

このスキルを使う場面

  • ブログ記事、記事、ニュースレターの執筆
  • 教育コンテンツやチュートリアルの作成
  • ソートリーダーシップ記事の執筆
  • ケーススタディの調査と執筆
  • 出典を明記した技術文書の作成
  • 適切な引用と参考文献を用いた執筆
  • フックや導入部の改善
  • 執筆中に各セクションごとのフィードバックを受ける

このスキルでできること

  1. 共同での構成案作成:アイデアを一貫性のある構成案にまとめます
  2. 調査支援:関連情報を探し、引用を追加します
  3. フックの改善:読者の関心を引くよう、書き出しを強化します
  4. セクションごとのフィードバック:各セクションを執筆に合わせて確認します
  5. 文体の維持:あなたの文体やトーンを保ちます
  6. 引用の管理:参考文献を適切に追加し、形式を整えます
  7. 反復的な推敲:複数の草稿を通じて改善を支援します

使い方

執筆環境をセットアップする

記事用の専用フォルダーを作成します。

mkdir ~/writing/my-article-title
cd ~/writing/my-article-title

草稿ファイルを作成します。

touch article-draft.md

このディレクトリから Claude Code を開き、執筆を始めます。

基本的なワークフロー
  1. 構成案から始めます:
Help me create an outline for an article about [topic]
  1. 調査して引用を追加します:
Research [specific topic] and add citations to my outline
  1. フックを改善します:
Here's my introduction. Help me make the hook more compelling.
  1. セクションごとのフィードバックを受けます:
I just finished the "Why This Matters" section. Review it and give feedback.
  1. 推敲して仕上げます:
Review the full draft for flow, clarity, and consistency.

執筆支援の手順

ユーザーが執筆支援を依頼した場合:

  1. 執筆プロジェクトを理解する

    確認のための質問をします:

    • テーマと主な主張は何ですか?
    • 対象読者は誰ですか?
    • 希望する長さや形式は何ですか?
    • 目的は何ですか?(教育、説得、娯楽、説明)
    • 取り入れたい既存の調査や資料はありますか?
    • 希望する文体は何ですか?(フォーマル、会話調、技術的)
  2. 共同でアウトラインを作成する

    内容の構成を支援します:

    # Article Outline: [Title]
    
    ## Hook
    
    - [Opening line/story/statistic]
    - [Why reader should care]
    
    ## Introduction
    
    - Context and background
    - Problem statement
    - What this article covers
    
    ## Main Sections
    
    ### Section 1: [Title]
    
    - Key point A
    - Key point B
    - Example/evidence
    - [Research needed: specific topic]
    
    ### Section 2: [Title]
    
    - Key point C
    - Key point D
    - Data/citation needed
    
    ### Section 3: [Title]
    
    - Key point E
    - Counter-arguments
    - Resolution
    
    ## Conclusion
    
    - Summary of main points
    - Call to action
    - Final thought
    
    ## Research To-Do
    
    - [ ] Find data on [topic]
    - [ ] Get examples of [concept]
    - [ ] Source citation for [claim]
    

    アウトラインを反復して改善する:

    • フィードバックに基づいて調整する
    • 論理的な流れを確保する
    • 調査が不足している箇所を特定する
    • 詳細に掘り下げるセクションを示す
  3. 調査を行う

    ユーザーがテーマについての調査を依頼した場合:

    • 関連情報を検索する
    • 信頼できる情報源を見つける
    • 重要な事実、引用、データを抽出する
    • 指定された形式で引用を追加する

    出力例:

    ## Research: AI Impact on Productivity
    
    Key Findings:
    
    1. **Productivity Gains**: Studies show 40% time savings for
       content creation tasks [1]
    
    2. **Adoption Rates**: 67% of knowledge workers use AI tools
       weekly [2]
    
    3. **Expert Quote**: "AI augments rather than replaces human
       creativity" - Dr. Jane Smith, MIT [3]
    
    Citations:
    [1] McKinsey Global Institute. (2024). "The Economic Potential
    of Generative AI"
    [2] Stack Overflow Developer Survey (2024)
    [3] Smith, J. (2024). MIT Technology Review interview
    
    Added to outline under Section 2.
    
  4. 導入部のフックを改善する

    ユーザーが導入部を共有した場合、分析して強化します:

    現在のフックの分析:

    • 効果的な点:[良い要素]
    • さらに改善できる点:[改善箇所]
    • 感情への訴求力:[現在の状態と改善の可能性]

    代替案の提案:

    案1:[大胆な主張]

    [例] 効果がある理由:[説明]

    案2:[個人的なエピソード]

    [例] 効果がある理由:[説明]

    案3:[意外性のあるデータ]

    [例] 効果がある理由:[説明]

    フックに関する質問:

    • 読者の好奇心を引き出せていますか?
    • 価値を提供することを示せていますか?
    • 十分に具体的ですか?
    • 対象読者に合っていますか?
  5. セクションごとにフィードバックを提供する

    ユーザーが各セクションを書き上げるたびに、次の点を確認します:

    # Feedback: [Section Name]
    
    ## What Works Well ✓
    
    - [Strength 1]
    - [Strength 2]
    - [Strength 3]
    
    ## Suggestions for Improvement
    
    ### Clarity
    
    - [Specific issue] → [Suggested fix]
    - [Complex sentence] → [Simpler alternative]
    
    ### Flow
    
    - [Transition issue] → [Better connection]
    - [Paragraph order] → [Suggested reordering]
    
    ### Evidence
    
    - [Claim needing support] → [Add citation or example]
    - [Generic statement] → [Make more specific]
    
    ### Style
    
    - [Tone inconsistency] → [Match your voice better]
    - [Word choice] → [Stronger alternative]
    
    ## Specific Line Edits
    
    Original:
    
    > [Exact quote from draft]
    
    Suggested:
    
    > [Improved version]
    
    Why: [Explanation]
    
    ## Questions to Consider
    
    - [Thought-provoking question 1]
    - [Thought-provoking question 2]
    
    Ready to move to next section!
    
  6. 書き手の声を保つ

    重要な原則:

    • 文体を把握する:既存の文章サンプルを読む
    • 置き換えるのではなく、提案する:指示ではなく選択肢を提示する
    • トーンを合わせる:フォーマル、カジュアル、技術的、親しみやすい
    • 選択を尊重する:書き手が自分の案を好む場合は、それを支持する
    • 上書きせず、磨き上げる:文章を別のものにするのではなく、より良くする

    定期的に次のように尋ねます:

    • 「あなたらしい文章になっていますか?」
    • 「このトーンでよいですか?」
    • 「もっと/控えめに[フォーマル/カジュアル/技術的]にしたほうがよいですか?」
  7. 引用を管理する

    ユーザーの希望に応じて参考文献を扱います:

    本文中の引用:

    Studies show 40% productivity improvement (McKinsey, 2024).
    

    番号付き参考文献:

    Studies show 40% productivity improvement [1].
    
    [1] McKinsey Global Institute. (2024)...
    

    脚注形式:

    Studies show 40% productivity improvement^1
    
    ^1: McKinsey Global Institute. (2024)...
    

    引用リストを継続的に管理します:

    ## References
    
    1. Author. (Year). "Title". Publication.
    2. Author. (Year). "Title". Publication.
       ...
    
  8. 最終確認と仕上げ

    草稿が完成したら、包括的なフィードバックを提供します:

    # Full Draft Review
    
    ## Overall Assessment
    
    **Strengths**:
    
    - [Major strength 1]
    - [Major strength 2]
    - [Major strength 3]
    
    **Impact**: [Overall effectiveness assessment]
    
    ## Structure & Flow
    
    - [Comments on organization]
    - [Transition quality]
    - [Pacing assessment]
    
    ## Content Quality
    
    - [Argument strength]
    - [Evidence sufficiency]
    - [Example effectiveness]
    
    ## Technical Quality
    
    - Grammar and mechanics: [assessment]
    - Consistency: [assessment]
    - Citations: [completeness check]
    
    ## Readability
    
    - Clarity score: [evaluation]
    - Sentence variety: [evaluation]
    - Paragraph length: [evaluation]
    
    ## Final Polish Suggestions
    
    1. **Introduction**: [Specific improvements]
    2. **Body**: [Specific improvements]
    3. **Conclusion**: [Specific improvements]
    4. **Title**: [Options if needed]
    
    ## Pre-Publish Checklist
    
    - [ ] All claims sourced
    - [ ] Citations formatted
    - [ ] Examples clear
    - [ ] Transitions smooth
    - [ ] Call to action present
    - [ ] Proofread for typos
    
    Ready to publish! 🚀
    

例

例1:Teresa Torresのワークフロー

ユーザー:「継続的なディスカバリーについての記事を書いています。アウトラインの作成を手伝ってください。」

プロセス:

  1. アウトラインの構成を共同で作成する
  2. 調査が必要な点を特定する
  3. ユーザーが導入部を書き始める
  4. フックを確認して改善する
  5. ユーザーが各セクションを書く
  6. 各セクションの後にフィードバックを提供する
  7. 調査を行い、引用を追加する
  8. 完成した草稿を最終確認する
  9. 公開に向けて文章を磨き、準備する

結果:十分に調査され、適切に引用され、Teresaの文体で書かれた、構成と流れの優れた記事。

例2:調査を重視した記事

ユーザー:「AIがプロダクトマネジメントに与える影響について書いています。最新のデータや事例を探すのを手伝ってください。」

出力:

## Research Compiled

### Recent Data

- Gartner: 80% of PMs will use AI tools by 2025 [1]
- Survey: 45% report faster feature shipping [2]
- Case study: Airbnb's AI-assisted prioritization [3]

### Expert Quotes

- "AI amplifies PM judgment, not replaces it" - Marty Cagan
- [Additional quotes with citations]

### Real Examples

1. **Company A**: Used AI for user research synthesis
   - Result: 60% time savings
   - Source: [citation]

2. **Company B**: AI-powered roadmap analysis
   - Result: Better stakeholder alignment
   - Source: [citation]

All added to your outline with proper citations.
例3:フックの改善

ユーザーの元のフック:

「AIによってプロダクトマネジメントは変化しています。この記事では、AIがプロダクトマネージャーにどのような影響を与えるかについて説明します。」

改善案:

案1(データに基づく):

「先月、AIに500件の顧客インタビューを分析してもらいました。3週間ではなく、30分で完了しました。プロダクトマネジメントは、もう以前と同じではありません。」

案2(問いかけ):

「朝のコーヒーを飲む前に、すべての顧客と話し、すべてのレビューを読み、すべてのサポートチケットを分析できるとしたら、どうでしょうか?」

案3(ストーリー):

「Sarahは、間違った機能を作るのに2週間を費やしました。ユーザーを理解していなかったからではなく、パターンを見つけるのに必要な何百件ものインタビューを、十分な速さで処理できなかったからです。」

例4:セクションへのフィードバック

ユーザー:「『よくある間違い』のセクションを書き終えました。どう思いますか?」

回答:

# Feedback: Common Mistakes Section

## What Works Well ✓

- Strong examples (the Slack notification story)
- Clear structure (3 mistakes, clean layout)
- Practical advice for each mistake

## Suggestions

### Make It More Specific

Your second point says "Bad prioritization" but could be stronger:

Current:

> "Many teams prioritize badly by focusing on features instead of outcomes."

Suggested:

> "I've watched teams ship 14 features in a quarter yet move none of their key metrics. They prioritized activity over progress."

### Add Data

The third mistake would benefit from evidence:

> "[Add citation]: Studies show teams without regular user contact are 3x more likely to build unused features [needs source]"

### Flow Improvement

Consider reordering: Mistake 3 → Mistake 2 → Mistake 1
This builds from small to big impact.

Ready for the next section!

執筆ワークフロー

ブログ記事のワークフロー
  1. 一緒にアウトラインを作成する
  2. 重要なポイントを調査する
  3. 導入部分を書く → フィードバックをもらう
  4. 本文の各セクションを書く → それぞれフィードバックをもらう
  5. 結論を書く → 最終レビューを受ける
  6. 仕上げて編集する
ニュースレターのワークフロー
  1. フックのアイデアを話し合う
  2. 簡単なアウトラインを作成する(短い形式)
  3. 1回のセッションで草稿を書く
  4. 明瞭さとリンクを確認する
  5. 手早く仕上げる
技術チュートリアルのワークフロー
  1. 手順のアウトラインを作成する
  2. コード例を書く
  3. 説明を追加する
  4. 手順をテストする
  5. トラブルシューティングのセクションを追加する
  6. 正確さを最終確認する
ソートリーダーシップのワークフロー
  1. 独自の切り口をブレインストーミングする
  2. 既存の見解を調査する
  3. 自分の主張を練り上げる
  4. 明確な視点を持って書く
  5. 裏付けとなる根拠を加える
  6. 説得力のある結論を練り上げる

プロのヒント

  1. VS Codeで作業する:長文を書く場合は、Claudeのウェブ版より適しています
  2. 一度に1つのセクションを進める:段階的にフィードバックをもらいます
  3. 調査資料は別に保存する:research.mdファイルを用意します
  4. 草稿にバージョンを付ける:article-v1.md、article-v2.mdなど
  5. 声に出して読む:ぎこちない文を見つけるためにフィードバックを活用します
  6. 締め切りを設定する:「今日中に草稿を仕上げたい」
  7. 休憩を取る:書く、フィードバックをもらう、休む、修正する

ファイル構成

執筆プロジェクトにおすすめの構成:

~/writing/article-name/
├── outline.md          # Your outline
├── research.md         # All research and citations
├── draft-v1.md         # First draft
├── draft-v2.md         # Revised draft
├── final.md            # Publication-ready
├── feedback.md         # Collected feedback
└── sources/            # Reference materials
    ├── study1.pdf
    └── article2.md

ベストプラクティス

調査について
  • 引用する前に情報源を確認する
  • 可能であれば新しいデータを使う
  • さまざまな視点のバランスを取る
  • 元の情報源へのリンクを付ける
フィードバックについて
  • 何を求めているのか具体的に伝える:「技術的すぎますか?」
  • 懸念点を共有する:「このセクションが間延びしていないか心配です」
  • 質問する:「論理的な流れになっていますか?」
  • 別案を求める:「これを説明する別の方法はありますか?」
文体について
  • 自分の文章の例を共有する
  • 希望するトーンを指定する
  • 合っている点を伝える:「私らしい表現ですね!」
  • 合っていない点を伝える:「私の文体には堅すぎます」

関連するユースケース

  • 記事をもとにしたソーシャルメディア投稿の作成
  • さまざまな読者層に合わせたコンテンツの調整
  • メールニュースレターの執筆
  • 技術ドキュメントの草稿作成
  • プレゼンテーションのコンテンツ作成
  • ケーススタディの執筆
  • コースのアウトライン作成

コメント