AGENT SKILL 一日工作坊 · 案例單元

本機做的漂亮頁面，一句話變成能傳給客戶的網址

AI 兩分鐘生一頁漂亮的 HTML，卻只能在你電腦上打開。這支 skill 一句「幫我部署」，就變成能直接傳出去的網址。

7 頁 · 案例單元 cloudflare-deploy · 純文字 skill 素材來源：Ordilux 自用
aha：本機只有你看得到的頁面，一句「幫我部署」，幾秒變成能貼給客戶的網址。

先講清楚痛在哪

頁面做得美美的，卻只有你打得開

AI 生一頁漂亮文件，兩分鐘就好。難的不是做，是怎麼送到客戶眼前。

🖥️ 只有本機打得開

網址是 file:///…，換台機器、傳出去就打不開。

📎 傳檔給客戶超不專業

寄 .html 過去，對方雙擊常開不出來、圖跑掉、樣式壞。第一印象就毀了。

🧱 自己架上線又太重

得碰 wrangler、Cloudflare 設定、認證坑。為一個一次性頁面搞這些，沒人想做。

真相是：做出漂亮頁面已經很簡單。難的是怎麼體面地送到對方眼前。

同一件事，兩種人生

手動部署 vs 有 skill

同一個目標：本機頁面變成能傳出去的網址。左邊徒手做，右邊一句話。

😰 手動，每次都這樣

  • 先想起來「上 CF 要用 wrangler」
  • 查文件：create 還是 deploy？參數怎麼帶
  • 跑下去，撞 Not logged in 認證錯誤
  • Google 半天才知道要設環境變數
  • 拿到 xxx.pages.dev，但對外該給哪個？

😌 有 skill，一句話

  • 「幫我把這個網頁部署上去」
  • skill 自動判斷：獨立站還是內部文件中心
  • 認證？它早設好了，你不會看到那行錯誤
  • 整包上傳，沒動到的地方不受影響
  • 直接回報 docs.ordiluxcorp.com 正式網址
差別不在快多少，而在「不必懂」。skill 把五步壓成一句話，連你不知道會踩的坑都先替你閃掉。

把抽象的「部署」拆開

這支 skill 裡，到底封了什麼

「部署」聽起來是一個動作，其實是四塊知識。skill 把這四塊一次扛掉。

① wrangler ＋ CF Pages
底層的工具與平台。該下哪個指令、帶哪些參數，skill 替你記。
② 認證處理
非互動環境的 token 坑，一行環境變數解掉。整支 skill 最值錢的一行。
③ 兩種模式
內部文件中心走 A，一次性獨立站走 B。skill 替你判斷走哪條。
④ 回報正式網址
不報 pages.dev，報綁定好的正式網域。對外該給哪個都幫你想好。
模式 A

內部文件中心
文件進專案子目錄，部署到 docs 站。多數走這個。

模式 B

獨立站
HTML 或資料夾丟成獨立 Pages 站。臨時預覽用。

判斷一句

內部專案文件走 A，其他走 B。這條判斷 AI 自己分。

部署不是魔法，是四塊知識。skill 把這四塊「踩過才知道」的眉角寫成明文，交給 AI 執行。

一個真實的坑，被一行解掉

「明明登入了，卻說沒登入」

整支 skill 最珍貴的一段：一個你第一次絕對會中、Google 半天才查到的坑。

🕳️ 坑長這樣

  • wrangler 明明 OAuth 登入過了
  • 但在 AI 跑的非互動 shell 裡
  • 部署時噴 Not logged in... non-interactive
  • 詭異的是 whoami、建專案都正常，只有部署卡

第一次碰的人，在這卡上半小時，反覆懷疑自己沒登入。

🔑 skill 怎麼收掉

  • 部署前先把 OAuth token 設成環境變數
  • 就這一行，認證錯誤永遠不再出現
  • 還寫死紀律：絕不 echo token、絕不寫進 git
  • token 約一小時過期，連備援方案都寫好了

你不會看到這錯誤，skill 替你先設好了。坑被固化成「不再踩」。

這就是 skill 真正的威力。它把一個踩過、痛過的真實坑，連同解法、紀律、備援永久封存。你省下的不是打字，是那半小時的鬼打牆。

收斂成一個動作

一行 deploy，自動印出正式網址

前面四塊知識，收斂成一支腳本。你說要部署，剩下三件事一氣呵成。

# 你只說一句
「幫我把這份文件部署上去」

# skill 在背後跑這支腳本
bash deploy-docs.sh wutai/p4/

  ① 載入認證
     → 設好 token，閃過認證坑
  ② wrangler pages deploy
     → 整包上傳，覆蓋式
  ③ 印出正式網址
     → docs.ordiluxcorp.com/...
整包覆蓋，互不干擾
整包上傳，你這次沒動到的其他文件原封不動。不怕誤傷。
報正式網域，不報 pages.dev
一律回報綁定好的 docs.ordiluxcorp.com，不丟原廠 pages.dev。對外網址不會給錯。
你拿到的是一條能點的連結
不是一堆 log，是能直接貼給客戶、貼進 Slack 的正式網址。
從「只有我看得到」到「一條能傳給客戶的網址」，就是這一頁。你說一句話，拿回一條能點的正式連結，中間那些坑一個都不必經過。

帶回去用

你做的任何網頁，都能這樣上線

✅ 任何 HTML 都適用

這份簡報、一份報價單頁、一個活動頁，做好就一句「幫我部署」，立刻拿到對外網址。

📐 學它怎麼封坑

真正教的不是 CF，是一種寫法：把踩過的坑、解法、紀律寫進 skill。下次同樣的坑，AI 自動替你閃。

素材來源：cloudflare-deploy 是 Ordilux 自用的部署 skill，封裝公司帳號設定、文件中心結構與認證解法。屬內部資產，這裡作為「把坑固化成 skill」的教學範例。
Agent Skill 工作坊 · 案例單元 · Cloudflare 部署