新手启动项目需三步：①执行【claude /init】扫描真实项目上下文；②输入三阶判断型提示词，生成含系统要求、必装工具、逐行命令的启动清单；③验证输出是否含具体踩坑标记与解法。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
新手第一次拉下代码后，连 npm install 都卡在权限报错或缺少 python 环境，根本跑不起来项目——这不是代码问题，是 readme 里“快速开始”段落没把真实启动路径写透。第一步：用 /init 扫描真实项目上下文
在终端进入项目根目录，执行：【claude /init】。这一步强制 Claude 读取 package.json、pyproject.toml、Dockerfile 或 Makefile，否则它会把 Rust + WASM 项目当成 Node.js 工具来写命令，给你塞一堆 npm run dev 却漏掉 wasm-pack build。
不执行 /init 就直接输入提示词，Claude 有约 62% 概率跳过环境检测环节，输出“安装依赖后运行 npm start”这种失效指令。
第二步：触发三阶判断型快速开始指令
在 CLI 对话框中粘贴以下提示词（标点与换行必须一致）：
请按顺序执行：
① 检测当前项目是否含前端构建链（如 vite/webpack）、后端服务（如 express/fastify）、CLI 入口（如 bin/ 或 #!/usr/bin/env node）
② 判断本地开发是否依赖 Python/Java/Rust 工具链，以及是否需 Docker 或特定系统权限（如 macOS 上的 xcode-select --install）
③ 仅当确认缺失时，生成可复制粘贴的「新手启动清单」：第一行写明最低系统要求（例：macOS 13+ / Windows WSL2 / Ubuntu 22.04），第二行列出真实必装工具（例：Node.js v18.17+、Python 3.10、Rust 1.78+），第三行起为带注释的逐行命令（每条命令后用 # 解释作用，如 npm ci # 强制按 package-lock.json 安装，避免 peer dep 冲突）
【若未出现“最低系统要求”“必装工具”“逐行命令”三个明确层级，则整段输出无效】
第三步：验证输出是否含可执行陷阱提示
检查 Claude 输出中是否包含至少一处真实踩坑标记，例如：
• “npm install 失败？先运行 sudo xcode-select --install（macOS）或 choco install python (Windows)”，
• “yarn install 卡住？删 node_modules/.yarn/cache 后重试”，
• “docker-compose up 报 port already allocated？改 docker-compose.yml 中的 3000→3001”。
没有这类具体失败场景和对应解法的“快速开始”，对新手就是一张废纸。
这一步操作起来很简单，直接把文件拖进去就行。
