HagiCode 使用 Tips

這篇 FAQ 會讀取文件站在發佈建置時同步下來的 Index tips 快照，並按主題整理成便於瀏覽的建議清單。

資料更新時間: 2026-06-0153 條 tips資料語言: zh-Hant檢視 Index 原始 JSON

專案管理

8 條

1. 開始工作階段前先建立專案，讓 HagiCode 能統一管理檔案、上下文與歷史紀錄。

   project-first

2. 讓每個專案聚焦在相關的程式碼與素材上，避免工作階段讀取到無關的上下文。

   project-boundary

3. 用業務名稱或儲存庫名稱來命名專案，日後搜尋更方便。

   project-name-clear

4. 在專案中記錄當前目標，讓後續的工作階段能更快接手。

   project-goal-note

5. 把啟動步驟、帳號資訊和常用指令放在專案筆記裡，就不用每次重複輸入。

   project-docs

6. 上傳素材前先移除無關檔案，讓 HagiCode 專注在當前任務上。

   project-context-clean

7. 開啟新的工作階段前先選好正確的專案，確保任務落在對的上下文中。

   project-before-session

8. 檢視專案歷史時，先從最近完成的工作階段結論開始看起。

   project-history

提案與範圍

8 條

1. 遇到較大的變更時，先請 HagiCode 撰寫提案，再決定是否執行。

   proposal-large-change

2. 明確界定提案範圍，避免工作階段在執行過程中不斷擴大。

   proposal-scope

3. 不確定方向時，請 HagiCode 在提案中列出多個方案供選擇。

   proposal-options

4. 提案中的風險說明能幫助你判斷這項變更是否值得繼續。

   proposal-risk

5. 將提案拆分成具體任務，執行進度會更容易追蹤。

   proposal-tasks

6. 開始實作前先審閱提案，及早發現遺漏的細節或錯誤方向。

   proposal-review

7. 為每份提案取一個簡短清楚的名稱，方便日後查找。

   proposal-change-name

8. 提案完成後記錄結果，日後可以回顧當初變更的原因。

   proposal-finish

會話協作

9 條

1. 為每個工作階段設定一個明確目標，讓成果更容易評估。

   session-single-goal

2. 開始工作階段時，直接說明目標、限制條件和預期產出。

   session-start-clear

3. 接續舊任務時，告訴 HagiCode 最近有什麼變動。

   session-context

4. 在較長的工作階段中，請 HagiCode 沿途回報進度檢查點。

   session-checkpoint

5. 暫停前先記錄下一步驟，恢復工作階段時能省下更多時間。

   session-stop-point

6. 工作階段結束後，先閱讀結果摘要，再決定是否繼續追問。

   session-review-result

7. 發現方向不對時立刻修正，不要等到最後才整個推翻。

   session-correction

8. 如果你已經知道相關檔案，直接把檔案路徑告訴 HagiCode。

   session-files

9. 出錯時，把完整的錯誤訊息傳給 HagiCode，而不是只說失敗了。

   session-errors

多會話協同

5 條

1. 平行執行多個工作階段前，先把目標拆成不會互相衝突的部分。

   multi-session-plan

2. 為平行工作階段取清楚的名稱，例如提案設計、前端實作、問題排查等。

   multi-session-naming

3. 平行執行工作階段時，盡量不要讓它們編輯同一批檔案。

   multi-session-isolation

4. 平行工作階段完成後，先一起檢視結果，再決定採用哪些部分。

   multi-session-merge

5. 重要任務可以讓一個工作階段負責實作、另一個負責審查。

   multi-session-review

Agent 分工

6 條

1. 為每個代理人設定清楚的角色，例如實作、審查、測試或文件整理。

   agent-role

2. 多個代理人協作時，事先界定各自的職責範圍。

   agent-boundary

3. 代理人之間交接時，保留關鍵結論、未完成事項和重要備註。

   agent-handoff

4. 審查代理人適合用來發現問題，不適合同時負責大規模改寫。

   agent-review

5. 研究代理人可以先收集背景資料，再將工作交接給實作代理人。

   agent-research

6. 需要快速判斷下一步時，請代理人提供簡短摘要。

   agent-summary

Claude 使用

3 條

1. Claude 擅長分析大量素材、比較不同方案，以及梳理複雜的上下文。

   claude-analysis

2. 進行複雜設計前，請 Claude 幫忙檢查推理是否完整。

   claude-design

3. 閱讀大量文件時，Claude 可以幫你提取重點與限制條件。

   claude-docs

Codex 使用

3 條

1. Codex 擅長進入儲存庫、編輯程式碼，以及執行指令來驗證結果。

   codex-implementation

2. 不確定該改哪裡時，先請 Codex 搜尋專案結構。

   codex-navigation

3. Codex 完成變更後，重點關注哪些檔案被修改以及修改的原因。

   codex-review-diff

code-server

4 條

1. 需要手動檢視程式碼時，用 code-server 開啟專案。

   code-server-open

2. 小幅手動調整時，code-server 比切換本機環境更方便。

   code-server-edit

3. 在 code-server 執行指令前，先確認終端機位於目標專案目錄。

   code-server-terminal

4. 調整介面時，用 code-server 預覽實際效果。

   code-server-preview

OmniRoute

4 條

1. OmniRoute 能在同一處連接不同模型，讓切換能力更加容易。

   omniroute-provider

2. 簡單任務用快速模型，複雜任務再切換到更強的模型。

   omniroute-model-choice

3. 模型無法使用時，OmniRoute 的備援路由能減少中斷。

   omniroute-fallback

4. 透過 OmniRoute，可以根據任務重要性來平衡速度、品質與成本。

   omniroute-cost

HagiPower

3 條

1. Hagipower 會追蹤你在各工作階段的能量與活動，讓你了解長期使用量的累積。

   hagipower-overview

2. 檢視每日 Hagipower 成就，幫助你保持程式設計目標和連續紀錄。

   hagipower-daily-achievement

3. 混合快速任務與深度專注的工作階段，讓 Hagipower 能量消耗保持平衡。

   hagipower-energy-balance