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()` 自動修復

MCP Tools 清單

撰寫工具 (mdpaper)

引用工具 (mdpaper)

工作流程

Flow A: 撰寫新 Section

Flow B: 插入引用

Flow C: 整理 References

🔒 受保護內容規則

Section 寫作指南

Introduction (400-600 words)

Methods (800-1200 words)

Results (600-1000 words)

Discussion (1000-1500 words)

Abstract (250-350 words)

Wikilink 格式

常見問題

相關技能

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

draft-writing

草稿撰寫技能

適用情境

⚠️ 前置條件