夥伴作業

作業回饋:夥伴做的 Claude Code 新手安裝教學

「我是第一次用 Claude Code 的初學者,用 Windows。請做一份能直接複製貼上的安裝教學,教我裝好、寫第一個 CLAUDE.md 和第一個 SKILL.md。」作業題目

第一次做就交出一份能照著走完的教學。三個可以更好的地方,照優先順序:讓 AI 習慣說台灣正體中文、補上為什麼與怎樣算好的故事、顏色和符號減半。附一段直接交給 AI 的修改提示詞。

第一次做,就交出一份別人能照著走完的安裝教學。先說做得好的,再說三個可以更好的地方,照重要的順序排。

夥伴的作品

01Claude Code 新手教學(Windows 版)

課堂上用 Claude App 的對話模式,一段話做出來的。下面就是原作,可以直接在框裡操作:按複製、打勾看進度。

在新分頁打開原作。原作一字未改,保留當時的樣子。

先說做得好的

02四個地方,已經比很多教學好

每一步都能打勾

上方有進度條,做完一步勾一步。初學者最怕不知道自己做到哪裡,這個設計直接解決。

標清楚「貼到哪裡」

每段指令都寫著要貼到終端機、貼到 Claude,還是貼到記事本,旁邊就是複製按鈕。這正是當初要求的。

有「出問題了」

把最常卡住的四種狀況和解法放在最後,還附一段萬用的求救提示詞。

已經有驗收的念頭

裝完看版本號、問 Claude「你從 CLAUDE.md 知道了什麼」、看 Skill 的回答格式對不對。這些就是「怎麼知道自己做對」,只是散在各處。

三個可以更好的地方

照重要的順序

第一優先

03先讓你的 AI 習慣說台灣正體中文

現況全篇是簡體字。連它寫給你的 CLAUDE.md 範本,都寫著「永遠用簡體中文回答」。
為什麼先改這不只是這一份文件的問題。照著範本做完,你之後每一次跟它說話,它都會用簡體回你。
怎麼改跟它說一次,並且寫進它每次都會讀的地方。App 版寫在設定裡的個人偏好;終端機版寫進 CLAUDE.md。兩邊都能設,用哪個版本就設哪邊。
怎樣算好開一段新的對話,什麼都不提醒,它的第一句話就是正體;用詞是資料夾、檔案、程式、登入,不是文件、程序、登錄。

要寫進去的那一句,複製這段就好:

請一律使用台灣正體中文(zh-Hant-TW)與台灣慣用語回答我,不要使用簡體字。

第二優先

04補上故事:為什麼學、怎麼做、做到怎樣算好

現在一打開,就是目標清單和步驟。步驟寫得很好,但讀的人不知道為什麼要花這一個小時,也不知道做完了要看什麼才算成功。

摘要一句話:這份教學做什麼、學完會拿到哪三樣東西。
為什麼一個真實的情境:在終端機打了 claude 沒反應,不知道從哪裡開始。學會之後,AI 可以直接在你的電腦上幫你建檔、改檔。
怎麼做原本的安裝步驟,保留。
怎樣算好一張檢查表:做到每一步,畫面上應該看到什麼;再寫一個常見的失敗樣子。把原本散在各處的驗收收進這裡。

怎樣算好:一個沒來上課的人,只讀前三段,就說得出「我為什麼要做、做完會拿到什麼、怎麼知道我做對了」。

第三優先

05視覺:留下米色,拿掉一半的顏色和符號

現況米色底很舒服,這個留著。但同一頁有橘、綠、黃、藍、紫五種強調色,還有 14 種表情符號、一共用了 50 次。
為什麼顏色每多一種,讀的人就要多記一種意思;符號一多,真正的重點反而看不出來,整份看起來就不夠專業。
怎麼改一個主色加灰色就夠了。「貼到哪裡」的三種標籤用文字分,不用顏色分。表情符號全部拿掉,真的需要圖示,就用單色的線條圖示。
怎樣算好把畫面截圖轉成黑白,還是看得懂哪裡是重點、哪裡是提醒。

給 AI 的修改提示詞

複製下面這段,連同原本的 HTML 檔一起交給你的 AI

怎麼用

06一段話,三件事一次改

App 版:把原本的 HTML 檔附加上去,再貼這段。終端機版:把檔案放在同一個資料夾,貼這段,並在第一行寫上檔名。

我附上一份我做的 HTML 教學《Claude Code 新手教學(Windows 版)》。請幫我改版,依照下面四點依序做:

1. 語言:全篇改成台灣正體中文與台灣慣用語(例如:資料夾、檔案、程式、登入、預設)。html 的 lang 改成 zh-Hant-TW,字型改成台灣字型優先(PingFang TC、Microsoft JhengHei、Noto Sans TC)。範本裡「永遠用簡體中文回答」全部改成「永遠用台灣正體中文回答」。

2. 故事:在步驟前面補三段——
   - 摘要:一句話說這份教學做什麼,學完會拿到哪三樣東西。
   - 為什麼:一個初學者的情境:在終端機打 claude 沒反應,不知道從哪裡開始;學會之後,AI 可以直接在自己的電腦上幫忙建檔、改檔。
   - 怎樣算成功:一張檢查表,每一列寫「做到這一步時,畫面上應該看到什麼」,再寫一個常見的失敗樣子。把原本散在各步驟的驗收(版本號、CLAUDE.md 測試、Skill 回答格式)集中到這裡。
   原本的安裝步驟保留,放在「怎麼做」。

3. 視覺:保留米色底色;只留一個主色(橘色)加灰色,拿掉綠、黃、藍、紫;三種「貼到哪裡」的標籤改用文字區分,不用顏色區分;拿掉所有表情符號,需要圖示時用單色線條 SVG。

4. 不要動:指令內容、複製按鈕、打勾進度的功能。

改完請給我完整的 HTML 檔,並用五行以內告訴我改了什麼。

改完之後,拿上面每一點的「怎樣算好」自己對一次。三點都對得上,就是一份可以分享出去的教學了。

帶得走的東西

請 AI 做教學時,一開始就交代:

「用台灣正體中文。先講為什麼,再講怎麼做,最後告訴我怎樣算做對。顏色和符號越少越好。」

留言

CYC 看過才會公開。

還沒有公開的留言。

看其他作業

留言