map-framework
先規劃再建構的AI編碼,適用於Claude Code和Codex CLI — 在模型撰寫任何程式碼之前,您先核准計畫。SPEC → PLAN → TEST → CODE → REVIEW → LEARN
map-framework 是什麼?
先規劃再建構的AI編碼,適用於Claude Code和Codex CLI — 在模型撰寫任何程式碼之前,您先核准計畫。SPEC → PLAN → TEST → CODE → REVIEW → LEARN
map-framework 概覽
這是什麼
MAP (map-framework) 是一個「先規劃再建置」的 AI 編碼框架,專為 Claude Code 與 Codex CLI 設計。使用者必須先核准計畫,模型才能開始撰寫程式碼。工作流程為 SPEC → PLAN → TEST → CODE → REVIEW → LEARN。本專案採用 MIT 授權,屬於開放原始碼,分類為開發者工具。
主要功能
- 先規劃再建置:使用者核准計畫後,模型才開始寫程式。
- 消除常見失敗模式:未經核准的架構決策、難以審查的大型差異、圍繞實作錯誤撰寫的測試、以及跨工作階段遺失的上下文。
- 將工程判斷提前:先撰寫行為規範,將工作拆分為小型合約,逐一驗證每個階段,對照規格進行審查,並為下一次執行保留經驗。
- 同時支援 Claude Code 與 Codex CLI,提供對應提供者的指令(例如 Claude 使用 /map-plan,Codex 使用 $map-plan)。
- 預設啟用自動穩定更新;一般 MAP 技能每專案每 24 小時最多檢查一次,自動套用修補與次要版本,主要版本則會先詢問。
- 核心指令包括 /map-auto、/map-plan、/map-efficient、/map-check、/map-review、/map-learn、/map-understand、/map-debug 等。
- 一份案例研究(DevOpsConf 2026)指出,一個原本估計需 90 天的 Kubernetes 專案運算子,使用 MAP 後在 7 天內完成。
使用情境
適合:複雜後端功能、Kubernetes 控制器與運算子、內部平台工具、API/CRD/領域模型變更(含不變條件)、以及具備有意義測試套件的重構。不適合:打字錯誤與微小編輯、小型一次性腳本、行為仍未知的產品構想、缺乏明確邊界的大規模重寫、以及直接處理比規劃更便宜的工作。
快速開始
安裝方式:bashuv tool install mapify-cli# 或使用 pippip install mapify-cli需要 Python 3.11 以上版本。初始化專案:Claude Code:bashcd your-projectmapify initclaudeCodex CLI:bashcd your-projectmapify init . --provider codexcodex然後執行黃金路徑:Claude:/map-plan → /map-efficient → /map-check → /map-review → /map-learnCodex:$map-plan → $map-efficient → $map-check → $map-review → $map-learn
授權與價格
授權:MIT。價格:開放原始碼。
內容整理自該專案公開的 README 與儲存庫資訊。