一段話開一個專案資料夾:README、CLAUDE.md、skill、input/output
「我想做一個 skill 幫我跑一個專案,資料夾裡要有哪些東西?從哪裡開始?」夥伴的提問
嚮導用一段話請 AI 開好整個專案:給人看的 README、給 AI 看的 CLAUDE.md 和三條規則、一個 skill、放需求和成品的兩個資料夾。附整理過可直接貼的指令,以及 skill 藏在哪、AGENTS.md 和 CLAUDE.md 的差別(對過官方文件)。
有夥伴問:想做一個 skill(一份寫好、可以重複用的固定做法)來幫自己跑一個專案,要從哪裡開始?嚮導當場講了一段話,AI 就把整個專案資料夾開好:給人看的說明、給 AI 看的規則、一個 skill,還有放需求和放成品的兩個資料夾。
動手之前
01需要的工具和幾個詞
這一篇要用能在你電腦上建資料夾、寫檔案的 AI。課堂上用 Claude Code 示範,是在 VS Code 下方的終端機裡叫出來的,怎麼叫出來看 在 VS Code 裡用 AI。只用網頁版對話的話,它沒辦法直接在你的電腦上建資料夾。
用 Codex 或 Gemini CLI 的人也能照做,只是給 AI 看的規則檔要換一個檔名,見最後一節「同一種東西,各家叫法不同」。
示範日期 2026 年 10 月 20 日。各家工具的檔案規則會調整,下面關於檔名和位置的說法,附了查證的來源和日期。
課堂上的那一段話
主題隨手挑:跳針音樂
他交代了哪幾件事
02一段話,五件事
那天大家一時沒有題目,嚮導順著當時放的背景音樂,隨手起了一個名字叫「跳針音樂」。這個名字沒有特別的意思,換成任何題目都可以。要做的事是用 Suno 來寫歌;Suno 是一個用文字描述就能生成音樂的 AI 服務。他用講的,一口氣交代了這些:
嚮導講為什麼要兩份說明:README.md 是讓大家知道這個資料夾在做什麼;CLAUDE.md 是讓接手的人用自己的 AI 打開時,AI 立刻知道這裡的工作規矩。
可以直接貼的一段
03整理過的版本
下面是把課堂上那段口語整理成一段可以貼的指令,不是逐字原話。括號裡的地方換成你自己的題目。對照上面的五件事:第一件寫在開頭那一句,第二到第五件依序是指令裡的 1 到 4。
這段指令會讓 AI 把你交代的需求存進 input 資料夾。填偏好和需求時,不要寫進別人的名字、聯絡方式這類資料。
請幫我建立一個專案資料夾,放在(下載資料夾,或你要的位置),名字叫「(專案名稱,例如:跳針音樂)」。 這個專案裡要有: 1. 一個 skill 它擅長:(例如:幫我寫 Suno 的曲風描述和歌詞) 怎麼寫才做得好,請你先上網查今年最好的做法,再寫進 skill 裡。 我的偏好:(例如:歌詞可以是英文、日文、韓文、繁體中文) 2. 兩個資料夾 input:我跟你講的任何工作需求,都存一份在這裡。 output:用 skill 做出來的成品,放在這裡。 3. README.md 寫給人看的。以後我把這個資料夾交給別人,對方讀這份就知道這是在做什麼。 4. CLAUDE.md 寫給 AI 看的工作規則,三條: - 用繁體中文跟我對話 - 遇到問題先上網查,找今年最好、最簡單、最不依賴框架的做法 - 我說要結束的時候,就算只做到一半,也寫一份收工筆記,記下做到哪、下一步是什麼 做完之後,請把整個資料夾的結構列給我看,包含隱藏的資料夾,每個檔案用一句話說它是做什麼的。 也請列出你為了寫 skill 上網查過的網址。
它交回來的時候,看一下有沒有列出查過的網址。沒有列,就當它沒有查,skill 裡寫的做法可能只是它原本知道的。
開出來的東西
打開來一份一份看
README.md
04一句話講清楚這裡在做什麼
AI 寫的 README.md 開頭就說明:這是用 Claude Code 寫 Suno 曲風和歌詞的專案;創作需求放 input,創作結果放 output。任何人拿到這個資料夾,讀完第一段就知道這是做跳針音樂的。
CLAUDE.md
05三條之外,還多了檔案規則
他要的三條都在:用繁體中文回答、上網找最好最簡單的做法、結束前寫收工筆記。另外還多了幾條檔案規則:
放哪裡
所有需求放 input,所有產出放 output。
有新版本
加上版本號另存,不蓋掉舊的。
要丟的檔案
不直接刪,移到一個叫 trash 的資料夾,由使用者決定要不要真的刪。
這幾條檔案規則,嚮導在那段話裡沒有講。Claude Code 除了讀專案裡的 CLAUDE.md,也會讀你使用者資料夾裡的 ~/.claude/CLAUDE.md,那一份對這台電腦上的所有專案都有效。嚮導在那一份裡平常就寫了類似的規則,AI 可能是從那裡帶過來的。你做的時候不一定會出現;想要的話,自己寫進 CLAUDE.md。這一層的用法見 CLAUDE.md 分兩層。
skill
06藏在一個名字前面有點的資料夾裡
skill 不在專案資料夾的第一層。它在專案資料夾裡一個叫 .claude 的資料夾中,路徑長這樣:
跳針音樂/.claude/skills/(skill 的名字)/SKILL.md
資料夾名字前面有一個點,代表它是隱藏資料夾。Mac 的 Finder 預設不顯示這種資料夾;VS Code 左邊的檔案區通常會列出來,但是收合著,要點開才看得到裡面。
課堂上嚮導第一眼看路徑,以為 skill 被放在整台電腦共用的那一層(下一節會講兩層的差別)。他沒有自己去翻,而是請 AI 把完整位置印出來、直接把那個資料夾打開。打開之後才看清楚:在專案資料夾裡面。
看不懂路徑,就請 AI 把完整位置印出來,或直接幫你打開。
下課前的追問
檔名和位置的規矩
skill 放哪一層
07綁專案,還是綁整台電腦
嚮導的說法:只跟這個專案有關的 skill,放在專案裡;每個專案都要用的,放在整台電腦那一層,會影響這台電腦的所有專案。
專案這一層
專案資料夾/.claude/skills/(名字)/SKILL.md
只在這個專案裡用。資料夾交給別人,skill 跟著走。
整台電腦這一層
~/.claude/skills/(名字)/SKILL.md
這台電腦上的所有專案都用得到。~ 是你的使用者資料夾。
查證:上面兩個位置對照 Claude Code 官方文件的 skill 說明頁(Claude Code:Skills,2026 年 10 月 20 日查)。每個 skill 一個資料夾,裡面那份檔案一定叫 SKILL.md。
AGENTS.md 和 CLAUDE.md
08同一種東西,各家叫法不同
有夥伴問到 AGENTS.md。嚮導的說明:它跟 CLAUDE.md 是同一種東西,都是給 AI 看的工作規則,只是不同家的 AI 認不同的檔名。
課堂上他說 Gemini 和 Codex 用 AGENTS.md。寫這篇時去對了各家官方文件,細一點的情況是這樣(2026 年 10 月 20 日查):
所以你可以這樣判斷:你用哪一家,就照那一家認的檔名寫。照著上面那段指令做的話,把「CLAUDE.md」換成你那一家的檔名。好幾家輪流用,就問你的 AI 怎麼讓一份規則給好幾家共用。
檔名為什麼都是大寫?嚮導的回答很老實:他也不知道,做這些工具的人定的寫法就是這樣,照著寫就好。
帶得走的東西
一段話講清楚:做什麼、放哪裡、給人看的、給 AI 看的。
開完之後,請 AI 把結構列給你看,連隱藏的資料夾一起。
同一堂課,AI 怎麼讀你交代的需求:AI 把你的話壓成幾個關鍵字:要它兩個版本都給你看。
留言
CYC 看過才會公開。
還沒有公開的留言。