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稳定版本发布，拥有完善的文档和社区贡献指南。