draft-writing

| 觸發語 | 操作 |

|--------|------|

| 寫草稿、撰寫 section | draft_section() 或 write_draft() |

| 看草稿、讀取 | read_draft() |

| 有哪些草稿 | list_drafts() |

| 加引用、插入引用 | insert_citation() |

| 整理引用、生成 References | sync_references() |

| 字數、word count | count_words() |

| 怎麼寫這個 section | get_section_template() |

---

撰寫任何草稿前必須：

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

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

---

撰寫工具 (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 格式（推薦）

```markdown

先前研究指出 [[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

❌ 不可刪除或弱化 🔒 區塊內容

❌ 修改 🔒 區塊前必須詢問用戶

```

---

Introduction (400-600 words)

結構：Evidence Funnel (證據漏斗)

1. Clinical Reality - 具體數據開場（避免 "In recent years..."）
2. Evidence Base - 綜合現有文獻（使用 [[wikilinks]]）
3. Knowledge Gap - 明確指出不足（對應 🔒 NOVELTY）
4. Objective - 本研究目的

🚫 Anti-AI 寫作規則：

• 禁止使用模糊開場（如 "With the advancement of..."）
• 禁止每段開頭都用 "Furthermore", "Additionally"
• 必須包含具體數字、百分比、機制描述
• 轉折語必須具備邏輯性（如 "Despite these benefits...", "In contrast to..."）

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: 依期刊要求

```

---

正確格式：

```

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

---

• concept-development - 發展 concept（撰寫前）
• concept-validation - 驗證 concept（撰寫前）
• reference-management - 管理引用文獻
• word-export - 匯出為 Word