fable-quotelisted
Install: claude install-skill abs1294/fulin-claude-plugins
# 寓意科技報價單產生器(fable-quote)
## 這個 skill 做什麼
把一份開發案的內容,套進**寓意科技既有的報價單版式**,產出格式完全一致、可直接交客戶的正式報價單 `.docx`。
核心價值:**不要每次重畫 Word 格式**。手刻報價單版式(標題樣式、表格框線、底色、欄寬、字型)極易跑掉,且乙方資料與通用條款每次都要重打。本 skill 用一份**已脫敏的公司模板**(`assets/quote_template.docx`)+一支產生腳本,你只需準備「這一案的內容」,其餘全部沿用。
## 何時用
- 使用者要對外報價:「做報價單」「幫客戶出報價」「這個開發案報價多少」
- 已有專案建議書 / 需求規劃,要轉成正式報價單
- 需要跟公司既有報價單格式一致(走報價程序、交客戶簽回)
## 產出流程
1. **蒐集這一案的內容**,整理成一份 JSON(schema 見下)。內容通常來自對話中的專案建議書、需求討論、或使用者口述。缺的欄位主動問使用者(尤其客戶統編、地址、聯絡人、報價日期、單價)。
2. **執行產生腳本**:
```bash
python scripts/build_quote.py <你的 project.json> -o "fable報價單_<客戶>_<專案>.docx"
```
腳本會套用 `assets/quote_template.docx`,動態展開明細列、自動算含稅金額與總計。
3. **轉 PDF 目視驗證**(強烈建議,確認無跑版):用 Word 或 LibreOffice 轉 PDF,逐頁看金額、明細、專案定義是否正確。
4. **提醒使用者待填/待確認項**:客戶 Email、報價有效期、折扣等若未定,留白並提醒。
## 乙方固定資料(已內建於模板,無需重填)
模板右欄與付款/簽回區已寫好寓意科技資料,產出時自動帶入,**不要重問使用者**:
- 公司:寓意科技股份有限公司|統一編號:53778177
- 電話:02-2388-0380|地址:台北市中山區中山北路三段47號603室
- 專案聯絡人:林甫軒(Email:fu.lin@fable.com.tw);簽回欄業務代表(公司代表人):施政源
- 匯款:台灣企銀大安分行 12012159119
- 通用條款(稅金 5%、報價生效、合約、保固三個月、發票規則)皆已內建於模板,除非使用者要改,否則沿用。
## JSON schema
只需填「這一案」的資料。範例見 `assets/example_project.json`(可直接複製修改)。
```jsonc
{
"client_short": "汎銓", // 用於輸出檔名
"project_short": "ModernMES", // 用於輸出檔名
"quote_date": "2026/06/29",
"valid_until": "2026/07/31", // 報價有效期
"unit_price": 10000, // 未稅單價(元/人天)
"tax_rate": 0.05, // 稅率,通常 0.05
"total_incl_tax": 267750, // 選填:指定含稅總價;有給則校驗與明細加總是否一致
"client": {