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 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/azaliomap-framework.svg)](https://yunodb.com/tools/azaliomap-framework?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/azaliomap-framework?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/azaliomap-framework.svg" alt="Featured on YunoDB" height="20"></a>