工作区生命周期

工作区是怎么组织的

一个 One 工作区至少包含这些核心元素：

• one.manifest.json（工作区配置 + 子项目台账，“是否 One 工作区”的判定标记）
• package.json（普通的 pnpm 工作区根，无 One 自有字段）
• pnpm-workspace.yaml
• apps/
• services/
• packages/

模板分类会决定默认落点：

• frontend -> apps/
• backend -> services/
• library -> packages/

推荐流程

创建骨架

one create my-workspace -d .

添加子项目

one add web-csr-react -n web-app -d ./my-workspace
one add api-nest -n backend-api -d ./my-workspace

同步并修复

one doctor -d ./my-workspace --fix

查看全量状态

one status --json -d ./my-workspace

status 和 doctor 的区别

one status

读取当前目录里的子项目状态，输出：

• 子项目 Dockerfile
• docker-compose.yml service 覆盖
• k8s/deployment.yaml workload 覆盖
• GitHub Actions workflow 覆盖
• one.manifest.json 追踪状态
• summary / coverage / issues / available_actions

适合 agent 和自动化先看现状。

one doctor

做健康检查；如果加上 --fix，会自动补齐 infra / workflow / manifest drift。适合日常巡检和 CI。

什么时候用 status --json

如果你想把状态观测接入 agent 或自动化，推荐直接使用：

one status --json -d ./my-workspace

如果只需要 CI gate，用：

one doctor --json -d ./my-workspace