| name | vibe-init |
| effort | xhigh |
| disable-model-invocation | true |
| description | 项目初始化。每个新项目首次使用 VibeCoding 时运行。扫描项目、生成环境脚本、创建状态目录。
|
/vibe-init — 项目初始化
1. CC 原生初始化
无 CLAUDE.md → 运行 /init，生成后追加: "本项目使用 VibeCoding，开发用 /vibe-dev"
已有 CLAUDE.md → 跳过。
2. 项目扫描
ls package.json pyproject.toml Cargo.toml go.mod 2>/dev/null
cat package.json 2>/dev/null | grep -A5 '"scripts"'
ls jest.config* vitest.config* pytest.ini .eslintrc* ruff.toml 2>/dev/null
3. 创建 .ai_state/
mkdir -p .ai_state/reviews
从 ~/.claude/skills/pace/templates/ 复制全部模板 (必须全部复制, 缺一不可):
- project.json — PACE 状态
- tasks.md — Sprint 任务 (含 Boundary/Depends 标注示例)
- progress.md — impl 进度日志 (铁律 5)
- design.md — 设计文档 (含 File Structure Plan 段)
- handoff.md — 跨模型/跨 worker 交接
- lessons.md — 项目级业务经验 (compound 写入目标, 不能缺)
- review-report.md — 审查模板 (含反伪装证据要求)
- init.sh — 基线脚本
project.json 填入检测到的 tech_stack, test_cmd, build_cmd, lint_cmd, dev_cmd。
4. 生成 init.sh
根据扫描结果生成 .ai_state/init.sh:
- 依赖安装命令
- dev server 启动 (如有)
- 基线测试命令
chmod +x .ai_state/init.sh
5. .gitignore
grep -q '.ai_state' .gitignore 2>/dev/null || echo '.ai_state/' >> .gitignore
6. 全局 lessons 检查
test -d ~/.claude/lessons && ls ~/.claude/lessons/INDEX.md 2>/dev/null
无 → 提示 "首次使用全局 lessons, 运行 /vibe-setup 初始化 ~/.claude/lessons/"
7. Git commit
git add .ai_state/ .gitignore
git commit -m "vibecoding: project initialized"
8. 验证
运行 bash .ai_state/init.sh 确认脚本正常。
test -f ~/.claude/skills/gstack/SKILL.md → 没有则提示: "Gstack 未安装, Feature+ 增强受限。运行 /vibe-setup 安装。"
npx ctx7 library express 2>&1 | head -1 → 报错则提示: "context7 未装, 库文档查询不可用。运行 npx ctx7 setup --claude。"
告知用户检测结果 + "用 /vibe-dev 开始开发"
已有 .ai_state/ → 提示用户是否重新初始化。
