Home zh HK

LockedIn CLI —— 與 AI 智能體一起開發的諷刺主題教程

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

歡迎。本 wiki 是一套動手實踐、適合初學者的教程：你將借助具有智能體能力的 AI 編程助手，構建一個真正的指令列工具；示例故意荒誕，讓學習過程更有趣。

示例專案是 LockedIn CLI：一個模擬“AI CLI”的作品，諷刺 AI 時代的開發工具和 職業社交網絡上的“思想領導力”。它有漸變啟動畫面、互動式聊天會話、斜線指令，以及一個 會非常努力地“思考”、卻故意不產生任何職業價值的模型。玩笑之下，它仍是一個結構清晰、 測試充分、零相依性的 Node.js 專案，非常適合學習。

笑點本身就是教學工具。 你會一邊嘲笑塞滿招聘廣告的收件箱，一邊學會架構、 測試，以及最重要的技能：如何指導 AI 智能體為你編寫和修改真實程式碼。

---

適合哪些讀者

• 剛接觸智能體式 / AI 輔助編程。 你也許用過聊天助手，但還沒有真正指揮過一個 能編輯檔案、執行測試並交付改動的智能體。教程會在這部分放慢節奏。
• 具備編程基礎。 你能閱讀 JavaScript、使用終端機並跟蹤函式呼叫即可。這裏的 程式碼屬於中級，AI 協作部分則面向初學者。不需要框架經驗——專案使用原生 Node， 而且零相依性。

任何有能力的編程智能體都可以配合本教程。示例使用 GitHub Copilot CLI （也是編寫這個專案的智能體），但工作流程同樣適用於其他智能體。

唯一規則：測試門禁 🧪

本專案有一條硬規則，也是整套教程的主線：

只有 npm test 通過，改動才能交付。

AI 智能體可以極快地產生大量程式碼，而驗證套件能讓控制權始終在你手中。你將學會讓智能體 在這道門禁後工作：描述改動、讓它補充測試、讓它實作功能，只有當測試全部變綠時才接受結果。

如何使用本教程

請按順序完成各章。每章都很短，以一個**“和你的智能體一起試試”**練習結尾，並承接上一章。

1. 教程 1：入門 — 獲取並執行專案，認識你的智能體， 第一次執行測試門禁。
2. 教程 2：程式碼如何工作 — 理解這個專案為何 容易且安全地交給智能體修改：純函式核心、帶種子的隨機性和測試套件。
3. 教程 3：你的第一個智能體任務 — 重頭戲：用測試優先的方式指導智能體端到端加入一個全新指令。
4. 教程 4：提示與審查 — 像技術負責人一樣 寫提示、審查智能體的差異、迭代修正，並在多個會話間保持進度。
5. 教程 5：本地化 — 了解 CLI 如何支援 33 種語言， 以及怎樣指導智能體加入新語言，包括 i18n、鍵一致性、雙寬字元和組合標記佈局。

想看故事世界內的玩笑文件？請閱讀原始諷刺“手冊” 指令參考。使用輔助技術？請查看 無障礙功能；CLI 提供屏幕閱讀器、高對比度和低干擾模式。

使用編程智能體參與貢獻

歡迎貢獻。克隆儲存庫後，可用任何有能力的編程智能體打開，例如 Claude Code、Cursor 或 Codex。請讓它遵循儲存庫說明和這些教程，審查它的改動，並在提交前執行 npm test。 這些只是示例，不代表認可，也不是內置集成。

---

前置條件一覽

• Node.js 18+（Linux、macOS 或 Windows，三個平臺的行為一致）。
• git，以及具有智能體能力的編程助手，例如 GitHub Copilot CLI。
• 大約 30–60 分鐘，以及一點幽默感。

準備好了嗎？前往 教程 1：入門。

---

_{諷刺作品。 LockedIn CLI 是對 AI 時代指令列工具和“思想領導力”文化的戲仿， 與 LinkedIn 或任何真實公司均無關聯，亦未獲其認可，也不代表其立場。本專案由大型語言模型 （GitHub Copilot CLI，Claude Opus 4.8）在人的指導下編寫，並以 GPL-3.0-or-later 授權。執行 lockedin legal 可查看完整免責聲明。}