草稿撰寫技能

適用情境

| 觸發語 | 操作 | |--------|------| | 寫草稿、撰寫 section | draft_section() 或 write_draft() | | 看草稿、讀取 | read_draft() | | 有哪些草稿 | list_drafts() | | 加引用、插入引用 | insert_citation() | | 整理引用、生成 References | sync_references() | | 字數、word count | count_words() | | 怎麼寫這個 section | get_section_template() |

⚠️ 前置條件

撰寫任何草稿前必須：

確認專案已選定：get_current_project()
確認 concept.md 存在且包含 🔒 區塊
結構驗證通過（🔒 NOVELTY + 🔒 SELLING POINTS 不為空）

例外：寫 concept.md 本身不需要驗證

MCP Tools 清單

撰寫工具 (mdpaper)

| 工具 | 參數 | 說明 | |------|------|------| | write_draft | filename, content, project | 建立/覆寫草稿檔案 | | draft_section | topic, notes, project | 根據筆記產出特定 section | | read_draft | filename, project | 讀取草稿結構與內容 | | list_drafts | project | 列出所有草稿 |

引用工具 (mdpaper)

| 工具 | 參數 | 說明 | |------|------|------| | insert_citation | filename, target_text, pmid | 在指定位置插入引用 | | sync_references | filename, project | 掃描 [[wikilinks]] 生成 References | | count_words | filename, section | 計算字數 | | get_section_template | section | 取得 section 寫作指南 |

工作流程

Flow A: 撰寫新 Section

Step 1: 確認專案和驗證狀態
  get_current_project()
  validate_for_section(section="Introduction")
  → ✅ CAN WRITE / ❌ CANNOT WRITE

Step 2: 讀取 concept 和受保護內容
  read_draft(filename="concept.md")
  → 提取 🔒 NOVELTY STATEMENT
  → 提取 🔒 KEY SELLING POINTS

Step 3: 取得寫作指南
  get_section_template(section="Introduction")
  → 返回該 section 的結構建議

Step 4: 撰寫內容
  draft_section(
    topic="Introduction",
    notes="Background on remimazolam... Gap in literature..."
  )
  或
  write_draft(
    filename="drafts/introduction.md",
    content="..."
  )

Step 5: 確認字數
  count_words(filename="drafts/introduction.md")

Flow B: 插入引用

方法 1: Wikilink 格式（推薦）

先前研究指出 [[greer2017_27345583]] 使用 propofol 有其限制。

然後執行：

sync_references(filename="drafts/introduction.md")
→ 轉換為 [1] 格式
→ 生成 References 區塊

方法 2: 定點插入

insert_citation(
  filename="drafts/introduction.md",
  target_text="先前研究指出",
  pmid="27345583"
)

Flow C: 整理 References

Step 1: 確認草稿有 wikilinks
  read_draft(filename="drafts/full_manuscript.md")
  → 檢查是否有 [[citation_key]] 格式

Step 2: 同步引用
  sync_references(filename="drafts/full_manuscript.md")
  → 輸出：
    | # | Citation Key | Title |
    | 1 | greer2017_27345583 | Review of... |
    | 2 | smith2020_12345678 | Analysis of... |

Step 3: 確認未找到的引用
  → ⚠️ Not found: chen2019_87654321
  → 需要先 save_reference_mcp(pmid="87654321")

🔒 受保護內容規則

| 受保護區塊 | 出現位置 | 規則 | |------------|----------|------| | 🔒 NOVELTY STATEMENT | concept.md | Introduction 必須體現 | | 🔒 KEY SELLING POINTS | concept.md | Discussion 必須強調全部 |

撰寫時的強制要求：

✅ Introduction 開頭或結尾必須呼應 NOVELTY
✅ Discussion 必須逐條強調 SELLING POINTS
❌ 不可刪除或弱化 🔒 區塊內容
❌ 修改 🔒 區塊前必須詢問用戶

Section 寫作指南

Introduction (400-600 words)

1. Background - 研究領域背景（2-3 段）
2. Gap - 現有研究的不足
3. Objective - 本研究目的（含 🔒 NOVELTY）

Methods (800-1200 words)

1. Study Design - 研究設計
2. Participants - 納入排除標準
3. Intervention - 介入措施
4. Outcomes - 結果指標
5. Statistics - 統計方法

Results (600-1000 words)

1. Participants - 收案流程、基線特徵
2. Primary Outcome - 主要結果
3. Secondary Outcomes - 次要結果
4. Tables/Figures - 圖表說明

Discussion (1000-1500 words)

1. Main Findings - 主要發現（含 🔒 SELLING POINTS）
2. Comparison - 與現有文獻比較
3. Implications - 臨床意義
4. Limitations - 研究限制
5. Conclusion - 結論

Abstract (250-350 words)

Structured: Background / Methods / Results / Conclusions
Unstructured: 依期刊要求

Wikilink 格式

正確格式：

[[author2024_12345678]]  ← 作者年份_PMID
[[greer2017_27345583]]

會被自動修復的格式：

[[12345678]] → [[author2024_12345678]]
[[PMID:12345678]] → [[author2024_12345678]]
Author 2024 [[12345678]] → [[author2024_12345678]]

常見問題

| 問題 | 解法 | |------|------| | 草稿被阻擋 | 檢查 concept.md 的 🔒 區塊是否填寫 | | 引用找不到 | 先 save_reference_mcp() 儲存文獻 | | 字數太多 | count_words() 逐 section 檢查 | | 不知道怎麼寫 | get_section_template() 取得指南 | | Wikilink 格式錯誤 | validate_wikilinks() 自動修復 |

draft-writing