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穩定版本發佈，擁有完善的文檔和社區貢獻指南。