快速开始

基础流程（人类版）

从 v0.2.0 开始，创建工作区和添加子项目是两步清晰动作：

one create my-workspace
cd my-workspace
one add api-nest --name backend-api
pnpm install

这会自动：

1. 生成工作区根骨架（one.manifest.json、pnpm-workspace.yaml、apps/ services/ packages/、git init）
2. 安装 4 个 Claude Code skills 到 ~/.claude/skills/
3. 添加 backend-api 子项目（NestJS 模板）
4. 自动补齐子项目的 Dockerfile / docker-compose / k8s / GitHub Actions
5. 生成或刷新 AGENTS.md / CLAUDE.md AI 指南
6. 用 package manager 安装依赖

加多个子项目

one add web-csr-react --name web-app

这一步同样自动补齐 infra + Actions + manifest。

看现状

# 人类视角
one status

# Agent 视角
one status --json

one status 输出全量结构化状态 + 排序好的”下一步建议”。

一致性检查

one doctor --fix

如果发现 manifest 缺失、Dockerfile 漏掉等，自动修复。

Secrets（可选，Infisical）

如果项目需要加密环境变量，准备好 Infisical 凭据后：

# 1. 凭据来自 Infisical Web → Organization → Access Control → Identities
export INFISICAL_UNIVERSAL_AUTH_CLIENT_ID=<...>
export INFISICAL_UNIVERSAL_AUTH_CLIENT_SECRET=<...>

# 2. 在工作区里初始化
cd my-app
one secrets init --project-id <infisical-project-id>

# 3. 之后正常使用
one secrets set DATABASE_URL "postgres://localhost/dev" --env dev --path /services/user-api
one secrets pull --env dev   # 按 .env.example 过滤后写入各子项目的 .env

不需要在本机装任何二进制——SDK 直连 Infisical SaaS（或自托管实例，传 --site-url）。

详细的 monorepo path 模型 + 安全双层过滤见 Secrets 指南。

AI Native 版本

如果你使用 Claude Code，整个流程只需要一句话：

“帮我建一个 saas-platform，包含 nestjs 后端 user-api 和 react 前端 dashboard”

Claude 会自动加载 one-bootstrap skill，按工作流调用上面的所有命令。 详见 AI Native 工作模式。

下一步

• 想理解全套 AI Native 设计：看 AI Native 工作模式
• 想理解整个生命周期：看 工作区生命周期
• 想把 secrets 用完整（含安全契约）：看 Secrets 管理
• 想查每个命令细节：看 命令参考