One CLI

one-cli 负责的是工作区初始化和治理，而不是接管每个子项目自己的 dev、build、test。你可以把它理解成团队级的根工作区控制面。

创建工作区

用 one create 生成统一的根骨架，包括 apps/、services/、packages/ 和 one.manifest.json。

添加模板项目

用 one add 从注册表选择模板，把 Web、API、文档站或移动端项目接入同一个工作区。

同步治理配置

用 one status 和 one doctor --fix 维护 Docker、K8s、GitHub Actions 和 manifest 一致性。

管理 Secrets

用 one secrets 管理 Infisical-backed 密钥； 支持 monorepo path 隔离 + .env.example 双层过滤。

初始化 AI 工作流

用 one create 安装打包内置 skills；one add 会生成并刷新 AGENTS.md / CLAUDE.md。

巡检与 CI

用 one doctor --json 和 one status --json 支持日常维护和 CI 集成。

核心心智

• one-cli 管理工作区骨架和根配置。
• 各模板自己的开发命令仍由子项目脚本负责。
• 工作区里的真实状态以文件系统和 one.manifest.json 为主。
• status 是观测入口，doctor --fix 是治理修复入口。

推荐阅读顺序

1. 先读 安装与准备 和 快速开始。
2. 如果你已经开始管理真实项目，继续读 工作区生命周期。
3. 需要上线或多人协作时，再读 Secrets 管理 和 治理与维护。