메뉴
維護本專案 AI agent harness（AGENTS.md / CLAUDE.md / GEMINI.md / .agent/{rules,skills,workflows} / docs/wiki）的 SOP：單一事實來源對照表、drift 稽核步驟、新增/刪除 skill 的判準、wiki 同步機制。當使用者提到「更新 harness、同步 AGENTS、文件過時、drift、稽核設定檔、整理 skills、維護 wiki」時觸發。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
建立本專案的 Pull Request：雙語描述 (zh-TW/en)、gh CLI、.agent/skills/pull-request/scripts/check-pr.sh 預驗證、references/pr_template.md 與 checklist.md。當使用者提到「開 PR、建 PR、create PR、pull request、提交變更、發 PR、新建 PR」時觸發。
本專案 (MV3 Chrome extension) 的除錯紀律與 playbook：先重現再修、證據優先於模式匹配、單變因修改、跨 context 時序問題、service worker 終止、storage 問題、flaky E2E 分流。當使用者提到「除錯、debug、壞掉、不會動、修不好、查原因、root cause、flaky、時好時壞」時觸發。
交付前驗證紀律：依變更類型選擇最小充分驗證組合（unit / 目標 E2E / happy-path CI / make build）、Makefile 打包檢查、i18n 連動、GEMINI.md key_files 同步、誠實回報。當使用者提到「驗證、收尾、完成了嗎、可以交付嗎、送 PR 前、檢查一下」或任何實作即將收尾時觸發。
清理已合併進 main 的本地與遠端 git 分支。本專案採 squash merge，PR 合併後特性分支可直接刪除。當使用者提到「清理分支、cleanup branches、刪除舊分支、清掉已合併分支、整理 branch」時觸發。
本專案 (Manifest V3 Chrome extension) 的 commit 規範與範例：subject 使用英文 Conventional Commits、body 使用繁中說明背景與原因。當使用者提到「commit、提交訊息、commit message、寫 commit、commit 規範」時觸發。
撰寫本專案的 PRD (產品需求文件)，位置為 /docs/specs/{type}/{ID-PREFIX}_{desc}/PRD_spec.md。當使用者提到「PRD、產品需求、需求文件、寫規格、新功能規劃、acceptance criteria」時觸發。分級 SDD 之 T2（完整流程）的 Phase 1，產出物提供給 sa skill 銜接；T1 輕量案件不需獨立 PRD。
| name | harness-maintenance |
| description | 維護本專案 AI agent harness（AGENTS.md / CLAUDE.md / GEMINI.md / .agent/{rules,skills,workflows} / docs/wiki）的 SOP：單一事實來源對照表、drift 稽核步驟、新增/刪除 skill 的判準、wiki 同步機制。當使用者提到「更新 harness、同步 AGENTS、文件過時、drift、稽核設定檔、整理 skills、維護 wiki」時觸發。 |
Harness（agent 設定檔與知識庫）不維護就會腐爛：檔案改名了文件還指舊名、流程改了三份副本只改一份。過時的指示比沒有指示更危險——agent 會自信地照著錯的做。本 skill 定義稽核與維護 SOP。
| 主題 | 單一事實來源 | 其他副本（只放摘要+指標） |
|---|---|---|
| 檔案級模組職責 | GEMINI.md key_files | AGENTS.md（目錄級）、RULE_002（不變式） |
| SDD 流程細節 | .agent/skills/sdd/SKILL.md | RULE_007、.agent/workflows/sdd-process.md、AGENTS.md |
| E2E 測試模式 | .agent/skills/puppeteer-test/SKILL.md | .agent/workflows/puppeteer-test.md |
| CI 測試穩定性 8 條方針 | .agent/workflows/review-pr.md | code-review skill（節錄） |
| Commit / PR / Release 規範 | 各對應 skill | RULE_004、CLAUDE.md §1 |
| 建置指令 | Makefile（程式即文件） | RULE_003、AGENTS.md Quick Start |
| 人類導向專案文件 | docs/wiki/（經 Action 同步至 GitHub Wiki） | — |
同步規則：改 SSOT 時，順手檢查右欄副本的摘要是否還成立；副本永遠不寫 SSOT 沒有的細節。
.claude/skills 與 .gemini/skills 都是指向 .agent/skills 的 symlink——skill 只需改一處。
# 抽出 .md 中的 modules/ 路徑並檢查存在
grep -rhoE '(modules|usecase_tests|scripts|docs)/[A-Za-z0-9_/.-]+\.(js|mjs|md|sh)' \
AGENTS.md CLAUDE.md GEMINI.md .agent/rules .agent/skills --include='*.md' \
| sort -u | while read f; do [ -e "$f" ] || echo "MISSING: $f"; done
npm run * 是否存在於 package.json scripts？make target 是否存在於 Makefile？CLAUDE.md §0 對齊。值得新增的 skill 具備：
應該刪除的 skill 特徵（判例：2026-07 刪除 ui-ux-pro-max，560KB 通用 CSV 資料庫、13 種與本專案無關的 tech stack、需 Python 執行環境）：
新 skill 一律放 .agent/skills/<name>/（symlink 自動讓 Claude/Gemini 同步看到），並同步：
AGENTS.md Skills 表格加一列；2. CLAUDE.md §0 觸發關鍵字表加一行；3. 用 python3 .agent/skills/skill-creator/scripts/quick_validate.py 驗證結構。刪除 skill 時反向清理同三處。docs/wiki/（wiki-as-code）；push 到 main 時由 .github/workflows/wiki-sync.yml 自動同步到 GitHub Wiki。docs/wiki/*.md 走 PR。CLAUDE.md §0 的 session 收尾慣例）。docs/wiki/Architecture.md。