菜单
管理 Power Platform 解决方案（Solution）的创建、同步、导入导出。当用户需要创建解决方案、管理解决方案组件、同步解决方案到 Dataverse、导入导出解决方案文件、处理发布商（Publisher）配置时使用此技能。包括"创建解决方案"、"解决方案同步"、"导入解决方案"、"导出解决方案"、"添加组件到解决方案"、"发布商管理"等短语，或处理 Power Platform Solution/publisher 相关操作时。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
| name | dv-solution |
| description | 管理 Power Platform 解决方案（Solution）的创建、同步、导入导出。当用户需要创建解决方案、管理解决方案组件、同步解决方案到 Dataverse、导入导出解决方案文件、处理发布商（Publisher）配置时使用此技能。包括"创建解决方案"、"解决方案同步"、"导入解决方案"、"导出解决方案"、"添加组件到解决方案"、"发布商管理"等短语，或处理 Power Platform Solution/publisher 相关操作时。 |
此技能提供 Power Platform 解决方案（Solution）的完整管理功能，包括解决方案的创建、组件管理、同步到 Dataverse、以及发布商（Publisher）配置。
Power Platform 解决方案是组件的容器，用于将相关组件（表、表单、视图、Web 资源等）打包在一起进行部署和管理。
| 概念 | 说明 |
|---|---|
| 解决方案 (Solution) | 组件的容器，用于打包和部署 |
| 发布商 (Publisher) | 定义组件的前缀（如 new_），一个解决方案必须关联一个发布商 |
| 组件 (Component) | 表、表单、视图、选项集、Web 资源等 |
| 非托管 (Unmanaged) | 可修改的解决方案，用于开发环境 |
| 托管 (Managed) | 不可修改的解决方案，用于生产环境 |
重要: 必须按照以下顺序操作：
发布商 (Publisher) → 解决方案 (Solution) → 组件 (Components)
在以下情况使用此技能：
解决方案定义文件存放在 metadata/solutions/ 目录：
$schema: "../_schema/solution_schema.yaml"
# ================================================================
# 解决方案基本信息
# ================================================================
solution:
schema_name: "your_solution_name" # 唯一名称
display_name: "您的解决方案显示名称" # 显示名称
description: "详细描述解决方案的功能和用途"
version: "1.0.0.0" # 版本号：主版本.次版本.内部版本.修订
publisher: "default" # 发布商引用（引用 config/publishers.yaml）
type: "Unmanaged" # 类型：Unmanaged/Managed
# ================================================================
# 解决方案组件（按类型分类）
# ================================================================
components:
tables: # 表定义
- "tables/your_entity.yaml"
forms: # 表单定义
- "forms/your_entity_main.yaml"
views: # 视图定义
- "views/your_entity_active.yaml"
optionsets: # 全局选项集
- "optionsets/your_global_optionset.yaml"
webresources: # Web 资源
- "webresources/js/your_script.js"
plugins: # 插件程序集
- "plugins/YourPlugin/bin/Debug/YourPlugin.dll"
other: # 其他组件
- component_type: "ribbon"
id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
schema_name: "custom_ribbon_command"
# ================================================================
# 同步配置
# ================================================================
sync:
enabled: true # 是否启用同步
direction: "local_to_remote" # 同步方向
on_conflict: "skip" # 冲突策略
order: # 同步顺序（遵循依赖关系）
- "optionset" # 全局选项集（必须先于表）
- "table" # 表（实体）定义
- "form" # 表单（依赖表的字段）
- "view" # 视图（依赖表的字段）
- "webresource" # Web 资源
- "plugin" # 插件程序集
# ================================================================
# 验证配置
# ================================================================
validation:
strict_mode: false # 严格模式
check_dependencies: true # 检查依赖
check_naming: true # 检查命名规范
# ================================================================
# 构建配置
# ================================================================
build:
auto_increment_version: false # 自动递增版本号
export_as_managed: false # 导出为托管解决方案
output_path: "" # 导出文件输出路径
include_dependencies: true # 包含依赖组件
发布商定义在 config/publishers.yaml 中：
publishers:
default:
schema_name: "DefaultPublishercrmdev"
display_name: "CrmDev 的默认发布者"
prefix: "new"
# 可以定义多个发布商
contoso:
schema_name: "ContosoPublisher"
display_name: "Contoso 发布者"
prefix: "contoso"
current: "default" # 当前使用的发布商
| 规则 | 说明 |
|---|---|
| 长度 | 3-8 个字符 |
| 字符 | 仅字母和数字，必须以字母开头 |
| 常见示例 | new, contoso, adv, cust |
解决方案组件按类型组织，路径相对于 metadata/ 目录：
| 组件类型 | components 键 | 路径示例 |
|---|---|---|
| 表 (Table) | tables | tables/payment_recognition.yaml |
| 表单 (Form) | forms | forms/payment_recognition_main.yaml |
| 视图 (View) | views | views/payment_recognition_active.yaml |
| 选项集 (OptionSet) | optionsets | optionsets/global_optionsets.yaml |
| Web 资源 | webresources | webresources/js/form.js |
| 插件 | plugins | plugins/Plugin/bin/Debug/Plugin.dll |
完整的解决方案同步包含以下 5 个步骤：
1. 发布商检查与创建
└── 确保 Publisher 存在，不存在则创建
2. 解决方案对象创建/更新
└── 在 Dataverse 中创建 Solution 容器
3. 组件同步到 Dataverse
└── 按依赖顺序创建/更新表、表单、视图等
4. 组件添加到解决方案
└── 将已同步的组件添加到 Solution 容器中
5. 发布解决方案
└── 发布自定义项使更改生效
| 步骤 | 操作 | 说明 |
|---|---|---|
| 1 | 检查发布商 | 从 YAML 获取发布商配置，确保在 Dataverse 中存在 |
| 2 | 创建解决方案 | 使用 create_solution API 创建 Solution 对象 |
| 3 | 同步组件 | 按依赖顺序同步组件到 Dataverse |
| 4 | 添加组件 | 使用 add_solution_component API 将组件加入 Solution |
| 5 | 发布 | 使用 publish_solution API 发布自定义项 |
重要: 只有完成所有步骤后，解决方案才能在 Dataverse 中正常工作。特别是第 5 步发布操作，不发布则无法在运行时使用新创建的组件。
Dataverse SolutionComponentType 选项集定义的组件类型代码（用于调试和问题排查）：
| 类型名称 | 代码 | 说明 | Dataverse 实体 |
|---|---|---|---|
| table/entity | 1 | 实体 | EntityMetadata |
| attribute | 2 | 属性 | AttributeMetadata |
| relationship | 3 | 关系 | RelationshipMetadata |
| optionset | 4/9 | 选项集 | OptionSetMetadata |
| view | 26 | SavedQuery (视图) | savedquery |
| form | 60 | SystemForm (表单) | systemform |
| webresource | 61 | WebResource | webresource |
注意: 错误的类型代码会导致添加组件时出现 "Cannot add...because it does not exist" 错误。
| 方向 | 说明 |
|---|---|
local_to_remote | 本地 YAML → Dataverse（部署） |
remote_to_local | Dataverse → 本地 YAML（导出） |
bidirectional | 双向同步 |
| 策略 | 说明 |
|---|---|
skip | 跳过已存在的组件（默认，安全） |
update | 更新已存在的组件 |
replace | 替换整个组件 |
create_only | 仅创建新组件 |
组件按依赖顺序同步：
optionset → table → form → view → webresource → plugin
依赖说明：
cp .claude/skills/dv-solution/references/solution_template.yaml \
metadata/solutions/your_solution.yaml
填写必要信息：
python -m framework.utils.schema_validator metadata/solutions/your_solution.yaml
# 通过 MCP 工具
solution_sync_from_yaml --file metadata/solutions/your_solution.yaml
# 或通过 Python
python -m framework.agents.solution_agent sync metadata/solutions/your_solution.yaml
此技能通过以下 MCP 工具实现功能：
| 工具 | 说明 |
|---|---|
solution_sync_from_yaml | 从 YAML 同步解决方案 |
solution_plan | 预览同步计划（dry-run） |
solution_validate | 验证解决方案定义 |
solution_scan | 扫描解决方案状态 |
publisher_create | 创建发布商 |
publisher_list | 列出所有发布商 |
详细说明请参阅:
.claude/skills/dv-solution/references/solution_template.yaml - 解决方案模板.claude/skills/dv-solution/references/solution_guide.md - 完整指南metadata/_schema/solution_schema.yaml - JSON Schema 定义每个组件 YAML 可以声明所属的解决方案：
# 在组件 YAML 文件中
solution:
schema_name: "payment_solution" # 所属解决方案名称
auto_add: true # 是否自动添加到解决方案
这支持两种同步模式：
基于 SOC 职业分类
将Excel实体设计转换为YAML元数据文件。当用户需要将Excel中的Dataverse实体定义转换成YAML格式、将设计文档转换为代码、Excel转YAML、实体设计转元数据时使用此技能。包括"转换Excel"、"生成YAML"、"Excel转元数据"、"设计文档转YAML"等短语，或处理Power Platform/Dataverse元数据转换时。
Power Platform Model-Driven App 前端开发最佳实践与设计指南。 触发关键词（中文）：表单设计、视图设计、前端开发、Web资源、业务规则、表单脚本、样式设计、界面布局、交互设计、Model-Driven App、MCC表单、Dataverse前端 Triggers (English): form design, view design, frontend development, web resource, business rule, form script, styling, UI layout, interaction design, Model-Driven App, MCC form, Dataverse frontend 覆盖范围：Model-Driven App 表单设计、视图设计、Web 资源开发、表单脚本、业务规则最佳实践。 Scope: Form design, View design, Web Resource development, Form scripting, Business rules best practices for Power Platform Dataverse.
Dataverse 元数据建模、表结构搭建、REST API 自动化操作标准总览。包含实体、选项集、字段、Lookup、表关系、视图、表单、Web资源、插件、业务逻辑的创建依赖顺序、API调用规范、命名规范、类型映射、增量更新、报错处理、限流并发与企业级落地最佳实践。只要用户提问、开发、编写代码、梳理流程、制定规范、排查问题、自动化开发涉及 Dataverse 相关操作，包含建模、实体、数据表、字段、查找、关系、选项集、UI配置、插件、Web资源、Power Platform、Dataverse REST/WebAPI 等场景，自动优先加载并启用本Skill。典型关键词：Dataverse、PowerPlatform、元数据、实体、表、字段、Lookup、选项集、关系、建模、REST、WebAPI、自动化、标准化、插件、视图、表单、命名规范、增量同步、错误处理、限流并发。
生成Microsoft Dataverse实体模型设计Excel模板。当用户需要设计Dataverse表/实体、定义列/字段、创建表单布局、指定视图或文档化数据模型需求时使用此技能。包括"设计表"、"创建实体模型"、"定义字段"、"表单设计"、"视图定义"、"数据模型文档"等短语，或处理Power Platform/Dataverse数据建模时。
Dataverse 认证指南 - 指导 Agent 如何正确使用已认证的 Dataverse 连接。**重要**：当需要与 Dataverse 交互（创建表、查询记录、修改元数据等）时，必须先阅读此 skill。所有 Dataverse 相关操作都应通过已认证的 core_agent 或 metadata_agent 或 plugin_agent 或 solution_agent进行，不要直接创建新的 DataverseClient 实例。请务必使用此 skill，特别是当你看到 "auth failed"、"access token"、"authentication" 等关键词，或需要执行任何 Dataverse API 调用（metadata_apply_yaml、metadata_create_table、query_records 等）时。
