quotation

name	quotation
description	當用戶詢問報價或說「報價單樣本」時，此 skill 協助你產生報價單。

Quotation Skill

主要目的

當用戶詢問報價時，此 skill 協助你產生報價單。當用戶說「報價單樣本」時，產生一份空白格式的報價單（項目內容、合計、稅金、總計皆空，由使用者填入）。

觸發條件

此 skill 在以下情況使用：

• 當用戶的輸入中包含「報價」或「報價單」時
• 當用戶說「報價單樣本」時：產生與 assets/quotation_sample.xlsx 格式一模一樣的報價單

指示

檔案結構

• assets/quotation_sample.xlsx：報價單格式範本
• scripts/：產生報價單的工具腳本
  • generate_quotation.py：依樣本產生新 xlsx，保證格式一致
  • update_quotation.py：逐一修改已產生的 xlsx，可透過 prompt 一個一個慢慢改
  • read_template.py：讀取樣本結構（合併儲存格、可變欄位）
  • sample_data.json：空白範本格式（項目內容、合計、稅金、總計由使用者填入）

當用戶說「報價單樣本」時

重要：產出的報價單必須為空白格式，項目內容、數量、單價、費用、合計、稅金、總計皆為空，由使用者後續填入。

1. 禁止直接提供或複製 assets/quotation_sample.xlsx 給用戶（該檔案含範例內容，非空白）
2. 必須執行以下指令產生空白報價單：

   python scripts/generate_quotation.py --json scripts/sample_data.json -o 報價單.xlsx
   

3. 若無法執行指令，則提供上述指令給用戶並說明：產出為空白報價單，項目內容、合計、稅金、總計由使用者填入
4. sample_data.json 已為空白範本（項目、合計、稅金、總計皆空），執行後產出的 xlsx 為空白格式

建立空白 xlsx 後，透過 prompt 逐一修改

使用者可透過 prompt 一個一個慢慢修改已產生的報價單，執行 scripts/update_quotation.py：

修改需求	指令範例
只改公司名稱（保留聯絡人、信箱等）	python scripts/update_quotation.py 報價單.xlsx --company-name "巨匠電腦股份有限公司"
只改客戶名稱（保留其他欄位）	python scripts/update_quotation.py 報價單.xlsx --client-name "新光企業股份有限公司"
公司聯絡人、信箱、電話、地址	--company-contact、--company-email、--company-phone、--company-address
客戶聯絡人、信箱、電話、地址	--client-contact、--client-email、--client-phone、--client-address
完整替換公司/客戶資料	--company "..." 或 --client "..."（會覆蓋全部）
第 1 項目的內容與價格	python scripts/update_quotation.py 報價單.xlsx --item 1 --desc "課程名稱" --price "48000" --amount "48000"
報價單編號	python scripts/update_quotation.py 報價單.xlsx --quote-no "Q-2025-002"
合計、稅金、總計	python scripts/update_quotation.py 報價單.xlsx --subtotal "100000" --vat "5000" --total "105000"

流程：產生空白 xlsx → 用 prompt 說「幫我改公司名稱為 XXX」→ AI 執行 --company-name "XXX"（只改該欄位，保留其他）→ 重複直到完成

重要：使用者說「改公司名稱為 XXX」時，必須使用 --company-name，不可使用 --company，否則會把全部內容替換成只有公司名稱。

一般報價單產生

當用戶詢問報價（非「報價單樣本」）時，可參考 assets/quotation_sample.xlsx 作為格式參考，依用戶需求產生報價單。