讀完 Claude Design 那份提示詞，我回頭刪掉了自己 agent 一半的代碼
整理版優先睇
讀完Claude Design提示詞，作者反思並改善自己agent設計嘅五個要點
呢篇文章係由一位叫竇竇嘅AI愛好者分享，佢讀完Anthropic嘅Claude Design系統提示詞（被放上Gist）之後，對比自己寫嘅agent提示詞，發現好多不足，於是刪咗一半代碼重新改過。整體嚟講，作者認為一個好嘅agent提示詞應該係一份專業嘅SOP，包含工作流、提問規範、禁止清單、驗收標準同埋上下文管理，而唔係只係寫「請盡量優秀」呢啲空話。
作者從Claude Design嘅提示詞入面揀咗五個最有啟發嘅重點：第一係佢嘅六步工作流，包含獨立驗證步驟，避免自己查自己；第二係對新任務要求至少問10個問題，問完先停，唔準偷跑做初版；第三係一個叫snip嘅上下文清理工具，可以標記用完嘅消息，唔會突然失憶；第四係反「AI味」清單，禁止大面積漸變背景、亂放emoji、用預設字體等，強調每塊空間都要有理由；第五係將踩過嘅坑寫入提示詞，例如指定React版本、避免變量名衝突等。
最後，作者提出三件今晚就可以做嘅事：加驗收子步驟、將過去一週做錯嘅事寫成「唔準咁做」、強制新任務前先問5個問題。呢啲建議好具體，值得所有寫agent嘅人參考。
- 六步工作流包括獨立驗證，避免自檢查漏。
- 新任務至少問10個問題，唔好偷步出初版。
- 用snip工具管理上下文，唔會突然失憶。
- 反AI味清單：禁止亂放emoji、預設字體、填充內容。
- 將踩過嘅坑寫成具體禁止條款，例如鎖定版本、變量命名。
Claude Design System Prompt Gist
Claude Design嘅系統提示詞原文，由hqman上傳
工作流：六步標準化，包括獨立驗證
Claude Design嘅工作流分六步：先問清楚要做咩、用邊套UI套件、咩品牌；跟住讀完UI套件嘅完整定義；然後列計劃同待辦；之後建目錄、拷資源；再調用done將文件送到用戶面前；最後唔係自己驗證，而係派一個子智能體獨立跑一遍。作者之前做到第五步就收工，結果每次都有用戶糾錯——自己做完自己查，同自己改卷一樣冇用。
自己做完自己查，同自己改卷一樣冇用
提問規範：先問夠10個問題先好鬱手
Claude Design 要求喺做新嘢之前至少問10個問題，而且問完就停，唔準偷走去寫初版。作者反思自己嘅 agent 成日都係「我先做一版你睇睇」，表面上好似高效，其實係偷懶。用戶睇完初版再俾意見，然後返工，兩輪嘅活抵唔過問清楚一次做一輪。
問完就停，唔準偷跑去寫初版
上下文管理：用 snip 登記用完嘅訊息
每條用戶訊息帶一個id，agent 做完一階段就調用 snip(m0003, m0007) 話俾系統「呢段以後可以刪」。但注意——唔係立刻刪，係登記。等到上下文真係快滿咗，系統先一次過刪曬所有登記咗嘅 snip。好處係 agent 可以邊做邊標記「呢段用完了」，唔會突然失憶，亦唔會亂截斷。
唔係立刻刪，係登記；等到快滿先一次過執行
反「AI味」清單：每塊空間都要有理由
Claude Design 禁止咗好多常見嘅AI設計風格：大面積漸變背景、亂放 emoji（除非品牌本身就用）、「左邊一條色+圓角卡片」嘅容器、用 SVG 畫插畫（要畫都係佔位圖）、用 Inter / Roboto / Arial / Fraunces 呢啲字體。仲有一句更直接：一千個不，換一個是。唔好往設計度塞填充內容，每塊空間都要有理由。你覺得某處好空，係佈局未諗好，唔係叫你造啲文案去填。堆料唔係內容，係遮羞布。
堆料唔係內容，係遮羞布
將踩過嘅坑寫入提示詞：具體版本鎖定同變量命名
Claude Design 嘅提示詞入面有幾條「唔準咁做」好具體：React + Babel 必須鎖死確定嘅小版本加完整性校驗，唔好寫 react@18；唔好寫 const styles = {...}，因為多組件同名變量會撞車，要寫 const terminalStyles = {...}；多個 <script type="text/babel"> 作用域係隔開嘅，共享組件要用 Object.assign(window, {...})。呢啲細節對應嘅都係線上事故。作者話，好嘅提示詞係要將 agent 踩過嘅坑一條條堵返，唔係寫「請盡量優秀」呢啲空話。
每一條對應一次線上事故
1. 加驗收子步驟——唔畀 agent 自己話「完成」，叫另一個進程或 model 掃一遍先講。
2. 將 agent 過去一週做錯嘅三件事寫入提示詞，每件事寫成一條明確嘅「唔準咁做」，帶例子。
3. 做新嘢之前強制 agent 先問5個問題，問完停，等用戶回答，唔準先出初版。呢兩日我嘅時間軸畀呢個消息洗版：Anthropic 上線 Claude Design，Figma 同一日跌咗 12%。
但產品本身冇咁令我意外——真正令我停低嘅，係有人將佢嘅系統提示詞扒咗上 Gist。幾千字，我讀咗兩次，返去改自己嘅 agent。
揀五段最有用嘅，講下我改咗乜。
一、佢嘅工作流程係六步，唔係一步
接到需求行呢六步：
問清楚：要做啲乜、用邊套 UI 套件、咩品牌 讀完 UI 套件嘅完整定義 列計劃同待辦事項 建目錄、拷資源 調 done，然後將檔案送到用戶面前自己唔驗證，派一個子智能體獨立行一次
我之前嘅 agent 去到第 5 步就收工。返轉頭睇日誌，每次「任務完成」後面都跟住三條用戶糾錯。
原因好清楚：自己做曬自己查，同自己改卷一樣。
二、佢對提問嘅要求
做新嘢，原文要求至少要問 10 個問題。而且問完就停，唔準偷走走去寫初版。
我反思自己嘅 agent 成日係「我做一版畀你睇嚇先」——睇落好似高效，其實係偷懶。用戶睇初版再畀反饋，你再返工。兩輪嘅工夫，不如問清楚一次再做一輪。
三、一個叫 snip 嘅上下文清理工具
每條用戶消息都有個 id。agent 做完一個階段，叫 snip(m0003, m0007)，話畀系統聽「呢段以後可以刪」。
留意——唔係即刻刪，係登記。
上下文真係就快滿曬，系統先將所有登記過嘅 snip 一齊執行。
好處係 agent 可以一邊做嘢一邊標記「呢段用曬」，唔會突然失憶，亦唔會亂咁切斷。
四、反「AI 味」清單
呢段值得搞內容同搞設計嘅一齊睇。原文禁止：
大面積漸變背景 放 emoji（除非品牌本身就用開） 「左邊一條色 + 圓角卡片」嗰種容器 用 SVG 畫插畫（要畫都係佔位圖） Inter / Roboto / Arial / Fraunces 呢幾個字體
仲有一條更直接——一千個唔，換一個係。
唔好喺設計裏面塞填充內容，每塊空間都要有理由。你覺得某個位空，係佈局未諗好，唔係要你作文案去填。
堆料唔係內容，係遮醜布。
五、佢將踩過嘅坑寫咗入提示詞
三條「唔好咁做」特別具體：
React + Babel 一定要 pin 到確定小版本 + 完整性校驗。唔好寫 react@18。不要寫 const styles = {...}。多組件同名變數會撞車。要寫const terminalStyles = {...}。多個 <script type="text/babel">作用域係分開嘅。共享組件要Object.assign(window, {...})。
第一次讀覺得「都太仔細啦」。寫過 HTML 產物嘅都知道，每一條對應嘅係一次線上事故。
好嘅提示詞係咁樣——將 agent 踩過嘅坑一條條塞返埋。唔係寫「請盡量優秀」呢啲空話。
最後
寫 agent 唔係寫一個「聰明嘅助手」，係喺定義一個專業崗位嘅 SOP。
Claude Design 嘅 SOP 裏面有：崗位說明、六步工作流程、禁止清單、提問規範、驗收標準、上下文管理。
對比一下你自己寫嘅提示詞，有幾多條？
三件今晚就可以做嘅事
加驗收子步驟——唔畀 agent 自己話「完成」，要另一個進程或者模型 scan 完先算。 將 agent 過去一星期做錯嘅三件事寫入提示詞，每件事寫成一條明確嘅「唔好咁做」，帶埋例子。 做新嘢之前強制 agent 先問 5 個問題，問完就停，等用戶回答，唔準先出初版。
原文 Gist：https://gist.github.com/hqman/f46d5479a5b663c282c94faa8be866de
end.
能夠識別代碼裏面嘅坑、判斷邊條路值得行、將技術變成可用嘅嘢—呢啲 先係 AI 時代真正值錢嘅能力。
每星期幫你篩一次 AI 工具同技術更新，淨係留值得花時間嘅。遇到部署問題
、揀款糾結，直接問我。一杯奶茶錢，試一次先。
主理人介紹：竇竇，普通打工仔，同時係重度 AI 研究愛好者。日頭忙工作，夜晚忙搞工具、試方法、做內容
更鍾意分享我自己試過、踩過坑、最後覺得真有用嘅嘢
關注我，一齊將複雜嘅 AI，變成普通人都用得上嘅日常。
這兩天我的時間線被這個消息刷屏了： Anthropic 上線 Claude Design，Figma 同一天跌 12%。
但產品本身沒那麼讓我意外——真正讓我停下來的，是有人把它的系統提示詞扒到 Gist 上了。幾千字，我讀了兩遍，回去改自己的 agent。
挑五段最有用的，說說我改了什麼。
一、它的工作流是六步，不是一步
接到需求走這六步：
問清楚：要做什麼、用哪套 UI 套件、什麼品牌 讀完 UI 套件的完整定義 列計劃和待辦 建目錄、拷資源 調 done，把文件送到用戶面前自己不驗證，派一個子智能體獨立跑一遍
我之前的 agent 到第 5 步就收工。回頭翻日誌，每次"任務完成"後面跟着三條用戶糾錯。
原因很清楚：自己做完自己查，跟自己改卷子一樣。
二、它對提問的要求
做新東西，原文要求至少問 10 個問題。而且問完就停，不允許偷跑去寫初版。
我反思自己的 agent 經常是"我先做一版你看看"——看着像高效，其實是偷懶。用戶看初版再反饋，你再返工。兩輪的活，抵不過問清楚一次再做一輪。
三、一個叫 snip 的上下文清理工具
每條用戶消息帶一個 id。agent 幹完一階段，調 snip(m0003, m0007)，告訴系統"這段以後可以刪"。
注意——不是立刻刪，是登記。
上下文真的快滿了，系統才把所有登記過的 snip 一起執行。
好處是 agent 可以一邊幹活一邊標記"這段用完了"，不會突然失憶，也不會亂截斷。
四、反"AI 味"清單
這段值得搞內容和搞設計的一起看。原文禁止：
大面積漸變背景 放 emoji（除非品牌本來就用） "左邊一條色 + 圓角卡片"那種容器 用 SVG 畫插畫（要畫也是佔位圖） Inter / Roboto / Arial / Fraunces 這幾個字體
還有一條更直接——一千個不，換一個是。
不要往設計裏塞填充內容，每塊空間都要有理由。你覺得某處空，是佈局沒想好，不是讓你造文案去填。
堆料不是內容，是遮羞布。
五、它把踩過的坑寫進了提示詞
三條"不要這樣做"特別具體：
React + Babel 必須 pin 到確定小版本 + 完整性校驗。不要寫 react@18。不要寫 const styles = {...}。多組件同名變量會撞車。要寫const terminalStyles = {...}。多個 <script type="text/babel">作用域是隔開的。共享組件要Object.assign(window, {...})。
第一次讀覺得"也太細了"。寫過 HTML 產物的都知道，每一條對應的是一次線上事故。
好的提示詞長這樣——把 agent 踩過的坑一條條堵回去。不是寫"請儘量優秀"這種空話。
最後
寫 agent 不是寫一個"聰明的助手"，是在定義一個專業崗位的 SOP。
Claude Design 的 SOP 裏有：崗位說明、六步工作流、禁止清單、提問規範、驗收標準、上下文管理。
對比一下你自己寫的提示詞，有幾條？
三件今晚就能做的事
加驗收子步驟——不讓 agent 自己說"完成"，讓另一個進程或模型掃一遍再說。 把 agent 過去一週做錯的三件事寫進提示詞，每件事寫成一條明確的"不要這樣做"，帶例子。 做新東西之前強制 agent 先問 5 個問題，問完停，等用戶回答，不允許先出初版。
原文 Gist：https://gist.github.com/hqman/f46d5479a5b663c282c94faa8be866de
end.
能識別代碼裏的坑、能判斷哪條路值得走、能把技術變成可用的東西—這 些才是 AI 時代真正值錢的能力。
每週幫你篩一遍 AI 工具和技術更新，只留值得花時間的。遇到部署問題
、選型糾結，直接問我。一杯奶茶錢，先體驗一次。
主理人介紹：竇竇，普通打工人，也是重度 AI 研究愛好者白天忙工作，晚上忙折騰工具、試方法、做內容
更喜歡分享 我自己試過、踩過坑、最後覺得真有用的東西
關注我，一起把複雜的 AI，過成普通人也能用上的日常。