/create-project

name: create-project
description: |-
  管理 Dataphin 项目创建场景的需求拆解、公开项目查询与创建 API 覆盖边界。
  当用户要创建 Dataphin 项目、初始化 Basic 或 DevProd 项目、检查项目是否已存在、确认项目依赖、配置项目白名单或准备项目创建参数时进入。
  触发词：创建项目、新建项目、Dataphin 项目、项目初始化、DevProd、Basic、项目白名单、项目依赖、create project、project initialization。
  关键限制：项目生命周期命令按模式拆分为 create-basic-project / create-dev-prod-project / update-basic-project / update-dev-prod-project / delete-project（无 create-project 形态）；创建命令走单一 --create-command JSON 对象参数而非扁平 flag；创建项目前必须确保数据板块与计算源已就绪（DevProd 需 dev/prod 两套计算源）；19 位大整数 ID 一律字符串传参。

创建 Dataphin 项目 Skill

1. Scenario Description

Dataphin 项目是数据开发工作的容器和起点，承载计算源、数据源、成员、任务、调度、发布和权限等后续配置。用户常见诉求包括创建 Basic 项目、创建 DevProd 项目、确认项目是否已存在、准备项目成员与白名单、或删除前检查项目是否存在依赖。

当前公开 `dataphin-public` CLI 已覆盖项目全生命周期（创建 / 更新 / 删除）以及查询、依赖校验、白名单与成员管理。因此本 Skill 的交付边界是：

• **需求拆解**：整理项目名称、英文名、模式、业务板块、计算源、成员、白名单等创建参数。
• **公开前置检查**：使用 `list-projects` / `get-project-by-name` / `get-project` 判断项目是否存在，使用 `check-project-has-dependency` 做删除前保护，使用 `get-project-white-lists` 查询白名单。
• **完整创建链路**：先确保数据板块与计算源就绪（DevProd 需 dev / prod 两套计算源），再调用 `create-basic-project` / `create-dev-prod-project` 完成创建并回读验证。

**Architecture**：`Tenant → Project Requirement → Public Project Query → Dependency / Whitelist Check → BizUnit / Compute Source Readiness → Create / Update / Delete Project → Read-back Verification`

当前公开 OpenAPI 覆盖

• `CreateBasicProject` / `CreateDevProdProject` — 创建 Basic（单环境）或 DevProd（双环境）项目。
• `UpdateBasicProject` / `UpdateDevProdProject` — 更新项目基础信息（项目英文名不可修改）。
• `DeleteProject` — 删除项目（Basic / DevProd 均适用）。
• `ListProjects` / `GetProject` / `GetProjectByName` — 查询项目列表、详情或按名称定位项目。
• `CheckProjectHasDependency` — 删除或迁移前检查项目是否被任务、模型、资产等对象依赖。
• `GetProjectWhiteLists` / `ReplaceProjectWhiteLists` — 查询或替换项目白名单。
• `AddProjectMember` / `UpdateProjectMember` / `RemoveProjectMember` / `ListProjectMembers` — 项目成员管理，主要由 `manage-project-member` 承接。

2. Installation

aliyun plugin install --names aliyun-cli-dataphin-public

各操作系统一键安装脚本与版本要求详见 [references/cli-installation-guide.md](references/cli-installation-guide.md)。

3. Environment Variables

> 凭证与环境变量由父 skill `alibabacloud-dataphin-skills` 统一声明并预检（父 §3 + §4 Authentication + §8 Step 0，先于路由到本 skill 执行）；本 skill 不重复声明。

4. Authentication

> **Pre-check: Alibaba Cloud Credentials Required** > > **Security Rules:** > - **NEVER** 读取、回显或打印凭证环境变量 > - **NEVER** ask the user to input AK/SK directly in the conversation or command line > - **NEVER** use `aliyun configure set` with literal credential values > - **ONLY** use `aliyun configure list` to check credential status > > ```bash > aliyun configure list > ``` > Check the output for a valid profile. > > **If no valid profile exists, STOP here.**

**Pre-check: Aliyun CLI >= 3.4.8 required** > Run `aliyun version` to verify >= 3.4.8.

**Pre-check: Aliyun CLI plugin update required** > [MUST] run `aliyun configure set --auto-plugin-install true` to enable automatic plugin installation. > [MUST] run `aliyun plugin update` to ensure that any existing plugins are always up-to-date.

5. RAM Policy

最小权限策略详见 [套件级 RAM 策略](../../ram-policies.md)。

> **[MUST] Permission Failure Handling:** When any command or API call fails due to permission errors at any point during execution, follow this process: > 1. Read `../../ram-policies.md` to get the full list of permissions required by this SKILL > 2. Use `ram-permission-diagnose` skill to guide the user through requesting the necessary permissions > 3. Pause and wait until the user confirms that the required permissions have been granted

6. Parameter Confirmation

> **IMPORTANT: Parameter Confirmation** — Before executing any command or API call, ALL user-customizable parameters MUST be confirmed with the user. Do NOT assume or use default values without explicit user approval.

| 参数 | 必填 | 描述 | 默认值 | |---|---|---|---| | `--tenant-id` | 是 | 租户 ID（大整数，建议字符串传） | — | | `--project-name` | 查询必填 | 项目英文名或项目名，用于 `get-project-by-name` | — | | `--project-id` | 查询/依赖/白名单必填 | 项目 ID | — | | `Name` | 创建必填 | 项目英文名（`--create-command` 内字段） | — | | `DisplayName` | 创建必填 | 项目显示名 | — | | `BizUnitId` | 创建必填 | 所属数据板块 ID | — | | `DevComputeSourceId` | DevProd 创建必填 | 开发计算源 ID | — | | `ProdComputeSourceId` | DevProd 创建必填 | 生产计算源 ID | — | | `ComputeSourceId` | Basic 创建必填 | 计算源 ID（Basic 单环境） | — | | `NameSpaceTag` | 创建可选 | `PUBLIC` / `GENERAL` | `PUBLIC` | | `memberList` | 创建后配置可选 | 项目成员与角色，建议交给 `manage-project-member` | — | | `whiteList` | 白名单场景可选 | 项目 IP 白名单或访问白名单，更新前需回读现有值 | — |

> **注意**：`create-basic-project` / `create-dev-prod-project` 的参数不是扁平 flag，全部收拢在单一 `--create-command` JSON 对象里（见 §8）。

7. Observability (MUST follow for every aliyun command)

版本 `{version}`（Shell 变量 `SKILL_VERSION`）来自套件 `references/manifest.json` 的 `version` 字段，与 session-id 一同继承[父技能 §7](../../../SKILL.md#7-observability)。直接加载本子技能时先完成父层初始化；所有 CLI / SDK 调用使用父技能名称与同一版本，跨 Shell 调用须重新注入这些值。

**session-id 由父 skill `alibabacloud-dataphin-skills` 在套件入口加载时生成（32-char 小写 hex），本子 skill 加载时直接继承同一 session-id，不再重新生成。**

**Rule: Every `aliyun` CLI command that calls a cloud API MUST include the `--user-agent` flag.** Local utility commands (e.g. `configure`, `plugin`, `version`) do not support this flag and should be excluded.

--user-agent "AlibabaCloud-Agent-Skills/alibabacloud-dataphin-skills/{session-id} skill-version/{version}"

Do not skip, alter the format, or omit `--user-agent` on any `aliyun` API command invocation.

8. Core Workflow

TENANT_ID="<大整数租户 ID，字符串>"
SESSION_ID="<inherited from alibabacloud-dataphin-skills>"
UA="AlibabaCloud-Agent-Skills/alibabacloud-dataphin-skills/$SESSION_ID skill-version/$SKILL_VERSION"

Step 1：查重与前置检查

# 1) 按名称查询项目，判断是否已存在。
aliyun dataphin-public get-project-by-name --tenant-id "$TENANT_ID" \
  --project-name "<项目英文名>" --user-agent "$UA" --format json

# 2) 分页查询项目列表，辅助用户选择目标项目。
aliyun dataphin-public list-projects --tenant-id "$TENANT_ID" \
  --page-no 1 --page-size 10 --user-agent "$UA" --format json

###