Tutorial 1 Orientation zh HK

教程 1 · 入門

🌎 語言： 繁體中文（香港） — 查看全部 33 種語言

目標： 執行專案、認識你的 AI 智能體，並執行一次測試門禁，讓之後的步驟成為肌肉記憶。

← 返回 首頁 · 下一章： 教程 2：程式碼如何工作

---

1. 為甚麼選擇一個玩笑應用？

學習與編程智能體協作時，最合適的程式碼應當小、真實、風險低。LockedIn CLI 三者兼具：

• 小： 一個核心檔案、一個進入點、一套測試、零相依性。
• 真實： 它可安裝為全局 lockedin 指令，行為像真正的 AI CLI。
• 風險低： 它是諷刺作品。即使智能體讓謙虛自夸又謙虛了 20%，也不會有人被緊急呼叫。

你因此可以專注於真正的技能：清楚描述改動、讓智能體完成工作，並驗證結果。

2. 獲取程式碼

git clone https://github.com/xjamesmorris/lockedin-cli.git
cd lockedin-cli

檢查 Node 版本（需要 18+）：

node --version

無需安裝任何東西，也不用為相依性執行 npm install，因為專案沒有相依性。這是刻意的： 可變因素越少，學習越專注。

3. 執行

試試真實程式：

node bin/lockedin.js            # 啟動畫面和橫幅
node bin/lockedin.js post       # 生成一篇“思想領導力”帖文
node bin/lockedin.js aura       # 掃描你的職業氣場
node bin/lockedin.js            # 不帶參數，進入聊天會話

在會話中輸入 /help，隨便探索，然後用 /exit 離開。所有內容都從本地詞池生成： 無網絡、無帳戶。完整列表見 指令參考。

4. 執行測試門禁

這是整套教程最重要的指令：

npm test

你應看到一整屏綠色檢查，結尾類似 pass 318。這套測試就是安全網。從現在開始，工作流始終是：

修改 → npm test → 只有全部變綠才能交付。

5. 認識你的智能體

在專案資料夾內打開編程智能體，讓它能看到檔案。使用 GitHub Copilot CLI 時執行：

copilot

先讓智能體幫你了解專案，不要立即改動。可以這樣提示：

“請用兩段話介紹這個儲存庫：說明每個頂層檔案和資料夾的用途，以及如何執行應用和測試。 暫時不要修改任何內容。”

把回答與你在步驟 3–4 中看到的內容對照。習慣先讓智能體解釋，再編輯，這是之後會反復使用的核心習慣。

---

✅ 和你的智能體一起試試

1. 問它：“node bin/lockedin.js reflect '我的咖啡冷掉了' 會輸出甚麼？ 哪個檔案決定輸出？” 然後親自執行指令核對。
2. 讓它執行測試並報告結果：“執行 npm test，告訴我有多少項檢查通過。”

你已經見過應用、測試和智能體。下一章將解釋這個程式碼庫為何如此適合智能體協作。

下一章：教程 2：程式碼如何工作 h