WeAgileAI 實作筆記 GUIDE / 001

AI SKILLS · 從一個檔案開始

讓 AI 照你的
方法做事。

把一套工作方法寫進 SKILL.md,讓 AI 在需要時讀取並使用。選擇你用的工具,跟著步驟建立第一個 Skill。

選擇我的 AI 工具 ↓手動建立檔案 · 全文直接複製
01 /

你在哪裡使用 AI?

先選工具,檔案放置位置與啟用方式會跟著切換。所有工具都使用下方同一份 Skill 文字。

GitHub Copilot 的設定方式

在 VS Code 的 Copilot Chat 中使用,檔案跟著專案一起保存。

官方文件 ↗
1

開啟工作專案

安裝並登入 GitHub Copilot,使用「檔案 → 開啟資料夾」開啟你的工作專案,再打開 Chat,選擇可使用工具的 Agent 模式。

2

建立資料夾與檔案

從專案最外層開始,依右方結構逐層建立資料夾,再新增 SKILL.md。將下方的完整內容貼入並儲存。

前往複製 Skill 全文 ↓
3

在 AI 對話中啟用

儲存後,在 Chat 輸入 /skills,確認清單中有 grill-boss;接著輸入 /grill-boss 並附上主管的原話。

也可從 Chat 的齒輪進入 Agent Customizations → Skills → New Skill (Workspace),命名為 grill-boss,再以本頁全文取代產生的內容。

試用對話

/grill-boss 主管說:「月底前幫我弄一份團隊導入 AI 的方案。」請先幫我釐清需求。

Cursor 的設定方式

Cursor 是獨立編輯器;在 Cursor 開啟你的專案,再於 Agent 對話中使用。

官方文件 ↗
1

開啟工作專案

安裝並登入 Cursor,開啟專案資料夾,打開 Agent 對話。若你在 VS Code 中,請切換到 Cursor 應用程式。

2

建立資料夾與檔案

從專案最外層開始,依右方結構逐層建立資料夾,再新增 SKILL.md。將下方的完整內容貼入並儲存。

前往複製 Skill 全文 ↓
3

在 AI 對話中啟用

儲存後,在側欄 Customize → Skills 確認 grill-boss 已被找到。在 Agent 對話輸入 /,選擇 grill-boss,再附上需求。

也支援專案的 .agents/skills/。這裡使用 Cursor 專屬路徑,方便第一次設定;同一個 Skill 不必在兩處重複放置。

試用對話

/grill-boss 主管說:「月底前幫我弄一份團隊導入 AI 的方案。」請先幫我釐清需求。

Claude Code 的設定方式

適用 Claude Code 的專案工作流程;可在 VS Code 擴充套件或終端機中使用。

官方文件 ↗
1

開啟工作專案

安裝並登入 Claude Code。在 VS Code 開啟專案,使用 Claude Code 擴充套件;或在這個專案的終端機執行 claude。

2

建立資料夾與檔案

從專案最外層開始,依右方結構逐層建立資料夾,再新增 SKILL.md。將下方的完整內容貼入並儲存。

前往複製 Skill 全文 ↓
3

在 AI 對話中啟用

儲存後,在該專案的 Claude Code 對話輸入 /grill-boss,再附上主管的原話。若未出現,重新開啟該專案的對話。

這是 Claude Code 的本機檔案設定。Claude 網頁版、Cowork 與雲端工作階段有不同的技能管理方式,不會直接讀取這個本機路徑。

試用對話

/grill-boss 主管說:「月底前幫我弄一份團隊導入 AI 的方案。」請先幫我釐清需求。

Codex 的設定方式

使用 Codex 的本機專案技能,讓桌面 App、IDE 擴充套件或 CLI 在對應專案中讀取。

官方文件 ↗
1

開啟工作專案

在 Codex 桌面 App 或 VS Code 的 Codex 擴充套件開啟本機專案;也可以在專案終端機執行 codex。

2

建立資料夾與檔案

從專案最外層開始,依右方結構逐層建立資料夾,再新增 SKILL.md。將下方的完整內容貼入並儲存。

前往複製 Skill 全文 ↓
3

在 AI 對話中啟用

Codex 會自動偵測 Skill 的變更。在專案對話中輸入 $grill-boss 並附上需求;若技能未出現,重新啟動 Codex。

這裡使用目前官方文件列出的 .agents/skills 路徑。$grill-boss 是對話中的技能名稱,不是要在終端機執行的 shell 指令。

試用對話

$grill-boss 主管說:「月底前幫我弄一份團隊導入 AI 的方案。」請先幫我釐清需求。

Gemini CLI 的設定方式

適用 Gemini CLI;你可以直接在 VS Code 的整合式終端機中操作。

官方文件 ↗
1

開啟工作專案

安裝並登入 Gemini CLI,開啟專案資料夾,在該資料夾的終端機執行 gemini。

2

建立資料夾與檔案

從專案最外層開始,依右方結構逐層建立資料夾,再新增 SKILL.md。將下方的完整內容貼入並儲存。

前往複製 Skill 全文 ↓
3

在 AI 對話中啟用

儲存後輸入 /skills reload,再用 /skills list 確認 grill-boss。以自然語言要求使用它;出現技能啟用確認時,閱讀內容後同意。

Gemini CLI 也支援 .agents/skills/。這些檔案設定不等於 Gemini 聊天網頁的 Gems 設定,也不是 Gemini Code Assist 的通用設定。

試用對話

請使用 grill-boss 技能。主管說:「月底前幫我弄一份團隊導入 AI 的方案。」請先幫我釐清需求。

02 / SKILL.md

複製這份
工作方法。

grill-boss 會先辨別能查的事實、你能決定的事,以及必須向主管確認的事,再整理可落地的方案。

  • 只有這一份檔案,沒有額外附件。
  • 完整保留開頭的 --- 區塊。
  • 貼入純文字檔,以 UTF-8 儲存。
SKILL.md Markdown
原文完整收錄 · 從第一個 --- 複製到最後一行

03 / 確認生效

AI 應該先問你,
而不是立刻交方案。

回到上方選擇的工具,複製「試用對話」送出。這份 Skill 的第一步,是把模糊需求拆開問清楚。

回到工具的測試文字 ↑
  1. 先追問主管為什麼現在提出需求、成果給誰看。
  2. 釐清完成標準、期限,以及可用的人力與資源。
  3. 把你能決定的事項與「問主管清單」分開。
  4. 資訊不足時,明列假設;釐清後再產出方案。
04 /

卡住時,先看這裡。

儲存了 SKILL.md,AI 還是沒有使用它?

先確認你開啟的是放有 Skill 的專案,檔名不是 SKILL.md.txt,而且 name: grill-boss 與資料夾名稱一致。保留 YAML 開頭與結尾的 ---。依工具的清單或啟用步驟檢查,再開新對話;也可直接要求 AI「請使用 grill-boss」,並確認它有讀取對應檔案。

檔案要放在電腦哪裡?

「專案最外層」就是你透過 VS Code、Cursor 或 AI 工具開啟的那個資料夾。若資料夾叫 my-work,Copilot 的完整位置就是 my-work/.github/skills/grill-boss/SKILL.md。以點開頭的資料夾可能在檔案總管中隱藏,但在編輯器內仍可建立。

我只用 ChatGPT、Claude 或 Gemini 聊天網頁,可以怎麼做?

一般聊天網頁不會自動讀取你電腦裡的技能目錄。你仍可複製完整文字,直接貼入對話,再加上「請依照以上方法處理接下來的需求」和主管的原話。這是本次對話的使用方式;若要跨對話保留,需另外使用該產品提供的自訂指令或專案設定,不能只靠本機檔案。

Skill 和每次貼上的提示詞有什麼不同?

Skill 把名稱、適用時機與處理流程存成可重複使用的檔案。支援它的工具會先辨識名稱與說明,再在適合的任務中讀取完整內容。你仍然要提供實際情境;Skill 不會自動知道主管的目的,也不保證每個模型都產生相同回答。

這個 Skill 可以改成自己的版本嗎?

可以。先保留目前版本測試,再調整流程或用語。如果改了 name,也要一起改資料夾名稱與對話中呼叫的名稱。請用不含公司機密的例子試跑,確認 AI 的提問順序與輸出符合你的需要。

設定方式查核:2026-09-16。產品介面可能更新,若選項不同請以官方文件為準。