





內容簡介
AI 寫程式越來越快,專案卻越做越難控制?
真正拉開差距的,不只是更強的模型,而是
AI Harness
把規則、工具、分工、權限與交接組成一套工作系統
OpenCode + Harness 架構,讓 Vibe Coding 更自由!
 ̄ ̄ ̄ ̄ ̄ ̄ ̄ ̄ ̄ ̄ ̄ ̄ ̄ ̄ ̄ ̄ ̄
AI Coding Agent 寫得越來越快,但專案真的因此更好做了嗎?
AI Coding Agent 一開始往往寫得又快又好,但專案一大,就容易忘記規則、反覆修改;換個 Session、模型或 Agent,需求、背景與進度又得重新交代。
更麻煩的是,如果每一步都仰賴大型模型硬撐,就像必須不斷「投幣」購買 Token:專案越長、Context 越大、Agent 來回嘗試越多,$$ 也跟著一路往上燒。
問題往往不只是 AI 不夠強,而是缺少一套能規範行為、分配工作、提供工具、驗證成果,並讓專案持續交接下去的系統——這就是 AI Harness。
Harness,就是把 AI 的力量真正「駕馭」起來
Harness 原意是「馬具」,也就是把力量導向正確方向、讓人能夠駕馭的工具。
在 AI Agent 的世界裡,它代表包圍在 Agent 周圍,讓它依照明確規則、工具與流程持續工作的整套機制。
如果說 Prompt 決定「這次要做什麼」、Context 決定「現在知道什麼」,那麼 Harness 決定的就是「整個專案要怎麼持續做下去」。
用 OpenCode,把 Harness 真正組成一套工作系統
本書以 OpenCode 為核心,帶你把 AGENTS.md、MCP、Skills、Subagent、Permission、Git、Model 等功能組合成完整的
AI 開發流程。
你可以讓不同 Agent 各司其職、依照任務選擇不同模型,把昂貴的旗艦模型留給真正需要高推理能力的工作,而不是所有事情都持續燃燒高價 Token。
即使更換 Session、切換模型,甚至在 Claude
Code、OpenCode 等不同 Agent 之間移動,專案的規則、工具、流程與進度依然能持續延伸,不必每次重新開始。
模型可以一直換,但真正值得留下來的,是你建立好的 Harness。
本書特色:
【6 大 Harness 核心,建立可長期運作的 AI 開發流程】
◆ AGENTS.md × Git × Handoff:讓專案不再失憶
把開發規範、環境設定、測試方式、需求與進度留在專案裡,讓新的 Session 或 Agent 接手時,也能快速掌握目前狀態,不必每次重新交代。
◇ Agent × Subagent:依任務分工,不讓一個 AI 包辦全部
將規劃、研究、實作、測試與 Code Review 拆給不同角色處理,降低單一 Context 過度膨脹與資訊混亂,並依任務難度搭配不同模型,兼顧效率、品質與模型成本。
◆ MCP × Skills:替 Agent 接上工具與固定工作流程
利用 MCP 串接瀏覽器與外部工具,再用 Skills 將測試、除錯、檢查等重複工作整理成可重複使用的 SOP,讓 Agent 不只會寫程式,也能自行操作、驗證與修正。
◇ Model × Provider:不同任務,自由搭配不同模型
看懂免費模型、訂閱方案、API 與不同 Provider 的差異,依照任務難度、資料敏感度與成本,決定哪些工作值得使用旗艦模型,哪些可以交給平價模型,避免所有任務都持續燃燒高價 Token。
◆ Permission × Plugin:控制 AI 哪些直接做,哪些要詢問
設定工具權限與操作邊界,讓低風險工作自動執行,高風險操作則透過 Telegram Bot 主動詢問;再加入可依 Agent 狀態切換動作的桌面寵物,兼顧效率、安全與趣味。
◇ Claude Code × OpenCode:Agent 可以換,專案不用重來
將共用規則、需求、Git 紀錄與交接資訊保留在專案本身。即使更換模型、Session,甚至切換不同 Coding Agent,開發脈絡依然可以延續。
【WorkDash 完整實戰,把 Harness 從概念變成真正的工作流程】
從一句需求開始,實際打造 WorkDash 浮動工作資訊欄,完整走過:
Plan → PRD → AGENTS.md → Agent / Subagent 分工
→ 實作 → 測試 → Git → Handoff →
Release
把前面學到的規則、工具、模型、權限與交接機制真正組合起來,建立一套能重複、能接手,也能持續改善的 AI 協作開發流程。
產品目錄
1-1 OpenCode 簡介
・什麼是 Harness?
・為什麼適合用 OpenCode 學習 Harness 思維?
・OpenCode、Claude Code 和 Codex:不是誰取代誰的問題
1-2 安裝 OpenCode
・Windows、macOS、Linux 安裝方式
・OpenCode 介面與內建工具介紹
1-3 第一個任務:讓 OpenCode 幫你準備環境
・讓 Agent 自己安裝開發工具
・保存並接續過去的 Session
CH 2 OpenCode 快速上手 — 實作 PDF 加浮水印工具
2-1 什麼是 AGENTS.md?
・專案級與全域級 AGENTS.md 該怎麼分?
2-2 與 Claude Code 專案的相容機制:OpenCode 自動讀取 CLAUDE.md
2-3 用 OpenCode 寫一個 PDF 加浮水印工具
2-4 切換權限模式
・Plan Agent 與 Build Agent:先規劃,再執行
・用 /undo 復原 Agent 修改過的檔案
・用 /init 更新專案近況到 AGENTS.md
CH 3 OpenCode 操作全攻略,與 Claude Code 無痛切換
3-1 OpenCode 操作介紹
・切換 Agent、模型與工作階段
・在 Prompt 中加入檔案與圖片
・管理 Context 與長對話
3-2 Claude Code 專案無痛轉移到 OpenCode
・分辨「專案共用規則」與「工具專屬設定」
・讓 OpenCode 接手既有 Claude Code 專案
3-3 如何建立跨 Agent 的專案架構
・建立單一可信來源(Single Source of Truth)
・建立能讓下一個 Agent 直接接手的開發流程
CH 4 Agent + Subagent — 組織你的 AI 團隊
4-1 Subagent 簡介
・建立與測試自己的 Subagent
4-2 多 Subagent 並行運作的威力
・讓多個 Agent 同時處理不同工作
・Subagent 對 Context 大小的影響
4-3 用獨立 Context 建立客觀的程式碼審查員
4-4 讓多個 Subagent 組成專業團隊
CH 5 用 MCP 與 Skills 幫 OpenCode 生出超能力
5-1 什麼是 MCP 與 Skills?
・MCP 與 Skills 到底差在哪裡?
5-2 Browser MCP:讓 OpenCode 接管瀏覽器
・使用 Chrome DevTools MCP 操作真實網頁
5-3 Playwright MCP:自動化測試的好幫手
・用 DeepWiki MCP 探索陌生專案知識
5-4 使用 Skills 和 Playwright CLI 打包完整測試流程
CH 6 設定檔與權限 — 解密你的 opencode.json
6-1 看懂 opencode.json 結構
6-2 權限管理與角色分工
・Primary Agent 與 Subagent 各自該擁有哪些權限?
6-3 日常使用更方便:斜線指令和快捷鍵
・建立自己的 Command 與快捷鍵
6-4 進階玩法:Plugin
・隨 Agent 狀態變化的桌面寵物:OpenPets
・自製 Telegram 通知 Plugin
CH 7 AI 模型選擇與平價方案
7-1 看懂 AI 模型與 Provider 生態
・OpenCode、Provider、Model 的三層關係
・封閉模型、開放權重模型與本地部署
7-2 免費、訂閱與 API 方案的計費方式
・OpenCode Go、OpenCode Zen、DeepSeek、GLM、Kimi 等方案
・ChatGPT Plus/Pro OAuth
7-3 哪個模型與方案適合你?
・依任務難度選模型,而不是一個模型用到底
7-4 平價模型的優勢與風險
・資料隱私、API 金鑰與服務限流風險
7-5 實作:把不同模型與 Provider 接入 OpenCode
CH 8 Harness 思維 — 從使用者到駕馭者
8-1 從會使用 AI,到掌握工作系統
・從一句 Prompt 到一套能長期運作的系統
・Harness 的六層控制力
8-2 從三個維度配置你的 Harness
・平台維度:把專案做事方式留在專案裡
・Agent 維度:先看工作關係,再決定要幾個 Agent
・模型維度:依任務需求自由升降級
8-3 當 Harness 走偏時:五種反模式
・過度拆分:並行不是免費的
・迷信模型能力:強模型不會自動補齊需求
・放棄理解:Agent 說完成,不代表真的完成
・無底洞除錯:失敗兩次就換方法
CH 9 實戰案例:打造 WorkDash 浮動工作資訊欄
9-1 設計應用程式功能與架構
・從需求構思、專案規則到正式實作
・用 Question 工具先釐清需求,再讓 Agent 動手
9-2 執行實作與除錯
・建立適合 Agent 使用的 debugging-methodology Skill
・跨 Session、模型與 Agent 平台接手專案
・使用多模態模型解決 UI 設計問題
・除錯時該換 Prompt、換方法,還是換模型?
9-3 完善專案各項功能
・AI 摘要功能規劃與實作
・AI 待辦清單生成功能規劃與實作
・把 Harness 真正走完一次,完成可持續開發的專案流程
規格
退貨說明
退貨須知:
- 依照消費者保護法的規定,您享有商品貨到次日起七天猶豫期(含例假日)的權益(請注意!猶豫期非試用期),辦理退貨之商品必須是全新狀態(不得有刮傷、破損、受潮)且需完整(包含全部商品、配件、原廠內外包裝、贈品及所有附隨文件或資料的完整性等)。
- 請您以送貨廠商使用之包裝紙箱將退貨商品包裝妥當,若原紙箱已遺失,請另使用其他紙箱包覆於商品原廠包裝之外,切勿直接於原廠包裝上黏貼紙張或書寫文字。若原廠包裝損毀將可能被認定為已逾越檢查商品之必要程度,本公司得依毀損程度扣除回復原狀必要費用(整新費)後退費;請您先確認商品正確、外觀可接受,再行拆封,以免影響您的權利;若為產品瑕疵,本公司接受退貨。
依「通訊交易解除權合理例外情事適用準則」,下列商品不適用七日猶豫期,除產品本身有瑕疵外,不接受退貨:
- 易於腐敗、保存期限較短或解約時即將逾期。(如:生鮮蔬果、乳製品、冷凍冷藏食材、蛋糕)
- 依消費者要求所為之客製化給付。(如:客製印章、鋼筆刻字)
- 報紙、期刊或雜誌。
- 經消費者拆封之影音商品或電腦軟體。
- 非以有形媒介提供之數位內容或一經提供即為完成之線上服務,經消費者事先同意始提供。(如:電子書)
- 已拆封之個人衛生用品。(如:內衣褲、襪類、褲襪、刮鬍刀、除毛刀等貼身用品)
- 國際航空客運服務。
若您退貨時有下列情形,可能被認定已逾越檢查商品之必要程度而須負擔為回復原狀必要費用(整新費),或影響您的退貨權利,請您在拆封前決定是否要退貨:
- 以數位或電磁紀錄形式儲存或著作權相關之商品(包含但不限於CD、VCD、DVD、電腦軟體等) 包裝已拆封者(除運送用之包裝以外)。
- 耗材(包含但不限於墨水匣、碳粉匣、紙張、筆類墨水、清潔劑補充包等)之商品包裝已拆封者(除運送用之包裝以外)。
- 衣飾鞋類/寢具/織品(包含但不限於衣褲、鞋子、襪子、泳裝、床單、被套、填充玩具)或之商品缺件(含購買商品、附件、內外包裝、贈品等)或經剪標或下水或商品有不可回復之髒污或磨損痕跡。
- 食品、美容/保養用品、內衣褲等消耗性或個人衛生用品、商品銷售頁面上特別載明之商品已拆封者(除運送用之包裝外一切包裝、包括但不限於瓶蓋、封口、封膜等接觸商品內容之包裝部分)或已非全新狀態(外觀有刮傷、破損、受潮等)與包裝不完整(缺少商品、附件、原廠外盒、保護袋、配件紙箱、保麗龍、隨貨文件、贈品等)。
- 家電、3C、畫作、電子閱讀器等商品,除商品本身有瑕疵外,退回之商品已拆封(除運送用之包裝外一切包裝、包括但不限於封膜等接觸商品內容之包裝部分、移除封條、拆除吊牌、拆除貼膠或標籤等情形)或已非全新狀態(外觀有刮傷、破損、受潮等)與包裝不完整(缺少商品、附件、原廠外盒、保護袋、配件紙箱、保麗龍、隨貨文件、贈品等)。
- 退貨程序請參閱【客服專區→常見問題→誠品線上退貨退款】之說明。











































































































