用途:把用户从“我想做点东西”带到可运行、已验证的 Agentic Coding Starter Kit 项目,最终在 http://localhost:3000 访问。流程线性推进,只有两个分支点:文件夹策略与数据库选择。
主要能力与步骤:先并行探测 node、pnpm、npm、yarn、docker、git 版本;Node 需 >=18,Git 必须存在,包管理器只保留探测成功的选项。根据当前目录是否为空决定就地脚手架、子目录或临时目录再移回(临时目录方案需加 --skip-git,避免覆盖用户 .git)。随后选择包管理器,执行 npx create-agentic-app@latest <target> --package-manager <pm> --yes,并检查 node_modules 是否真正安装成功。接着复制 env.example 为 .env,用 node -e "console.log(require('crypto').randomBytes(32).toString('hex'))" 生成 BETTER_AUTH_SECRET,确认 NEXT_PUBLIC_APP_URL=http://localhost:3000。数据库可选本地 Docker、Neon、Vercel Postgres 或自带 POSTGRES_URL,之后运行 <pm> db:migrate,禁止用 db:push 绕过迁移历史。AI 能力为可选,通过 OpenRouter 配置 OPENROUTER_API_KEY,默认模型 openai/gpt-5-mini。认证默认启用邮箱密码,OAuth 可选。生产扩展(Vercel Blob、Polar、事务邮件)为多选可选。最后运行 <pm> build:ci,后台启动 <pm> dev,等待就绪后验证进程存活、HTTP 200 与无致命错误。
限制:命令为 POSIX 形式,Windows 需经 Bash 工具运行;脚手架失败多需用户侧修复;数据库连接、端口占用、密钥缺失等错误需先解决再宣称成功。其他安装方式:npx skills add <owner>/<repo>@create-agentic-app --agent claude-code。