메뉴
方法論撰寫指南。Use for: (1) 撰寫新方法論, (2) 改寫冗長的舊方法論, (3) 檢查方法論品質
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Composes atomic, intent-revealing, grep-friendly writing (Zettelkasten) for code comments, docs, logs, prompts, schema/ticket fields, and long-form technical articles. Use when cognitive load and token cost matter. Triggers: 寫註解, 寫文件, 寫日誌, 寫 prompt, 寫文章, 技術文章, post-mortem, 架構決策, 除錯復盤, 欄位設計, atomic, reusable.
Agent Teams 協作派發指南。Use when: (1) Agent A 的發現會改變 Agent B 正在進行的工作, (2) 用戶要求使用 team/swarm, (3) 多代理人需即時協商共用介面或 API 契約。涵蓋 team 建立、Ticket-Task 橋接、teammate 入職、生命週期管理。
Branch Worktree Guardian - Git 分支和 Worktree 管理工具。Use for: (1) 新開發需求時建立隔離分支, (2) 使用 worktree 機制避免分支衝突, (3) 驗證當前工作分支正確性, (4) 預防在錯誤分支上開發
broken-link 偵測工具。掃描 .claude/ 目錄所有 Markdown 文件中的路徑引用，偵測失效連結。Use for: (1) 一次性掃描所有 broken links, (2) 搭配 /loop 定期監控, (3) 修改規則/方法論/代理人文件後驗證路徑完整性。Use when: user runs /broken-link-check, 或搭配 /loop 定期執行, 或發現 broken link 錯誤後。
子任務拆分與 Context 卸載工具。將可拆分的大型任務分成 N 個子 Ticket，各由 Agent 獨立執行，結論直接寫入 Ticket 不回報主線程。Use for: 批量檔案評估, 大型審查任務拆分, 任何需要讀取大量資料但結果可落地到 Ticket 的任務
認知負擔評估與審查工具。作為決策樹、代理人、Code Review 的基本參考標準。用於: (1) 任務複雜度評估, (2) 代理人升級判斷, (3) 任務拆分建議, (4) 程式碼品質審查與熱點識別
| name | methodology-writing |
| description | 方法論撰寫指南。Use for: (1) 撰寫新方法論, (2) 改寫冗長的舊方法論, (3) 檢查方法論品質 |
讀者已經知道方法論內容，只是忘記細節。
你的任務：幫讀者找回記憶，不是教導或說服。
禁止：
一個方法論必須在 30 秒內可讀完。
超出部分 → reference 到其他方法論或 SKILL
專注於：檢查和複習，不是完整說明
| 類型 | 定位 | 內容 |
|---|---|---|
| SKILL | 完整實作指南 | 設計邏輯、實作細節、範例、錯誤處理 |
| 方法論 | 30 秒快速複習 | 核心概念、檢查清單、reference 連結 |
# [方法論名稱]
## 核心概念
[1-2 句話定義]
## 執行步驟
1. [步驟]
2. [步驟]
3. [步驟]
## 檢查清單
- [ ] [檢查項]
- [ ] [檢查項]
## Reference
- [相關方法論]
層級限制：最多 H1 → H2 → H3，禁止 H4 以下
| 刪除對象 | 理由 |
|---|---|
| 「XXX 不是什麼」 | 讀者知道，不需要提醒 |
| 重複的範例 | 保留 1 個代表性範例 |
| 反模式章節 | 已在正向規則中說明 |
| 冗長的背景說明 | 讀者是專家 |
| 空洞的結論 | 沒有新資訊 |
| 保留對象 | 理由 |
|---|---|
| 核心定義（1-2 句） | 快速回憶 |
| 執行步驟（3-5 步） | 可操作 |
| 檢查清單 | 驗證完成度 |
| Reference 連結 | 深入查閱 |
[FAIL] 禁止
### 註解不是什麼
- 不是程式碼解釋器
- 不是 API 文件
- 不是 TODO 列表
[OK] 直接說
### 核心概念
註解是需求保護器，記錄業務決策和修改約束。
[FAIL] 禁止（同概念講 4 次）
2.3: 選擇1 vs 選擇2
2.4: 對比表
3.3: 詳細對比
3.5: 對比總結
[OK] 直接說
## Sociable vs Solitary
| 面向 | Sociable | Solitary |
|-----|----------|----------|
| Unit | Module | Class |
| Mock | 外部依賴 | 所有協作者 |
[FAIL] 禁止（每個規則都有完整範例）
規則一範例：20 行程式碼
規則二範例：25 行程式碼
規則三範例：15 行程式碼
[OK] 直接說
## 執行步驟
1. 判斷錯誤類型
2. 程式錯誤 → 改程式
3. 架構變更 → 先更新文件
詳細範例見 [SKILL 名稱](./path/to/skill.md)
改寫舊方法論時，除了精簡內容，還需處理「引用完整性」。
# 搜尋所有引用該方法論的文件
grep -r "方法論檔名" .claude/
建立「引用→章節」對照表：
| 引用者 | 引用次數 | 實際引用內容 |
|---|---|---|
| file-a.md | 3 次 | 第二章五層定義 |
| file-b.md | 1 次 | 第六章檢查機制 |
拆分標準：
| 條件 | 決策 |
|---|---|
| 章節可完全獨立 | 拆分為衛星文件 |
| 章節有高複用性 | 拆分為獨立方法論 |
| 章節是核心定義 | 保留在主文件 |
| 章節是範例/FAQ | 拆分或刪除 |
是否需要 SKILL：
對每個引用者判斷：
| 引用者 | 原引用 | 新引用 | 動作 |
|-------|-------|-------|-----|
| file-a.md | 主文件 | 主文件 | 不變 |
| file-b.md | 主文件 | 衛星文件 | 更新 |
| file-c.md | 主文件 | 主文件 + 衛星 | 更新 |
觸發條件：完成 2 個以上方法論改寫後（批量改寫必須執行）
檢查項目：
| 檢查項目 | 問題 | 判斷標準 |
|---|---|---|
| 主題重疊 | 多個方法論講同一件事？ | 核心概念相似度 > 70% |
| 職責模糊 | 讀者會困惑該看哪個？ | 使用場景無法區分 |
| 內容重複 | 相同檢查清單或步驟？ | 步驟重複 > 50% |
| 情況 | 處理 | 範例 |
|---|---|---|
| 完全重疊 | 刪除其一，更新引用 | A 和 B 講同一件事 → 刪除 B |
| 部分重疊 | 合併為一，各自精簡 | A 有 80% 和 B 重疊 → 合併 |
| 互補關係 | 保留，加入交叉引用 | A 講概念，B 講實作 → 互相 reference |
| 無重疊 | 維持現狀 | 各自獨立 |
Last Updated: 2026-03-02 Version: 1.0.0