"AI協作心得"
- codebase-memory-mcp：155 語言 tree-sitter 知識圖譜 MCP 的能力與邊界
codebase-memory-mcp (cbm) 的設計拆解：155 vendored tree-sitter grammar、11-signal 語意搜尋、Go / TS / C / C++ 上的 hybrid type resolution、跨 service HTTP/RPC 鏈接，以及在沒有 hybrid resolution 的語言上會降級成什麼樣。
- codegraph：用 tree-sitter per-language query 撐起 19+ 語言 call graph 的 MCP
codegraph MCP 的設計拆解：tree-sitter per-language query 抽 call graph、native OS file watcher 2 秒 debounce auto-sync、14 web framework routing、7 codebase benchmark 的 token 節省方法論。重點在 tree-sitter syntactic 路線能解到什麼程度、type-inferred dispatch 仍漏什麼。
- serena：把 LSP 包成 agent-first MCP 的 symbol-level 編輯方案
serena MCP 的設計拆解：直接整合各語言 LSP、symbol-level atomic edit（replace_symbol_body / insert_after_symbol / rename）、per-session project activation、跨 session memory。重點在 LSP 路線的型別精度可信度與 per-session 沒持久化的取捨。
- 三 MCP 工作流與 Dart 實測：cbm / codegraph / serena 的職責分工與三刀流
在同一個 Dart 商業專案上跑同一組 query，量化 codebase-memory-mcp / codegraph / serena 三個 code intelligence MCP 的能力差距，得到「不能互相取代、要互補使用」的三刀流結論。含 5 個實驗的 CLI baseline 跟 MCP 驗證對照。
- Codex 與 Claude Code Statusline 相容設計方法
用 case-first 查詢與 WRAP 判讀，整理 Claude Code statusLine 與 Codex tui.status_line 的差異，說明如何讓同一個 statusline 工具保留 Claude 原功能並預留 Codex 相容入口。
- Blog 文章模板設計：作者品質閘門與正文分工
文章模板的定位與 SSoT 歸屬：模板是作者品質閘門、正文仍走技術推導、backend 正文不暴露填表結構。
- Blog Markdown 寫作規範與 mdtools 檢查
本 blog 的 Markdown 排版規範權威契約。涵蓋 H1 禁用、MD024 siblings_only、反釣魚 TLD 校驗、卡片雙向完整性、front matter schema；改規則時要與 scripts/mdtools 實作同步。
- 5W1H 自覺決策方法論：系統化決策框架
基於 5W1H 原則的系統化決策框架，確保每個開發決策都經過完整思考，消除重複實作和逃避行為，並強制區分執行者與分派者的職責邊界
- Clean Architecture 實作指引
我們在 AI 協作開發中引入 Clean Architecture 作為任務分派的核心判斷框架。這篇文章整理了四層架構的設計順序、實作順序，以及我們實際執行時的關鍵檢查點。
- Code Smell 品質閘門檢測方法論
在 Ticket 進入 Phase 2 前強制執行 C1/C2/C3 品質檢測，將修正成本降低 80%
- Ticket 生命週期管理方法論
從一個 Ticket 失控的故事，談如何建立有紀律的任務生命週期管理
- Ticket 設計派工方法論
我們如何用 Ticket 機制解決大型開發任務的協作困境：從工作日誌臃腫到積極派發的實踐歷程。
- 用 Claude Code GitHub Actions 自動除錯 CI 建置失敗
GitHub Actions 整合 Claude Code 做 CI 修復與 Code Review。含觸發設定、成本控制、OAuth vs API key 計費差異。
- 用 Hook 系統把開發規範變成自動執行的基礎設施
從一個社群文章得到靈感，到建立完整的 Hook 系統方法論，我們如何用 Claude Code Hook 把開發規範從「應該遵守」變成「無法不遵守」
- 即時 Review 機制：Ticket 完成就 Review，不累積
每完成一個 Ticket 立即觸發 Review，30 分鐘內用 16 項標準清單完成，把偏差消滅在最小範圍。
- 敏捷重構方法論 - Agent 分工協作模式
描述如何讓AI使用敏捷開發的流程方法論，以主線程統籌、子代理人專責執行的協作模式，確保重構品質和進度控制
- 程式碼自然語言化撰寫方法論
將程式碼視為自然語言的撰寫哲學：從認知負擔的理論出發，透過五行函式、事件驅動、變數專一化，實現如同閱讀文章般流暢的程式碼
- 程式碼註解撰寫方法論
定義程式碼註解的本質：需求保護器而非程式解釋器，建立維護者導向的註解撰寫標準，涵蓋事件驅動架構與 Widget 獨立性註解規範
- 層級隔離：讓每張 Ticket 只做一件層級的事
我們在實際開發中整理出一套方法論，讓 Clean Architecture 五層架構與 Ticket 拆分真正結合——每張 Ticket 只修改一個架構層，不多也不少。
- MVVM ViewModel 開發方法論
建立完整的 ViewModel 開發規範，確保 MVVM 架構一致性
- Ticket 拆分標準方法論
Ticket 拆分標準
- Code Smell 檢查清單
在這裡列出常見的 Code Smell 清單，提供 設計和派工做 review 的參考及早察覺問題
- Ticket 設計派工方法論
本方法論提供完整的 Ticket 設計和派工機制，解決大型開發任務的協作效率問題，降低實作偏差風險
- 如何建立AI輔助系統開發
建立從理論到實踐的完整閉環
- 敏捷開發方法論
基於敏捷重構方法論追加文件設計規範以及實際跑一陣子後的範例說明
- v0.9.0 錯誤處理系統重構工作日誌
實際使用敏捷模式工作的工作日誌
- Claude Code Hook 系統 Exit Code 實驗
建立 Claude 內建自檢、Hook 系統驗證、修復模式補救的完整防護體系，從根本預防逃避行為
- Package 導入路徑語意化方法論
跨語言的導入聲明語意化原則，讓程式碼架構一眼可見
- AI 任務逃避偵測與預防三層防護方法論
建立 Claude 內建自檢、Hook 系統驗證、修復模式補救的完整防護體系，從根本預防逃避行為
- 如何要求ai使用正確的格式撰寫md文件
ai 寫的md會有許多格式上的錯誤，需要讓他先檢查再修正
- 開始一個新專案的做法
我已經跟AI描述過我的需求，請AI建立了相關的需求文件，現在要開始建立新專案
- 開始一個新專案的測試規劃
從測試開始規劃專案流程，分析事件交互的需求，之後再依據測試實作
- 大規模系統遷移方法論
描述如何設計重構的流程和檢驗的方法論
- 在文章中加入圖片的語法
Hugo 文章插圖的寫法、width / caption 參數、以及圖片路徑規則。