环境搭建流程复刻
1. 安装 GitHub CLI
macOS (使用 Homebrew):
bash
brew install gh
Windows (使用 winget):
powershell
winget install --id GitHub.cli
验证安装:
bash
gh --version
2. 登录 GitHub
bash
gh auth login
检查登录状态:
bash
gh auth status
3. 初始化项目
bash
gh repo clone your-org/ai-collab-demo
cd ai-collab-demo
git checkout -b feat/init-ai-workflow
4. 安装 Claude Code
macOS/Linux/WSL:
bash
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell:
powershell
irm https://claude.ai/install.ps1 | iex
验证安装:
bash
claude --version
启动 Claude Code:
bash
claude
5. 创建项目目录结构
bash
mkdir -p .claude .github/workflows docs scripts src tests
touch CLAUDE.md docs/dev-workflow.md
6. 配置 CLAUDE.md
markdown
# 项目协作规则
## 技术栈
- Node.js 20+
- TypeScript
- React
- GitHub Actions
## 编码要求
- 所有新增逻辑必须包含测试
- 不允许直接修改 main 分支
- 不允许提交 .env 文件
- 不允许提交临时调试日志
## 提交前检查
- npm run lint
- npm run test
- npm run build
## PR 要求
PR 描述必须包含:
- 变更说明
- 测试结果
- 影响范围
- 风险说明
- 回滚方案
7. 最终目录结构
ai-collab-demo
├── .claude
├── .github
│ └── workflows
├── docs
│ └── dev-workflow.md
├── scripts
├── src
├── tests
├── CLAUDE.md
└── README.md
关键说明
.claude目录用于存储协作配置文件CLAUDE.md是核心协作规范文件- 分支策略采用
feat/前缀的功能分支 - 工作流文档位于
docs/dev-workflow.md - 所有技术约束已在
CLAUDE.md明确定义
此配置为AI协作建立了标准化基础,确保自动化流程与人工开发遵循相同规范。
CLAUDE.md文件将作为AI代理理解项目规则的主要依据。