pharmacy-mcp: Instructions file for GitHub Copilot

Copilot 自定義指令

此文件整合 AGENTS.md 和 CLAUDE.md 內容，為 VS Code Copilot 和 Claude Code 提供統一指引

---

開發哲學 💡

「想要寫文件的時候，就更新 Memory Bank 吧！」

「想要零散測試的時候，就寫測試檔案進 tests/ 資料夾吧！」

• 不要另開檔案寫筆記，直接寫進 Memory Bank
• 今天的零散測試，就是明天的回歸測試

---

專案概述

藥品資訊 MCP Server v0.8.0 - 透過 Model Context Protocol 提供完整藥品功能。

指標	數值
版本	v0.8.0
MCP Tools	19 個
測試數量	43 個 (全部通過)
藥名對照	120+ 藥品
健保規則	60+ 藥品

---

法規遵循

你必須遵守以下法規層級：

CONSTITUTION.md          ← 最高原則（不可違反）
  │
  ├── .github/bylaws/    ← 子法（細則規範）
  │     ├── ddd-architecture.md
  │     ├── git-workflow.md
  │     ├── memory-bank.md
  │     └── python-environment.md
  │
  └── .claude/skills/    ← 實施細則（操作程序）

---

架構原則

• 採用 DDD (Domain-Driven Design)
• DAL (Data Access Layer) 必須獨立
• 依賴方向：Presentation → Application → Domain ← Infrastructure
• 參見子法：.github/bylaws/ddd-architecture.md

目錄結構約定

src/pharmacy_mcp/
├── domain/              # 領域層 - 純業務邏輯（無外部依賴）
│   ├── entities/        # 實體
│   └── value_objects/   # 值物件
├── application/         # 應用層 - 用例編排
│   └── services/        # 應用服務
├── infrastructure/      # 基礎設施 - 外部服務
│   ├── api/             # API 客戶端 (FDA, RxNorm, TFDA)
│   └── cache/           # 快取
└── presentation/        # 呈現層 - MCP Tools
    └── server.py        # MCP Server 定義

---

Python 環境（uv 優先）

• 優先使用 uv 管理套件和虛擬環境
• 專案使用 pyproject.toml + uv.lock
• 禁止全域安裝套件

# 初始化環境
uv venv
uv sync --all-extras

# 安裝依賴
uv add package-name
uv add --dev pytest ruff mypy

參見子法：.github/bylaws/python-environment.md

---

MCP 開發規則

• 所有 Tool 定義在 src/pharmacy_mcp/presentation/server.py
• Tool 函數必須使用 type hints
• Tool 描述必須清楚說明參數和回傳值
• 台灣相關 Tools 使用 TaiwanDrugService

可用 MCP Tools (19 個)

基礎功能 (13 個)

• search_drug - 藥品搜尋
• get_drug_info - 藥品資訊（含台灣資訊）
• get_drug_dosage - 劑量資訊
• get_drug_warnings - 警告資訊
• check_drug_interaction - 藥物交互作用
• check_multi_drug_interactions - 多藥物交互作用
• check_food_drug_interaction - 食品藥物交互
• calculate_dose_by_weight - 體重劑量計算
• calculate_dose_by_bsa - BSA 劑量計算
• calculate_creatinine_clearance - 腎功能計算
• calculate_pediatric_dose - 小兒劑量
• calculate_infusion_rate - 輸液速率
• convert_dose_units - 劑量單位轉換