Hallmark audit 與 redesign 實戰：用 Codex 檢查並重構 AI 模板化網頁

Hallmark 的這個教學只處理標題中的具體任務。 Hallmark 的 audit、redesign 與 study 是三種不同動作；正確流程是先取得唯讀問題清單，再在獨立分支重構，最後用截圖、響應式和可訪問性檢查驗證。

以下所有操作都先放在測試儲存庫、測試帳號或僅回環監聽的服務中。指令中的網域名稱、使用者名稱、路徑與金鑰是佔位符，執行前需要替換。

audit、redesign、study 不要混用

這一節解決的是「audit、redesign、study 不要混用」。先記錄目前狀態，再執行最小動作，最後用獨立證據確認結果。

對 Hallmark 而言，判斷依據是：Hallmark 的 audit、redesign 與 study 是三種不同動作；正確流程是先取得唯讀問題清單，再在獨立分支重構，最後用截圖、響應式和可訪問性檢查驗證。不要在這個階段順手打開更多權限。

1

npx skills add nutlope/hallmark

執行後保留命令輸出和時間戳記。若輸出依賴目前終端機裡的臨時變量，開啟新終端複查一次。

為 audit 準備足夠具體的目標

按下面順序處理：

1. 讀取實際版本和目前配置。
2. 只改變與本節相關的一項設定。
3. 執行一個唯讀或可撤銷的請求。
4. 檢查日誌、退出碼和最終檔案。
5. 失敗時恢復剛才那一項修改。

1

git status --short

這裡的完成標準不是介面出現，而是「給 audit 準備足夠具體的目標」有可重複結果。

安裝 Skill 後檢查檔案來源

1

Get-ChildItem -Recurse $env:USERPROFILE\.codex\skills\hallmark

表格中的停止訊號一旦出現，先撤銷本節改動，不要繼續後面的自動化。

只讀審計應該輸出什麼

圍繞「只讀審計應該輸出什麼」準備一個成功樣本和一個失敗樣本。成功樣本驗證正常路徑，失敗樣本驗證限制是否真的生效。

1

hallmark audit ./src

建議記錄以下四項：

• 執行前的版本或 Git 提交。
• 實際輸入，不記錄秘密值。
• 可觀察的輸出、狀態碼或 diff。
• 恢復動作以及恢復後的複查結果。

如果失敗原因仍不清楚，每次只修改一個變數；不要同時更換連接埠、執行時間、Provider 和代理程式。

把問題清單依照影響排序

這一節解決的是「把問題清單依照影響排序」。先記錄目前狀態，再執行最小動作，最後用獨立證據確認結果。

對 Hallmark 而言，判斷依據是：Hallmark 的 audit、redesign 與 study 是三種不同動作；正確流程是先取得唯讀問題清單，再在獨立分支重構，最後用截圖、響應式和可訪問性檢查驗證。不要在這個階段順手打開更多權限。

1

git diff --stat

執行後保留命令輸出和時間戳記。若輸出依賴目前終端機裡的臨時變量，開啟新終端複查一次。

redesign 前儲存文案與資訊架構

按下面順序處理：

1. 讀取實際版本和目前配置。
2. 只改變與本節相關的一項設定。
3. 執行一個唯讀或可撤銷的請求。
4. 檢查日誌、退出碼和最終檔案。
5. 失敗時恢復剛才那一項修改。

1

git switch -c redesign/hallmark

這裡的完成標準不是介面出現，而是「redesign 前保存文案與資訊架構」有可重複結果。

在獨立分支中運作結構重做

1

hallmark redesign ./src

表格中的停止訊號一旦出現，先撤銷本節改動，不要繼續後面的自動化。

study 如何擷取設計語言而不抄頁面

圍繞「study 如何提取設計語言而不抄頁面」準備一個成功樣本和一個失敗樣本。成功樣本驗證正常路徑，失敗樣本驗證限制是否真的生效。

1

hallmark study https://example.com

建議記錄以下四項：

• 執行前的版本或 Git 提交。
• 實際輸入，不記錄秘密值。
• 可觀察的輸出、狀態碼或 diff。
• 恢復動作以及恢復後的複查結果。

如果失敗原因仍不清楚，每次只修改一個變數；不要同時更換連接埠、執行時間、Provider 和代理程式。

57 項 slop test 以外還要檢查什麼

這一節解決的是「57 項 slop test 之外還要檢查什麼」。先記錄目前狀態，再執行最小動作，最後用獨立證據確認結果。

對 Hallmark 而言，判斷依據是：Hallmark 的 audit、redesign 與 study 是三種不同動作；正確流程是先取得唯讀問題清單，再在獨立分支重構，最後用截圖、響應式和可訪問性檢查驗證。不要在這個階段順手打開更多權限。

1

git diff --check

執行後保留命令輸出和時間戳記。若輸出依賴目前終端機裡的臨時變量，開啟新終端複查一次。

用多視窗截圖比較前後結果

按下面順序處理：

1. 讀取實際版本和目前配置。
2. 只改變與本節相關的一項設定。
3. 執行一個唯讀或可撤銷的請求。
4. 檢查日誌、退出碼和最終檔案。
5. 失敗時恢復剛才那一項修改。

1

git diff --stat

這裡的完成標準不是介面出現，而是「用多視窗截圖比較前後結果」有可重複結果。

無障礙、效能和互動回歸

1

npm test

表格中的停止訊號一旦出現，先撤銷本節改動，不要繼續後面的自動化。

拒絕重構結果時如何乾淨回退

圍繞「拒絕重構結果時如何乾淨回退」準備一個成功樣本和一個失敗樣本。成功樣本驗證正常路徑，失敗樣本驗證限制是否真的生效。

1

git switch -

建議記錄以下四項：

• 執行前的版本或 Git 提交。
• 實際輸入，不記錄秘密值。
• 可觀察的輸出、狀態碼或 diff。
• 恢復動作以及恢復後的複查結果。

如果失敗原因仍不清楚，每次只修改一個變數；不要同時更換連接埠、執行時間、Provider 和代理程式。

品牌字體與顏色不能讓 Skill 猜

這一節解決的是「品牌字體與顏色不能讓 Skill 猜」。先記錄目前狀態，再執行最小動作，最後用獨立證據確認結果。

對 Hallmark 而言，判斷依據是：Hallmark 的 audit、redesign 與 study 是三種不同動作；正確流程是先取得唯讀問題清單，再在獨立分支重構，最後用截圖、響應式和可訪問性檢查驗證。不要在這個階段順手打開更多權限。

1

git grep -n -I -E 'font|color|brand' -- src

執行後保留命令輸出和時間戳記。若輸出依賴目前終端機裡的臨時變量，開啟新終端複查一次。

保留元件 API 還是重寫元件

按下面順序處理：

1. 讀取實際版本和目前配置。
2. 只改變與本節相關的一項設定。
3. 執行一個唯讀或可撤銷的請求。
4. 檢查日誌、退出碼和最終檔案。
5. 失敗時恢復剛才那一項修改。

1

git diff --name-status

這裡的完成標準不是介面出現，而是「保留元件 API 還是重寫元件」有可重複結果。

行動端不能只是桌面版縮放

1

npm test

表格中的停止訊號一旦出現，先撤銷本節改動，不要繼續後面的自動化。

把最終設計規則留在專案內

圍繞「把最終設計規則留在專案內」準備一個成功樣本和一個失敗樣本。成功樣本驗證正常路徑，失敗樣本驗證限制是否真的生效。

1

git diff --check

建議記錄以下四項：

• 執行前的版本或 Git 提交。
• 實際輸入，不記錄秘密值。
• 可觀察的輸出、狀態碼或 diff。
• 恢復動作以及恢復後的複查結果。

如果失敗原因仍不清楚，每次只修改一個變數；不要同時更換連接埠、執行時間、Provider 和代理程式。

Hallmark 常見問題

是否可以跳過測試環境，直接把 Hallmark 用到正式專案？

不建議。至少先完成一次最小成功請求、一次故意失敗和一次恢復演練。

Hallmark 指令能運作但結果不對，先查哪裡？

先查輸入範圍、實際生效的配置和上游響應，再查模型總結。進程正常不代表業務結果正確。

如何避免 Hallmark 的金鑰或令牌進入 Git？

使用系統環境變數、Secret 管理或專案外設定文件，並在提交前搜尋 diff。發現洩漏後必須輪換密鑰。

升級 Hallmark 時最容易漏掉什麼？

最容易漏掉配置格式、預設監聽位址、權限範圍和快取相容性。升級前儲存版本與驗證樣本。

Hallmark 驗收問題

完成後應能回答下面的問題：

• 使用的是哪個確切版本？
• 哪些目錄、連接埠、帳號和外部服務可被存取？
• 成功結果如何回到原始資料或 Git diff？
• 上游失敗時會報錯、重試還是切換？
• 金鑰是否可能出現在日誌或歷史記錄？
• 如何在十分鐘內回到修改前狀態？

如果其中任何一項無法回答，Hallmark 仍處於試用狀態，不應擴大權限或存取生產自動化。