打造私人教練：從一個名字到會讀書

私人教練不是買來的，是養出來的。這頁記錄的是我自己的那一個 —— 她叫小妖，住在這台電腦的一個獨立 profile 裡，有自己的名字、自己的記憶、自己的紅線，還有一份會愈來愈長的技能清單。

這是什麼

一個只做健康與健身的 AI 教練。她跟一般聊天機器人的差別在三件事：

• 她自己去拿數據：體重、訓練紀錄、動作與組數，她從訓記的 Open API 抓，不是我貼給她
• 她有教科書：不是「網路上都這樣講」，而是指定專書的頁碼與章節，引用得出依據
• 她會回一句「這個我現在不行」：能力邊界是明列的，缺什麼、缺到幾成，她會講

目前是第 0 版。下面是它長出來的順序，包含還沒長好的部分。

怎麼做的

一路走來時間都寫在檔案上，不是我回想出來的：

① 10/23 16:59 —— 先有角色，才有工具

開一個新 profile，第一件事不是裝功能，是寫定位：她是教練、不是助理；不診斷、不開處方、遇到紅旗症狀直接停手並導向就醫。第一則訊息與第一支腳本（xunji_fetch.py，17:25）只差 26 分鐘 —— 定位寫完就馬上去拿資料。

② 10/23–10/25 —— 把訓記裝成她的感官

xunji_fetch.py 先能抓 → backfill_trains.py（21:18）補歷史 → analyze_trains.py（21:26）會算訓練量 → dp_calculator.py（10/25 00:23）算劑量 → 最後是 xunji_api.py（10/25 16:21，27.7 KB）把 Open API v2 整套包起來。從此她的問題不是「你可以告訴我你的數據嗎」，而是「我上週三練了什麼」。

③ 10/24–10/25 —— 技能不是一次裝完，是卡住才裝

• 10/24 00:25｜obsidian-vault —— 每次對話結束，結論就散了
• 10/24 08:02｜cross-role-handoff —— 要跟其他角色交接工作，格式每次都不一樣
• 10/24 16:03｜humanizer-zh-tw —— 講得像在讀說明書
• 10/25 16:07｜grilling —— 她太容易順著我的話講，不會反問

同一天（10/25 16:07）她的 SOUL.md 被重寫：定位、紅線、回報格式全部重排。技能是手腳，SOUL.md 是人格 —— 手腳可以一直長，人格要早點定。

④ 10/26 13:22 —— 教練技能本體

health/fitness-coach：SKILL.md 25 KB，加 26 份參考檔（動作庫、課表劑量、身體組成、恢復與疼痛、風險篩檢、決策引擎）。她從「知道很多」變成「有一套固定做法」。

⑤ 10/26 上午 —— 讓她讀書，而且承認沒讀完

我把《肌力課程設計》給她。她沒有先說「可以」，先給一張覆蓋率表：Part 3 約 30%、Part 2 的動作技術細節約 5%、Chapter 3 與三種週期 0%。我叫她讀完，她算出還有 100 多張跨頁，一頁一頁讀會把上下文塞爆 —— 於是她自己派出五個平行子代理，各分一段、各寫一份摘要。

十到二十分鐘後回來四份（16 KB、13.5 KB、13.1 KB、22 KB）。第五個把 14 張跨頁讀完，卻在寫檔前結束 —— 這個洞留在頁面上，沒有替它補。

那天的完整對話：她說細節只讀了三成，然後派出五個自己

接下來

她自己列了「已能做／還不能做」，我照抄：

現在可以：從訓記讀資料、算出訓練量與劑量、依專書原則排課表、用固定格式回報、被追問時講出依據的章節頁碼。

還不行：把飲食與恢復納入課表（資料源不齊）、判斷身體數據的長期趨勢（樣本還不夠）、幫別人排課（她只有一個學員，就是我）。

明確不做：不做診斷、不開處方、不接極端減脂或脫水減重、不碰競技備賽。這是紅線，不是待辦。

學到什麼

• 角色先於工具：先寫清楚她是誰、不做什麼，再給能力。順序反了，能力會亂長
• 不要餵數據，讓她自己去拿：能自己抓資料的角色，問的問題層次完全不同
• 誠實的覆蓋率比漂亮的宣稱有用：「細節約三成」這種話，比「我讀完了」有價值得多
• 一個角色可以拆成五個子代理：讀長文件不要一條線慢慢讀，切段平行讀、各自寫檔，母體只負責整合
• 教練的價值不在知道多少，而在知道自己缺什麼

---

這篇由 Border 與 Hermes 協作完成，內容經人工審核。角色形象照由 Jason 提供，已去背處理；訓記 App 圖示版權屬原開發者，僅作辨識用途。