one create

用途

one create 创建工作区根骨架，并安装随包分发的 agent skills。它不再负责添加首个子项目、选择初始化模块或代理依赖安装；这些动作分别交给 one add、one doctor --fix、one secrets init 和 package manager。

用法

one create [project-name] [options]

参数

• project-name：工作区目录名（位置参数）。传 .（或 ./）则就地在当前目录创建，项目名取自 basename(cwd) 并需匹配命名规则。目标目录必须不存在或为空，否则报 EXISTING_TARGET_NOT_EMPTY 退出
• -d, --dir <parent>：父目录（默认 cwd）
• -y, --yes：非交互模式（跳过 prompt 用默认值；TTY 自动检测，pipe 时自动启用）
• --docker：启用 Docker 支持（生成 docker-compose.yml）
• --k8s：启用 K8s 支持（生成 k8s/deployment.yaml）
• --json：强制 JSON 输出

输出

{
  "schema": "one-cli/create/v1",
  "project_name": "my-app",
  "created_path": "/abs/path/my-app",
  "created_in_place": false,
  "package_manager": "pnpm",
  "docker": false,
  "k8s": false,
  "skills": {
    "status": "completed",
    "installed_to": ["/Users/example/.claude/skills"],
    "skill_count": 4
  }
}

created_in_place 为 true 时表示用 one create . 在当前目录就地创建。 skills.status 为 failed 时工作区仍然创建成功，但需要检查本机权限或重新安装 npm 包。

示例

交互式

one create

非交互式

one create my-app --yes

含 Docker / K8s

one create saas-platform --yes --docker --k8s

在当前目录就地创建

mkdir my-app && cd my-app
one create . --yes

添加首个子项目

one create my-app --yes
cd my-app
one add api-nest --name user-api --yes
pnpm install

one add 会自动刷新 AGENTS.md / CLAUDE.md。如果 AI 指南缺失，也可以用 one doctor --fix 补齐。

错误恢复

错误码	处理
EXISTING_TARGET_NOT_EMPTY	换一个空目录，或手动删除目标后重试
INVALID_NAME	名字必须匹配 ^[a-zA-Z0-9][a-zA-Z0-9_-]*$；空格替换为 -
PROJECT_NAME_REQUIRED	非交互模式必须传位置参数名字
NODE_VERSION_UNSUPPORTED	升级 Node.js 到 18+
SKILLS_NOT_BUNDLED	重新安装 npm 包
SKILLS_INSTALL_FAILED	检查 ~/.claude/skills 写入权限

完整的错误码表见 error-codes。