顯示具有 GitHub 標籤的文章。 顯示所有文章
顯示具有 GitHub 標籤的文章。 顯示所有文章

GitHub CLI 教學:高效的開發工作流程

關於本教學
本教學適合想要透過命令列提升GitHub工作效率的開發者,從基礎功能到進階工作流程都有涵蓋。

## 引言

GitHub命令列工具(GitHub CLI) 是提升開發工作流程效率的絕佳工具。透過命令列介面操作GitHub,您可以更快、更有條理地管理專案,無需頻繁切換至瀏覽器界面。本教學將帶您了解GitHub CLI的主要功能和實用工作流程。

安裝與設置

要開始使用GitHub CLI,首先需要安裝它:

各平台安裝命令
macOS (使用Homebrew):

brew install gh

Windows (使用Scoop):

scoop install gh

Linux (Debian/Ubuntu):

sudo apt install gh

安裝後,您需要進行驗證:

gh auth login
遵照螢幕上的指示,選擇通過瀏覽器或令牌(token)進行身份驗證。

基本命令介紹

GitHub CLI使用gh作為主命令,後接不同的子命令執行各種操作:

常用指令類別
| 指令 | 功能 | | ---- | ---- | | gh repo | 倉庫管理 | | gh issue | 問題追蹤 | | gh pr | 拉取請求操作 | | gh release | 版本發布 | | gh gist | 代碼片段管理 |

每個命令都有自己的子命令和選項,可以通過`gh help [command]`獲取幫助。

實用使用案例

讓我們看一些實際使用案例,幫助您更好地理解GitHub CLI在日常開發中的應用:

以下案例展示了GitHub CLI如何在各種場景中幫助您提高工作效率。

### 案例1:快速複製並參與開源專案

想要貢獻某個開源專案?GitHub CLI可以讓這個過程變得簡單:

快速參與開源專案的命令
```bash

複製倉庫並自動在您的帳號創建fork

gh repo fork cli/cli

自動為您設置遠端倉庫,無需手動配置

如果只想創建fork但不clone到本地

gh repo fork cli/cli --clone=false

創建分支並開始工作

git checkout -b feature-branch

完成工作後,直接從命令行提交PR

gh pr create --title "實現新功能" --body "解決了#123問題"


</div>
這個流程讓您無需在瀏覽器和終端間切換,顯著提高效率。

### 案例2:快速查看和管理專案狀態

需要快速了解專案中的問題和拉取請求?

<div style="background:#f5f5f5;border-left:4px solid #777;color:#333;padding:12px 16px;margin:12px 0;border-radius:4px">

<strong>專案狀態查詢命令</strong><br>```bash
# 列出所有開放的PR
gh pr list

# 查看特定PR的詳細信息
gh pr view 21

# 列出分配給您的issue
gh issue list --assignee @me

# 查看特定issue的詳細信息和評論
gh issue view 13 --comments
### 案例3:團隊協作和代碼審查

GitHub CLI提供強大的代碼審查功能,讓團隊協作更高效!

代碼審查相關命令
```bash

檢出同事的PR到本地,進行審查

gh pr checkout 15

在終端中查看PR的差異

gh pr diff

直接在命令行中批准PR

gh pr review 15 --approve

或者提出評論和修改建議

gh pr review 15 --comment -b "請考慮優化這部分的性能"


</div>
### 案例4:自動化工作流程整合

將GitHub CLI整合到您的自動化腳本中:

<div style="background:#f5f5f5;border-left:4px solid #777;color:#333;padding:12px 16px;margin:12px 0;border-radius:4px">

<strong>自動化工作流程命令</strong><br>```bash
# 創建新版本發布
gh release create v1.0.0 --title "第一個穩定版本" --notes "修復了多個bug和性能優化"

# 監控GitHub Actions工作流程
gh run list

# 等待特定工作流程完成
gh run watch
這些使用案例展示了GitHub CLI如何在各種場景中幫助您提高工作效率。

分支保護設置

在使用GitHub CLI之前,建議先設定分支保護規則,確保工作流程的安全性:

沒有適當的分支保護設置,可能導致團隊成員意外直接推送至主分支。

1. 在GitHub網站上導航至您的倉庫 2. 點擊「Settings」→「Branches」 3. 點擊「Add rule」為主分支(通常是`main`)添加保護規則 4. 建議的設置: - 勾選「Require a pull request before merging」 - 勾選「Require approvals」(團隊協作時) - 勾選「Require status checks to pass before merging」 - 勾選「Do not allow bypassing the above settings」

這些設置將防止直接推送到主分支,確保所有變更都經過PR流程審核。

工作流程教學:從issue到PR到合併

GitHub CLI支持完整的開發工作流程,下面是一個典型範例:

步驟1:創建Issue

每個新功能或修復都從創建issue開始:

Issue創建命令
```bash gh issue create -t "添加新功能:使用者註冊" -b "實現使用者註冊功能,包括表單和驗證"


或者使用交互模式:

```bash
gh issue create
系統會提示您輸入標題、描述和其他詳細信息。

步驟2:從Issue創建開發分支

這是GitHub CLI的強大功能之一,您可以直接從issue創建並切換到新分支:

從Issue創建分支
```bash gh issue develop [issue編號] -c


</div>
這個命令會:

- 創建一個基於issue標題的新分支
- 將分支與issue關聯
- 自動切換到新分支

現在您可以開始編寫代碼了!

### 步驟3:提交更改並推送

完成工作後,提交您的更改:

<div style="background:#f5f5f5;border-left:4px solid #777;color:#333;padding:12px 16px;margin:12px 0;border-radius:4px">

<strong>提交與推送命令</strong><br>```bash
git add .
git commit -m "添加使用者註冊功能"
git push -u origin HEAD
### 步驟4:創建PR

使用GitHub CLI創建PR:

PR創建命令
```bash gh pr create


系統會提示您輸入標題(默認使用提交信息)和描述。您也可以使用`-d`標記創建草稿PR:

```bash
gh pr create -d
草稿PR表示工作仍在進行中,尚未準備好審核。

步驟5:將草稿PR標記為準備就緒

當您的工作完成並準備好審核時:

將PR標記為準備就緒
```bash gh pr ready


</div>
### 步驟6:審核和合併PR

查看PR的狀態:

<div style="background:#f5f5f5;border-left:4px solid #777;color:#333;padding:12px 16px;margin:12px 0;border-radius:4px">

<strong>PR審核與合併命令</strong><br>```bash
gh pr view

合併PR(如果您有權限):

gh pr merge
您可以選擇合併方式(標準合併、壓縮合併或變基合併)。

GitHub工作流程視覺化指南

以下使用Mermaid圖表視覺化展示GitHub完整工作流程,從初次提交到分支開發、合併與發布:

初始化倉庫與首次提交

[mermaid 圖表 — 原始 HackMD 版本可正常渲染]

flowchart TB A[開始專案] --> B["初始化本地倉庫
git init"] B --> C["建立必要檔案
echo '# 專案名稱' > README.md
echo '初始版本' > CHANGELOG.md"] C --> D["添加檔案
git add README.md CHANGELOG.md .gitignore"] D --> E["首次提交
git commit -m '初始提交: 建立專案結構'"] E --> F["創建遠端倉庫
gh repo create my-project --public --source=."] F --> G["推送至遠端
git push -u origin main"]

style A fill:#f9f,stroke:#333,stroke-width:2px
style G fill:#bbf,stroke:#333,stroke-width:2px</div>

查看詳細實現代碼
```bash

初始化本地倉庫

git init

建立忽略檔案 (最佳實踐)

cat > .gitignore << 'EOF'

依語言自動生成適合的 .gitignore

可訪問 https://gitignore.io/ 獲取適合您專案的內容

node_modules/ *.log .DS_Store .env EOF

添加文件

echo "# 我的專案" > README.md echo "初始版本" > CHANGELOG.md git add README.md CHANGELOG.md .gitignore

首次提交

git commit -m "初始提交: 建立專案結構"

使用GitHub CLI創建遠端倉庫 (推薦選項)

gh repo create my-project
--public \ # 公開倉庫,使用 --private 創建私有倉庫 --description "我的新專案描述" \ # 添加描述 --homepage "https://myproject.com" \ # 可選的主頁 --source=. \ # 使用當前目錄作為源 --remote=origin \ # 設置遠端名稱 --gitignore Node # 自動添加語言特定的.gitignore (可選)

如果需要添加授權文件

gh repo edit --add-license mit # 添加MIT授權

推送至遠端

git push -u origin main # 或 git push -u origin master 若使用舊版Git

驗證倉庫創建成功

gh repo view --web # 在瀏覽器中打開倉庫

常見問題解決:

如果遇到分支名稱問題 (master 與 main)

git branch -M main # 將當前分支重命名為main


</div>
**建議選項與最佳實踐:**

<div style="background:#d9edf7;border-left:4px solid #31708f;color:#31708f;padding:12px 16px;margin:12px 0;border-radius:4px">

- 使用有意義的倉庫名稱和描述,方便他人理解專案目的
- 建立 `.gitignore` 文件排除不需要版本控制的檔案
- 添加 `LICENSE` 和詳細的 `README.md` 說明專案用途和使用方法

</div>
使用結構化格式獲取倉庫資訊:

```bash
gh repo view --json name,description,visibility,defaultBranchRef

創建私有倉庫時添加協作者:

gh repo create --private my-project
gh repo add-collaborator my-project username --permission admin

開發分支與Bug修復流程

[mermaid 圖表 — 原始 HackMD 版本可正常渲染]

flowchart TB A["主分支
git checkout main
git pull"] --> B["建立問題
gh issue create -t '修復登入問題'"] B --> C["創建分支
gh issue develop issue編號 -c"] C --> D["修改代碼
(編輯相關檔案)"] D --> E["提交修復
git add .
git commit -m '修復登入問題'"] E --> F["推送分支
git push -u origin HEAD"] F --> G["創建PR
gh pr create --title '修復登入問題'"] G --> H{"需要修改?"} H -- 是 --> I["審查反饋
gh pr view --comments"] I --> J["修改代碼
(根據反饋修改)"] J --> K["提交修改
git commit -am '根據審查調整'
git push"] K --> H H -- 否 --> L["合併PR
gh pr merge --squash"] L --> M["清理分支
git checkout main
git pull
git branch -d bugfix-branch"]

style A fill:#bbf,stroke:#333,stroke-width:2px
style M fill:#bbf,stroke:#333,stroke-width:2px</div>

使用GitHub CLI實現完整修復流程
```bash

確保main分支最新

git checkout main git pull

創建並切換到bugfix分支

gh issue create -t "修復登入問題" -b "使用者無法在Safari瀏覽器登入" gh issue develop $(gh issue list --limit 1 --json number --jq '.[0].number') -c

設置分支追踪 (可選,方便後續操作)

git branch --set-upstream-to=origin/main

修復問題並提交

(進行必要的代碼修改)

git add . git commit -m "修復Safari登入問題" -m "詳細描述問題原因和解決方案"

遇到衝突時如何解決

git fetch origin main

git rebase origin/main

(解決衝突後)

git rebase --continue

推送分支到遠端

git push -u origin HEAD

創建PR (完整選項)

gh pr create
--title "修復Safari登入問題"
--body "解決issue #1中描述的Safari登入問題"
--assignee @me \ # 分配給自己 --label "bug,urgent" \ # 添加標籤 --milestone "v1.0" \ # 指定里程碑 --reviewer teammate1,teammate2 # 請求審核

檢查PR狀態

gh pr status

追蹤PR評論

gh pr view --comments

修改PR以回應審查意見

(進行修改後)

git add . git commit -m "根據審查意見調整" git push

等待審查後合併PR (多種選項)

gh pr merge
--squash \ # 壓縮合併,或使用 --merge/--rebase --delete-branch \ # 合併後刪除分支 --body "包含所有必要修復" # 自定義合併信息

同步本地環境

git checkout main git pull git branch -d bugfix-login-issue

如果忘記刪除遠端分支

gh pr list -s merged # 列出已合併的PR

gh pr view # 查看特定PR

git push origin --delete # 手動刪除遠端分支


</div>
**重要提示與最佳實踐:**

- 使用有意義的分支名稱,推薦格式: `<類型>/<描述>`,例如 `bugfix/safari-login`
- 提交詳細的PR描述,使用模板:

<div style="background:#f5f5f5;border-left:4px solid #777;color:#333;padding:12px 16px;margin:12px 0;border-radius:4px">

<strong>PR描述模板</strong><br>```markdown
## 問題描述
簡要說明問題

## 解決方案
如何解決

## 測試方法
如何驗證修復

Fixes #1
- 定期從主分支同步變更,避免大型合併衝突 - 使用 `gh pr ready` 標記草稿PR為可審核狀態 - 利用GitHub CLI監控CI/CD狀態: `gh run list --workflow=ci.yml`

版本發布流程

[mermaid 圖表 — 原始 HackMD 版本可正常渲染]

flowchart TB A["同步最新代碼
git checkout main
git pull"] --> B["確保測試通過
npm test"] B --> C["更新版本號
npm version patch
或手動更新package.json"] C --> D["更新變更日誌
更新CHANGELOG.md"] D --> E["提交版本更新
git add .
git commit -m '版本提升至 v1.0.0'
git push"] E --> F["創建標籤
git tag -a v1.0.0 -m '穩定版發布'
git push origin v1.0.0"] F --> G["發布版本
gh release create v1.0.0
--title 'v1.0.0 穩定版發布'
--notes-file CHANGELOG.md"] G --> H["添加發布資產
gh release upload v1.0.0 ./dist/app.zip"]

style A fill:#f9f,stroke:#333,stroke-width:2px
style H fill:#bbf,stroke:#333,stroke-width:2px</div>

使用GitHub CLI實現發布流程
```bash

確保在main分支上並同步最新變更

git checkout main git pull

建立版本標籤的不同方式

方式1: 使用語義化版本標籤

VERSION="1.0.0" echo "當前版本: $VERSION"

更新版本號(示例:在package.json中)

方式1: 手動編輯

方式2: 使用npm工具 (Node.js項目)

npm version patch --no-git-tag-version # 小版本更新

方式3: 使用jq工具 (通用方法)

jq '.version = "1.0.0"' package.json > tmp && mv tmp package.json

更新CHANGELOG.md (最佳實踐)

cat > CHANGELOG.md << 'EOF'

更新日誌

[1.0.0] - $(date +%Y-%m-%d)

新功能

  • 實現使用者註冊
  • 新增發布通知功能

修復

  • 修復Safari登入問題
  • 解決移動裝置顯示錯誤 EOF

提交版本更新

git add package.json CHANGELOG.md git commit -m "版本提升至 v1.0.0" git push

創建發布標籤

git tag -a v1.0.0 -m "v1.0.0 穩定版發布" git push origin v1.0.0

使用GitHub CLI創建完整發布 (多樣選項)

gh release create v1.0.0
--title "v1.0.0 穩定版發布"
--notes-file CHANGELOG.md \ # 使用CHANGELOG作為發布說明 --discussion-category "公告" \ # 創建討論主題 --target main \ # 指定目標分支 --verify-tag # 驗證標籤存在

可選: 添加發布資產

gh release upload v1.0.0 ./dist/app.zip ./docs/user-guide.pdf

可選: 發布後的維護操作

更新專案依賴

npm update --save

git add package.json package-lock.json

git commit -m "更新專案依賴"

git push

檢視並驗證發布

gh release view v1.0.0 gh release view v1.0.0 --web # 在瀏覽器中查看發布頁面


</div>
**版本發布最佳實踐建議:**

<div style="background:#dff0d8;border-left:4px solid #3c763d;color:#3c763d;padding:12px 16px;margin:12px 0;border-radius:4px">

- 使用[語義化版本控制](https://semver.org/lang/zh-TW/)規範(MAJOR.MINOR.PATCH)
  - MAJOR: 不兼容的API變更
  - MINOR: 向下兼容的功能新增
  - PATCH: 向下兼容的問題修復
- 維護詳細的CHANGELOG文件,記錄每個版本的更改
- 發布前進行完整測試,確保所有CI流程通過

</div>
為發布添加詳細文檔和使用示例:

- 使用預發布版本進行測試:
  ```bash
  gh release create v1.0.0-beta.1 --prerelease --title "v1.0.0 Beta 1"
  • 設置自動化發布流程,利用GitHub Actions:

GitHub Actions發布工作流程
```yaml name: Release on: push: tags: ['v*'] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - run: npm ci - run: npm test - uses: softprops/action-gh-release@v1


</div>
這個視覺化工作流程展示了使用GitHub CLI管理整個軟體開發生命週期的方式,從初始化專案到功能開發、bug修復,再到版本發布。通過遵循這些步驟和使用GitHub CLI,您可以顯著提高團隊協作效率和代碼質量。

## 進階技巧:draft PR和PR驅動開發

### 使用草稿PR進行迭代開發

草稿PR非常適合用於長期持續開發的任務:

<div style="background:#d9edf7;border-left:4px solid #31708f;color:#31708f;padding:12px 16px;margin:12px 0;border-radius:4px">

<strong>草稿PR工作流程</strong><br>1. 創建草稿PR以早期獲取反饋
2. 持續在分支上工作並推送更新
3. 團隊成員可以實時跟踪和評論您的工作
4. 當準備就緒時,將PR標記為可審核

</div>
這種方法的優點:

- 保持工作透明度
- 提早發現潛在問題
- 避免大型PR帶來的審核困難
- 為長期工作保留開發記錄

### 多分支平行開發

當您同時處理多個功能時:

<div style="background:#d9edf7;border-left:4px solid #31708f;color:#31708f;padding:12px 16px;margin:12px 0;border-radius:4px">

<strong>平行開發策略</strong><br>1. 為每個功能創建單獨的issue
2. 從每個issue創建開發分支
3. 使用草稿PR跟踪每個功能的開發進度
4. 在不同分支間切換:`gh pr checkout [PR編號]`

</div>
當某個功能開發完成時,將其PR標記為可審核並合併,而不影響其他正在進行的工作。

## 總結與建議

GitHub CLI是一個強大的工具,能夠顯著提升您的開發工作流程效率:

<div style="background:#dff0d8;border-left:4px solid #3c763d;color:#3c763d;padding:12px 16px;margin:12px 0;border-radius:4px">

- 使用issue追踪任務和功能開發
- 遵循分支保護和PR流程,維護代碼質量
- 利用草稿PR進行透明的迭代開發
- 熟練使用GitHub CLI命令,減少上下文切換

</div>
最佳實踐:

- 為每個任務創建issue
- 保持PR規模小且集中
- 定期提交和推送更改
- 使用有意義的提交信息和PR描述
- 鼓勵團隊成員進行早期和持續的代碼審核

通過熟練運用GitHub CLI和這些工作流程,您可以建立更有組織、更高效的開發過程,無論是個人專案還是團隊協作。

## 常用命令參考

<div style="background:#f5f5f5;border-left:4px solid #777;color:#333;padding:12px 16px;margin:12px 0;border-radius:4px">

<strong>常用命令速查表</strong><br>```bash
# 倉庫操作
gh repo create           # 創建新倉庫
gh repo clone [倉庫]     # 克隆倉庫
gh repo view             # 查看當前倉庫信息

# Issue操作
gh issue list            # 列出issue
gh issue create          # 創建issue
gh issue view [編號]     # 查看issue詳情
gh issue develop [編號]  # 從issue創建開發分支

# PR操作
gh pr create             # 創建PR
gh pr list               # 列出PR
gh pr view [編號]        # 查看PR詳情
gh pr checkout [編號]    # 檢出PR分支
gh pr ready              # 將草稿PR標記為準備就緒
gh pr merge              # 合併PR

# 瀏覽器整合
gh browse                # 在瀏覽器中打開當前倉庫
gh pr view --web         # 在瀏覽器中查看PR

# 其他實用命令
gh run list              # 列出工作流程運行
gh release create        # 創建發布
gh gist create           # 創建代碼片段
## 參考資料
  1. GitHub CLI官方文檔 - Examples
  2. GitHub CLI官方快速入門
  3. GitHub CLI - 將GitHub帶入命令行
  4. GitHub CLI命令行工具(gh) - 知乎專欄

希望本教學能幫助您提升GitHub工作流程效率!


本文最初發布於 HackMD @BASHCAT。

2026 我把 4000+ Claude Code Skills 裝進終端機之後 — 16 個值得收藏的 GitHub Repo 地圖

claude-skills-hero

說一個有點糗的真實場景。某個禮拜五晚上,我滑著 GitHub 看到 sickn33/antigravity-awesome-skills 寫著「installable GitHub library of 1,450+ agentic skills」,腦袋一熱,npx antigravity-awesome-skills --claude 一口氣全裝。隔天打開 Claude Code,光是讀取 marketplace 就卡了 5 秒,叫它做一個小重構,它居然先列出 17 個候選 skill 讓我選。

那一刻我才搞懂:Claude Code 的 skill 生態到了 2026 已經不是「東西多 = 強」,而是「選得準 = 強」。

這篇是我研究完官方規格、跑完 Anthropic、Trail of Bits、GitHub Changelog 的公告,又把 GitHub 上 16 個高 star 的 repo 都翻過 README 之後,整理給繁中讀者的一張「Skills 寶藏地圖」。我會用四檔分類把它們分清楚,附上可以直接 copy-paste 的 cheat sheet,最後用 6 種角色幫你決定先裝哪 3 個。

Skills 是什麼?為什麼 2026 變元年

Anthropic 在 2025 年 10 月 16 日的官方部落格 正式發表 Agent Skills,原文標題是 Introducing Agent Skills,定位寫得很乾脆——「Claude 可以用 Skills 來改善它執行特定任務的表現」。當時還只是 Claude 自家功能。

兩個月後更進一步:2025 年 12 月 Anthropic 把規格 agentskills.io 拿出來開源,正式變成跨平台「Agent Skills 開放標準」。The New Stack 把它比擬成另一個 MCP 級別的標準布局 ——Anthropic 先做事實標準、再開源、再讓整個工具鏈被綁進來。事後看,這個策略奏效得很快。

到 2026 年 4 月,這個標準已被 Claude Code、Claude.ai、Cursor、Gemini CLI、GitHub Copilot 等多個 agent host 採用,並陸續擴散到 OpenAI Codex CLI、Antigravity、Windsurf 等工具(規格本身也維護在開放的 agentskills/agentskills repo 由社群貢獻——注意 agentskills 是獨立 org、不是 Anthropic 名下的 repo)。同時 GitHub 在 2026-04-16 的 Changelog 上線 gh skill 子指令——一個 CLI 工具就能跨所有 agent host 安裝、更新、發布 skill。

換句話說:

2026 是「skills 變成像 npm 套件那樣被生態管理」的元年。

這也是為什麼 GitHub 上 awesome-claude-skills 這個關鍵字從 2025 年底開始爆炸長出十幾個 repo,每一個都號稱「1000+ skills」。

claude-skills-anatomy

30 秒搞懂 SKILL.md 到底長什麼樣

別被「規格」兩個字嚇到。一個 skill 本質上只有一個資料夾跟一個檔案:

my-deployment-checklist/
└── SKILL.md

SKILL.md 最少只要兩個 YAML frontmatter 欄位就能跑:

---
name: deployment-checklist
description: Pre-deployment validation for production releases
---

# Process

1. Run tests: `npm test`
2. Build: `npm run build`
3. Verify environment variables
4. Run database migrations
5. Document rollback plan

# Verification
- [ ] All tests passing
- [ ] Build successful
- [ ] Migrations applied
- [ ] Rollback documented

就這樣。Claude(或任何 agent host)會根據你的對話內容判斷 description 與當前任務的相關性,只在需要時 把完整的 SKILL.md 載進 context。這個「按需載入」的機制是它跟 system prompt、CLAUDE.md 最大的差異——一個 system prompt 是「永遠存在的內隱規則」,一個 skill 是「該你上場時你才被叫出來」。

可選欄位也很節制:author、version、license、user-invocable: true(在 slash command 選單裡顯示)、context: fork(在獨立 subagent 裡跑)。整套規格的設計哲學就是「越少越好」,方便讓不同工具廠商都能無痛實作。

放置位置只有兩種:

  • 專案層:<project>/.claude/skills/<name>/SKILL.md
  • 使用者層:<sub>/.claude/skills/<name>/SKILL.md

知道這個之後,後面看 repo 就很容易——所有 repo 不管包裝得多花俏,最後都是把一堆 SKILL.md 丟進這兩個資料夾的其中一個。

claude-skills-install-evolution

安裝方式三代演進:從 git clone 到 gh skill

這半年安裝方式經歷了非常明顯的三代演進。如果你還在用第一代寫教學,那已經過時了。

[mermaid 圖表 — 原始 HackMD 版本可正常渲染]

graph LR A["Gen 1
2025 Q4
git clone"] --> B["Gen 2
2026 Q1
/plugin marketplace"] B --> C["Gen 3
2026 Q2
gh skill CLI"] A -.-> A1["手動進 /.claude/skills/
易碎、難版本管理"] B -.-> B1["Claude Code 內建
marketplace 系統
支援 update / browse"] C -.-> C1["GitHub 官方 CLI
跨 agent host
支援 version pinning"]

三代差異一張表看完:

世代 指令 出現時間 特性 是否仍適用
Gen 1 git clone … <sub>/.claude/skills/foo 2025 Q4 手工、無版本控制、易碎 仍可,但僅適合「我自己寫的私房 skill」
Gen 2 /plugin marketplace add owner/repo + /plugin install name@marketplace 2026 Q1 Claude Code 原生 UI、可 browse 目前最主流
Gen 3 gh skill install owner/repo[/path][@tag] --agent claude-code 2026 Q2 跨 host、支援版本鎖定、immutable releases 新專案首選

Gen 3 的 gh skill 是真的解決問題的。它允許版本釘選、gh skill publish 還能自動啟用 GitHub immutable releases 確保供應鏈完整性。對企業團隊來說,這是「終於可以把 skill 寫進採購清單」的關鍵。

我自己現在的習慣是:個人實驗用 Gen 2、團隊與生產環境用 Gen 3、寫 demo 才用 Gen 1。

claude-skills-four-tiers

第一檔:官方原生型——安全感的起點

如果你完全不知道從哪開始,這檔不用糾結,直接裝。

anthropics/skills

anthropics/skills (132k stars,2026-05 快照)是官方範例庫。你會在這裡找到 pdf、docx、xlsx、pptx(這幾個是 source-available 而非 MIT,注意授權)、mcp-builder(教 Claude 建 MCP server)、artifacts-builder、webapp-testing、skill-creator,以及一個值得單獨提的 claude-api skill——它把整個 Anthropic API 與 Agent SDK 的最新規格、模型 ID、價格、beta header 全部包成一個 skill,是內部訊息流通最快的地方。

授權主體是 Apache 2.0,少數文件處理 skill 為 source-available。對企業合規很重要。

anthropics/knowledge-work-plugins

anthropics/knowledge-work-plugins (12k stars)是 Anthropic 為「非工程師」設計的 plugin 集合,11 個 plugin 分別針對 sales、marketing、legal、finance、data、customer-support、product-management、enterprise-search、bio-research 等角色,預設綁好對應的 MCP 連接器(Slack、Notion、HubSpot、Snowflake、Databricks、BioRender、ClinicalTrials.gov…)。

如果你的公司想推「全員 AI 化」,這是最容易上手的官方範本——直接拿 finance plugin 給會計、拿 legal plugin 給法務,連 prompt 都不用自己寫。

第二檔:明星框架——4 個值得 fork 的設計哲學

這檔不是「skills 多」,而是「對 agent 工作流的思考夠深」。看完 README 你會學到的不只是怎麼用,而是怎麼設計自己的 skill。

obra/superpowers — TDD 紀律的高山

obra/superpowers (150k+ stars,2026-05 持續快速增長中)由 Jesse Vincent 維護,是 2026 上半年 Claude Code 生態裡聲量最大的個人作品。它的 30+ skills 不是隨便堆砌,而是一整套有紀律的開發方法論:

  • Test-Driven:test-driven-development、testing-anti-patterns、condition-based-waiting
  • Debug 系統化:systematic-debugging、root-cause-tracing、verification-before-completion
  • 規劃/審查:brainstorming、writing-plans、executing-plans、subagent-driven-development、requesting-code-review、receiving-code-review
  • Git workflow:using-git-worktrees、finishing-a-development-branch

它的核心信念寫得很直白:「Write tests first, always」「Systematic process over guesswork」「Simplicity is the primary design goal」。如果你曾經被 Claude「自信地寫了一個沒測試的 bug fix」氣到,這套 skill 是反制方案。安裝 /plugin marketplace add obra/superpowers-marketplace。

affaan-m/everything-claude-code — 把 harness 當作品

affaan-m/everything-claude-code (175k stars,2026-05 快照)不是 skill 收藏,而是一整個「agent harness 效能優化系統」。它包了 48 個 subagent、185+ skills、34 條 always-follow rules(含 TypeScript / Python / Go / Swift / PHP 變種)、14 個 MCP server 配置。

作者宣稱在開源前已私下使用多月迭代,repo 於 2026 年 1 月上 GitHub 後成長極快。對於想把 Claude Code 當成「我這個人的延伸大腦」的人,這是最接近現成「整套人格 + 工作流」的選擇。

JuliusBrussee/caveman — 一個 skill 也能爆紅

JuliusBrussee/caveman (57k stars)證明「單一 skill 也能變現象級」。它做的事情很有趣:強迫 Claude 用「穴居人式」的縮略英文回答,repo 自報 10 個 prompt 測試下平均約 65% output 壓縮、範圍 22–87%,極端情境(解釋 React re-render)可達 87% 上限。

我自己跑過幾次,老實說對「機械式 coding」很有效(產 boilerplate、改變數名、寫測試),但對需要長鏈推理的任務(複雜演算法、跨檔案重構)會影響思考品質。Shareuhack 在 2026 年的實測文章 也提到,過度壓縮在需要 chain-of-thought 的複雜推理任務上可能拖累結果。所以——該省 token 時 caveman 上、該想清楚時關掉。

jarrodwatts/claude-hud — 終於有人做儀表板

jarrodwatts/claude-hud (22k stars)是一個 HUD plugin,把 context 用量、active tools、subagent 狀態、todo 進度、git 分支用視覺化方式顯示在 Claude Code 的 terminal 邊上。

它解決的是一個「你不用打它也明白現在發生什麼」的痛點。對於每天會跑 5 個以上 subagent 並行任務的人,這是必裝。

第三檔:awesome 集散地——把 GitHub 當 NPM 用

這檔是「我需要時去翻」的圖書館型 repo。不要每個都裝,挑 1–2 個逛即可。

Repo Stars 量體 特色
ComposioHQ/awesome-claude-skills 59k 1000+ 78 個透過 Composio MCP 連接 SaaS 的 app-automation skills
hesreallyhim/awesome-claude-code 43k 廣義 整個 Claude Code 生態的中央目錄(含 hooks、slash commands、status lines)
sickn33/antigravity-awesome-skills 37k 1450+ npx antigravity-awesome-skills 一鍵部署到指定工具
wshobson/agents 35k 185 agents + 153 skills 拆成 80 個聚焦 plugin、25 個類別
davila7/claude-code-templates 27k 模板 npx claude-code-templates@latest 互動式選裝;aitmpl.com 有 web dashboard
VoltAgent/awesome-agent-skills 21k 1100+ 收錄 Google、Microsoft、Stripe、Cloudflare、Vercel、Netlify、Trail of Bits、Binance 等企業官方 skills
alirezarezvani/claude-skills 14k 235 唯一完整覆蓋 C-Level、Regulatory & Quality Management、Finance 等管理面 skills
travisvn/awesome-claude-skills 12k 中型 分類清楚、有明確的安全警語
BehiSecc/awesome-claude-skills 9k 135+ 含「健康與生命科學」「學習與知識」冷門類別
karanb192/awesome-claude-skills n/a 50+ 每個 skill 都標星等、註明 Source 與是否人工驗證過

要特別點名一個 2026 年最大的陷阱——別把「skill 數量」當品質指標。buildtolaunch.substack.com 在 一篇實測文 直接點破:「Not everything in these repos is installable. 1,916 skills does not mean 1,916 things you can /plugin install.」很多 awesome list 收錄的是「指向其他 repo 的連結」而非可即裝包。挑 repo 時請看:(a) 有沒有 plugin.json / marketplace.json / npx 一鍵安裝(sickn33 與 davila7 屬此類);(b) 還是只是純連結清單(hesreallyhim 屬此類,當搜尋引擎用即可)。

第四檔:領域利基——一招打中的單點突破

這檔是「我只要解決這一件事」的 repo,通常 star 數不高但領域深度極強。

trailofbits/skills — 安全研究的天花板

trailofbits/skills (5k stars)是 Trail of Bits 這家全球頂級 security 顧問公司的官方 skill 集合,包含:

  • 智能合約:building-secure-contracts、entry-point-analyzer
  • 程式碼審計:agentic-actions-auditor、c-review、differential-review、semgrep-rule-creator、static-analysis(CodeQL + Semgrep + SARIF)、supply-chain-risk-auditor、variant-analysis
  • 驗證測試:constant-time-analysis(密碼學側通道)、mutation-testing、property-based-testing、zeroize-audit
  • 惡意軟體:yara-authoring
  • 逆向工程:dwarf-expert
  • 行動安全:firebase-apk-scanner

如果你做 AppSec、CTF、bug bounty,這是不裝白不裝的權威來源。安裝 /plugin marketplace add trailofbits/skills。

其他值得收進工具箱

  • lackeyjb/playwright-skill (2.2k stars):Claude 自主寫並執行 Playwright 自動化測試
  • timescale/pg-aiguide (1.7k stars):PostgreSQL skill + MCP,讓 Claude 寫出更好的 SQL
  • thedotmack/claude-mem :把每個 session 的 context 用 AI 壓縮存起來、下次自動注入相關片段——解決「Claude 三天後就不認得我做過什麼」的記憶問題
  • context7(官方 plugin):即時抓取最新 library 文件,避開訓練資料過時

claude-skills-personas

我的推薦組合:6 種角色,6 套搭配

我把上面所有 repo 重新組合成 6 個角色 starter pack。每組都是「3 個 skill / plugin 起跳」,不用第一天就裝滿。

入門開發者(剛裝 Claude Code 不到一週)

  1. anthropics/skills — 安裝 pdf / docx / pptx / skill-creator
  2. obra/superpowers — 至少裝 test-driven-development、brainstorming、writing-plans
  3. jarrodwatts/claude-hud — 看清楚 context 用到哪

進階全端工程師

  1. obra/superpowers 完整版
  2. wshobson/agents 挑語言對應 plugin(python / typescript / kubernetes)
  3. context7 — docs 即時 lookup
  4. (選)JuliusBrussee/caveman — 想省 token 時切換

安全研究 / AppSec

  1. trailofbits/skills — 全裝
  2. obra/superpowers 的 systematic-debugging、root-cause-tracing
  3. anthropics/skills/webapp-testing

行銷 / 成長

  1. anthropics/knowledge-work-plugins/marketing
  2. ComposioHQ/awesome-claude-skills 的 SEO / CRO / 內容 skill(如 claude-seo)
  3. alirezarezvani/claude-skills 的 marketing pod(44 skills 分 7 個專業)

知識工作者 / PM

  1. anthropics/knowledge-work-plugins/productivity + product-management
  2. BehiSecc/awesome-claude-skills 中的 Linear / Kanban / Google Workspace skills
  3. thedotmack/claude-mem — 長期專案必備

C-Level / 經營者

  1. alirezarezvani/claude-skills 的 C-Level pod(34 skills 覆蓋全 C-suite)
  2. anthropics/knowledge-work-plugins/finance + legal
  3. obra/superpowers/brainstorming + writing-plans — 把策略思考結構化

安裝 Cheat Sheet

# =<mark> 官方 marketplace </mark>=
/plugin marketplace add anthropics/skills
/plugins                                          # 進 UI 瀏覽

# =<mark> 明星框架 </mark>=
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers

/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/claude-hud:setup

# =<mark> 集散地(互動式選裝)</mark>=
npx antigravity-awesome-skills --claude          # 1450+ skills
npx claude-code-templates@latest                 # davila7 模板互動 CLI

# =<mark> 領域 </mark>=
/plugin marketplace add trailofbits/skills        # 安全
/plugin marketplace add wshobson/agents          # 多 plugin 拆裝

# =<mark> 知識工作者 </mark>=
claude plugin marketplace add anthropics/knowledge-work-plugins
claude plugin install sales@knowledge-work-plugins

# =<mark> 2026 Q2 新標準:gh CLI(跨 agent host)</mark>=
gh skill search pptx
gh skill install anthropics/skills skills/pptx@latest --agent claude-code --scope user
gh skill update --all
gh skill publish                                  # 你也可以發布自己的

中文社群觀察與寫作機會

研究完最大的感慨:繁中圈幾乎沒有人在維護 awesome-claude-skills。我用「claude skills 繁體 awesome」「claude skills 中文 推薦」等各種組合搜尋,最後找到的多半是中國大陸 medium 個人作者的短文、Reddit 翻譯、HackMD 個人筆記。

這同時是壞消息也是好消息。

壞消息是台灣團隊容易卡在「英文教學」與「實際團隊導入」之間的鴻溝,特別是中型公司的非工程同事很難自己摸索安裝流程。好消息是——這是內容創作者的肥沃土壤。任何願意把官方 README 用繁中重寫一次、加上台灣工程文化 context(例如「老闆要我加班裝這個」「主管怕資安所以連 marketplace 都不准用」)的人,都會非常受歡迎。

我自己這篇就是一個小小的補白嘗試。如果你也想開始,我建議從「fork 一個英文 awesome list 翻譯成繁中」開始,比從零寫快得多。

claude-skills-three-picks

結語:先選 3 個跑 1 週

寫完這篇我發現一個反直覺的結論——裝得越多越廢。

Skill 越多,Claude 在 marketplace 載入時讀的 metadata 越多、在做任務時也要花更多 token 去判斷該選哪個。我自己 2026 年 3 月那次大裝特裝之後,跑一個簡單 refactor 居然要 7 秒才開始輸出。後來砍到只留 12 個,速度立刻回來。

所以給你的具體建議是:

  1. 先選 3 個:1 個官方範例、1 個明星框架(強烈推薦 obra/superpowers)、1 個對應你工作的領域 skill
  2. 跑 1 週:故意挑日常會做的 5–10 個任務全程用這 3 個
  3. 再回頭評估:哪個你按一次「不要用這個 skill」?砍掉。哪個你會主動 @skill-name 召喚?保留並深入。
  4. 第二週再加 2 個:根據第一週的真實使用情境,從集散地 repo 挑兩個新的進來

這個節奏走 6 週,你會建立起一套真正屬於自己的工作流,而不是別人 README 的拼貼。

如果你覺得這篇有用,請把它分享給身邊還在 git clone skill 的朋友——順便提醒他升級到 gh skill。然後告訴我你最後留下的 3 個 skill 是什麼,我很好奇繁中工程社群最終會收斂出什麼樣的組合。

延伸閱讀


本文研究與寫作於 2026-05-11 完成;所有 GitHub star 數為當日快照,可能已變動。歡迎在留言區補上你最愛的 repo——尤其歡迎繁中作者的作品。


本文最初發布於 HackMD @BASHCAT。

8GB 的 RK3588 能跑多聰明的 LLM?ROCK 5C 用 NPU 實測 5 個模型

先講結論,省得你滑到最後: 在一片 8GB 的 RK3588 板子上,用 NPU 跑得最聰明的是 Qwen3-4B-Instruct-2507,我出的 7 題全對,但每秒只吐 3.7 個 token。 想要順一點的對話體驗,Qwen3.5-2B 的 8.4 tok/s 是比...