uipath-core

分类: 开发与编程 | 上传者: marcelocruzrpa | 下载: 0 | 版本: v1.0（最新）

通过 94 个确定性 Python 生成器（加上来自已安装插件技能的附加生成器）生成 UiPath Studio XAML 工作流程、项目支架（序列/调度器/执行器）和表达式。当用户提及 UiPath、XAML、RPA、REFramework、Orchestrator 或 UiPath Studio 开发时使用。 --- # UiPath 核心技能 > ⚠️ **安全规则**（`rules.md` 中的 I-1、I-2）> - 编剧/浏览器检查是 **只读**。登录页面 → 停止，等待用户。请参阅 `ui-inspection.md` → 登录门。 > - 通过 PowerShell 进行桌面检查 (`inspect-ui-tree.ps1`)：仅限只读树检查。 > - 永远不要生成凭证、令牌或密码——无论是真实的还是假的。使用真正的 Studio 导出模板和全面的参考文档生成生产质量的 UiPath 自动化工件。模板基线：Studio 24.10 Windows。 ## 何时阅读哪个参考 **从这里开始。** 将用户的任务与正确的文件相匹配，然后仅阅读需要的内容。对于超过 200 行的文件，请使用“grep”或行范围读取 - 切勿读取整个大文件或 XAML 资产。 ### 常见任务（首先检查这些）|任务|首先阅读 | |---|---| |生成 XAML 工作流程（任何类型）| `cheat-sheet.md` → JSON 规范模式 → `scripts/generate_workflow.py` **(G-1)** | |搭建项目| `scaffolding.md` → 模板选择 → 运行 `scripts/scaffold_project.py` | |生成完整的项目（清单）| `scaffolding.md` → “生成完整项目”清单 | |检查网络应用程序（选择器）| `ui-inspection.md` → Playwright MCP 工作流程 → `playwright-selectors.md` | |验证 XAML |运行 `scripts/validate_xaml <project> --lint` | |修复特定的 lint 警告 | `lint-reference.md` → 按 lint 编号搜索 | |编写表达式 (VB.NET/C#) | `expr-foundations.md`（任何表达式任务从这里开始）| |分解/项目结构| `decomposition.md` → 分解规则（通用 1-8、浏览器 9-13、桌面 14）| |修复用户的 .xaml 文件 | `技能GUI de.md` → 示例 6 | |行动中心

更新日志: Source: GitHub https://github.com/marcelocruzrpa/uipath-ai-skills

目录结构

当前层级: tree/main/uipath-core/

📁 assets/
- 📁 generator-snapshots/
  - 📄 action_center_form_task.xaml 4.1 KB
  - 📄 attach_and_navigate.xaml 5.5 KB
  - 📄 data_operations.xaml 6.2 KB
  - 📄 excel_read_write.xaml 3.1 KB
  - 📄 file_operations.xaml 3.7 KB
  - 📄 if_else_control_flow.xaml 4.5 KB
  - 📄 message_box_dialog.xaml 3.5 KB
  - 📄 misc_activities.xaml 3.4 KB
  - 📄 pdf_extraction.xaml 3.1 KB
  - 📄 queue_dispatcher.xaml 4.6 KB
  - 📄 sap_wingui_workflow.xaml 5.3 KB
  - 📄 simple_log.xaml 2.6 KB
  - 📄 try_catch_with_retry.xaml 8.7 KB
  - 📄 ui_automation_login.xaml 9.1 KB
  - 📄 while_loop.xaml 4.5 KB
- 📁 lint-test-cases/
  - 📁 bad_project_crossfile/
    
    📁 Framework/
    
    📄 CloseAllApplications.xaml 971 B
    
    📄 InitAllApplications.xaml 1.2 KB
    
    📄 Process.xaml 1.8 KB
    
    📁 Workflows/
    
    📁 WebApp/
    
    📄 WebApp_DoAction.xaml 1.2 KB
    
    📄 Main.xaml 787 B
    
    📄 project.json 288 B
  - 📁 bad_project_cycle/
    
    📄 A.xaml 799 B
    
    📄 B.xaml 805 B
    
    📄 Main.xaml 805 B
    
    📄 project.json 292 B
  - 📁 bad_project_orphan/
    
    📄 A.xaml 778 B
    
    📄 Main.xaml 805 B
    
    📄 project.json 291 B
    
    📄 Unused.xaml 793 B
  - 📁 filename-sensitive/
    
    📁 Framework/
    
    📄 Process.xaml 1.7 KB
    
    📄 CloseAllApplications.xaml 970 B
    
    📄 Main.xaml 1.1 KB
  - 📄 bad_ACME_Login.xaml 1.3 KB
  - 📄 bad_addqueue_dict_expr.xaml 1.4 KB
  - 📄 bad_addqueue_ui_inargument.xaml 1.2 KB
  - 📄 bad_api_no_retry.xaml 920 B
  - 📄 bad_app_close_in_process.xaml 1.0 KB
  - 📄 bad_AppName_DoAction.xaml 1.3 KB
  - 📄 bad_AppName_Launch_noout.xaml 1.3 KB
  - 📄 bad_AppName_Launch_novalidation.xaml 2.6 KB
  - 📄 bad_AppName_NavigateTo.xaml 960 B
  - 📄 bad_argument_type_mismatch.xaml 1.8 KB
  - 📄 bad_assign_bare_string.xaml 1.3 KB
  - 📄 bad_assign_operation.xaml 1.1 KB
  - 📄 bad_assign_type_mismatch.xaml 1.7 KB
  - 📄 bad_attach_by_url.xaml 1.0 KB
  - 📄 bad_attach_no_uielement.xaml 2.3 KB
  - 📄 bad_bare_config_in_process.xaml 1.3 KB
  - 📄 bad_bare_datarow_type.xaml 1.5 KB
  - 📄 bad_bare_datatable_type.xaml 1.2 KB
  - 📄 bad_bare_variable_no_wrapper.xaml 1.1 KB
  - 📄 bad_build_datatable_columns.xaml 1.0 KB
  - 📄 bad_closemode_always.xaml 1.2 KB
  - 📄 bad_continue_on_error_x.xaml 913 B
  - 📄 bad_credential_args.xaml 1.1 KB
  - 📄 bad_css_selector.xaml 1.4 KB
  - 📄 bad_delay_activity.xaml 1.1 KB
  - 📄 bad_dict_stray_invoke_argument.xaml 1.4 KB
  - 📄 bad_double_bracket_expr.xaml 982 B
  - 📄 bad_double_escaped_quotes.xaml 1.3 KB
  - 📄 bad_duplicate_if_then.xaml 1.4 KB
  - 📄 bad_duplicate_invoke_arguments.xaml 1.2 KB
  - 📄 bad_duplicate_invoke_arguments_children.xaml 1.4 KB
  - 📄 bad_duplicate_viewstate.xaml 1.0 KB
  - 📄 bad_element_type.xaml 1.4 KB
  - 📄 bad_empty_catch.xaml 1.8 KB
  - 📄 bad_empty_field_mode.xaml 1.3 KB
  - 📄 bad_enum_namespace.xaml 1.1 KB
  - 📄 bad_extract_datatable.xaml 966 B
  - 📄 bad_extract_no_metadata.xaml 1.3 KB
  - 📄 bad_fqdn_bre.xaml 905 B
  - 📄 bad_fqdn_type_arguments.xaml 2.1 KB
  - 📄 bad_fuzzy_default.xaml 1.6 KB
  - 📄 bad_gettext_interactionmode.xaml 1.5 KB
  - 📄 bad_GetTransactionData_dispatcher.xaml 1.8 KB
  - 📄 bad_hallucinated_ui_props.xaml 2.1 KB
  - 📄 bad_hardcoded_url.xaml 830 B
  - 📄 bad_hardcoded_user_path.xaml 1.0 KB
  - 📄 bad_if_multi_child.xaml 1.1 KB
  - 📄 bad_InitAllApplications.xaml 1.3 KB
  - 📄 bad_InitAllApps_missing_uielement_out.xaml 1.7 KB
  - 📄 bad_inline_result_extractdata.xaml 1.4 KB
  - 📄 bad_invalid_array_type.xaml 1.4 KB
  - 📄 bad_invoke_bare_typearg.xaml 1.3 KB
  - 📄 bad_invoke_code_datatable.xaml 969 B
  - 📄 bad_invoke_code_filedelete.xaml 922 B
  - 📄 bad_invoke_code_screenshot.xaml 1.0 KB
  - 📄 bad_invoke_code_sql.xaml 974 B
  - 📄 bad_invoke_direction_mismatch.xaml 1.4 KB
  - 📄 bad_invoke_empty_arg.xaml 1.4 KB
  - 📄 bad_launch_login_no_validation.xaml 2.3 KB
  - 📄 bad_main_undeclared_invoke_var_Main.xaml 1.6 KB
  - 📄 bad_multiple_assign_body.xaml 1.7 KB
  - 📄 bad_mva_visualbasic.xaml 1015 B
  - 📄 bad_ncheckstate_empty_ifnotexists_NavigateToTab.xaml 4.3 KB
  - 📄 bad_nclick_checkbox.xaml 3.3 KB
  - 📄 bad_nextractdata_hallucinated.xaml 1.2 KB
  - 📄 bad_no_incognito.xaml 1.0 KB
  - 📄 bad_no_log_bookends.xaml 1.4 KB
  - 📄 bad_no_trycatch_ui_heavy.xaml 1.7 KB
  - 📄 bad_nselectitem_interactionmode.xaml 999 B
  - 📄 bad_nselectitem_null_item.xaml 1.5 KB
  - 📄 bad_nselectitem_version.xaml 1.4 KB
  - 📄 bad_orphaned_scoped_activity.xaml 1.0 KB
  - 📄 bad_password_text.xaml 1.1 KB
  - 📄 bad_persistence_subworkflow.xaml 995 B
  - 📄 bad_Process.xaml 1.2 KB
  - 📄 bad_queue_name_property.xaml 1.3 KB
  - 📄 bad_references_xstring.xaml 1.3 KB
  - 📄 bad_selector_double_escaped.xaml 1.5 KB
  - 📄 bad_selector_double_quotes.xaml 1.4 KB
  - 📄 bad_sequence_variables_after_children.xaml 1.2 KB
  - 📄 bad_special_folder_temp.xaml 1.1 KB
  - 📄 bad_tab_click_no_sync.xaml 1.4 KB
  - 📄 bad_targetanchorable_child.xaml 1009 B
  - 📄 bad_throw_csharp.xaml 808 B
  - 📄 bad_uielement_in_config.xaml 2.0 KB
  - 📄 bad_undeclared_vars.xaml 1.6 KB
  - 📄 bad_WebApp_Login.xaml 1.3 KB
  - 📄 bad_wrong_datatable_prefix.xaml 1.2 KB
  - 📄 bad_wrong_xmlns_url.xaml 888 B
  - 📄 bad_xlist_selectitem.xaml 1.3 KB
  - 📄 good_browser_workflow.xaml 2.8 KB
- 📁 reframework/
  - 📁 Data/
    
    📁 Input/
    
    📄 placeholder.txt 68 B
    
    📁 Output/
    
    📄 placeholder.txt 107 B
    
    📁 Temp/
    
    📄 placeholder.txt 146 B
    
    📄 Config.xlsx 16.1 KB
  - 📁 Exceptions_Screenshots/
    
    📄 placeholder.txt 110 B
  - 📁 Framework/
    
    📄 CloseAllApplications.xaml 4.5 KB
    
    📄 GetTransactionData.xaml 17.1 KB
    
    📄 InitAllApplications.xaml 5.0 KB
    
    📄 InitAllSettings.xaml 22.9 KB
    
    📄 KillAllProcesses.xaml 10.8 KB
    
    📄 Process.xaml 6.4 KB
    
    📄 RetryCurrentTransaction.xaml 19.1 KB
    
    📄 SetTransactionStatus.xaml 64.1 KB
    
    📄 TakeScreenshot.xaml 10.5 KB
  - 📁 Tests/
    
    📄 GetTransactionDataTestCase.xaml 12.2 KB
    
    📄 InitAllApplicationsTestCase.xaml 10.7 KB
    
    📄 InitAllSettingsTestCase.xaml 9.5 KB
    
    📄 MainTestCase.xaml 11.5 KB
    
    📄 ProcessTestCase.xaml 12.6 KB
    
    📄 Tests.xlsx 10.4 KB
    
    📄 WorkflowTestCaseTemplate.xaml 10.4 KB
  - 📄 entry-points.json 493 B
  - 📄 Main.xaml 89.5 KB
  - 📄 Main.xaml.json 1022 B
  - 📄 project.json 3.0 KB
- 📁 samples/
  - 📁 common-workflows/
    
    📁 Workflows/
    
    📁 Api/
    
    📄 Api_FetchInvoices.xaml 15.6 KB
    
    📁 Dispatcher/
    
    📄 ExcelDispatcher_Process.xaml 10.9 KB
    
    📁 Performer/
    
    📄 Performer_Process.xaml 10.6 KB
    
    📁 Utils/
    
    📄 App_Close.xaml 9.9 KB
    
    📄 Browser_NavigateToUrl.xaml 10.9 KB
    
    📁 WebAppName/
    
    📄 WebAppName_Launch.xaml 32.1 KB
    
    📄 HttpApiDispatcher_Main.xaml 10.2 KB
- 📁 simple-sequence/
  - 📄 FormFilling_Main.xaml 92.0 KB
  - 📄 Main.xaml 18.3 KB
  - 📄 PDFExtraction_Main.xaml 17.4 KB
  - 📄 WebScraping_Sequence1.xaml 12.5 KB
- 📁 simple-sequence-template/
  - 📄 Main.xaml 5.4 KB
  - 📄 project.json 1.4 KB
- 📁 stripped/
  - 📄 FormFilling_Main.xaml 25.9 KB
  - 📄 REFramework_Main.xaml 46.3 KB
  - 📄 SetTransactionStatus.xaml 37.1 KB
📁 evals/
- 📄 core-battle-tests.md 14.1 KB
📁 references/
- 📄 cheat-sheet.md 25.3 KB
- 📄 config-sample.md 9.5 KB
- 📄 decomposition.md 33.7 KB
- 📄 expr-collections-json.md 13.9 KB
- 📄 expr-datatable.md 16.8 KB
- 📄 expr-foundations.md 6.1 KB
- 📄 expr-strings-datetime.md 18.2 KB
- 📄 generation.md 21.9 KB
- 📄 golden-templates.md 14.7 KB
- 📄 lint-reference.md 9.7 KB
- 📄 playwright-selectors.md 17.4 KB
- 📄 rules.md 13.1 KB
- 📄 scaffolding.md 25.4 KB
- 📄 skill-guide.md 7.9 KB
- 📄 ui-inspection-reference.md 12.8 KB
- 📄 ui-inspection.md 12.3 KB
- 📄 xaml-control-flow.md 11.9 KB
- 📄 xaml-data.md 12.3 KB
- 📄 xaml-error-handling.md 11.0 KB
- 📄 xaml-foundations.md 9.3 KB
- 📄 xaml-integrations.md 15.2 KB
- 📄 xaml-invoke.md 8.6 KB
- 📄 xaml-orchestrator.md 15.4 KB
- 📄 xaml-ui-automation.md 33.6 KB
📁 scripts/
- 📁 generate_activities/
  - 📄 __init__.py 5.6 KB
  - 📄 _helpers.py 3.5 KB
  - 📄 _xml_utils.py 4.0 KB
  - 📄 application_card.py 9.2 KB
  - 📄 control_flow.py 25.6 KB
  - 📄 data_operations.py 24.9 KB
  - 📄 dialogs.py 2.1 KB
  - 📄 error_handling.py 4.7 KB
  - 📄 file_system.py 10.4 KB
  - 📄 http_json.py 7.6 KB
  - 📄 integrations.py 22.7 KB
  - 📄 invoke.py 6.8 KB
  - 📄 logging_misc.py 8.5 KB
  - 📄 navigation.py 8.9 KB
  - 📄 orchestrator.py 9.7 KB
  - 📄 ui_automation.py 17.6 KB
- 📁 validate_xaml/
  - 📄 __init__.py 1.3 KB
  - 📄 __main__.py 269 B
  - 📄 _cli.py 8.5 KB
  - 📄 _constants.py 5.8 KB
  - 📄 _context.py 2.0 KB
  - 📄 _fixes.py 8.9 KB
  - 📄 _orchestration.py 7.2 KB
  - 📄 _registry.py 1.9 KB
  - 📄 _structural.py 12.1 KB
  - 📄 lints_activities.py 42.4 KB
  - 📄 lints_data.py 29.7 KB
  - 📄 lints_framework.py 27.1 KB
  - 📄 lints_hallucinations.py 39.6 KB
  - 📄 lints_project.py 9.9 KB
  - 📄 lints_selectors.py 5.6 KB
  - 📄 lints_types.py 10.1 KB
  - 📄 lints_ui.py 16.1 KB
  - 📄 lints_variables.py 16.6 KB
- 📄 _mf_snippet_checks.py 5.8 KB
- 📄 _mf_types.py 2.4 KB
- 📄 _wf_boilerplate.py 5.1 KB
- 📄 _wf_types.py 4.0 KB
- 📄 _wf_validation.py 7.5 KB
- 📄 check_skill_budget.py 3.7 KB
- 📄 config_xlsx_manager.py 8.8 KB
- 📄 dependency_graph.py 12.9 KB
- 📄 generate_object_repository.py 24.5 KB
- 📄 generate_workflow.py 51.0 KB
- 📄 grade_battle_test.py 25.2 KB
- 📄 inspect-ui-tree.ps1 42.6 KB
- 📄 modify_framework.py 36.3 KB
- 📄 plugin_loader.py 10.9 KB
- 📄 regression_test.py 53.6 KB
- 📄 resolve_nuget.py 14.2 KB
- 📄 run_lint_tests.py 15.2 KB
- 📄 scaffold_project.py 24.7 KB
- 📄 test_all.py 4.7 KB
- 📄 test_auto_fix.py 6.8 KB
- 📄 test_cross_plugin.py 20.0 KB
- 📄 test_dependency_graph.py 11.2 KB
- 📄 test_generator_lint_integration.py 21.2 KB
- 📄 test_generator_snapshots.py 4.9 KB
- 📄 utils.py 5.6 KB
📄 requirements.txt 268 B
📄 SKILL.md 18.8 KB

SKILL.md

---
name: uipath-core
description: >
  Generates UiPath Studio XAML workflows, project scaffolds (sequence/dispatcher/performer),
  and expressions via 94 deterministic Python generators (plus additional generators from installed plugin skills). Use when the user mentions
  UiPath, XAML, RPA, REFramework, Orchestrator, or UiPath Studio development.
---

# UiPath Core Skill

> ⚠️ **Safety Rules** (I-1, I-2 in `rules.md`)
> - Playwright/browser inspection is **READ-ONLY**. Login page → STOP, WAIT for user. See `ui-inspection.md` → Login Gate.
> - Desktop inspection via PowerShell (`inspect-ui-tree.ps1`): read-only tree inspection only.
> - NEVER generate credentials, tokens, or passwords — real or fake.

Generate production-quality UiPath automation artifacts using real Studio-exported templates and comprehensive reference documentation. Template baseline: Studio 24.10 Windows.

## When To Read Which Reference

**Start here.** Match the user's task to the right file, then read only what's needed. For files > 200 lines, use `grep` or line-range reads — never read entire large files or XAML assets.

### Common Tasks (check these first)

| Task | Read first |
|---|---|
| Generate a XAML workflow (any kind) | `cheat-sheet.md` → JSON spec patterns → `scripts/generate_workflow.py` **(G-1)** |
| Scaffold a project | `scaffolding.md` → Template Selection → run `scripts/scaffold_project.py` |
| Generate a full project (checklist) | `scaffolding.md` → "Generating a Full Project" checklist |
| Inspect a web app (selectors) | `ui-inspection.md` → Playwright MCP workflow → `playwright-selectors.md` |
| Validate XAML | Run `scripts/validate_xaml <project> --lint` |
| Fix a specific lint warning | `lint-reference.md` → search by lint number |
| Write an expression (VB.NET/C#) | `expr-foundations.md` (start here for any expression task) |
| Decomposition / project structure | `decomposition.md` → Decomposition rules (Universal 1-8, Browser 9-13, Desktop 14) |
| Fix a user's .xaml file | `skill-guide.md` → Example 6 |
| Action Center, form tasks | **→ uipath-action-center skill** (read its `SKILL.md`) |

### Activity-Specific Reference

| Task | File | Section guidance (for large files) |
|---|---|---|
| Core activities (Assign, Log, Delay, InputDialog) | `xaml-foundations.md` (165 lines) | Read in full |
| Control flow (If, ForEach, While, Flowchart) | `xaml-control-flow.md` (208 lines) | Read in full |
| DataTable ops, file system | `xaml-data.md` (255 lines) | Grep for activity name |
| Error handling, TryCatch, Throw, RetryScope | `xaml-error-handling.md` (194 lines) | Read in full |
| InvokeWorkflowFile, InvokeCode, InvokeMethod | `xaml-invoke.md` (175 lines) | Read in full |
| Orchestrator, queues, HTTP, credentials | `xaml-orchestrator.md` (293 lines) | Grep for activity name |
| Excel, Email, PDF activities | `xaml-integrations.md` (285 lines) | Grep: `## Excel`, `## Email`, or `## PDF` |
| Build/fix selectors | `xaml-ui-automation.md` (576 lines) | **Don't read in full.** Grep: `## Selector Reference` or specific selector type |
| UI automation XAML (NClick, NTypeInto, etc.) | `xaml-ui-automation.md` | **Selector guidance only.** XAML generation via `generate_workflow.py` **(G-1)** |

### Expression Reference (large files — use targeted reads)

| Task | File | Section guidance |
|---|---|---|
| DataTable expressions (Select, Compute, LINQ) | `expr-datatable.md` (432 lines) | Grep: `## Select`, `## Compute`, `## LINQ`, `## Filter` |
| String/DateTime/numeric expressions | `expr-strings-datetime.md` (502 lines) | Grep: `## String`, `## DateTime`, `## Numeric`, `## Regex` |
| JSON, collections, type conversions | `expr-collections-json.md` (462 lines) | Grep: `## JSON`, `## Dictionary`, `## List`, `## LINQ` |

### Project & Configuration

| Task | Read first |
|---|---|
| Choose template or variant | `scaffolding.md` → Choosing the Right Variant |
| Browser automation with Playwright | `ui-inspection.md` → Playwright MCP workflow |
| Desktop app inspection | `ui-inspection.md` → Desktop Inspection → `ui-inspection-reference.md` |
| Login/Launch pattern | `decomposition.md` → Login/Launch section |
| Config.xlsx keys and structure | `config-sample.md` → three-sheet reference, decision flowchart |
| Extract Config keys from project | Run `validate_xaml <project> --lint` — lint 39 |
| Lint regression tests | Run `scripts/run_lint_tests.py` |
| Ground rules (all rule definitions) | `rules.md` — single source of truth for G/I/A/P/S rules |
| project.json schema and configuration fields | `scaffolding.md` → Key project.json Configuration Fields |

## Ground Rules

> **Full rule definitions with rationale:** `references/rules.md`. Rules below are referenced by ID.

1. **G-4** — Never generate XAML from scratch. Copy from closest template and modify.
2. **G-5** — Never guess NuGet package versions. Run `scripts/resolve_nuget.py`.
3. **G-1** — ⛔ Create .xaml files ONLY via `scripts/generate_workflow.py`. Never hand-write. See `generation.md` § Workflow Generation CLI.
4. **P-1** — Follow the PDD exactly. Implement the specified approach faithfully — propose alternatives separately.
5. **P-2** — Architecture selection: PDD describes BOTH reading AND processing items? → Dispatcher + Performer. See `scaffolding.md`.
6. **A-5** — Modular decomposition. Break into `Workflows/<AppName>/` subfolders. See `decomposition.md`.
7. **I-2** — ⛔ HALT at login gates during Playwright inspection. End your response, wait for user.
8. **G-3** — ⛔ Framework wiring: GENERATE FIRST, WIRE SECOND. Snippets MUST come from generator output. See `scaffolding.md` Phase 3c.
9. **G-2** — ⛔ JSON specs: WRITE TO DISK, NEVER INLINE. See `cheat-sheet.md` § type keys for valid types.

## CRITICAL: Project Context Check (Always Do This First)

Before generating ANY XAML, determine project context:

**A) project.json EXISTS (inside existing project):**
- Generate the .xaml file inside the project directory
- Check `dependencies` — add missing NuGet packages: `python3 scripts/resolve_nuget.py --add <project_dir> PackageName`

**B) project.json DOES NOT EXIST:**
- Scaffold first — a standalone .xaml is useless without project.json
- Use `scripts/scaffold_project.py` (see `scaffolding.md`)
- **Do NOT create the project folder before scaffolding.** The script creates `<o>/<n>/` automatically. Pre-creating causes duplicate nesting.

## Capabilities

1. **Generate XAML workflow files** — copy from real Studio exports and modify
2. **Scaffold UiPath projects** — Simple sequence, REFramework Dispatcher, or REFramework Performer
3. **Write expressions** — VB.NET and C# for UiPath activities (LINQ, DataTable, JSON, DateTime, etc.)
4. **Build selectors** — strict, fuzzy, dynamic, wildcard, regex selectors for web/desktop/SAP
5. **HTTP API integration** — OAuth token flows, retry policies, query parameters, response handling
6. **Action Center tasks** — **→ Fully decoupled to uipath-action-center skill** (generators, lint rules, scaffold hooks all live in `uipath-action-center/extensions/`, loaded via `plugin_loader.py`)
7. **UI automation** — NApplicationCard, NClick, NTypeInto, NSelectItem, NGetText, Extract Table Data, Check App State — **via `scripts/generate_activities`**
8. **Error handling & workflow** — TryCatch, RetryScope, Throw/Rethrow, InvokeWorkflowFile, AddQueueItem, GetRobotCredential, BuildDataTable, IfElseIfV2, MultipleAssign — **via `scripts/generate_activities`**
9. **File system operations** — Copy/Move/Delete files, Create Directory, Path Exists
10. **Invoke Code/Method** — inline C#/VB.NET code blocks, instance/static method calls

## Reference Files

| File | Coverage |
|---|---|
| `references/xaml-foundations.md` | XAML file structure, namespace declarations, core activities (Assign, Log, InputDialog, MessageBox, Delay), variable & argument declarations |
| `references/xaml-control-flow.md` | If, IfElseIf, ForEach, ForEachRow, While, DoWhile, Break/Continue, ForEachFile, Flowchart, State Machine, annotations |
| `references/xaml-data.md` | BuildDataTable, AddDataRow, FilterDataTable, MergeDataTable, SortDataTable, OutputDataTable, JoinDataTables, LookupDataTable, DeserializeJSON, file system ops |
| `references/xaml-error-handling.md` | TryCatch, Throw/Rethrow, exception types, RetryScope (incl. NCheckState condition) |
| `references/xaml-invoke.md` | InvokeWorkflowFile, InvokeCode, InvokeMethod |
| `references/xaml-orchestrator.md` | GetRobotAsset, GetRobotCredential, AddQueueItem, GetQueueItem, SetTransactionStatus, HTTP Request. **Action Center → uipath-action-center skill** |
| `references/xaml-integrations.md` | Excel Classic Workbook (ReadRange, WriteRange, WriteCell), Email/Integration Service (GetIMAP, SendMail), PDF (ReadPDFText, ReadPDFWithOCR) |
| `references/xaml-ui-automation.md` | Selector construction, dynamic selectors, fuzzy/regex, anchor targeting, desktop frameworks, Version table. **For XAML generation use generators** — this file is for selector guidance and activity property reference. **Large file — use grep or line-range reads.** |
| `references/expr-foundations.md` | VB.NET + C# expression syntax, null safety patterns. Read first for any expression task |
| `references/expr-datatable.md` | DataTable operations: Select, Compute, filter, sort, lookup, merge, clone, column ops, row iteration. **Large file — grep for section.** |
| `references/expr-strings-datetime.md` | String (split, join, trim, replace, format), DateTime (parse, format, diff, business days), file/path, numeric, regex. **Large file — grep for section.** |
| `references/expr-collections-json.md` | Array/List, Dictionary, JSON (JObject, JArray, parse, query, build), LINQ on typed collections, type conversions, Queue Item. **Large file — grep for section.** |
| `references/golden-templates.md` | Template catalog — patterns extracted from each real template file |
| `references/scaffolding.md` | Template selection, NuGet mapping, XAML validation, project scaffolding (variants, dispatcher/performer, transaction types), full project generation checklist |
| `references/decomposition.md` | Naming conventions, decomposition rules (universal 1-8, browser 9-13, desktop 14), common process patterns, argument design, Login/Launch pattern, REFramework Init/Close, UiElement chain |
| `references/generation.md` | Object Repository, Workflow Generation CLI (JSON spec format, 94 core generators + plugin extensions), Activity Generators (usage pattern, what model provides vs what generators lock down) |
| `references/ui-inspection.md` | Playwright MCP workflow (login gate, 5-step process, element mapping), Desktop inspection (PowerShell, inspect-ui-tree.ps1, framework detection) |
| `references/skill-guide.md` | **Index + examples.** Routes to scaffolding/decomposition/generation/ui-inspection. Contains 7 worked examples + anti-example |
| `references/lint-reference.md` | **71 lint rules** by severity, searchable by lint number (core rules; plugins add more) |
| `references/playwright-selectors.md` | Playwright MCP → UiPath selector mapping |
| `references/config-sample.md` | Config.xlsx three-sheet reference (Settings, Constants, Assets), key naming conventions, sheet placement decision flowchart, required keys output format |
| `references/cheat-sheet.md` | JSON spec patterns (multiple_assign, if, try_catch, foreach_row, pick_login_validation, filter_data_table, add_queue_item, selectors.json), modify_framework.py CLI+Python API, valid enum values, naming, quick rules |
| `references/cheat-sheet.md` § Desktop Form-Filling | Desktop form-filling: tab nav, idx selectors, save verification, data externalization |
| `references/ui-inspection-reference.md` | `inspect-ui-tree.ps1` reference — UIA→UiPath property mapping, framework detection, WinForms |
| `references/rules.md` | **Ground Rules Reference** — single source of truth for all generation (G), inspection (I), architecture (A), PDD (P), SAP (S), and skill authoring (K) rules. Other docs reference by ID |

### Scripts

> **All `scripts/` paths below are relative to this skill's directory (`.claude/skills/uipath-core/`).**
> Invoke from the skill root: `cd .claude/skills/uipath-core && python3 scripts/<script>.py ...`

| File | Purpose |
|---|---|
| `scripts/validate_xaml` | Validate generated XAML — structural checks + lint rules (core + plugin). Use `--golden` for asset templates. See `lint-reference.md` for full rule table. |
| `scripts/resolve_nuget.py` | **Resolve real NuGet versions.** Query UiPath feed for latest stable. Validate project.json. Add/update deps in existing project.json (`--add`). |
| `scripts/scaffold_project.py` | Scaffold UiPath projects (sequence / dispatcher / performer). Customizes Config.xlsx. Dispatcher replaces GetQueueItem with DataTable row indexing. |
| `scripts/config_xlsx_manager.py` | Add/list/validate Config.xlsx keys. Cross-references XAML Config() refs vs actual sheets. |
| `scripts/modify_framework.py` | Insert InvokeWorkflowFile into framework files, replace SCAFFOLD.* markers, **wire UiElement argument chain** (`wire-uielement`), **add variables with auto type normalization** (`add-variables`), **replace placeholder expressions** (`set-expression`). ⛔ G-8: Never Edit/Write .xaml directly — use this script or `generate_workflow.py`. |
| `scripts/generate_activities` | **Deterministic XAML generators** for 94 core activities. Locks down enums, versions, child elements. MANDATORY for NTypeInto, NClick, NGetText, NCheckState, NApplicationCard, etc. Plugin skills add more (e.g., Action Center, SAP WinGUI). |
| `scripts/generate_workflow.py` | **Generate complete .xaml files from JSON specs.** 94 core generators + plugin generators loaded via `plugin_loader.py`. Covers ALL activities including Pick login validation, TryCatch, ForEachRow, NExtractData, NCheckState. **Pass `--project-dir <project>` to auto-wire Object Repository references** (`Reference=`/`ContentHash=` on TargetAnchorable) from `.objects/refs.json`. ⛔ Do NOT write .xaml by hand — use this CLI instead. |
| `scripts/generate_object_repository.py` | **Generate Object Repository** (`.objects/` tree). CLI: `python3 generate_object_repository.py --from-selectors selectors.json --project-dir <dir>`. Reads `selectors.json` (written during Playwright inspection) with full app/screen/element hierarchy. Lint 94 is ERROR — project cannot pass validation without populated Object Repository. |
| `scripts/inspect-ui-tree.ps1` | **Windows-only.** Inspect desktop app UI tree via UIA API. Run via Bash (`powershell -File`). |
| `scripts/regression_test.py` | Regression tests — validates templates, scaffolding, naming conventions, line count accuracy, skill integrity |
| `scripts/run_lint_tests.py` | Lint regression: verifies bad XAML test cases trigger expected lints. Run after modifying lint rules. |

## Key Architecture Rules

> Full definitions: `references/rules.md` § Architecture Rules (A-1 through A-12).

**App initialization (A-1):** ALL apps open and ready by end of `InitAllApplications.xaml`. Action workflows ONLY attach (`OpenMode="Never"`). Wire UiElement chain: `python3 scripts/modify_framework.py wire-uielement <project> <AppName>`.

**Key constraints:** no flat files in `Workflows/` (must be in app subfolders), login stays inside `AppName_Launch.xaml` (no separate `AppName_Login.xaml`), navigation uses shared `Utils/Browser_NavigateToUrl.xaml` **(A-6)**, persistence activities stay in Main.xaml **(A-2)**, `SetTransactionStatus.xaml` never modified **(A-4)**, dispatchers pass `Nothing` for `in_TransactionItem`.

### Login/Launch Workflow Pattern

See `decomposition.md` → "Login/Launch Workflow Pattern" for the full recipe, required XAML structure, argument design, UiElement reference chain, and common mistakes. Key rule: **login stays inside `AppName_Launch.xaml`** — NEVER create a separate `AppName_Login.xaml`. Copy structure from golden sample `WebAppName_Launch.xaml`.

## Quick Validation Reference

For detailed lint rules by number, see `lint-reference.md`. The most critical categories:

**🔴 Studio crash** — Inline `Result=` on modern activities, hallucinated enum values (`AttachMode="ByUrl"`, `Version="V3"/"V4"`, `ElementType="InputBoxText"`), missing xmlns declarations, hallucinated properties (`NApplicationCard Url=`, `NCheckState Appears=`, `NTypeInto EmptyField=`, `AddQueueItem.SpecificContent`). See `cheat-sheet.md` → Valid Enum Values.

**🟡 Compile error / silent data loss** — Wrong enum namespace (`UIAutomation` vs `UIAutomationNext`), C# syntax in Throw expressions, `InteractionMode` on activities that don't support it (only NClick/NTypeInto have it), `QueueName=` instead of `QueueType=`, empty Out/InOut argument bindings, direction tag mismatches.

**🟢 Production / security** — Credentials via `GetRobotCredential` inside the workflow (never as arguments), API/network wrapped in RetryScope, URLs from Config (never hardcoded), browser `IsIncognito="True"`, log bookends on every workflow.

## Desktop App Automation

When automating a **desktop application** (not browser/web):

1. **Get the executable path first.** Before generating NApplicationCard XAML, you MUST have the full `.exe` path. Never use placeholders. ASK → STOP → WAIT. UWP apps use the package AppId.

2. **Desktop vs Browser differences:** Desktop uses `TargetApp.FilePath` (no `BrowserType`/`Url`/`IsIncognito`), `InteractionMode` = `HardwareEvents` or `Simulate` (NOT `DebuggerApi`). Selectors use `<wnd app='...' />` with `automationid`, `cls`, `aaname`, `role` attributes.

3. **Inspection is mandatory** when PowerShell is available (Windows) — run `inspect-ui-tree.ps1` BEFORE generating desktop XAML.

4. **WinForms tab names vs group box names:** When `inspect-ui-tree.ps1` shows a TabControl, children at depth 2 are TabItems (actual tab names for navigation). Children at depth 3 are GroupBoxes (visual containers INSIDE a tab, NOT navigation targets). See `decomposition.md` → Rule 14 supplement and `ui-inspection-reference.md` → WinForms Tab Control Hierarchy.

## Naming Conventions

**Variables:** camelCase with type prefix — `strName`, `intCount`, `boolSuccess`, `dt_Report`, `dr_Row`, `arr_Files`, `dict_Config`, `dtmStart`, `dblAmount`, `jo_Response`, `secstrPassword`, `qi_Item`, `mm_Mail`.

**Arguments:** `{direction}_{typePrefix}{Name}` — `in_strUserName`, `out_boolSuccess`, `io_dt_Data`.

**Workflow files:** PascalCase with underscores — `WebApp_CreateRecord.xaml`, `App_Close.xaml`.

See `cheat-sheet.md` → Naming Quick Reference for the full type prefix table.

## Selectors — Always Default to Strict

Generators default to `SearchSteps="Selector"` (strict). Use `FuzzySelector` only when user requests or strict proven unreliable. Always populate BOTH `FullSelectorArgument` and `FuzzySelectorArgument`.

## Tested Models

This skill is developed and tested with **Claude Opus** and **Claude Sonnet**. The prompt engineering (HALT semantics, routing table placement, urgency tiers) is Claude-optimized. Other LLMs may work but are untested — expect to adapt the prompt layer.

登录后下载/点赞/收藏 ❤ 37 | ★ 0

uipath-core

目录结构

SKILL.md

举报内容

提示