改善
路徑：${CLAUDE_SKILL_DIR} 代表包含此 SKILL.md 的資料夾，而 ${CLAUDE_SKILL_DIR}/../.. 代表編輯器位於該資料夾上兩層的 .claude/ 資料夾。
所有對使用者的提問都請放在問題框中：使用 AskUserQuestion 工具（提供 2-4 個選項，建議選項排第一位）。只有在不具備該工具的代理程式中，才以文字方式提出編號問題。
此技能在儲存庫的檢出副本中執行，供維護該儲存庫的人使用。在此處進行的修正，將在所有使用者下次更新時生效。S="${CLAUDE_SKILL_DIR}/scripts"。在 Mac 和 Linux 上使用 python3 執行腳本，在 Windows 上使用 py 執行。
0. 誰在執行此技能
python3 "$S/improve.py" mode
maintainer：僅在設定 AI_EDITOR_MAINTAINER=1 的儲存庫 git 檢出副本中執行：請繼續進行步驟 1。
user：編輯器本身的檔案會在每次更新時被取代，因此絕對不要編輯它們（不得編輯 SKILL.md、參考文件、腳本或 PRINCIPLES.md）。請按照以下方式收集並挑選，然後將每個接受的項目儲存在使用者自己的圖層中，該圖層不會被更新觸及（儲存庫中的 docs/customise.md）：
- 一個設定，使用
taste.py add ... --set； - 一個單字規則，使用
python3 "${CLAUDE_SKILL_DIR}/../../lib/ai_editor/custom.py" rule "<rule>"； - 一個字幕外觀，儲存為
custom/captions/<name>.json加上taste.py set captions.preset <name>； - 範本預設值，儲存為
custom/templates/<type>.json。
然後提供 taste.py suggest，以便維護者可以為所有人修復問題。在此停止。
1. 收集
python3 "$S/improve.py" collect [--edits D] [--no-gh]
一行一條規則，最常重複的排在最前面：出現次數、來源（建議、品味回歸、預覽修正、審閱筆記、GitHub issue）、所屬擁有者名稱，以及最多三個範例。由多位使用者提出，或是在套用後又被提出的規則會優先顯示。
2. 挑選
顯示佇列頂端的項目，並在問題框中詢問現在要修正哪一個（多選，最常重複的排第一位，建議選項）。對於每個項目，如果資訊不明確，也請一併詢問：每位使用者（建議選項） / 僅限部分創作者的風格（這屬於 style.json 欄位，而非規則） / 不修正（關閉）。
3. 依序修正每個項目
- 規則。 在
${CLAUDE_SKILL_DIR}/../../PRINCIPLES.md的適當標題下一行，說明在何處實施，以及相同的規則也納入所屬的 SKILL.md 或參考文件中。規則應具有通用性，永遠不要針對單一影片：例如「縮放淡入淡出至少需要 0.5 秒」，而不是「0:12 的縮放太突然」。 - 實施方式。 讓規則得以強制執行、無需任何人記憶的最小程式碼：在檢查腳本（
check.py、quality.py、product.py check、ai_tells.py）中出現的 FAIL、在可能違反規則的腳本中出現的拒絕（gates.py）、一個無法產生違規情況的預設值，或是針對儲存庫規則在tests/check_plugins.py中新增的一行。優先考慮加強現有檢查，而非新增檢查。 - 測試。 在該腳本的
demo()（或tests/）中新增一個斷言，基於一個小的合成失敗範例來建置。在修正前執行測試，確認它會失敗；然後在修正後執行，確認它會通過。只有代理程式才能遵循的規則（需要提問或說明），則改為在evals/中建立評估案例：包含prompt.md以及tool_used或llm評分器。 - 記錄。 在
docs/feedback-matrix.md中記錄：規則、規則寫在哪裡、由什麼機制執行、有哪些測試。
4. 執行所有項目
python3 tests/check_plugins.py
python3 .claude/lib/ai_editor/okf.py check
然後執行 tests/demos.sh（每個腳本的展示）、node tests/test_record.mjs，以及如果渲染器已設定，則執行 tests/smoke.py 和 tests/golden.py。全部通過後才能交接。請勿提交變更；維護者會審閱差異並提交。
對於現在已修正的 GitHub issue，在詢問後，可以提議在 issue 中留言一行摘要說明修正內容並關閉它（gh issue close <n> --comment "..."）。
絕對禁止
- 絕對不要編輯使用者的 taste.md、taste.json、rules.json 或 suggestions.jsonl：這些是屬於他們的檔案。
- 絕對不要將個人資料放入儲存庫中：不得包含姓名、帳號、電子郵件、檔案名稱或來自回饋的影片素材。請撰寫通用規則和合成範例。
tests/check_plugins.py會對已知的私人名稱檢查失敗；在放入每個範例前，請先仔細閱讀。 - 絕對不要僅靠一則筆記就結束一個問題的處理。一個沒有實施機制和測試的規則不算完成。
檔案
scripts/improve.py：mode、collect、demo。僅供讀取。${CLAUDE_SKILL_DIR}/../../lib/ai_editor/custom.py：使用者的<library>/custom/資料夾（使用者模式會寫入此處）。${CLAUDE_SKILL_DIR}/../../skills/taste/scripts/taste.py：suggest和issue會將使用者端的資料寫入此處。