메뉴
生成Microsoft Dataverse实体模型设计Excel模板。当用户需要设计Dataverse表/实体、定义列/字段、创建表单布局、指定视图或文档化数据模型需求时使用此技能。包括"设计表"、"创建实体模型"、"定义字段"、"表单设计"、"视图定义"、"数据模型文档"等短语，或处理Power Platform/Dataverse数据建模时。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
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.
管理 Power Platform 解决方案（Solution）的创建、同步、导入导出。当用户需要创建解决方案、管理解决方案组件、同步解决方案到 Dataverse、导入导出解决方案文件、处理发布商（Publisher）配置时使用此技能。包括"创建解决方案"、"解决方案同步"、"导入解决方案"、"导出解决方案"、"添加组件到解决方案"、"发布商管理"等短语，或处理 Power Platform Solution/publisher 相关操作时。
Dataverse 元数据建模、表结构搭建、REST API 自动化操作标准总览。包含实体、选项集、字段、Lookup、表关系、视图、表单、Web资源、插件、业务逻辑的创建依赖顺序、API调用规范、命名规范、类型映射、增量更新、报错处理、限流并发与企业级落地最佳实践。只要用户提问、开发、编写代码、梳理流程、制定规范、排查问题、自动化开发涉及 Dataverse 相关操作，包含建模、实体、数据表、字段、查找、关系、选项集、UI配置、插件、Web资源、Power Platform、Dataverse REST/WebAPI 等场景，自动优先加载并启用本Skill。典型关键词：Dataverse、PowerPlatform、元数据、实体、表、字段、Lookup、选项集、关系、建模、REST、WebAPI、自动化、标准化、插件、视图、表单、命名规范、增量同步、错误处理、限流并发。
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 等）时。
| name | design-dv-model |
| description | 生成Microsoft Dataverse实体模型设计Excel模板。当用户需要设计Dataverse表/实体、定义列/字段、创建表单布局、指定视图或文档化数据模型需求时使用此技能。包括"设计表"、"创建实体模型"、"定义字段"、"表单设计"、"视图定义"、"数据模型文档"等短语，或处理Power Platform/Dataverse数据建模时。 |
此技能用于生成Microsoft Dataverse实体模型的综合Excel模板，包括实体定义、视图配置、表单布局、选项集和业务规则。
重要提示:
sources/templates/excel/ba_system_design_template.xlsx 以保持结构、格式和命名约定的一致性sources/features/ 下的功能迭代目录中config/naming_rules.yaml 配置：
{prefix}_{name} (如 new_payment_recognition){prefix}_{lowercase_name} (如 new_payment_amount){prefix}_{relationship_name} (如 new_payment_customer)在以下情况使用此技能：
标准模板位置: sources/templates/excel/ba_system_design_template.xlsx
这是包含标准结构、格式和示例数据的参考模板。生成新模板时，请先读取此文件以确保一致性。
重要: 生成的Excel文件必须放置在功能迭代目录结构中：
sources/features/
└── feature-xxx/ # 功能迭代目录 (如: feature-customer-management)
├── 01-requirements/ # 需求文档 (BRD/PRD/流程图)
└── 02-designs/ # 设计文档
├── entities/ # ← 实体设计Excel放这里
├── forms/ # 表单设计
└── views/ # 视图设计
文件命名规范: {feature_name}_entity_design.xlsx
示例：
customer_management_entity_design.xlsxorder_processing_entity_design.xlsx目录创建流程:
sources/features/feature-xxx/02-designs/entities/ 目录Excel模板包含7个工作表：
| 类型 | API类型 | 可作主字段 | 说明 |
|---|---|---|---|
| Text | StringType | 是 | 单行文本（最大4000） |
| Multiline Text | MemoType | 否 | 多行文本（最大1048576） |
| StringType(Email) | 否 | 电子邮件地址 | |
| Phone | StringType(Phone) | 否 | 电话号码 |
| URL | StringType(URL) | 否 | 网站链接 |
| Date and Time | DateTimeType | 否 | 日期时间值 |
| Whole Number | IntegerType | 否 | 整数 |
| Decimal Number | DecimalType | 否 | 十进制数（精度10） |
| Currency | MoneyType | 否 | 货币值 |
| Yes/No | BooleanType | 否 | 布尔值（两个选项） |
| Choice | PicklistType | 否 | 选项集（单选） |
| MultiSelect Choice | MultiSelectPicklistType | 否 | 选项集（多选） |
| Lookup | LookupType | 否 | 多对一关系 |
| Customer | LookupType(Customer) | 否 | 客户查找（Account或Contact） |
| Owner | LookupType(Owner) | 否 | 所有者（User或Team） |
| Autonumber | StringType(Autonumber) | 否 | 自动编号 |
询问用户当前设计属于哪个功能迭代：
读取标准模板以了解结构：
读取 sources/templates/excel/ba_system_design_template.xlsx
确认/创建目标目录：
sources/features/{feature_name}/02-designs/entities/
在目标目录下生成实体设计Excel文件，文件名格式：
{feature_name}_entity_design.xlsx
根据用户需求：
表单设计工作表（04_表单设计）用于规划窗体的 Tab/Section/字段布局。
左侧列 A-G 为可视化布局区域，右侧 L-Q 为字段属性配置：
| 区域 | 说明 |
|---|---|
| A 列 | Tab 标记（<Tab N: 名称>） |
| B-E 列 | 字段放置（可视化网格，每行最多 2 个字段） |
| L 列 | 字段 schema name |
| M 列 | 是否只读 |
| N 列 | 是否必填 |
| Q 列 | Tab 归属标记 |
| 约束 | 说明 |
|---|---|
| Tab 数量 | 通常 2-4 个，按业务逻辑分组 |
| Section 分组 | 每个 Tab 内按语义分区 |
| 字段布局 | 每行 1-2 个字段，宽度和 ≤ 2 |
| 必填字段 | 放在 Tab 顶部、靠左位置 |
| Lookup 字段 | 与普通字段放在同一 Section |
设计完成后，通过 dv-model-to-yaml 将 Excel 表单设计转换为 metadata/forms/{entity}_main.yaml，再通过 /dv-sync 同步到 Dataverse。窗体 YAML 格式和同步策略详见 dv-model-to-yaml skill。
视图设计工作表（03_视图定义）用于配置实体列表视图的显示列和排序。
| 列 | 说明 | 取值 |
|---|---|---|
| 视图名称 | 视图唯一标识 | 如 "Active Accounts" |
| 实体名称 | 所属实体逻辑名 | 如 "account" |
| 序号 | 列显示顺序 | 1, 2, 3... |
| 字段名称 | 字段 schema name | 如 "accountnumber" |
| 显示名称 | 列标题 | 中文显示名 |
| 列宽 | 列宽度（像素） | 50-500 |
| 对齐方式 | left/center/right | 默认 left |
| 是否可排序 | 是/否 | 默认是 |
| 是否可筛选 | 是/否 | 默认是 |
| 排序方式 | asc/desc | 排序方向 |
| 格式 | text/number/date | 数据格式 |
| 综合方式 | 汇总类型 | sum/avg/count |
| 约束 | 说明 |
|---|---|
| 列数量 | 建议 3-8 列，避免过宽 |
| 列宽 | 总宽度建议 800-1200 像素 |
| 排序 | 通常按第一列或关键字段排序 |
| 必含列 | 建议包含主字段和状态字段 |
设计完成后，通过 dv-model-to-yaml 将 Excel 视图设计转换为 metadata/views/{entity}_{view}.yaml，再通过 /dv-sync 同步到 Dataverse。视图 YAML 格式详见 dv-model-to-yaml skill。
用户: 设计客户管理模块的实体
↓
LLM: 确认功能迭代名称为 feature-customer-management
↓
LLM: 创建目录 sources/features/feature-customer-management/02-designs/entities/
↓
LLM: 读取标准模板 sources/templates/excel/ba_system_design_template.xlsx
↓
LLM: 生成文件 sources/features/feature-customer-management/02-designs/entities/customer_management_entity_design.xlsx
↓
LLM: 填充客户实体数据到02_实体模型工作表
scripts/generate_template.py - 执行此脚本可创建新模板
详细架构说明请参考：docs/spec/architecture.md