AI News HubLIVE
站内改写

單一Markdown檔案搞定Claude、Codex、Cursor和Copilot的AI專案設定

一個名為ai-project-setup的開源專案提供了一份約7600行的Markdown引導檔案，可自動為Claude Code、ChatGPT Codex CLI、Cursor和GitHub Copilot等AI編碼助手建立規則、安全鉤子、會話恢復、記憶系統和雙語GitHub檔案。僅需一個命令下載檔案，然後告訴AI讀取執行，1-3分鐘內即可完成設定，且所有工具檔案預設被gitignore，保持專案歷史清潔。

文章情報

工程師中級

要點

  • 單一Markdown檔案（AI_PROJECT_SETUP.md）作為單一事實源，支援Claude、Codex、Cursor、Copilot等多個AI工具。
  • 自動生成13節的規則檔案、5個安全鉤子、3層會話儲存機制、雙寫記憶系統以及英韓雙語的GitHub標準檔案。
  • 安裝過程冪等且可自愈：重新執行會修復漂移，備份舊檔案，保留使用者自定義內容。
  • 透過符號連結實現多工具規則同步，支援跨工具程式碼接力（如Claude規劃、Codex實現）。

為什麼重要

這條新聞值得關注，因為單一Markdown檔案（AI_PROJECT_SETUP.md）作為單一事實源，支援Claude、Codex、Cursor、Copilot等多個AI工具。

技術影響

可能影響模型選型、推理成本、產品能力和評測基準。

專案背景

在每次開始新專案時，開發者往往需要重複配置AI編碼助手的規則、安全限制和工具整合。ai-project-setup專案旨在透過一份名為AI_PROJECT_SETUP.md的Markdown檔案（約7600行）一次性解決這個問題。該檔案可作為唯一的事實源，讓Claude Code、ChatGPT Codex CLI、Cursor和GitHub Copilot等主流AI編碼工具自動執行完整的專案設定。

快速開始

在任何Git倉庫中，只需執行以下命令下載引導檔案：

curl -fsSL https://raw.githubusercontent.com/kernalix7/ai-project-setup/main/AI_PROJECT_SETUP.md > AI_PROJECT_SETUP.md

然後開啟你的AI工具（如Claude、Codex、Cursor或VS Code的Copilot），告訴它“讀取並執行AI_PROJECT_SETUP.md”。等待1-3分鐘後，執行驗證指令碼：

./tmp-igbkp/verify-setup.sh
# 預期輸出：Pass: 83 Fail: 0 Warn: 0

自動建立的內容

執行後，專案根目錄會生成以下結構：

  • 符號連結檔案：CLAUDE.md、AGENTS.md、.cursorrules（均指向同一目標）
  • .priv-storage/ 目錄（gitignored）：包含13節專案規則、本地覆蓋規則、會話日誌、記憶檔案、安全鉤子、預設代理、斜槓命令等
  • tmp-igbkp/ 目錄（gitignored）：包含驗證、備份、恢復、秘密掃描等9個指令碼
  • 標準GitHub檔案：README.md、SECURITY.md、CONTRIBUTING.md、CODE_OF_CONDUCT.md、CHANGELOG.md及其韓語翻譯版本
  • .github/ 目錄：問題模板和拉取請求模板

核心特性

**安全鉤子**：針對Claude Code實現了PreToolUse、PostToolUse、SessionStart、PreCompact和Stop五個鉤子。PreToolUse可阻止危險命令（如rm -rf /、強制推送、秘密洩露等）、大檔案讀取、提交資訊中包含AI工具名等。PostToolUse自動記錄會話。

**會話恢復**：採用3層日誌系統：current.md（每次呼叫）、handoff-{date}.md（會話結束）、recovery.md（壓縮前）。即使遇到崩潰或速率限制，下一次會話也能自動恢復上下文。

**記憶雙寫**：每個記憶檔案會同步到~/.claude/projects/，確保跨機器遷移時記憶即時恢復。

**預設代理**：預配置技術主管、探索者、程式碼審查員和日誌分析器四個代理，並在超過閾值（3個檔案、500行程式碼或跨模組工作）時強制使用子代理委託，以節省上下文視窗。

**斜槓命令**：提供/status、/health、/recover、/ship、/save、/clean等10餘個命令，方便日常操作。

**跨AI工具接力**：v4.9+版本支援Claude與Codex CLI之間的任務分配。Claude負責規劃與審查，Codex負責實現，透過/codex-brief、/codex-review、/codex-fix等命令協作。

**秘密掃描**：內建14種正則模式（AWS金鑰、OpenAI金鑰、GitHub令牌等），可整合到git pre-commit鉤子中。

生命週期

設定完成後，每次正常會話中，AI只需讀取CLAUDE.md（約200行）和POST_SETUP_INDEX.md（約50行），無需重新載入完整的7000行引導檔案，從而節省約25k token。當需要更新時，只需說“更新設定”即可自動從GitHub拉取最新版本並替換所有指令碼。

支援的工具與版本

| 工具 | 最低版本 | 規則檔案 | 鉤子支援 | |------|---------|---------|---------| | Claude Code | 2.0+ | CLAUDE.md | 完整（5個鉤子事件） | | ChatGPT Codex CLI | 0.10+ | AGENTS.md → CLAUDE.md | 僅策略 | | Cursor | 0.40+ | .cursorrules → CLAUDE.md | 僅策略 | | GitHub Copilot | 1.150+ | AGENTS.md | 僅策略 |

“僅策略”意味著規則透過提示詞內容實施，無核心級阻止。

總結

ai-project-setup為AI編碼工具的標準化設定提供了一個優雅的單一檔案解決方案。它顯著減少了重複性配置工作，同時透過強大的安全機制和會話管理提升了開發體驗。該專案目前在GitHub上以v5.2穩定版本釋出，擁有完善的文件和社群貢獻指南。