dx-devops-project-manage

用途

该技能用于管理 Salesforce 组织中 DevOps Center 项目的完整生命周期，包括列出项目、创建项目以及更新项目设置。它提供无头 CLI 驱动的操作，支持自动化发布工作流。

主要能力

• 列出项目：显示组织中所有 DevOps Center 项目，或将项目名称解析为项目 ID。
• 创建项目：创建新项目，需提供项目名称（必填）和描述（可选）。创建操作是幂等的，若同名项目已存在则返回现有 ID。
• 更新项目：更新项目的名称、描述或启用状态。需提供项目 ID 或名称，以及至少一个待更新字段。

使用方式

所有操作均通过 sf devops project CLI 命令执行，并使用 --json 标志输出结构化数据。技能提供以下脚本：

• scripts/list-projects.sh [target-org]：列出所有项目，输出制表符分隔的 Id、Name、Description；若没有项目则输出 NO_PROJECTS。
• scripts/list-projects.sh --resolve "<project-name>" [target-org]：将项目名称解析为 ID。
• scripts/create-project.sh "<name>" "<description>" [target-org]：创建项目，输出 CREATED <id> 或 EXISTING <id>。
• scripts/update-project.sh --project (<id>|name:<name>) [--name "<new-name>"] [--description "<new-desc>"] [--is-active|--no-is-active] [--target-org <alias>]：更新项目，输出 UPDATED <id>。

执行前需验证组织认证（sf org display --target-org <alias> --json），并确保目标组织已启用 DevOps Center。若未设置默认组织，需通过 --target-org 指定别名。

适用场景

• 需要查看或管理 Salesforce DevOps Center 项目列表。
• 需要创建新项目以用于后续工作项和管道配置。
• 需要重命名项目、修改描述或启用/停用项目。
• 作为 DevOps Center 工作流的入口，为工作项管理和管道管理技能提供项目 ID。

限制

• 不涉及工作项生命周期、管道创建/配置、提升/部署、冲突检测（由其他技能处理）。
• 必须使用 sf devops project CLI，不能使用 MCP 工具或元数据查询。
• 所有命令必须使用 --json 标志。
• 更新操作必须提供至少一个更新字段。
• 创建操作必须提供项目名称。
• 不支持交互式提示，所有输入必须通过 CLI 标志传递。
• 若组织未启用 DevOps Center，需在 Setup → DevOps Center 中配置。