一個人的廣告公司 (Agency of One)
為何存在
當被要求做一個網站時,模型會產出「最可能」的網站。即使禁止那種樣子,也只會換成第二可能的那種(奶油色 + 襯線字體 + 黏土風、黑色 + 螢光綠、全大寫的眉毛、連結上的 →:第二波 AI 味)。而且「創意」也不是解方:商業網站必須看起來像 一家頂尖廣告公司製作的,可信且精緻,所有元素都到位。
優先順序:1) 對客戶而言美麗且正確,2) 清晰且可信,3) 有區別度(不像 AI 做的)。 避免 AI 味是必要但不充分條件:一個有區別度但平淡或偏離品牌的頁面,就是失敗。
因此,這個技能 從客戶已有的品牌出發,把風險最高的選擇權從開發者手中拿走,並要求最終產出達到世界級的完成度與美感標準:
- 客戶的品牌與資產優先,然後才是策略:Logo 顏色、真實照片、參考資料、定位、證明、品牌想法。
- 真正的隨機性,品牌鎖定的色彩:一個腳本會決定佈局、品牌裝置、色彩策略、字體策略。當有客戶 Logo 時,顏色從 Logo 來;否則從一個經過策展且通過對比檢查的色板庫中選取,絕不依賴模型的品味。
- 一位獨立評論者 會為五個方向評分「典型性」與「強度」;腳本會從中挑選「非典型且強而有力」的方案。
- 一套工藝標準 (
craft.md) 和一個 在隔離狀態下先建構的英雄元素。 - 你無法反駁的檢查:每次編輯的 lint、渲染後的測量、計畫與渲染的差異比較、跨專案記憶、渲染後的美感檢查,以及盲審評論者先對「渴望度」和「品牌契合度」評分,再評工藝與區別度。
當規則衝突時,以此順序為準: 客戶的簡報與品牌資產 > 美感 (craft.md 優先順序, §2b) > 抽到的色板與卡片 > 避免 AI 味清單。任何卡片或避免 AI 味的規則,都不能用來合理化更醜或偏離品牌的東西。
$S = 此技能的資料夾:Claude Code 載入技能時的基底目錄(作為插件時為 ${CLAUDE_PLUGIN_ROOT}/skills/agency-of-one;作為直接放入時為 .claude/skills/agency-of-one 或 ~/.claude/skills/agency-of-one)。從 repo 根目錄執行腳本:node $S/scripts/<name>.mjs。Session hook 會印出腳本的絕對路徑;將這個絕對路徑傳遞給每個子代理(它們無法自己解析 $S)。絕對不要開啟 references/decks.json。 卡片僅來自腳本。
模式
- Agency(預設): 商業導向、專業、精緻。請閱讀
references/agency.md。 - Expressive(
--mode expressive): 僅在簡報要求實驗性、藝術性、編輯、活動或事件風格時使用。它使用非網頁的參考媒體與限制;請閱讀references/process-notes.md。
門檻檢查 (Gate)
DESIGN.md已經存在 → 完全遵循它;直接進入第三階段。提案修改時請先提出;絕對不能默默偏離。如果其中沒有<!-- agency-of-one design v1.1 -->標記,代表它早於品牌優先色彩: 執行brand-extract.mjs;如果色板與品牌資產衝突(plan-diff 會報告衝突),在據以建構之前,先向使用者提案 §4 的色彩修改。- 簡報已指定方向或品牌指南 → 簡報優先,即使它指名了某個已知的 AI 味。記錄下來(以及 §9 中的例外);直接進入第三階段。
- 其他情況 → 執行第一、二階段,即使是「小」頁面也一樣。
每個 repo 設定一次: npm i -D playwright && npx playwright install chromium(作為 devDependency,這樣之後的 npm i 就不會刪除它)。
第一階段:資產、品牌、策略 (DESIGN.md §1)
- 真實資產:先問 (agency.md 步驟 0)。Logo、人物照片、生平事實、客戶名稱或案例研究、聯絡與法律資訊、真實數字、產品截圖。在盲審中,沒有這些東西,即使設計再好,可信度與圖像感也會卡在 6/10 左右。缺失的項目會變成專業的 佔位符 (agency.md 步驟 5),你的報告要優先說明需要提供什麼。
- 你已經擁有的品牌 (agency.md 步驟 0a)。如果有 Logo、企業標誌、現有網站或人物照片,請執行
node $S/scripts/brand-extract.mjs(自動發現,或傳入路徑)。它會寫入.design-review/brand.json;從那時起draw.mjs會自動 鎖定品牌,且 plan-diff 會對任何失去 Logo 顏色的色板標記失敗。有人參與:用一行話向使用者確認提取到的品牌顏色。絕對不能對抗品牌自己的顏色。 - 參考資料(有人參與): 詢問 2–3 個客戶覺得漂亮的網站(任何行業)。將截圖儲存在
design-references/。評論者會以此為比較基準。它們設定的是品質標竿,而非外觀。 - 人類品味(僅有人參與): 問一次,「你欣賞的 2–3 個品牌或物品,以及一個你不想與之相似的競爭對手網站。」
- 策略 (agency 模式, agency.md 步驟 1):定位語句、一個信念、5 個類別代碼標記為保留/打破(打破 ≥ 2)、品牌想法、帶有「但不」的個性、證據清單(絕不憑空發明證據)。
- 主題清單: 8 個以上來自客戶世界的真實產品、地點、材質與日常事物(expressive 模式需 12 個以上)。在 agency 模式中,這些用來引導圖像方向、品牌裝置與文案,而非裝扮。
- 以品牌語氣草擬英雄句子與主要行動標籤。 可以在抽牌後再潤飾。
第二階段:抽牌 → 基準 → 發散 → 評論 → 挑選 → 提交
2a. 抽牌。 執行 node $S/scripts/draw.mjs --project "<name>"(預設為 agency 模式)會發出一張品質參考、佈局系統、品牌裝置、色板策略與字體策略。當 .design-review/brand.json 存在時,色彩會自動鎖定品牌(僅能以 --no-brand "<reason>" 覆蓋,例如客戶要求的品牌重塑);否則來自一個經過策展且通過對比檢查的色板庫:美麗的起點,絕非原始隨機色調。將其貼入 DESIGN.md §2。允許一次附帶書面理由的否決:--redraw <slot>。如果某張卡片要求使用避免 AI 味清單上的項目(例如可見的網格),則允許作為卡片強制的例外:在 §9 中記錄為 card: <reason>,並將其作為結構而非裝飾來執行。
2b. 基準線。 寫出兩個孿生版本:AI 孿生(模型會為此簡報製作的東西:字型、色碼、英雄、區段)以及,在 agency 模式下,廣告公司老套孿生(那種獎項導向的版本)。將兩者與 references/tells.md 比對。
2c. 發散。 在 .design-review/directions.md 中寫出 5 個方向 (A–E),並附上簡短的摘要與 §1 的清單。每個方向都需要:品牌想法的表達方式、每個抽到的槓桿如何應用、英雄佈局(一個 ASCII 線框草圖)、字型 類別(尚未指定具體字型)、色板草稿,以及品牌裝置。不要自己為它們打分。 至少有 3 個方向必須在頁面架構上有差異,而不只是外觀。
2d. 獨立評論者。 執行 direction-critic 子代理(在插件系統中為 agency-of-one:direction-critic),只給它路徑。它會為每個方向回傳「典型性 t」與「強度 s」,以及一個 PICK_ARG。
2e. 挑選。 執行 node $S/scripts/draw.mjs --pick "<PICK_ARG>"。在 agency 模式下,它會挑選最強的方向(s ≥ 8,且與最佳值差距在 0.5 以內),僅排除那些明顯平庸的(t ≥ 0.7)。在 expressive 模式下,它會偏好非典型的。結束代碼 3 代表沒有方向符合資格:寫出 3 個新方向(融入評論者的 STRONGEST_IDEA_TO_STEAL),然後重新執行評論者。建構腳本挑選的方案。 有人參與:用一行話向使用者展示被選中的方案與第二名,讓使用者可以覆蓋。
2e′. 英雄合成圖(美感門檻)。 在提交之前,為被選中的方案 和 第二名方案建立英雄區塊(摺疊處 + 第一屏,包含桌機與手機版),使用真實資產,做成兩個快速的靜態合成圖。對兩者進行截圖(screenshot.mjs --file comp-a.html comp-b.html),然後給一個全新的 design-reviewer 只看兩者的摺疊處與手機摺疊處圖片,不加標籤,並問一個強制選擇:哪一個會讓客戶更自豪地分享出去,為什麼? 建構被選中的那個。如果評論者認為兩者都很平淡或偏離品牌,則應重新抽牌,而不是潤飾。
2f. 差異比較。 在 DESIGN.md §3 的表格中,填寫與兩個孿生版本相比的差異。任何匹配的軸向都必須改變,除非簡報要求保留。互換測試:換上競爭對手的名字也說得通嗎?如果是,則從 §1 中提取更多獨特性。
2g. 提交代幣。 完成 templates/DESIGN.md → DESIGN.md,包括 機器可讀的 tokens 區塊,供 plan-diff 讀取。
- 字型:
references/typography.md。用node $S/scripts/type-specimen.mjs渲染你的候選清單,然後用看的來選擇。使用一個比例尺;將流動的顯示尺寸標記為fluid。 - 色彩: 從 brand.json 的提案(或策展色板)開始:品牌色 verbatim、品牌文字色用於淺色背景上的文字、深/淺色調、帶色調的中性色與墨色 (craft.md §4)。測試 AA 對比度。保持 Logo 色彩可辨識。
- 重複檢查: 執行
node $S/scripts/designlog.mjs check --project "<name>" [--brand-locked] --display … --body … --ground … --accent … --layout … --medium "<composition or primary medium>"。如果回報 REPEAT,則改變重複的軸向。
第三階段:依照工藝標準建構
3a. 先隔離建構英雄區塊。 只建構英雄區塊(agency 模式:完美執行抽到的佈局;expressive 模式:簽名式機制)。對其截圖(screenshot.mjs,加上 --state 處理互動狀態),並反覆迭代直到它在 references/craft.md 的每個相關工藝軸上都能得分 ≥ 8。只有這樣才能建構其餘部分。
3b. 建構頁面,僅使用代幣(CSS 變數 / Tailwind v4 @theme),遵循 agency.md 步驟 3 的架構或 expressive 的骨架。shadcn/Radix 只提供行為;重新設計每個基礎元件的樣式。文案要具體、使用句子大小寫,且符合品牌語氣;證據必須是真實的或佔位符。Lint hook 會在每次編輯時標記 AI 味,所以一出現就修復它們。
3c. 完成度檢查。 逐條檢查 references/craft.md §1–10:字體細節、網格審計、節奏、色彩與對比、圖像與佔位符、動畫與狀態、在 1440/1024/768/390 尺寸下的響應式佈局、文案編輯(精簡 30%)、技術完成度。這個環節正是讓頁面看起來像是「廣告公司製作的」的關鍵。不要跳過。
第四階段:驗證(最多 3 輪,保留最佳版本)
- 先快照: 在每輪之前提交(或複製)當前狀態,以便能回復到較差的修訂版。
- 執行
node $S/scripts/slop-lint.mjs:零錯誤;每個警告必須在 §9 和slop-lint.config.json中修正或說明理由。 - 執行
node $S/scripts/screenshot.mjs --url <dev url> --routes / /about …(或靜態頁面使用--file index.html about.html …;每個頁面,不只是首頁)--state <name>=click:<sel>|hash:<#id>|scroll:<sel>|hover:<sel>,為每個簽名狀態進行截圖。檢查 摺疊處、手機摺疊處、scroll50 以及狀態截圖。 - 執行
node $S/scripts/plan-diff.mjs:Logo 色彩要在色板中,計劃的字型已載入,色板已渲染,比例尺已應用,沒有計畫外的底色,以及在桌機和 390px 下的美感檢查:沒有因動畫而隱藏或需 JS 才可見的內容,沒有初始頭像,一致的照片群組(裁切、大小、背景),沒有置中多行文字,沒有全大寫標籤,沒有分隔線,每個頁面都有設計過的頁首。 - 盲審: 子代理
design-reviewer(在插件系統中為agency-of-one:design-reviewer)只會收到 URL 或檔案、路由,以及.design-review/。它會先對渴望度和品牌契合度評分,然後再對工藝與區別度評分,並與design-references/中的參考資料進行比較(如果有的話)。SHIP 的條件是渴望度、品牌契合度及每個工藝軸都 ≥ 8。多頁面網站的評判標準是其最弱的一頁。 - 修復並重新渲染。僅當修訂版的分數高於前一個最佳版本時才保留它。 3 輪後停止,並報告仍然未解決的問題。
- 鏡像(精簡): 移除一個不服務於品牌想法的裝飾元素;在 DESIGN.md §11 中記錄。
- 記錄: 執行
node $S/scripts/designlog.mjs add --project "…" …與 check 相同的旗標… --media "<draw summary>" --signature "<device / set piece>"(使用--log <path>將記錄保留在 repo 中)。 - 報告: 方向(一行)、品牌想法、簽名元素、lint/plan-diff/審查結果(附上工藝分數)、未解決的例外、每個需要客戶填寫或確認的佔位符與假設。
參考檔案
| 檔案 | 使用時機 |
|---|---|
references/agency.md | Agency 模式:策略、識別系統、商業架構、佔位符、可信度 |
references/craft.md | 3a, 3c, 第四階段:完成度標準、對齊、照片系統、頁面頁首、評分 |
references/patterns.md | 3b:經過驗證的人物網格、頁面頁首、證明區塊、活動、捐贈、表單的 recipe |
references/palettes.json | 策展色板庫(由 draw.mjs 讀取;你可以瀏覽它) |
references/tells.md | 2b, 2f, 第四階段:AI 味(第 1–3 代)及其特徵與來源 |
references/typography.md | 2g:字型流程、來源、授權、比例尺 |
references/process-notes.md | Expressive 模式:解讀卡片;實際範例 |
templates/DESIGN.md | 2g |