課程講義從 Chat 到 Harness
範本
AI Agent 應用課程・下半場兩小時・含 40 分鐘動手

工具會換,
repo 不會。

上半場讓 AI 有了手腳和規則。今天看三件事:為什麼用 Git 當 AI 的長期記憶、怎麼讓「絕不能忘」的規則由系統保證,以及怎麼把整套工作系統帶回家。

講師|林琮堡・高雄醫學大學 口腔醫學院 計畫經理 示範資料均為虛構合成資料,僅供教學。

00
上課前完成

上課前

今天有兩段要你動手:第 7 段 25 分鐘、第 8 段 15 分鐘。一定要帶筆電(Windows 或 Mac),並在課前完成下面的課前作業。

  • 確認一下

課前作業:點兩下安裝檔(約 15 分)

第 7、8 段的「換你做」,要讓 AI 在你的電腦上建資料夾、存檔、上傳 GitHub。一個安裝檔全部幫你裝好:AI 工具、git(版本管理工具)、gh(GitHub 官方的命令列工具),並帶你登入 GitHub;最後在桌面放一個「開始上課」捷徑。

先完成上面的 GitHub 註冊與隱藏信箱,再執行安裝檔。安裝檔的第 4 步會帶你登入 GitHub;沒有帳號就會卡在那裡,驗證信也可能晚到。

第 1 步|下載安裝檔,點兩下

WindowsMac
下載 Windows 安裝檔 → 按右鍵「全部解壓縮」→ 點兩下 install-ai-course.bat。跳出「Windows 已保護您的電腦」:按「其他資訊」→「仍要執行」。跳出「是否允許此 App 變更你的裝置」:按「是」。下載 Mac 安裝檔 → 點兩下解壓縮 → 點兩下 install-ai-course.command。跳出「無法打開…Apple 無法驗證」:按「完成」,到系統設定 → 隱私權與安全性,最下面按「仍要打開」再輸入電腦密碼。跳出「安裝命令列開發者工具」:按「安裝」→「同意」,裝完會自動繼續。

第 2 步|照畫面回答兩件事

  1. 選 AI 工具:直接按 Enter(=1,Codex)

    Codex 用 ChatGPT 帳號,免費版就能上課跟做。已有 Claude Pro 的可以選 2 或 3。

  2. 登入 GitHub

    畫面出現 8 碼代碼並打開瀏覽器:有問題出現就直接按 Enter;在瀏覽器登入 GitHub、貼上代碼、按授權。瀏覽器沒自己打開,就自己開 github.com/login/device。密碼只在瀏覽器裡輸入。

看到「🎉 安裝完成」就好了。署名會自動設成 GitHub 提供的不公開信箱,不會露出你的真實 email。

兩件事:① 把「🎉 安裝完成」畫面截圖,在開課前 2 天填課前驗收表單(填 GitHub 帳號名稱、上傳截圖;需登入 Google)。② 課前除了登入,先不要用 Codex:免費版一個月大約只夠做 10 件事,要留給上課的第 7、8 段。

第 3 步|點兩下桌面的「開始上課」,登入 AI 工具

桌面會多一個 開始上課-Codex(選 Claude Code 的是 開始上課-Claude)。點兩下會在你的課程資料夾打開 AI 工具;第一次會請你登入:Codex 選 Sign in with ChatGPT,用瀏覽器登入你的 ChatGPT 帳號。看到可以打字的畫面就完成,關掉即可。

不用一直按「允許」:捷徑已設好「代我核准」(Codex 的 Approve for me、Claude Code 的 auto 模式),一般操作由 AI 審查員替你核准,危險動作仍會擋下。你只要看它做了什麼。

課程資料夾在你的使用者資料夾裡(ai-course),不放桌面:很多 Windows 的桌面會被 OneDrive 同步,Codex 在同步資料夾裡會無法啟動。

已實測:安裝檔 2026-10-05 在全新的 Windows 與 Mac 雲端環境實跑通過(裝好工具、新開視窗打得出指令、捷徑設定正確、中文不亂碼)。學校或公司的電腦可能擋安裝,請改用個人筆電;安裝檔跑不動時,看 卡住了怎麼辦 的「安裝檔跑不動」。

→

今天的流程

實際時間會依現場狀況調整。

    ↺

    上半場走到哪

    Model 決定會不會想;Harness 決定能不能做、怎麼做、出錯怎麼修、哪些絕對不能做。

    L1Prompt(提示)

    每次口頭交代。

    上半場
    L2Repository Instructions(常駐規則)

    規則寫成檔案,AI 每次先讀。

    上半場
    L3Skills(技能檔)

    連 SOP(標準作業程序)都變成可載入的檔案。

    第 6 段
    L4Enforced Harness(強制機制)

    重要規則由系統保證,不靠 AI 自覺。

    第 9 段

    上半場結尾留下的問題:寫在規則檔裡的東西,AI 可能忘。絕不能忘的規則怎麼辦?今天第 9 段回答。

    06
    看示範

    Skills:程序性知識

    SOP 從「每次口述」變成「可載入的檔案」,任務相關時 AI 自動拿出來照做。這就是 L3。

    Instructions(常駐規則)管原則

    例:「檔名用日期開頭」。

    Skill(技能檔)管程序:一步一步怎麼做

    例:「企劃書檢核 SOP」。寫成 SKILL.md 這個檔案,任務相關時自動載入。

    示範:企劃書檢核 Skill

    Skill 裡寫三條:必填欄位齊全?經費加總正確且不超上限?申請日早於活動日至少 14 天?拿兩份有問題的虛構企劃書當靶。

    想回家自己重現:有 Claude Code 或 Codex 的,貼下面的 P14,它會自己下載檔案、放到對的位置。

    只想看檔案內容(虛構文件):Skill 檔 SKILL.md;企劃書三份 寒假營隊、期末成果展、AI 入門工作坊,加上規則檔 企劃書格式要點。

    • 看示範時注意

    檢核清單本身就是「驗證」:不是相信 AI 做對,而是設一道檢查。

    一份真的能用的「出稿前檢核」

    任何文件對外交付前,逐項核對:

    1. 禁止事項清單逐條掃過

      這份清單怎麼長出來,第 9 段講。

    2. 人名、職稱、單位名稱與正本核對
    3. 數字與來源核對

      並標明數字的期間與性質。

    4. 每一張圖片的授權狀態確認
    5. 時效性

      文中的「目前」「今年」「現任」是否仍正確。

    第 3 項最容易出事:產出量 ≠ 成效
    寫法是什麼
    「辦了 10 場活動、收了 200 份問卷」產出量(output)
    「參與者的能力提升了」成效(outcome)

    兩者不得互換書寫。把產出量寫成成效,在申請書、成果報告、研究論文裡都是硬傷。

    沒有 Claude Code 也能用:把下面這段存進 Project 的 Instructions,就是一個「出稿前檢核」工作區。

    用 Codex 怎麼做(實測於 2026-10-04、2026-10-05,Codex 命令列版)

    • 同一份 SKILL.md 一字不改,放到 .agents/skills/proposal-check/SKILL.md(課堂上放 .claude/skills/)。
    • 實測它自己找到並載入,三份企劃書的判定與課堂相同。想手動叫用,打 $ 或 /skills 選它。
    07
    全課核心你要動手

    Git/GitHub:為什麼用 Git 建 AI 的長期記憶

    從第 4 段一路累積的每一次整理、每一條規則、每一個 Skill,全部有紀錄、有時間、有差異比對。這個資料夾,就是 AI 的長期記憶。

    上雲

    操作意義
    push(推送)上傳到 GitHub=備份+可以協作
    clone(複製)整套搬到任何一台電腦

    為什麼是 Git:四個理由

    1 明文記憶是看得見的檔案,不是黑箱。
    2 可稽核(auditable)每次改動都留下差異與歷史。
    3 可修正記錯了就改檔案、留紀錄,錯誤不再擴散。
    4 可帶走(portable)clone 到哪,記憶就跟到哪。

    示範:AI 記錯一件事

    想一想:AI 記錯一件事,記在聊天記憶(memory 功能)裡怎麼改?記在 repo 裡又怎麼改?

    • 看示範時注意

    但 diff 只回答「改了什麼」

    半年後你真正會問的是:當初為什麼這樣做?幹部交接時,新任者最常問的也是「為什麼是這樣」。Git 記不住這個,所以要多一份檔案。

    檔案回答
    Git 歷史(commit+diff)改了什麼
    決策紀錄(Decision Log)為什麼改

    編號 D1、D2、D3…不重編、不跳號;之後引用直接寫「依 D3」,不必複述。

    對照:黑箱式「AI 記憶功能」

    各家聊天產品的 memoryGit repo
    看得到全貌嗎存在服務商那裡,看不到全部是你的檔案
    改得了細節嗎錯了難以精準修正改哪一行都留紀錄
    換平台歸零clone 過去就好

    這個骨架,現在給你

    上半場第 5 段套上去的那份規範檔,由講師實際工作方式簡化而成,是一份公開的 template repository(範本倉庫,可一鍵複製成你自己的 repo)。裡面有 CLAUDE.md、決策紀錄.md(含格式範本與 D1 實例)、治理擴增指南.md,以及三個用途目錄。授權 CC BY 4.0:可自由改作,標示來源即可。

    換你做|25 分鐘

    做完你會有:一個自己的 private repo,而且親眼看到改動的紀錄。

    用 agent 把骨架帶回本機

    1. 點兩下桌面的「開始上課」

      會在課程資料夾打開 AI 工具。第一次會問要不要信任這個資料夾,選信任。

    2. 複製下面的 P12,整段貼上

      它會依序做 9 步:檢查工具、確認登入(沒登入會帶你登入)、設定署名、從範本建 private repo 並下載、建三區、(Codex)改名 AGENTS.md、寫進規則檔、commit 並上傳、確認 Private。

    3. 看它做,不用按允許

      「代我核准」會替你放行一般操作,約 2–3 分鐘做完。畫面停住、或出現你看不懂的問題,舉手。

    4. 打開 GitHub,確認 Private,點 Commits 看 diff

      最上面那筆就是 AI 幫你做的;點進去看它改了哪些檔。

    5. 關掉視窗,再點兩下「開始上課」

      這次會直接在 my-harness 裡打開,AI 就會讀到它的規則檔。第 8 段從這裡接著做。

    Codex 免費版就能做這段(2026-10-05 以免費帳號、代我核准實測:約 2–4 分鐘,不需要按任何允許)。它若說 token 無效或 Permission denied,那是沙盒(AI 的安全隔離區)的限制,它會自己申請在沙盒外重跑,不要去改電腦的代理設定。

    免費版一個月大約只夠做 10 件事(實測:第 7 段+10 則課後提示詞就用完,30 天後恢復)。課後的優先順序見第 10 段。

    三區:轉入、轉出、工作

    資料夾放什麼進版控嗎
    轉入區/外來的檔案(別人寄來的、下載的),處理完再歸檔只有說明檔進
    轉出區/要交出去的檔案(寄出的、送件的)只有說明檔進
    工作區/草稿與暫存只有說明檔進

    知識庫本體只放整理好的東西;外來的、要交出去的、還在寫的,各有一區。這是「單一正本」的延伸。P12 已經幫你建好。

    權限:預設就是「代我核准」

    課前安裝的捷徑已經把權限設成代我核准(Codex 叫 Approve for me,Claude Code 叫 auto 模式):一般的改檔、連網、commit 由另一個 AI 審查員替你判斷放行,刪除或看起來危險的動作仍會擋下。你只要看結果。

    想保護某一個檔案(例如名冊不准改、經費表改之前先問):Claude Code 貼上半場講義的 P19;Codex 沒有針對單一檔案的設定,改用第 9 段的 P15(Hook)。課堂上老師示範的「先問/禁止」就是這兩種做法。

    • 確認一下

    你剛剛親手做了一次「可稽核」:規則的每一次改動,都留下看得見的紀錄。

    帶走的其實是三句話

    1. 規範寫下來,不放在腦裡

      你會忘,組員會換,AI 讀得到檔案、讀不到默契。

    2. 每件事實只有一個正本

      同一資訊存兩處,遲早其中一處是錯的。

    3. 先裁定,後動工

      重要修改先列選項與利弊,決定了才動手,並留下紀錄。

    工具會換,這三句不會。

    用 Codex 怎麼做(實測於 2026-10-04、2026-10-05,Codex 命令列版)

    • push、clone 是 Git 的事,跟用哪個 AI 無關,步驟完全一樣。
    • 「記錯一件事」實測:Codex 第一輪的推論和課堂不同,但人裁定後改正的檔案一致,也同樣不改會議紀錄、自己寫決策紀錄。要它 commit 時同第 4 段:自己 commit,或靠 Stop Hook。
    08
    你要動手

    說不清楚也沒關係:讓 AI 幫你收斂需求

    骨架帶回來了,裡面要放什麼規則?大部分人卡在這裡:不是不會寫,是不知道要寫什麼。這段練習先講一個大方向,讓 AI 一題一題問你,最後寫進你自己的治理系統。

    換你做|15 分鐘

    1. 寫一句大方向1 分

      想不到就挑一個:「管理實驗室讀書會的共筆」「整理研究計畫的文獻與進度」「準備社團活動企劃書」。

    2. 貼 P20,讓 AI 訪談你8 分

      把【】換成你的大方向。它一次只問一題、附選項和建議,最多 7 題,最後給你一份需求摘要。看過沒問題再往下。

    3. 同一個對話貼 P21,寫進治理系統5 分

      它會先說要加什麼:規則條文、一筆決策紀錄、一份「痛了再升級」清單。你同意後才動手。

    4. 看過內容,同意再 commit1 分

      它改完會給你看,同意後它 commit。

    在第 7 段建好的 my-harness 資料夾開 Claude Code 或 Codex,P20、P21 都在這裡貼。

    • 做完檢查

    把說不清楚的需要,變成寫得下來的規則,而且留下為什麼這樣定。這就是建構自己的治理系統。哪些要升級成 Hook?等它真的痛了再說,下一段就講。

    09
    看示範

    Hooks:從自動化到強制

    「請 AI 記得」和「系統保證」是兩回事。絕不能忘的規則,要交給系統。

    先看軟約束的極致:禁止事項清單

    什麼時候開始寫:你第一次發現「這個錯誤絕對不能再犯」的時候。請 AI 在規則檔開一節,逐條編號 N1、N2…,每條寫:錯誤寫法/正確寫法/適用範圍/例外。用下面的 P09,它會照格式加進去,你看過再 commit。

    寫法評價
    「N3:成員個資不外流」好:違反了你知道是哪一條
    「N3:注意個資與授權與時效」差:出事時不知道違反了哪一半

    鐵則:一條寫一件事,不要合併。

    建議加進你的清單(用 P09 請 AI 加,一次一條):

    • 授權不明時,一律當作不可公開。照片、他人作品、活動紀錄,查不到授權依據就不要用,回頭問清楚。
    • 引用文獻,一律回原文核對。文獻筆記是自己寫的摘要,寫錯了不會自己發現;題目、數字、計分方式,引用前回原文確認並附頁碼。第 7 段那份照抄錯誤共筆的詞向量筆記,就是反例。

    但是:痛了才升級。沒痛過就加的規則,你不會遵守,只會變成裝飾。規則是被具體事故推出來的,不是預先蓋一座大教堂。

    Hook(掛鉤)是什麼

    在系統層自動觸發的機制,不經過 AI 的腦。

    類型例
    便利類每次操作後自動 commit
    強制類攔截危險指令、範圍外寫入

    示範:讓 AI「忘記」規則

    紅線:社員名冊(虛構)不得外流。

    • 看示範時注意
    soft constraint(軟約束)寫給 AI 看的字

    忘了也還好的規則:Instructions 就夠。

    hard constraint(硬約束)系統層攔截

    絕不能忘的規則:必須上 Hook。這就是 L4:Enforced Harness。

    重要規則不能只靠自然語言。

    用 Codex 怎麼做(實測於 2026-10-04、2026-10-05,Codex 命令列版)

    • 設定檔放 .codex/hooks.json,格式和課堂上的 .claude/settings.json 幾乎一樣;差別是 Codex 改檔的工具叫 apply_patch。不用自己寫,用下面的 P15 讓 AI 設好。
    • 要先信任才會執行:Codex 會先問你信不信任這個資料夾,再打 /hooks 逐一信任。沒信任的 Hook 不會跑,也不會報錯。
    • 實測結果與課堂相同:沒有 Hook 時,軟約束多擋了一輪,最後還是被說動;加上 Hook 後,名冊資料寫不進企劃書,它也不繞路。Stop Hook 自動 commit 也可用。

    想自己設一個:貼 P15,把【】換成你要保護的檔案。它會先說明做法、等你同意;你只要在它請你信任時打 /hooks 確認。

    10
    看截圖

    帶著走:跨 LLM 可攜性

    同一份 repo 搬到別家 AI 工具上,知識與規則照用,只改少數語法。

    延伸:文件多到 AI 讀不完時,有 RAG(檢索增強生成:先找出相關段落再回答)這類做法,本課不展開,需要時再查。先把知識庫分層整理好,比選哪種檢索技術更重要。

    同一份 repo 搬到 Codex(OpenAI)

    可直接帶走需轉寫
    repo 知識庫Hook 語法
    Instructions 內容(請 Codex 把 CLAUDE.md 改名為 AGENTS.md,內容照用)Permission(Codex 沒有單一檔案的設定,改用 Hook)
    SKILL.md(換資料夾放,內容不改)
    整套工作方法

    「需轉寫」不等於「沒有」:兩邊都有 Hook,Permission 的做法不同但目的一樣。換家要改的是寫法,不是重新學一套觀念。第 4–9 段在 Codex 怎麼做,見各段的「用 Codex 怎麼做」。

    你帶走的是 repo,不是工具

    整堂課示範用的 Claude Code 要付費(Pro US$20/月起,核對於 2026-10)。但這正是本段要證明的:你帶走的是 repo,不是工具。

    課堂上的你回去用的
    Claude CodeCodex(課前安裝檔已裝好,桌面「開始上課-Codex」)
    CLAUDE.mdAGENTS.md(/init 指令幫你產生)
    Permission 三態/permissions 指令(預設 Approve for me)
    HookHook(語法不同,機制一樣)
    Claude Pro US$20/月起ChatGPT Plus US$20/月起

    第 4–9 段在 Codex 都做得到,免費版也可以(2026-10-05 以免費帳號、代我核准實測,見測試表)。但免費版一個月大約只夠做 10 件事,用完要等 30 天;Plus 的額度是 5 小時滾動+每週上限。一次只叫它做一件小事比較省。價格核對於 2026-10。

    ✓

    全課收尾

    Model 決定會不會想;Harness 決定能不能做、怎麼做、出錯怎麼修、哪些絕對不能做。

    今天帶走的三樣東西,前兩樣一毛錢都不用花:

    1. 一個 template repo

      第 7 段。

    2. 一套治理方法

      規範層/來源層/成品層、決策紀錄、單一正本。

    3. 一條實作路徑

      Codex(免費版可用,課前安裝檔已裝好)。

    結論不是「去買訂閱」,而是:把知識與規則沉澱成 repo,工具怎麼換都不歸零。

    →
    你要動手

    課後:自己做一次

    照順序做,全部免費;第 3 步用 Codex 免費版,一個月約 10 件事。每做完一項就勾起來,下次打開這頁還記得進度。

    第 1 步|帶走一份 repo(免費)

    • 帶走 repo

    只有免費帳號也能這樣用。這個 repo 日後升級到 Claude Code 時,一行都不用改,你現在存的每一份規範與紀錄都不會白做。

    第 2 步|其餘零成本練習

    • 零成本練習

    進階:範本的治理擴增指南有「隨時可加:兩條小規則」(刪除前判斷是不是原始檔、決策紀錄的登錄門檻),用一陣子後覺得需要再加:貼下面的 P18,它會連同範本更新一起列給你選。

    第 3 步|用 Codex 跑一個真的 agent(免費版可用)

    1. 點兩下桌面的「開始上課」

      做過第 7 段的,會直接在 my-harness 裡打開:它已經有規則檔和存檔點,改壞了回得去,不要拿正本練。沒做第 7 段的:先貼第 7 段的 P12 建好 my-harness,關掉再點一次捷徑。

    2. 請它加三五條規則,然後叫它做事

      貼下面的 P10 起手規則,它會加進規則檔,你看過就好。

    3. 權限維持「代我核准」

      捷徑已經設好,不用改。打 /permissions 看得到 Read Only、Approve for me、Full Access 等選項,不要選 Full Access。想保護某個檔,用第 9 段的 P15。

    免費版一個月約 10 件事,建議照這個順序做:① P10 起手規則 → ② P14 裝 Skill → ③ P15 保護個資的 Hook → ④ P08 記一筆決策。其餘(P11、P16 整理資料夾、P17 自動存檔、P18)有額度再做。

    P17 會讓每回合結束自動 commit,和 P21「同意後才 commit」互相衝突,兩者擇一。

    進階|用熟之後:把下面這段整段貼給 Codex,它會把一套較完整的工作規範融入你現有的 AGENTS.md,不會整份取代;有衝突的地方它自己決定,做完會列出每一處怎麼決定的,不同意再請它改。

    第 4 步|付費與選配(有心得之後再看)

    • Claude Code(課堂示範用的):Pro US$20/月起。
    • API 按量計費:輕度嘗試幾美元等級,但須綁信用卡且費用不封頂,請自行評估。
    • 校園方案:Anthropic 有 Claude for Education 校園合作;學校有無合作、涵蓋範圍,請洽校方。

    價格與方案核對於 2026-10,以各家官方公告為準。

    先把 repo 與治理習慣養起來,工具晚點再說。

    ?
    隨時查

    卡住了怎麼辦

    課後自己做時最常卡的地方。也可以按右上角搜尋,直接打你看到的字。

    登入後跳出 GitHub Education 的邀請Join GitHub Education、教育版、學生

    用學校信箱註冊常會看到。今天的操作用不到,按右上的 ✕ 關掉或直接略過即可,不影響建立 repo。

    找不到鉛筆、不會在 GitHub 網頁上改檔案編輯、鉛筆、Edit file、In place、commit changes

    點進檔案 → 右上角鉛筆圖示。手機或視窗太窄時沒有鉛筆:按檔案右上的「…」→「Edit file」底下的「In place」。改完按上方「Commit changes…」,在跳出的視窗寫一句這次改了什麼(Copilot 自動填的英文可以換掉),再按「Commit changes」。這就是一次 commit。

    找不到 History,或看不到綠色那一行commits、歷史、diff、差異、提示框

    回到 repo 首頁,檔案列表上方右側有「N Commits」字樣和時鐘圖示(手機只有時鐘),點它就是歷史;在檔案頁則是右上的「History」。點最上面那一筆,往下捲就是 diff:綠底加號是新增、紅底減號是刪除。如果跳出「Customizable line height」之類的新功能提示框擋住畫面,按「Dismiss」關掉。

    把 CLAUDE.md 貼進 Project 後,AI 好像沒照做Instructions、規則沒生效
    • 確認是在 Project 裡面開的新對話。
    • 改過 Instructions 後,開一個新對話再試。
    • 規則是軟約束,偶爾沒照做是正常的;重要的事請它「先列計畫等我同意」。
    安裝檔跑不動install-ai-course、winget、被擋、學校電腦、公司電腦、無法安裝

    學校或公司的電腦常擋安裝,先換個人筆電。只有某一步失敗(例如 git、gh 沒裝好):點兩下「開始上課」打開 AI 工具,貼下面這段 P13,它會補裝並帶你登入。連 AI 工具都裝不起來,帶著筆電提早到,上課前問老師。

    Codex 說額度用完了usage limit、稍後再試、每週上限

    免費版一個月大約只夠做 10 件事,用完要等 30 天(畫面會寫恢復日期);Plus 是 5 小時滾動和每週上限,等一段時間會恢復。一次只叫它做一件小事,比較省額度;課後優先順序見第 10 段。

    AGENTS.md 好像沒被讀到/init、規則沒生效

    先問它:「你這次讀到了哪個規則檔?」沒讀到,就請它檢查 AGENTS.md 是不是在你打開的資料夾最上層、檔名大小寫對不對,需要的話由它搬移或改名。改完後開一個新對話再試。

    Codex 說 token 無效或代理有問題gh auth status、token invalid、proxy、127.0.0.1、Permission denied、沙盒

    多半不是真的沒登入,也不是你的電腦設定錯:Codex 的沙盒預設不能連網、不能寫設定檔,指令就會誤報。它通常會自己申請在沙盒外重跑;如果它停下來問你,回它「請申請在沙盒外重跑同一個指令」。不要去改代理設定。沙盒外也失敗,才是真的沒登入:重新點兩下安裝檔,它會帶你登入。

    gh 或 git 找不到指令command not found、不是內部或外部命令、gh 無法辨識

    代表還沒裝好,或裝完沒重開視窗。先把視窗關掉、重新點兩下「開始上課」;仍不行,重新點兩下安裝檔(已裝好的會略過)。課堂上來不及就舉手,老師或助教協助。

    repo 名稱已經存在already exists、Name already exists

    你的帳號裡已經有同名的 repo(例如之前用網頁版建過 my-harness)。跟 AI 說「名稱改成 my-harness-2 再做一次」。

    Codex 說它沒辦法 commit.git、唯讀、index.lock、git add 失敗、dubious ownership

    Codex 的沙盒把 .git 設成唯讀,所以它會申請在沙盒外 commit,「代我核准」會替你放行。如果它停下來問你,回它「請申請在沙盒外重跑同一個指令」。

    Hook 好像沒作用/hooks、信任、trust、沒擋下

    Codex 的 Hook 要先信任才會執行,沒信任時不會跑、也不會報錯。先把輸入法切成英文,打 /hooks,選那個 Hook 按 t 信任;也請 Codex 確認設定檔在 .codex/hooks.json。改過 Hook 內容後,可能要重新信任一次。

    不敢讓 AI 動我的檔案怕改壞、備份

    對,所以第 3 步用 my-harness 練,不拿正本。每次改檔它都會 commit(存檔點),改壞了可以請它「回到上一個存檔點」。

    P
    隨時查

    範本總表

    下半場的範本都在這裡。按「複製」,貼到卡片上寫的位置,再把【】換成你的內容。上半場的提示詞在上半場講義。

    A
    隨時查

    名詞小抄

    上半場的名詞(Model、Harness、Context、Agent、Git 等)見上半場講義。

    Skill(技能檔)寫成檔案的 SOP,任務相關時自動載入。
    SKILL.mdSkill 的檔案格式。換到 Codex 是否原格式沿用,尚在核對。
    GitHub放 Git repo 的網站,可以備份、分享、協作。
    push/clone上傳到 GitHub/把整套 repo 複製到另一台電腦。
    Template Repository可一鍵複製成自己 repo 的範本倉庫。
    Fork另一種複製方式;公開 repo 的 fork 必須維持公開,今天不用。
    Decision Log(決策紀錄)記「為什麼這樣決定」的檔;Git 只記「改了什麼」。
    禁止事項清單CLAUDE.md 裡逐條編號(N1、N2…)的「絕不能再犯」清單。
    Hook(掛鉤)系統層的自動化與攔截,不經過 AI 的判斷。
    hard constraint(硬約束)由系統執行、AI 忘了也擋得住的規則。
    CodexOpenAI 的 AI 工具,在你電腦的文字視窗裡讀寫資料夾;用 ChatGPT 帳號登入,免費版可用。
    AGENTS.mdCodex 的常駐規則檔,等同 Claude Code 的 CLAUDE.md。
    ✓
    隨時查

    這份講義測過什麼

    項目狀態
    第 6、7、9 段的課堂示範(講師機)已預跑2026-10-04,依上課順序連跑
    點播示範選單六題已預跑2026-10-04
    第 4–9 段在 Codex 怎麼做(各段「用 Codex 怎麼做」)已實測2026-10-04 付費帳號;2026-10-05 免費帳號+代我核准重測 P14–P21 皆可用
    換你做 P12(建 private repo、三區、commit、push)已實測2026-10-05,Codex 免費版(代我核准,不需按允許)與 Claude Code(auto 模式)皆成功
    一鍵安裝檔(AI 工具、git、gh、桌面捷徑)已實測2026-10-05,全新 Windows 與 Mac 雲端環境;SmartScreen、Gatekeeper 畫面與登入步驟未在雲端測
    第 8 段練習 P20 訪談+P21 融入已實測2026-10-05,Claude Code 與 Codex 免費版
    P14 裝 Skill、P15 設 Hook、P17 自動存檔已實測2026-10-05,Codex 免費版;Hook 擋下與自動 commit 另以測試輸入驗證
    Codex 免費版額度已實測2026-10-05:P12+10 則提示詞即達上限,30 天後恢復
    價格、方案、免費額度、產品畫面核對於 2026-10改版後可能不同

    「尚未」的項目,開課前驗證後會更新這張表。