跳至主要內容
← 返回部落格

Claude Code Skills:安裝、建立與驗證

加入 Claude Code Skills,撰寫最小 SKILL.md,檢查輸出,並區分本機指令與外部應用任務。

OOMOL

Skill 能保存重複使用的流程,例如整理版本說明或檢查報告。先選範圍小、結果可核對的任務。本機寫作 Skill 不需要 OOMOL 帳號;外部應用仍需要工具和授權。

建立專案 Skill

在本機專案中建立 .claude/skills/release-note-outline/SKILL.md。個人 Skill 可放在 ~/.claude/skills/,供本機不同專案使用;專案 Skill 可隨儲存庫分享。雲端和受管理環境的載入規則可能不同,請參考官方指南。以下原創英文範例採手動呼叫:

---
name: release-note-outline
description: Turn supplied change notes into a release-note outline.
disable-model-invocation: true
---
Use only the change notes supplied by the user.
If no change notes are provided, ask the user to supply them.
Return three headings: Added, Fixed, Questions.
Put each confirmed change under Added or Fixed.
Put unclear claims under Questions. Do not invent versions or dates.
Do not edit files, run commands, or publish anything.

用已知輸入驗證

呼叫 /release-note-outline,輸入:“Added CSV export. Fixed duplicate notifications. Faster reports, but no measurement yet.”

確認輸出有 Added、Fixed、Questions。CSV 匯出和通知修正應歸類為已提供變更;尚未量測的速度說法應列為問題。在同一專案開啟新對話,不帶入先前的變更說明,再以空白輸入呼叫 /release-note-outline,確認它詢問變更內容,而非沿用前例。

安裝現有 Skill

先閱讀 SKILL.md 和附帶腳本,確認任務、檔案修改範圍、憑證與費用。將可信的獨立 Skill 資料夾放入適當位置,保留支援檔案;若透過外掛分發,遵循外掛安裝說明。用熟悉的小樣本驗證,選單出現只代表已被發現。

假設你已審閱 ~/Downloads/release-note-outline/ 這個獨立資料夾,將整個資料夾複製到儲存庫的 .claude/skills/,應得到 .claude/skills/release-note-outline/SKILL.md。不要多放一層同名資料夾;保留 scripts/、references/ 等附檔。

跨專案使用時改放在 ~/.claude/skills/release-note-outline/,只選一處。若已建立前例,檢查原資料夾即可,不要覆寫。在目標專案開啟 Claude Code,輸入 / 找到命令,並用前述輸入執行 /release-note-outline。

手動與自動呼叫

disable-model-invocation: true 讓你手動決定執行時機。移除欄位或改成 false 可允許自動選擇;description 要寫清任務與適用時機。用「把這些變更整理成發布說明」測試,再確認是否使用目標 Skill。

排除執行問題

檢查目錄、檔名、frontmatter 和會話工作目錄。同名 Skill 或組織政策可能影響可用性。此例設定 disable-model-invocation: true,需手動輸入命令。若結果不佳,調整輸入要求和缺漏資訊的處理方式。

依任務選擇

處理提供的文字可從上述發布說明 Skill 開始,不能補造缺少的變更。程式碼審閱應讀取相關檔案並引用路徑;外部研究應交代帳號、來源、查詢限制與費用。

從 Skills 目錄挑選,按需設定 Claude Code 的 OOMOL 接入,也可直接使用 OOMOL Chat。

Skills、MCP 與外掛

Skill 描述流程,MCP 提供工具介面,外掛可打包不同能力。安裝 Skill 不會自動取得帳號權限。試著透過 Jira讀取一筆 Issue 或用 GitHub檢查 PR,核對來源與結果。選擇介面時參考 MCP 與 API。