從整段建置歷程中挑出 5 段對話,代表這套系統設計過程中最關鍵的判斷點。
指令 1 · 階段 1 Gemini 設計助手
用「五要素框架」寫第一版指令
不要直接寫「請幫我分類」,先用「五要素框架」把要 AI 做的事拆清楚。Gemini 內的「設計助手」(一個專門幫忙寫指令的小工具)會把你的需求重組成五要素結構,英文叫 PARTS(取 Persona 角色、Act 做什麼、Recipient 給誰看、Theme 主題、Source 依據資料五個字的字首,下方表格有完整對照)。
設計一個 agent,能幫忙完美、有資安保護的建置自動化流程:
INPUT:醫院顧客在官網填寫滿意度表單(Google Form)
PROCESS:Gemini 自動讀詢問內容,分類如下方補充。
OUTPUT:分類結果寫回 Sheets + 急件 email 通知值班主管。
Gemini 的回應 :用 PARTS 框架重組原始 prompt 成結構化指令,並建議輸出格式與 Google Sheets 整合方式
五要素框架(PARTS)
英文 / 字母
中文 / 意思
本案例對應
P PersonaAI 的角色 資深 Google Cloud 解決方案架構師 + GAS 開發專家
A Act做什麼 建置 AI 自動分類 + 通知 + 統計分析系統
R Recipient給誰看 / 給誰用 具備醫療品管與資訊管理概念的專案管理者
T Theme主題範圍 醫院顧客滿意度 AI 自動化分類、通知、統計分析
S Source依據資料 過去 343 則歷史回應 + 11 主類 × 43 子類分類表
關鍵心法 :寫 AI 指令前先過「五要素框架」。寫得清楚後,後續所有 AI(Gemini / Claude / Claude Code)拿到同樣指令都能產出一致結果,日後要改也容易。
指令 2 · 階段 2 Claude Code
用歷史資料訓練分類規則
分類規則不要憑空寫,要用歷史資料反覆校對。把 343 則回應丟給 Claude Code,要它先分類、列出邊界案例,人工校對後修分類表。指令中用到的 SLA(Service Level Agreement,服務等級協議,承諾多久內必須處理完)與 Critical / Important / Nice-to-have(必須做 / 應該做 / 有就更好)都是專案管理常見用語。
請依照附上的 343 則歷史滿意度回應,設計一份完整的分類系統:
1. 主類別(Category):建議分 8 - 12 個主類,例如「醫師專業」「服務態度」「等候時間」「環境衛生」等
2. 子類別:每個主類下分 3 - 5 個子類,例如「醫師專業」下分「醫術精湛/判斷」「醫療技術」「醫德問題」等
3. 急迫性(Urgency):4 級(P0 24 小時內 / P1 1 週內 / P2 2 週內 / P3 1 個月內),分別給出 SLA + 判定條件 + 範例
4. 重要性(Importance):3 級(Critical / Important / Nice-to-have),分別給出衝擊範圍 + 判定條件 + 範例
5. 邊界案例:列出 5 - 10 則你判讀後不確定該歸哪類的回應,標明你的疑慮,給我人工校對
最後給我一張完整的分類表,我會逐項校對後再請你修正。
分類表(部分) :Claude Code 產出 11 主類(醫師專業、服務態度、等候時間、環境衛生、清潔衛生、餐飲膳食、人員溝通、人員配置、病人權益、員工權益、正面回饋等)× 43 子類
急迫性與重要性表 :急迫性分 4 級,P0(最緊急,24 小時內要處理,例如涉及病人安全、感染風險)→ P3(最不急,1 個月內處理即可,例如政策與結構性議題);重要性分 3 級,「高」=影響病人安全或多人權益,「低」=個人偏好
關鍵心法 :分類規則先「用歷史資料訓練 」再上線,比憑空想分類表可靠太多。AI 會主動列出邊界案例讓你校對,這是它最有用的功能之一。
指令 3 · 階段 3 Claude Code
讓 Claude Code 自己審查指令是否完整
把分類規則整合成完整指令後,別急著開始寫程式。請 Claude Code 用「審稿者」角度檢查指令是否充分完整、無遺漏,並建議要放成什麼形式(CLAUDE.md、skill.md 還是規格文件)。
根據你對我資料的了解,我寫了一份你的任務指令,請協助:
1. 審核內容是否足夠充分完整無遺漏。
2. 是適合做成一份 claude.md 放資料夾,還是做成 skill.md,我不太懂這些差別。
[貼上完整指令]
Claude Code 的回應 :把使用者的指令改寫為「資深 Google Cloud 解決方案架構師與 GAS 開發專家(角色)+ 建置醫院顧客滿意度 AI 自動化分類、通知與統計分析系統(主題)+ 建置與部署指南(任務 & 對象)」,接著直接給完整 GAS 程式碼
Claude Code 的審核結果 :列出 7 個指令中缺漏的細節(API 金鑰怎麼藏起來,API 金鑰是呼叫 AI 服務的密鑰,等同密碼,外洩後別人會用你的帳號計費或濫用;AI 跑錯時怎麼處理、太多人同時用怎麼辦、歷史資料怎麼引用、輸出格式長什麼樣等),建議補齊
三種文件的差別 :Claude Code 解釋 CLAUDE.md(給 AI 看的長期記憶)、skill.md(給 AI 帶工具書)、SPEC.md(規格書)三者差別,建議這個案例用「規格書 SPEC.md」比較合適
關鍵心法 :讓 Claude Code 在寫程式前先審指令。它會主動列出你沒想到的缺口(權限、出錯怎麼辦、輸出格式),補完再開始寫程式可省下大量返工時間。
指令 4 · 階段 4 Claude Code
把規格書一次餵給 Claude Code 寫程式
審核完畢、指令凍結後,把規格書(SPEC.md)整份丟給 Claude Code,讓它一次寫完 Google Apps Script 程式 + 部署說明書。指令中指定的 gemini-2.5-flash 是 Google 一個輕量快速的 Gemini 模型版本,分類任務不需用到旗艦模型,flash 已綽綽有餘且省額度。
請依附上的 SPEC.md(已凍結)實作一套 Google Apps Script 系統。
技術要求:
- 觸發:Google Form 提交時自動執行
- 處理:呼叫 Gemini(模型用 gemini-2.5-flash)依規格書規則分類
- 寫回:把分類結果(類別、急迫性、重要性、判定理由、處理狀態、首次時間戳記)寫回原試算表
- 多分頁:自動建立「月報-類別」「月報-急迫性」「待辦清單」三個分析分頁
- 通知:急迫性 P0 + 重要性高 的案件自動 email 通知值班主管
- 錯誤處理:Gemini 跑錯時記錄到「處理狀態」欄位,標記重試,最多 3 次
請給我:
1. 完整 .gs 程式碼,功能分塊寫(表單提交 / 呼叫 Gemini / 寫回 Sheets / 寄通知 / 更新月報)
2. 部署說明書(取得 Gemini 金鑰、貼程式碼、設定何時自動執行、按授權鈕)
3. 設定參數說明(收件人 email、Gemini 金鑰存放位置等)
Claude Code 產出的部署 README :依步驟操作即可上線,每步都有具體操作指令(網址、按鈕位置、貼上的程式碼)
關鍵心法 :SPEC 凍結後再實作,Claude Code 不會偏題;明確要求「分模組」「附 README」「附參數說明」,產出的程式可立即上線且日後好維護。
指令 5 · 上線後維護
把分類結果開放回原試算表審視
上線後要人工抽樣校對 AI 分類品質。把判定理由、處理狀態、重試次數等過程資料都寫回原試算表,方便每天打開就能檢視。
在 Sheets 加入下列欄位,讓我能即時看到 AI 的判定結果:
- 類別 1 / 類別 2 / 類別 3(可同時涵蓋兩個主類)
- 急迫性(P0 / P1 / P2 / P3)
- 重要性(高 / 中 / 低)
- 判定理由(50 字內,寫出 AI 依據什麼下這個判斷)
- 處理狀態(等待中 / 已完成 / 重試 / 失敗)
- 重試次數
- 首次時間戳記
- 清洗後內容(若原內容需要清洗,把清洗後版本記錄這裡)
讓我每天打開 Sheets 就能抽樣校對。如果 AI 判定錯誤,我可以在原表上手動修改,作為下次精修指令的參考。
關鍵心法 :AI 系統上線後不是「裝完就忘」,要把判定依據 寫回原表,方便人工抽樣校對。發現 AI 判錯的案件累積成「邊界案例集」(也就是「不確定該歸哪類」的案例),定期回頭修指令,系統才會越用越準。