academic-chapter-writer について
academic-chapter-writerは、調査、構成案、執筆、編集を段階的に進めて教科書の章を作成するスキルです。PubMedの文献、Vancouver形式の引用、各段階の確認を必要とする学術執筆者向けです。
主な機能
- 01PubMedを検索して文献を整理
- 02語数付きの章構成を作成
- 03節ごとに番号付き引用を付けて執筆
- 04Vancouver形式の参考文献一覧を編集
- 05承認と段階ごとのレビューを待機
活用シーン
- 01テーマから教科書の章を作成
- 02執筆前に研究文献を整理
- 03章の構成と内容を段階的にレビュー
MCP 対応
ワークフローでは、PubMed MCPを使って論文を検索し、論文メタデータを取得するようエージェントに指示します。その結果を引用付きの章の執筆に活用します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ drshailesh88/ integrated_content_os --skill academic-chapter-writerインストール後、Claude Code で/academic-chapter-writerを入力して読み込まれたか確認します。
同梱ファイルreferences/writing-style.md
詳細
学術書籍の章の執筆
トピックを、包括的な調査、適切な引用、人間らしい学術的な文章を備えた、出版可能な教科書の章に仕上げます。
概要
このスキルは、エージェント型ワークフローを通じて、5,000~15,000語の学術教科書の章を作成します。
- 調査 - PubMedを検索し、重要な文献を20~30件まとめます
- 計画 - 語数の割り当てを含む詳細な目次を作成 → 承認を得ます
- 執筆 - 引用を含め、セクションごとに執筆します
- 編纂 - バンクーバー方式の参考文献リストを含む章全体をまとめます
ワークフロー
フェーズ1:トピックの分析と調査
ユーザーからトピックが提示されたら:
-
範囲を確認します:
- トピック:[正確なトピック]
- レベル:学部 | 大学院 | 専門職 | 上級
- 目標の長さ:[デフォルトは8,000語]
- 特別な焦点:[特定の切り口があれば記載]
-
PubMed MCPで調査します:
Use PubMed:search_articles for: - Main topic + "review" (find reviews) - Main topic + "clinical trial" (find trials) - Main topic + "guideline" (find guidelines) - Main topic + "meta-analysis" (find syntheses) -
参考文献ライブラリをまとめます:
- 目標は論文20~30件です
- 優先する雑誌:NEJM、JAMA、Lancet、JACC、Circulation、EHJ
- 含めるもの:画期的な臨床試験3~5件、メタ分析2~3件、ガイドライン1~2件、レビュー
-
ユーザーに報告します: 「PubMedを検索し、以下を含む重要な参考文献を[N]件まとめました。
- 画期的な臨床試験:[X]件
- メタ分析:[X]件
- ガイドライン/レビュー:[X]件
目次を作成してもよろしいですか?」
フェーズ2:目次の作成
各章の語数を割り当てた構成目次を作成します。
# [Chapter Title]
## 1. Introduction (~500 words)
- Opening hook (clinical scenario)
- Scope and importance
- Chapter overview
## 2. [Historical Context / Background] (~800 words)
- Evolution of understanding
- Key milestones
- Current landscape
## 3. [Core Topic Area 1] (~1,500 words)
### 3.1 [Subtopic A]
### 3.2 [Subtopic B]
### 3.3 [Subtopic C]
## 4. [Core Topic Area 2] (~1,500 words)
### 4.1 [Subtopic A]
### 4.2 [Subtopic B]
## 5. [Evidence Review / Clinical Data] (~2,000 words)
### 5.1 Landmark Trials
### 5.2 Meta-analyses
### 5.3 Real-world Data
## 6. [Practical Applications / Clinical Pearls] (~1,000 words)
### 6.1 [Application A]
### 6.2 [Application B]
## 7. [Controversies / Ongoing Debates] (~500 words)
## 8. Future Directions (~400 words)
## 9. Conclusions (~300 words)
- Key takeaways
- Practice implications
## References
重要:ユーザーの承認を待ちます
目次を提示し、次のように尋ねます。 「提案する構成は合計約[X]語です。確認のうえ、次のいずれかをお知らせください。
- 執筆に進む場合は[承認]
- 特定のセクションを変更する場合は[変更]
- 別のアプローチにする場合は[再生成]」
フェーズ3:セクションの執筆
目次の承認後、次の手順で各セクションを執筆します。
セクションごとの執筆手順
- 関連する参考文献を取得します - セクションに関連する論文について、PubMed:get_article_metadataを使用します
- authentic-voiceを適用します -
references/writing-style.mdに厳密に従います - 引用を含めます - [1]、[2]など、順番に番号を付けます
- 目標語数に合わせます - ±10%以内に収めます
- レビュー用に提示します - 各主要セクションの後に提示します
セクションのテンプレート
## [Section Title]
[Opening sentence that grounds reader - specific, concrete, not abstract claims]
[Body paragraphs with citations. Each major claim cited. Mix of sentence lengths. No AI tells.]
[Transition to next section or closing thought]
**Citations used in this section:** [1] Author et al., Journal Year; [2] ...
引用形式(バンクーバー方式)
本文中:順番に番号を付けます([1]、[2]、[1,3]、[4-6])
参考文献リストの形式:
1. Author AA, Author BB, Author CC. Title of article. Journal Abbrev. Year;Volume(Issue):Pages. doi:xxx
フェーズ4:編纂
すべてのセクションが承認されたら:
-
セクションを統合します - 滑らかにつながるようにします
-
引用に番号を付けます - 章全体を通して連番にします
-
参考文献リストを作成します - バンクーバー方式で番号を付けます
-
書式を確認します:
- すべての引用番号が参考文献リストに含まれている
- 見出しのスタイルが統一されている
- 参照されていない文献がない
- 語数の概要がある
-
完成した章を提示します:
# [Chapter Title] [Full content with numbered citations] ## References 1. [Reference 1] 2. [Reference 2] ... --- Total words: X,XXX Total references: XX
執筆スタイル(重要)
Eric Topolの文体の原則
- エビデンスを重視 - すべての主張を引用した研究に基づかせます
- 懐疑的な楽観主義 - 進歩を歓迎しながらも、厳密な姿勢を保ちます
- 患者中心 - 人々への影響に立ち返ります
- 深みとわかりやすさを両立 - 複雑な科学を明快に説明します
- 対話的な権威 - 講師ではなく、同僚として語りかけます
- データの可視化 - NNT、ARR、信頼区間を示します
自然な文体のルール
AIらしさが出る次の表現は使用しないでください:
- 分詞構文で締めくくる表現(「…の重要性を浮き彫りにしながら」など)
- 重要性を大げさに表現する言い回し(「これは大きな進歩を意味します」など)
- 否定を使った対句(「単にXというだけでなく、Yです」など)
- 幽霊のような表現(ささやき、こだま、タペストリー)
- 宣伝めいた誇張表現(ひっそりとたたずむ、息をのむほどの、活気に満ちた)
必ず次のようにしてください:
- 抽象的な主張ではなく、具体的な事実から始めます
- 文の長さに大きな変化をつけます
- 「強調した」「浮き彫りにした」ではなく「述べた」「示した」を使います
- ダッシュは段落ごとに最大1つにします
- こびへつらうような書き出しは避けます
語彙の置き換え:
- delve → examine、look at
- leverage/utilize → use
- landscape → field、area
- tapestry → mix、blend
- pivotal/crucial → [なぜ重要なのかを具体的に示します]
- comprehensive → thorough、full
- nuanced → subtle、detailed
- foster → build、encourage
- navigate → handle、work through
音声チェックリスト(すべてのセクションに適用)
- 根拠なしに重要性を主張する文がない
- 抽象的な説明より具体的な詳細が多い
- 文の長さに変化がある(短文・中文・長文を組み合わせる)
- 1つの段落につき、emダッシュは1つまで
- 書き出しが「今日では……」や「……の領域では」から始まっていない
- 重要性を主張する「-ing」句で文を終えていない
- 何かを「証となる」と表現していない
- すべての主張に引用がある
参考文献の管理
出典の優先順位
ティア1(最優先):
- New England Journal of Medicine
- JAMA
- Lancet
- BMJ
ティア2(専門分野):
- European Heart Journal
- JACC(すべての派生誌)
- Circulation(すべての派生誌)
- JAMA Cardiology/Oncologyなど
ティア3(分野別):
- インパクトファクターが5を超える専門誌
引用要件
| 章の長さ | 参考文献の最小数 |
|---|---|
| 5,000語 | 15~20 |
| 8,000語 | 20~30 |
| 12,000語 | 30~40 |
| 15,000語 | 40~50 |
ユーザーに確認する場合
- 「詳細な方法を確認するため、[TRIAL NAME]の全文が必要です。お持ちですか?」
- 「[TOPIC]の適切な背景を把握するため、特定の試験を検索しましょうか?」
- 「抄録には[DETAIL]の記載がありません。この情報なしで進めますか、それともご提供いただけますか?」
やり取りの例
例1:新しい章の依頼
ユーザー:「心不全におけるSGLT2阻害薬について、教科書の章を書いてください」
応答: 「心不全におけるSGLT2阻害薬について、教科書の章を作成します。まず、次の点を確認させてください。
- 対象読者のレベルは?(専門家/大学院生/上級者)
- 目標の長さは?(デフォルト:8,000語)
- 特に焦点を当てたい点はありますか?(作用機序、臨床試験、患者選択、すべて)
ご回答をお待ちする間に、DAPA-HF、EMPEROR-Reduced、最近のメタ解析などの主要な参考文献をPubMedで検索します。」
[PubMed:search_articlesを使用]
例2:目次の提示
調査後の応答: 「NEJMから6件、Lancetから4件、JACCから8件、Circulationから5件、EHJから5件、合計28件の主要な参考文献をまとめました。
構成案は次のとおりです。
心不全におけるSGLT2阻害薬:包括的レビュー
1. 序論(約400語)
2. 作用機序(約1,000語)
- 2.1 尿糖排泄作用
- 2.2 血行動態への作用
- 2.3 心臓リモデリング
3. 臨床エビデンス(約2,500語)
- 3.1 DAPA-HF
- 3.2 EMPEROR-Reduced
- 3.3 DELIVER
- 3.4 メタ解析
4. 患者選択(約1,200語)
- 4.1 HFrEF
- 4.2 HFpEF
- 4.3 特別な集団
5. 実践的な導入(約1,000語)
6. 安全性に関する考慮事項(約800語)
7. 今後の展望(約600語)
8. 結論(約500語)
合計:約8,000語 | 参考文献:28件
[承認] [修正] [再生成]」
例3:セクションの提示
セクション完成後の応答: 「## 3. 臨床エビデンス
心不全におけるSGLT2阻害薬の臨床開発は、予想外の経緯をたどりました。当初は糖尿病の血糖コントロール薬として承認されましたが、安全性試験で顕著な心血管系のベネフィットが示され、心不全を対象とする試験の実施につながりました[1,2]。
3.1 DAPA-HF
DAPA-HF試験では、駆出率が低下した心不全患者4,744人を、ダパグリフロジン10mg群またはプラセボ群に無作為に割り付けました[3]。追跡期間の中央値18.2か月において、ダパグリフロジンは心不全の悪化または心血管死からなる主要複合評価項目を26%低下させました(HR 0.74、95% CI 0.65-0.85)[3]。このベネフィットは数週間以内に現れ、糖尿病の有無にかかわらず持続しました。この結果によって、臨床医がこれらの薬剤をどう捉えるかが変わりました[4]。
[引用8~10件を含む約800語の続き]
**セクションの語数:**823 引用:[1-10]
セクション3.2(EMPEROR-Reduced)に進みますか?[続行] [このセクションを修正]」
最終納品前の品質チェックリスト
- すべてのセクションが揃っており、内容に抜けがない
- 総語数が目標の±10%以内
- すべての引用番号が連番になっている
- 参考文献リストが本文中の引用と一致している
- AI特有の表現がない(自然な文体のルールに照らして確認済み)
- セクション間のつながりが滑らかである
- 冒頭のつかみが魅力的である(ありきたりではない)
- 結論が具体的である(決まり文句ではない)
- バンクーバー方式の引用形式に一貫性がある
出力形式
最終章は次の形式で納品します。
# [Chapter Title]
**Author:** [User name if provided]
**Word Count:** X,XXX
**References:** XX
---
[Full chapter content with [numbered] citations]
---
## References
1. [Full Vancouver-format reference]
2. [Full Vancouver-format reference]
...