메뉴
Repo ↔ 教學文章雙向同步。實作撞牆或設計階段發現教學缺口時建 challenge 記錄；回補教學章節；教學新章節產生實作需求時建 issue 追蹤。觸發詞：teaching-sync、教學同步、撞牆記錄、回補教學、challenge、教學回補、blog sync、知識同步、設計缺口、教學缺口、gap 分析。Use when: 實作遇到挑戰需記錄、設計階段發現教學覆蓋不足、需要回補教學章節、教學章節需要實作驗證、schema/transport 變更需同步教學文件。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
UX / UI 設計的系統性評估方法：把「使用者被困住」類缺口從實機測試提前到設計階段。Use for: (1) 設計或審查畫面狀態（狀態矩陣四欄：顯示 / 可用操作 / 進入條件 / 退出路徑，退出路徑為空 = 死胡同）, (2) Gate 設計（biometric / network / permission / 環境條件的成功、失敗、不確定路徑與 fallback）, (3) 輸入機制（keyboard type / submit model / IME policy / special keys 四維決策、IME 安全）, (4) 錯誤恢復（錯誤訊息、retry、error loop 逃生口、degraded mode）, (5) 導航（go/push 語意、tab / drawer / deep link、iOS vs Material 慣例）, (6) 互動回饋（回饋分層、時間門檻、spinner vs skeleton、SnackBar / Dialog / Banner 選擇、元件語意與版面：切換標籤 / 可點性辨識 / 選中態對比 / 溢出 affordance / 版面保障 / 完成宣告）。Use when: 設計新畫面或流程、審查 UI 實作、UX review、使用者反映被卡住 / 按了沒反應 / 標籤被讀反 / 選中看不到字 / 文字被壓成省略號 / 宣告完成但資料不全 / 通知被忽略。Triggers: UX 設計, UI 設計, 畫面設計, 狀態矩陣, 退出路徑, 死胡同, initializing, gate, fallback, 生物辨識, 權限請求, 破壞性操作, 輸入框, 鍵盤, IME, 表單, 搜尋框, 錯誤訊息, retry, 重試, 降級, degraded, 導航, back 行為, deep link, hash 路由, tab bar, service worker, loading, spinner, skeleton, SnackBar, Dialog, Banner, Bottom Sheet, 通知形式, 按鈕狀態, 切換模式, 標籤語意, 選中態, 對比, 溢出, 截斷, 省略號, ellipsis, 佔位, placeholder, 完成宣告, debounce, 防連點, 回饋.
Sync Claude Code skills between local .claude/skills/ and a remote skills repository. Use for: pulling skills from remote, pushing local skills to remote, listing available remote skills.
Use this skill whenever the user wants to create, track, query, or manage tickets. Triggers include: creating new tickets, claiming or releasing tickets, checking ticket status or progress, completing tickets, handing off work between agents, resuming interrupted tasks, migrating tickets between versions, converting plans to tickets, splitting tickets into subtasks, evaluating ticket granularity, or any mention of /ticket, task tracking, ticket lifecycle operations, or ticket splitting. 拆分相關：當用戶問「ticket 怎麼拆」「拆分粒度」時，建立/拆分 ticket 用本 skill，拆分邊界判讀（測試變綠驗收點）見 /tdd skill 的 task-granularity-rules。
WRAP 決策框架 — 認知偏誤防護、選項擴增與資料充足度閘門。用於防護自動駕駛、假選項、證據不足下的倉促決策。內含完整 premortem 流程（失敗原因並行深挖 + 綜合報告），適用版本規劃、提案評估、發版前等高成本決策。Use when: 被困住或連續失敗 2+、準備宣告限制性結論前、偏離核心目標、根因分析、代理人失敗歸因、提案評估、重大架構或規則決策、個人化建議（健康/醫療/金錢/法律）前、Context 沉重時、需要對計畫做事前風險推演時。Triggers: stuck, blocked, loop, no progress, 分析, debug, 限制性解法, 個人化建議, 具體推薦, premortem, 事前驗屍, 事前假設失敗, 壓力測試計畫, 這計畫會怎麼死, 找出盲點。
寫多篇章節後做多輪 agent reviewer audit 的標準操作流程。每輪用不同 frame 切換、跨輪 finding 互不重疊、停止訊號是 frame 涵蓋而非 finding 數遞減。Round 1-A 寫作規範 reviewer 必須同步 invoke `compositional-writing` skill 的字句層 keyword bank（正向陳述 / 口語修辭 / 地區用語 / 廢話前綴 / 裝飾符號 / 對讀者喊話 / 自評誇飾 / 必然性框架）、且命中後要做語意判定（命中是候選不是判決）。觸發詞：多輪審查、Round 1/2/3、frame 切換、跨輪審查、reviewer 規劃、何時停止 review、寫作 audit、batch review、cadence 同骨化、enumeration 不窮盡、正向陳述、self-application sweep。Trigger when reviewing multiple writings via successive rounds of agent reviewers.
Composes atomic, intent-revealing, grep-friendly writing (Zettelkasten) for code comments, docs, logs, prompts, schema/ticket fields, external-analysis transformation, and long-form technical articles. Use when cognitive load and token cost matter. **Also triggers during multi-round review / batch review / 寫作 audit** — provides the keyword bank (正向陳述 / 口語修辭 / 地區用語 / 廢話前綴 / 裝飾符號 / 對讀者喊話 / 自評誇飾 / 必然性框架 / 澄清式框架) and frame-specific check lists that multi-round-review reviewer agents need. Triggers: 寫註解, 寫文件, 寫日誌, 寫 prompt, 寫文章, 技術文章, 商業分析, 外部分析文章, 經驗談轉教學, 訪談整理, 機制重建, post-mortem, 架構決策, 除錯復盤, 欄位設計, atomic, reusable, 多輪審查, multi-round review, batch review, 寫作 audit, 正向陳述, 口語修辭, 字句層 grep.
| name | teaching-sync |
| description | Repo ↔ 教學文章雙向同步。實作撞牆或設計階段發現教學缺口時建 challenge 記錄；回補教學章節；教學新章節產生實作需求時建 issue 追蹤。觸發詞：teaching-sync、教學同步、撞牆記錄、回補教學、challenge、教學回補、blog sync、知識同步、設計缺口、教學缺口、gap 分析。Use when: 實作遇到挑戰需記錄、設計階段發現教學覆蓋不足、需要回補教學章節、教學章節需要實作驗證、schema/transport 變更需同步教學文件。 |
| license | MIT |
| metadata | {"version":"2.0.0","category":"knowledge-management"} |
管理 monitor repo（實作端）和 blog monitoring 教學系列（教學端）之間的知識同步。
教學和實作是互補關係，兩者各自承擔不同的知識生產責任：
| 方向 | 觸發 | 動作 |
|---|---|---|
| 實作 → 教學 | 實作撞牆（bug / 效能 / 設計困難） | challenge — 記錄 → 標記回補點 |
| 設計 → 教學 | UC / spec 設計時發現教學覆蓋不足 | design-gap — 比對分析 → 記錄 → 標記回補點 |
| 記錄 → 教學 | challenge / gap 記錄待回補到 blog | backfill — 切 blog branch → 修改教學章節 → 更新 sync-pending |
| 教學 → 實作 | 教學新章節需要實作驗證 | need-impl — 建 issue 追蹤 |
| 雙向 | schema / transport 變更 | schema-change — 同步更新兩端 |
/teaching-sync challenge — 記錄實作撞牆當實作遇到挑戰時執行。建立 docs/challenges/<name>.md 記錄，並標記應回補的教學模組。
流程：
docs/challenges/README.md）docs/sync-pending.md/teaching-sync design-gap — 設計階段教學缺口分析UC / spec / proposal 設計過程中，比對教學內容發現覆蓋不足時執行。和 challenge 的差異：gap 在設計階段發現（尚未實作），不是撞牆後的回顧。
流程：
讀取待分析的 UC / spec 檔案
對照每個描述、例外場景、邊界條件，讀取 blog 對應教學章節
逐項比對覆蓋度，找出：
產出 gap 分析表格：
| UC | UC 中的描述 | 對應 blog 章節 | Gap 描述 | 建議回補方向 |
建立 challenge 記錄檔（docs/challenges/NNN-*.md），含完整 gap 清單和優先序
新增項目到 docs/sync-pending.md，標記優先級（P0 / P1 / P2）
只列真正的 gap。教學已充分覆蓋的部分不列入，避免噪音。
/teaching-sync backfill — 執行教學回補將 challenge / gap 記錄中的待回補項目實際寫入 blog 教學文章。
前置條件：docs/sync-pending.md 中有未完成的回補項目。
流程：
讀取 docs/sync-pending.md，列出待回補項目
按優先級選擇要回補的項目（可指定，如 /teaching-sync backfill P0）
讀取對應的 challenge 記錄，理解 gap 的完整背景
切 blog repo feature branch：
git -C ~/project/blog checkout -b feat/monitor-teaching-backfill-NNN
讀取目標教學章節，理解現有內容結構
直接修改 blog 教學文章——在適當位置新增或補充內容
字句層審查（commit 前強制執行）：
對修改過的檔案執行 blog multi-round-review Round 1-A 字句層 grep，keyword bank 來自 blog 的 compositional-writing skill：
FILES="<modified-file-paths>"
# 以下 grep 全部用子 shell，不裸 cd
(cd ~/project/blog && rg "不[行可是要能該支對符夠必]|無法|沒[做有]|而非|而不是" $FILES) # 否定起手
(cd ~/project/blog && rg "其實|實務上|真的|碰巧|立刻撞牆|沒事" $FILES) # 口語修辭
(cd ~/project/blog && rg "集群|默認|質量|視頻|函數|文件夾|接口" $FILES) # 地區用語
(cd ~/project/blog && rg "值得注意的是|需要說明的是|實際上|基本上|事實上" $FILES) # 廢話前綴
(cd ~/project/blog && rg "✅|❌|⚠️|🚨|🟡|🟢|⭐|📌|✓|✗" $FILES) # 裝飾符號
(cd ~/project/blog && rg "很多人|大家|不少人|你天天|你會|你可能|先讀懂|先釐清|別搞混" $FILES) # 對讀者喊話
(cd ~/project/blog && rg "教科書級|堪稱|可謂|完美|經典|範本級|最佳實踐|best practice" $FILES) # 自評誇飾
(cd ~/project/blog && rg "天生|與生俱來|本質就是|本來就是|必然|唯一|註定|理所當然" $FILES) # 必然性框架
命中是候選、不是判決——每個命中逐一做語意判定：
判定結果記錄為表格（維度 / 命中數 / 判定），違規項立即修正後 commit。
commit + merge + push：
git -C ~/project/blog add <changed-files>
git -C ~/project/blog commit -m "docs(monitoring): 回補教學缺口 — <摘要>
來源：docs/challenges/<NNN>.md (<Gap-ID>)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>"
git -C ~/project/blog checkout main
git -C ~/project/blog merge feat/monitor-teaching-backfill-NNN
git -C ~/project/blog push origin main
git -C ~/project/blog branch -d feat/monitor-teaching-backfill-NNN
審查修正如有額外 commit，同樣走 feature branch → merge → push 流程。
更新 docs/sync-pending.md，將完成項目標記 [x] 並附 commit hash
寫作原則：
品質閘門：
multi-round-review + compositional-writing 規範/teaching-sync need-impl — 教學需要實作驗證當教學章節撰寫中發現需要實作驗證時執行。
流程：
teaching-driven）> 待實作驗證：monitor#<issue-number>/teaching-sync schema-change — Schema 變更同步當 schema/event.schema.json 或 docs/transport.md 變更時執行。
流程：
monitoring/02-log-schema/ 的欄位解說monitoring/03-sdk-design/ 的 SDK API 設計monitoring/04-collector/ 的驗證邏輯backfill 的 step 4-8：切 branch → 修改 → commit → merge → push）docs/sync-pending.md 追蹤/teaching-sync status — 同步狀態總覽列出當前同步狀態：
docs/challenges/ 中未標記教學回補的記錄docs/sync-pending.md 中待同步項目（已完成 / 未完成分開列）_index.md 中待寫章節 checklist 的完成狀態（需讀 blog repo）| 挑戰類型 | 對應教學模組 |
|---|---|
| 高併發寫入 / 儲存效能 / 查詢效能 | 04 Collector |
| SDK 離線 buffer / 攢批策略 / 生命週期 | 03 SDK 設計 |
| 平台特異行為（CORS / isolate / GIL / 短生命週期） | 05 平台適配 |
| Secret 洩漏 / redaction / access control | 07 資安與隱私 |
| 事件分類困難 / 命名規範 | 01 心智模型 |
| Schema 版本演進 / 欄位設計 | 02 Log Schema |
| 自架 vs 商業取捨 | 06 商業方案對照 |
| funnel / cohort / attribution 實作 | 08 商業利用 |
教學文章位於 ~/project/blog/content/monitoring/。本 skill 直接修改 blog 教學文章，完成 commit、merge、push 全流程。
| 操作 | 在哪個 repo 做 | 分支要求 |
|---|---|---|
| 記錄 challenge / gap | monitor repo | 無（docs/ 在 main 可寫） |
| 回補教學章節 | blog repo（直接修改） | feature branch → merge main → push → 刪 branch |
| schema 變更同步 | monitor repo 先改 → blog repo 直接同步 | 同上 |
| 教學需要驗證 | blog repo 發現 → monitor repo 建 issue | 無 |
blog repo 的所有修改遵循固定流程：
docs(monitoring):，body 含 challenge 來源引用）branch 命名：feat/monitor-teaching-backfill-NNN（NNN = challenge 編號）
docs/challenges/ 的記錄是強制的——發現不記錄等於知識丟失docs/sync-pending.md，不靠記憶docs/challenges/README.md — challenge 記錄格式docs/sync-pending.md — 待同步到教學端的變更清單（本 skill 維護）CLAUDE.md §3「教學 × 實作互補」— 教學模組對應表和雙向工作流content/monitoring/ — 教學文章content/monitoring/cases/ — 由 challenge 教學化後產生的 case