wshobson skills

Name: wshobson skills (Claude Skill)
Author: wshobson

為什麼要用

核心特性

Anthropic SKILL.md 格式，可自然觸發
每個技能深度、有主見的指導
涵蓋流程（測試、除錯）而非只是程式碼
wshobson/agents 和 wshobson/commands 的夥伴
MIT 授權，頻繁更新

即時演示

實際使用效果

就緒

安裝

作者儲存庫 · Claude Skills 官方文件

使用場景

實戰用法： wshobson skills

卡住時套用系統性除錯流程

👤 在 bug 追查第三小時的開發者 ⏱ ~60 min intermediate

何時使用： 你已經猜了一個小時，需要結構化的方法。

步驟

觸發技能

I'm stuck debugging a flaky test that fails on CI but passes locally. Apply your debug-systematically skill.✓ 已複製

→ 技能啟動，詢問重現步驟 + 最近的變更
按步驟操作

Step through the bisect/log/instrument plan it gives you.✓ 已複製

→ 捕獲逐步輸出
修復 bug

Once root cause confirmed, apply the fix and add a regression test.✓ 已複製

→ Bug 已修復；CI 通過

結果： Bug 已解決，並有記錄的證據鏈。

注意事項

對瑣碎 bug 使用技能造成額外開銷 — 對明顯的 bug 跳過技能——在卡超過 30 分鐘的情況下使用它

搭配使用： wshobson-agents-skill

為新功能設計測試策略

👤 規劃 sprint 的技術主管 ⏱ ~45 min intermediate

何時使用： 功能不簡單；你想要正確的單元 + 整合 + e2e 覆蓋。

步驟

向技能說明

Use testing-strategy. Feature: per-tenant data isolation in the API. Help me decide what to test where.✓ 已複製

→ 測試金字塔對應到功能
實作測試框架

Generate the scaffolding. Mark which tests are highest leverage.✓ 已複製

→ 帶有測試樁的檔案

結果： 可以在設計審查中辯護的測試計畫。

重構高流量函式而不造成行為退化

👤 觸碰關鍵程式碼路徑的開發者 ⏱ ~90 min advanced

何時使用： 函式在關鍵路徑上，一個 bug 就等於客戶影響。

步驟

用特徵測試固定行為

Use refactor-safely. First write characterization tests around src/checkout.ts:processOrder.✓ 已複製

→ 鎖定當前行為的測試
以微小步驟重構

Now apply refactors one tiny step at a time, running tests after each.✓ 已複製

→ 帶有綠色測試的逐步差異

結果： SRE 不會反對的重構。

搭配使用： wshobson-commands-skill

組合

與其他 MCP 搭配，撬動十倍槓桿

wshobson-skills-skill + wshobson-agents-skill

技能決定如何做，代理去做

wshobson-skills-skill + wshobson-commands-skill

指令用於快速觸發，技能用於更深入的指導

工具

此 MCP 暴露的能力

工具	輸入參數	何時呼叫
debug-systematically	bug description	卡超過 30 分鐘
testing-strategy	feature spec	實作前
refactor-safely	target	關鍵路徑重構
review-architecture	design doc	設計審查

成本與限制

運行它的成本

API 配額: 不適用——本地
每次呼叫 Token 數: 完全呼叫時較高（技能是詳細的指令區塊）
費用: 免費（MIT）
提示: 技能只在觸發時載入；不用擔心閒置費用

安全

權限、密鑰、影響範圍

最小權限： filesystem-read

憑證儲存： 無

資料出站： 無——純提示

故障排查

常見錯誤與修復

技能未自動觸發

檢查 SKILL.md 描述是否與使用者請求語義上相符；若有誤報，收緊描述

技能在不需要時觸發

編輯描述使其更具體；移除通用觸發詞

長技能導致 token 費用增加

將技能內容精簡到要點；技能應該是檢查清單，而非長篇文章

替代方案

wshobson skills 對比其他方案

替代方案	何時用它替代	權衡
wshobson/agents (sibling)	你想要子代理而非技能	子代理是顯式的；技能是自動觸發的
obra/superpowers	帶有不同觀點的較小精選技能集	較少覆蓋，更多品味