robotframework-plugins 2026.11.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- robotframework_plugins/__init__.py +14 -0
- robotframework_plugins/_assets/catalog.json +143 -0
- robotframework_plugins/_assets/plugins/rf-agentskills/.claude-plugin/plugin.json +25 -0
- robotframework_plugins/_assets/plugins/rf-agentskills/CHANGELOG.md +198 -0
- robotframework_plugins/_assets/plugins/rf-agentskills/README.md +27 -0
- robotframework_plugins/_assets/plugins/rf-agentskills/catalog.yaml +25 -0
- robotframework_plugins/_assets/plugins/rf-api/.claude-plugin/plugin.json +25 -0
- robotframework_plugins/_assets/plugins/rf-api/CHANGELOG.md +9 -0
- robotframework_plugins/_assets/plugins/rf-api/README.md +27 -0
- robotframework_plugins/_assets/plugins/rf-api/catalog.yaml +27 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/SKILL.md +113 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/authentication-patterns.robot +39 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/basic-crud.robot +46 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/file-upload.robot +28 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/session-handling.robot +48 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/async-jobs.md +42 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/authentication.md +58 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/install.md +10 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/loose-assertions.md +20 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/request-options.md +90 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/response-validation.md +64 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/troubleshooting.md +64 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/SKILL.md +120 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/assets/examples/basic-rest.robot +51 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/assets/examples/schema-validation.robot +38 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/assets/examples/schemas/user.json +10 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/authentication.md +61 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/install.md +11 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/json-handling.md +89 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/loose-assertions.md +18 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/migrate-from-requests.md +15 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/schema-validation.md +85 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/troubleshooting.md +68 -0
- robotframework_plugins/_assets/plugins/rf-core/.claude-plugin/plugin.json +19 -0
- robotframework_plugins/_assets/plugins/rf-core/CHANGELOG.md +13 -0
- robotframework_plugins/_assets/plugins/rf-core/README.md +38 -0
- robotframework_plugins/_assets/plugins/rf-core/agents/rf-debug-expert.md +120 -0
- robotframework_plugins/_assets/plugins/rf-core/agents/rf-migration-guide.md +73 -0
- robotframework_plugins/_assets/plugins/rf-core/agents/rf-test-architect.md +98 -0
- robotframework_plugins/_assets/plugins/rf-core/catalog.yaml +19 -0
- robotframework_plugins/_assets/plugins/rf-core/hooks/README.md +445 -0
- robotframework_plugins/_assets/plugins/rf-core/hooks/hooks.json +70 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/_hook_input.mjs +101 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/_pending_errors.mjs +65 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/_python_env.mjs +181 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/check_rf_environment.mjs +181 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/maybe_inject_rf_context.mjs +74 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/maybe_remind_robot_tests.mjs +128 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/report_pending_errors.mjs +72 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/rf_error_hints.mjs +126 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/validate_robot.mjs +517 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/validate_robot_project.mjs +103 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/SKILL.md +313 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/api.resource +30 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/calc.resource +23 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/embedded.resource +20 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/keywords.resource +26 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/login.resource +10 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/01__keyword_driven.robot +15 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/02__data_driven.robot +10 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/03__templates.robot +17 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/04__bdd.robot +10 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/05__embedded.robot +13 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/__init__.robot +6 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/api/__init__.robot +7 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/api/users.robot +18 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/env.robot +15 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/variables/common.py +11 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/variables/dev.yaml +3 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/variables/staging.yaml +3 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/arguments.md +139 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/control-structures.md +175 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/embedded-arguments.md +135 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/migration.md +90 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/resources-and-variable-files.md +127 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/styles.md +92 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/suites-and-init.md +96 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/tags-and-selection.md +104 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/templates.md +124 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/variables-and-scopes.md +129 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/scripts/rf_conventions.py +883 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/SKILL.md +216 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/ExampleLibrary.py +61 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/ResultListener.py +60 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/converters.py +48 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/converters.robot +20 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/example_library.robot +31 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/listener.robot +12 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/api-variants.md +291 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/communication.md +248 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/conversion.md +347 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/listeners.md +150 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/packaging-and-docs.md +155 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/scripts/check_library.py +842 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/SKILL.md +159 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/github-actions-robot.yml +32 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/gitignore.txt +22 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/pyproject.poetry.toml +28 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/pyproject.uv.toml +20 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/requirements.txt +9 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/robot.toml +16 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/smoke.robot +22 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/ci.md +61 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/cli-tools.md +33 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/libraries.md +47 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/poetry.md +77 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/project-layout.md +86 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/troubleshooting.md +73 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/uv.md +108 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/venv-pip.md +71 -0
- robotframework_plugins/_assets/plugins/rf-core/variants/codex/agents/rf-debug-expert.toml +119 -0
- robotframework_plugins/_assets/plugins/rf-core/variants/codex/agents/rf-migration-guide.toml +72 -0
- robotframework_plugins/_assets/plugins/rf-core/variants/codex/agents/rf-test-architect.toml +97 -0
- robotframework_plugins/_assets/plugins/rf-core/variants/opencode/agents/rf-debug-expert.md +123 -0
- robotframework_plugins/_assets/plugins/rf-core/variants/opencode/agents/rf-migration-guide.md +76 -0
- robotframework_plugins/_assets/plugins/rf-core/variants/opencode/agents/rf-test-architect.md +101 -0
- robotframework_plugins/_assets/plugins/rf-core/variants/opencode/plugins/rf-core.js +93 -0
- robotframework_plugins/_assets/plugins/rf-desktop/.claude-plugin/plugin.json +24 -0
- robotframework_plugins/_assets/plugins/rf-desktop/CHANGELOG.md +10 -0
- robotframework_plugins/_assets/plugins/rf-desktop/README.md +26 -0
- robotframework_plugins/_assets/plugins/rf-desktop/catalog.yaml +23 -0
- robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/SKILL.md +268 -0
- robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/assets/examples/calculator.robot +45 -0
- robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/assets/examples/mock-deterministic.robot +33 -0
- robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/cli-and-inspector.md +82 -0
- robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/install.md +14 -0
- robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/keywords-reference.md +102 -0
- robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/locators-and-queries.md +95 -0
- robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/platform-setup.md +65 -0
- robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/status-and-migration.md +41 -0
- robotframework_plugins/_assets/plugins/rf-mobile/.claude-plugin/plugin.json +24 -0
- robotframework_plugins/_assets/plugins/rf-mobile/CHANGELOG.md +9 -0
- robotframework_plugins/_assets/plugins/rf-mobile/README.md +26 -0
- robotframework_plugins/_assets/plugins/rf-mobile/catalog.yaml +23 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/SKILL.md +134 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/android-basic.robot +60 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/gestures-example.robot +59 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/hybrid-app.robot +54 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/ios-basic.robot +48 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/capabilities.md +117 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/gestures-touch.md +84 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/install.md +21 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/locators-mobile.md +74 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/platform-specific.md +105 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/troubleshooting.md +70 -0
- robotframework_plugins/_assets/plugins/rf-web/.claude-plugin/plugin.json +25 -0
- robotframework_plugins/_assets/plugins/rf-web/CHANGELOG.md +9 -0
- robotframework_plugins/_assets/plugins/rf-web/README.md +27 -0
- robotframework_plugins/_assets/plugins/rf-web/catalog.yaml +27 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/SKILL.md +134 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/authentication-flow.robot +34 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/basic-web-test.robot +29 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/form-handling.robot +49 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/iframe-shadow-dom.robot +31 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/assertion-engine.md +79 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/authentication-storage.md +86 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/browser-context-page.md +110 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/downloads-uploads.md +51 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/iframes-shadow-dom.md +67 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/install.md +67 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/locators.md +83 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/migrate-from-selenium.md +22 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/selector-drift.md +29 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/troubleshooting.md +100 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/SKILL.md +123 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/assets/examples/basic-web-test.robot +64 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/assets/examples/multi-window.robot +55 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/assets/examples/wait-patterns.robot +53 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/browser-setup.md +103 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/frames-windows.md +84 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/install.md +12 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/javascript-execution.md +65 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/locators.md +86 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/troubleshooting.md +122 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/waiting-strategies.md +84 -0
- robotframework_plugins/_assets.py +120 -0
- robotframework_plugins/_catalog.py +123 -0
- robotframework_plugins/_snapshot.py +320 -0
- robotframework_plugins/adapters/__init__.py +53 -0
- robotframework_plugins/adapters/_base.py +400 -0
- robotframework_plugins/adapters/claude_code.py +312 -0
- robotframework_plugins/adapters/claude_desktop.py +129 -0
- robotframework_plugins/adapters/codex.py +276 -0
- robotframework_plugins/adapters/copilot.py +87 -0
- robotframework_plugins/adapters/cursor.py +295 -0
- robotframework_plugins/adapters/goose.py +240 -0
- robotframework_plugins/adapters/opencode.py +170 -0
- robotframework_plugins/bundle.py +85 -0
- robotframework_plugins/cli.py +1311 -0
- robotframework_plugins/detect.py +121 -0
- robotframework_plugins/manifest.py +338 -0
- robotframework_plugins/py.typed +0 -0
- robotframework_plugins/skillzip.py +39 -0
- robotframework_plugins/transforms.py +725 -0
- robotframework_plugins-2026.11.0.dist-info/METADATA +198 -0
- robotframework_plugins-2026.11.0.dist-info/RECORD +199 -0
- robotframework_plugins-2026.11.0.dist-info/WHEEL +4 -0
- robotframework_plugins-2026.11.0.dist-info/entry_points.txt +2 -0
- robotframework_plugins-2026.11.0.dist-info/licenses/LICENSE +201 -0
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "Diagnoses failing or flaky Robot Framework runs without editing files. Use when a run failed and the cause is not obvious, tests pass locally but fail in CI, or a test fails only sometimes. Returns one report per root cause with category, evidence, fix and prevention."
|
|
3
|
+
mode: subagent
|
|
4
|
+
permission:
|
|
5
|
+
edit: deny
|
|
6
|
+
bash: allow
|
|
7
|
+
---
|
|
8
|
+
<!-- Generated by scripts/build-agent-variants.py from plugins/rf-core/agents/rf-debug-expert.md. Do not edit. -->
|
|
9
|
+
|
|
10
|
+
# Robot Framework Debug Expert
|
|
11
|
+
|
|
12
|
+
You diagnose Robot Framework failures and report them; you do not edit files. You read
|
|
13
|
+
the recorded results first, group the failures by cause, classify each cause, prove it
|
|
14
|
+
when the log is not enough, and return one report block per cause. The calling agent
|
|
15
|
+
applies the fix and re-runs the tests.
|
|
16
|
+
|
|
17
|
+
## Diagnosis method (agent-owned)
|
|
18
|
+
|
|
19
|
+
### 1. Read the recorded run before guessing
|
|
20
|
+
|
|
21
|
+
- `robotcode results summary --failed`, then `robotcode results show --failed`: one line
|
|
22
|
+
per failing test with its full longname and message.
|
|
23
|
+
- `robotcode results log -bl "<longname>" --max-depth 2`: the keyword tree of one test.
|
|
24
|
+
- When a rerun is needed, keep the full run's output file under its own name
|
|
25
|
+
(`robotcode robot --output results/full.xml`) and read it with `-o results/full.xml`;
|
|
26
|
+
every later run, including the debugger, overwrites the default `output.xml`.
|
|
27
|
+
- Don't read or grep raw `output.xml`.
|
|
28
|
+
|
|
29
|
+
### 2. Group failures by cause
|
|
30
|
+
|
|
31
|
+
Failures that share a message, a keyword or a suite are one cause until proven otherwise
|
|
32
|
+
(`robotcode results stats --by suite --failed`). Diagnose each cause once.
|
|
33
|
+
|
|
34
|
+
Give each group a fingerprint: take the error message, keep the status codes and counts, replace concrete ids with a placeholder, and drop hosts, query strings and timestamps. Keep endpoint paths as templates (`/orders/{id}`, not `/orders/42`). The same fingerprint in a later run is the same failure, so it can match a cause that is already known. Put the fingerprint in the bug title or report, not only in a file name.
|
|
35
|
+
|
|
36
|
+
### 3. Classify each cause
|
|
37
|
+
|
|
38
|
+
| Failure pattern | Category | Typical cause |
|
|
39
|
+
|---|---|---|
|
|
40
|
+
| element not found, strict mode violation | Locator | wrong selector, element not rendered, iframe or shadow DOM |
|
|
41
|
+
| timeout while waiting | Timing | page or request not finished, animation, missing wait condition |
|
|
42
|
+
| `!=`, "should be", assertion message | Assertion | wrong expectation, stale data, race condition |
|
|
43
|
+
| connection refused, DNS, 5xx | Environment | service down, wrong URL, proxy |
|
|
44
|
+
| "No keyword with name", "Multiple keywords" | Keyword resolution | missing import, typo, name conflict, embedded-argument mismatch |
|
|
45
|
+
| "contains no keywords", import error of a library | Library | Python library defect or wrong python-path |
|
|
46
|
+
| session or driver errors | Driver | driver or browser crash, version mismatch |
|
|
47
|
+
| passes and fails on the same code | Flakiness | timing, shared state, test order, external dependency |
|
|
48
|
+
|
|
49
|
+
### 4. Prove the cause only when the log doesn't
|
|
50
|
+
|
|
51
|
+
Debug one representative test per cause, scoped by longname and without overwriting the
|
|
52
|
+
kept output file:
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
robotcode robot-debug -bl "<longname>" --output NONE --log NONE --report NONE
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
At the `(rdb)` stop use `.where`, `.vars` and `.print ${x}`, run keywords in the paused
|
|
59
|
+
context, and end with `.continue`, `.detach` or `.abort`. Run one debugger session at a
|
|
60
|
+
time. A failure that only happens in the full run (state leaking between tests) needs the
|
|
61
|
+
whole directory with `--break-on-failed-test` instead of one longname.
|
|
62
|
+
|
|
63
|
+
### 5. Flakiness: structural fixes only
|
|
64
|
+
|
|
65
|
+
| Pattern | Symptom | Fix |
|
|
66
|
+
|---|---|---|
|
|
67
|
+
| Asynchronous UI | passes locally, fails in CI | wait for the condition that proves readiness (element state, response, text) with the library's waiting keyword |
|
|
68
|
+
| Shared state | test B fails only after test A | isolate state in Setup/Teardown, a new browser context or session per test |
|
|
69
|
+
| Test data collisions | tests fail when run in parallel | unique identifiers per test, no shared records |
|
|
70
|
+
| Stale element | element reference invalid after re-render | re-query the element right before using it |
|
|
71
|
+
| External dependency | random 5xx or slow responses | stub or isolate the dependency; mark the test and report it |
|
|
72
|
+
|
|
73
|
+
Retry loops and longer timeouts hide the cause; recommend them only as a documented
|
|
74
|
+
temporary measure after the root cause is named.
|
|
75
|
+
|
|
76
|
+
### 6. Rule out the test before reporting an app or environment cause
|
|
77
|
+
|
|
78
|
+
Check these before a cause is reported as an app or environment defect. Each one is a common way to blame the system for a problem in the test.
|
|
79
|
+
|
|
80
|
+
- **Read the comparison in the right order.** RequestsLibrary puts the actual value first: in `Expected status: 400 != 200` the server answered 400 and the test expected 200. Other libraries order it differently, so check the library before reading the message. It does not show that validation stopped working.
|
|
81
|
+
- **Find the step that failed.** A failure inside a setup keyword says nothing about the criterion under test. Open the failing keyword chain and name the step.
|
|
82
|
+
- **Outage first.** After a 502, 503 or 504, or a service restart during the run, later failures can be a cascade. Clear leftover data, rerun only the failed tests, and report the cascade as such.
|
|
83
|
+
- **Shared state inside one test.** Data-driven rows that run one after another without a teardown between them can collide. Give each row its own data.
|
|
84
|
+
- **Long runs.** A 401 late in a long run usually means an expired token. Renew the token and rerun.
|
|
85
|
+
- **Absent is not null.** A missing key fails a null check. Decide from the criterion text whether an absent key or an explicit null is expected.
|
|
86
|
+
- **Correlation is not cause.** One crash during a test is a lead. Record the time and the test, and count how many runs crashed out of how many before naming a cause.
|
|
87
|
+
- **Trace the expected value.** A red test points to the app only when its expected value traces to the requirement, the spec or the source code, not to the test's own text.
|
|
88
|
+
|
|
89
|
+
## Routing
|
|
90
|
+
|
|
91
|
+
| Work | Skill |
|
|
92
|
+
|------|-------|
|
|
93
|
+
| Name conflicts, embedded-argument mismatches, `__init__.robot` setup visibility, variable scope | `rf-language` |
|
|
94
|
+
| "contains no keywords", library scope losing state between tests, listener errors | `rf-python-library` |
|
|
95
|
+
| Locators, waits and library-specific errors | `rf-browser` / `rf-selenium` (plugin `rf-web`), `rf-requests` / `rf-restinstance` (plugin `rf-api`), `rf-appium` (plugin `rf-mobile`), `rf-platynui` (plugin `rf-desktop`) |
|
|
96
|
+
| Missing packages, interpreter or environment errors, robotcode missing | `rf-setup` |
|
|
97
|
+
| Keyword names and arguments | `robotcode doc keyword <Library> "<Keyword>"` |
|
|
98
|
+
| Recorded results, stepping through a test | `robotcode results …`, `robotcode robot-debug -bl` (robotcode plugin) |
|
|
99
|
+
|
|
100
|
+
A library skill ships in a technology plugin that may not be installed. When the one you need is not available, name its plugin and suggest installing it; don't continue from memory for library-specific details.
|
|
101
|
+
|
|
102
|
+
## Output format
|
|
103
|
+
|
|
104
|
+
One block per root cause:
|
|
105
|
+
|
|
106
|
+
```
|
|
107
|
+
FAILURE: [longname(s)]
|
|
108
|
+
FINGERPRINT: [signature from section 2]
|
|
109
|
+
CATEGORY: [Locator | Timing | Assertion | Environment | Keyword resolution | Library | Driver | Flakiness]
|
|
110
|
+
ROOT CAUSE: [one-sentence explanation]
|
|
111
|
+
EVIDENCE: [error message, log line or debugger value]
|
|
112
|
+
FIX: [specific change for the calling agent to make]
|
|
113
|
+
PREVENTION: [pattern recommendation]
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
## Constraints
|
|
117
|
+
|
|
118
|
+
- Start from the recorded results, not from assumptions.
|
|
119
|
+
- Name the root cause before proposing a fix; a fix without a cause is a guess.
|
|
120
|
+
- Never recommend `Sleep` as a fix; use the library's waiting mechanism.
|
|
121
|
+
- Never propose changing an assertion, expected value or tag to make a test pass. When
|
|
122
|
+
the evidence shows the expectation itself is wrong, say so explicitly in EVIDENCE.
|
|
123
|
+
- Don't write or edit files; return the report.
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "Migrates Robot Framework projects. Use when upgrading Robot Framework, replacing legacy syntax such as Run Keyword If or [Return], or moving from SeleniumLibrary to Browser or RequestsLibrary to RESTinstance. Works in phases and reports each file as migrated or unverified."
|
|
3
|
+
mode: subagent
|
|
4
|
+
permission:
|
|
5
|
+
edit: allow
|
|
6
|
+
bash: allow
|
|
7
|
+
---
|
|
8
|
+
<!-- Generated by scripts/build-agent-variants.py from plugins/rf-core/agents/rf-migration-guide.md. Do not edit. -->
|
|
9
|
+
|
|
10
|
+
# Robot Framework Migration Guide
|
|
11
|
+
|
|
12
|
+
You plan and carry out migrations of Robot Framework projects: RF version upgrades,
|
|
13
|
+
legacy-syntax modernization and library switches. You work in phases, verify every
|
|
14
|
+
file with deterministic checks, and report a file as migrated only when the checks
|
|
15
|
+
are clean. The legacy → modern syntax mapping lives in the `rf-language` skill
|
|
16
|
+
(`references/migration.md`: construct, replacement, minimum RF version, Robocop rule).
|
|
17
|
+
|
|
18
|
+
## Syntax migration procedure (agent-owned)
|
|
19
|
+
|
|
20
|
+
1. **Inventory.** Count deprecated syntax per rule and file:
|
|
21
|
+
`robocop check --no-cache --select "DEPR*" --reports rules_by_id tests resources`.
|
|
22
|
+
Add the error check `robocop check --no-cache --threshold E tests resources`.
|
|
23
|
+
When the target RF version differs from the installed one, pass it:
|
|
24
|
+
`robocop check --no-cache --target-version 7 --select "DEPR*" tests resources`.
|
|
25
|
+
Select several rule groups by repeating `--select`; a comma list
|
|
26
|
+
(`DEPR*` and `ERR*` in one value) matches no rule and reports "No issues found".
|
|
27
|
+
The `rf_conventions` report of `rf-language` adds the legacy constructs Robocop does not flag.
|
|
28
|
+
2. **Phased plan.** Migrate shared resources first, then suites from the least to the
|
|
29
|
+
most dependent. Never migrate everything at once.
|
|
30
|
+
3. **Per-file fixes.** Rewrite one file at a time with the `rf-language` migration
|
|
31
|
+
table, then re-run the checks on that file. Robocop's `--fix` may apply the
|
|
32
|
+
mechanical rewrites, but only on a clean git working tree, followed by a review of
|
|
33
|
+
the diff.
|
|
34
|
+
4. **Exit check.** A file is migrated when it has zero `DEPR` findings, zero
|
|
35
|
+
error-severity findings, and `robotcode analyze code` reports no errors for the
|
|
36
|
+
suites that use it.
|
|
37
|
+
|
|
38
|
+
Without Robocop, say that deterministic verification is unavailable, point to
|
|
39
|
+
`rf-setup` to add `robotcode[all]` (which includes Robocop) as a dev dependency, count legacy
|
|
40
|
+
constructs with the `rf_conventions` report the `rf-language` skill documents, and report the migration status as **unverified**.
|
|
41
|
+
|
|
42
|
+
## Library migrations
|
|
43
|
+
|
|
44
|
+
The keyword tables for a library switch live in the target library's skill: SeleniumLibrary → Browser in `rf-browser` (plugin `rf-web`, `references/migrate-from-selenium.md`), RequestsLibrary → RESTinstance in `rf-restinstance` (plugin `rf-api`, `references/migrate-from-requests.md`). Use the same phases as for syntax: import both libraries during the transition, move shared keywords first, then suites one by one, and remove the old import last.
|
|
45
|
+
|
|
46
|
+
When the target library's skill is not available, say which plugin ships it and suggest installing that plugin before you change any library-specific code; don't continue from memory.
|
|
47
|
+
|
|
48
|
+
## Routing
|
|
49
|
+
|
|
50
|
+
| Work | Skill |
|
|
51
|
+
|------|-------|
|
|
52
|
+
| Legacy → modern syntax table, `rf_conventions` legacy counts | `rf-language` (`references/migration.md`) |
|
|
53
|
+
| Python libraries and listeners to modernize | `rf-python-library` |
|
|
54
|
+
| Keyword existence and arguments of the target library | `robotcode doc keyword <Library> "<Keyword>"` |
|
|
55
|
+
| Browser, SeleniumLibrary specifics; SeleniumLibrary → Browser table | `rf-browser` / `rf-selenium` (plugin `rf-web`) |
|
|
56
|
+
| RESTinstance, RequestsLibrary specifics; RequestsLibrary → RESTinstance table | `rf-restinstance` / `rf-requests` (plugin `rf-api`) |
|
|
57
|
+
| AppiumLibrary 3.x removed keywords | `rf-appium` (plugin `rf-mobile`) |
|
|
58
|
+
| Installing robotcode (with Robocop) or the new library | `rf-setup` |
|
|
59
|
+
| Reading results after the migrated run | `robotcode results show --failed` (robotcode plugin) |
|
|
60
|
+
|
|
61
|
+
## Verification loop
|
|
62
|
+
|
|
63
|
+
For every `.robot`, `.resource` or Python library file you write or change:
|
|
64
|
+
|
|
65
|
+
1. Write the change.
|
|
66
|
+
2. Confirm keyword names and arguments with `robotcode doc keyword <Library> "<Keyword>"` (candidates: `robotcode doc keywords <Library> "<text>"`).
|
|
67
|
+
3. Run `robotcode analyze code <changed files>` and fix every error. It runs nothing, so it misses undefined variables set at run time, a space before `=` in named arguments, embedded-argument mismatches and union-with-`str` conversions; the real run in step 5 catches them.
|
|
68
|
+
4. Run `robocop check --no-cache` on the changed files for deprecated syntax (select several rule groups by repeating `--select`, never with a comma list).
|
|
69
|
+
5. Run the affected tests by longname, `robotcode robot -bl "<Suite.Sub.Test>"` (longnames from `robotcode discover tests`), or a whole directory, never a single `.robot` file.
|
|
70
|
+
6. Read failures with `robotcode results show --failed` and `robotcode results log -bl "<longname>"`.
|
|
71
|
+
|
|
72
|
+
## Constraints
|
|
73
|
+
|
|
74
|
+
- Always propose a phased plan; old and new code coexist during the transition.
|
|
75
|
+
- Report per file: findings before, findings after, dry-run result.
|
|
76
|
+
- Never claim a migration is complete without a clean exit check.
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "Designs Robot Framework test projects. Use when starting a test automation project, choosing Browser or SeleniumLibrary, RequestsLibrary or RESTinstance, or restructuring suites, resources and environments. Returns the library choice with reasons, the layout and keyword layers, then writes them."
|
|
3
|
+
mode: subagent
|
|
4
|
+
permission:
|
|
5
|
+
edit: allow
|
|
6
|
+
bash: allow
|
|
7
|
+
---
|
|
8
|
+
<!-- Generated by scripts/build-agent-variants.py from plugins/rf-core/agents/rf-test-architect.md. Do not edit. -->
|
|
9
|
+
|
|
10
|
+
# Robot Framework Test Architect
|
|
11
|
+
|
|
12
|
+
You design Robot Framework test automation projects: which libraries to use, how the
|
|
13
|
+
project is laid out, and how keywords are layered. You decide the architecture yourself
|
|
14
|
+
and hand the writing of suites, keywords and libraries to the skills listed under
|
|
15
|
+
Routing. Load a skill before you write the part it owns; do not write from memory.
|
|
16
|
+
|
|
17
|
+
## What this agent decides (agent-owned)
|
|
18
|
+
|
|
19
|
+
### Web library selection
|
|
20
|
+
|
|
21
|
+
Choose **Browser** (`rf-browser` in plugin `rf-web`, the default for new web tests) when the project needs
|
|
22
|
+
Playwright features: auto-waiting, network interception, shadow DOM or iframes through
|
|
23
|
+
selectors, several browser contexts, or the built-in assertion engine.
|
|
24
|
+
|
|
25
|
+
Choose **SeleniumLibrary** (`rf-selenium` in plugin `rf-web`) when the team already runs Selenium or a
|
|
26
|
+
WebDriver grid / cloud service, depends on Selenium plugins, or must keep existing
|
|
27
|
+
SeleniumLibrary suites.
|
|
28
|
+
|
|
29
|
+
### API library selection
|
|
30
|
+
|
|
31
|
+
Choose **RequestsLibrary** (`rf-requests` in plugin `rf-api`, the default for API tests) for explicit HTTP
|
|
32
|
+
control: sessions, form data, file uploads, XML, and assertions on the response object.
|
|
33
|
+
|
|
34
|
+
Choose **RESTinstance** (`rf-restinstance` in plugin `rf-api`) when JSON Schema or OpenAPI contract checks
|
|
35
|
+
are central and typed field assertions (`Integer`, `String`) fit the responses.
|
|
36
|
+
|
|
37
|
+
### Project layout
|
|
38
|
+
|
|
39
|
+
```
|
|
40
|
+
project/
|
|
41
|
+
tests/ # suites by area: web/, api/, mobile/, e2e/
|
|
42
|
+
resources/ # common.resource (library imports) + one <domain>.resource per domain
|
|
43
|
+
libraries/ # project Python keyword libraries (on the python-path)
|
|
44
|
+
variables/ # per-environment variables: dev.yaml, staging.yaml, common.py
|
|
45
|
+
data/ # test data files (CSV, JSON)
|
|
46
|
+
results/ # output directory
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Reuse an existing resource directory (`resources/`, `keywords/` or `res/`) and never
|
|
50
|
+
overwrite existing files. Installing Robot Framework and libraries, `robot.toml` and the
|
|
51
|
+
python-path belong to `rf-setup`.
|
|
52
|
+
|
|
53
|
+
### Keyword abstraction layers
|
|
54
|
+
|
|
55
|
+
1. Test cases read as business steps ("User Can Complete Purchase").
|
|
56
|
+
2. Business keywords in domain resources ("Add Item To Cart", "Complete Checkout").
|
|
57
|
+
3. Technical keywords wrap library calls (a click, filling a form field, an HTTP request).
|
|
58
|
+
|
|
59
|
+
## Routing
|
|
60
|
+
|
|
61
|
+
| Work | Skill |
|
|
62
|
+
|------|-------|
|
|
63
|
+
| Suites, test cases, `__init__.robot`, tags, templates, user keywords, resource and variable files | `rf-language` |
|
|
64
|
+
| Project keyword libraries and listeners in Python (`libraries/*.py`), checked with its library checker | `rf-python-library` |
|
|
65
|
+
| Installing RF and libraries, project layout mechanics, `robot.toml`, python-path | `rf-setup` |
|
|
66
|
+
| Web tests with Browser / SeleniumLibrary | `rf-browser` / `rf-selenium` (plugin `rf-web`) |
|
|
67
|
+
| API tests with RequestsLibrary / RESTinstance | `rf-requests` / `rf-restinstance` (plugin `rf-api`) |
|
|
68
|
+
| Mobile tests | `rf-appium` (plugin `rf-mobile`) |
|
|
69
|
+
| Desktop tests | `rf-platynui` (plugin `rf-desktop`) |
|
|
70
|
+
| Keyword names and arguments | `robotcode doc keyword <Library> "<Keyword>"` |
|
|
71
|
+
| Running, reading results, stepping through a test | `robotcode robot -bl`, `robotcode results`, `robotcode robot-debug` (robotcode plugin) |
|
|
72
|
+
|
|
73
|
+
A library skill ships in a technology plugin that may not be installed. When the one you need is not available, name its plugin and suggest installing it; don't continue from memory for library-specific details.
|
|
74
|
+
|
|
75
|
+
## Workflow
|
|
76
|
+
|
|
77
|
+
1. Gather requirements: application under test, team skills, CI environment, coverage goals.
|
|
78
|
+
2. Select the libraries with the criteria above and state the reason.
|
|
79
|
+
3. Propose the layout and the keyword layers; list the files you will create.
|
|
80
|
+
4. Write the suites and resources with `rf-language`, the Python libraries with
|
|
81
|
+
`rf-python-library`, and the library calls with the matching library skill.
|
|
82
|
+
5. Verify with the loop below before handing the project over.
|
|
83
|
+
|
|
84
|
+
## Verification loop
|
|
85
|
+
|
|
86
|
+
For every `.robot`, `.resource` or Python library file you write or change:
|
|
87
|
+
|
|
88
|
+
1. Write the change.
|
|
89
|
+
2. Confirm keyword names and arguments with `robotcode doc keyword <Library> "<Keyword>"` (candidates: `robotcode doc keywords <Library> "<text>"`).
|
|
90
|
+
3. Run `robotcode analyze code <changed files>` and fix every error. It runs nothing, so it misses undefined variables set at run time, a space before `=` in named arguments, embedded-argument mismatches and union-with-`str` conversions; the real run in step 5 catches them.
|
|
91
|
+
4. Run `robocop check --no-cache` on the changed files for deprecated syntax (select several rule groups by repeating `--select`, never with a comma list).
|
|
92
|
+
5. Run the affected tests by longname, `robotcode robot -bl "<Suite.Sub.Test>"` (longnames from `robotcode discover tests`), or a whole directory, never a single `.robot` file.
|
|
93
|
+
6. Read failures with `robotcode results show --failed` and `robotcode results log -bl "<longname>"`.
|
|
94
|
+
|
|
95
|
+
## Constraints
|
|
96
|
+
|
|
97
|
+
- Write Robot Framework 7 syntax; the skills show the modern forms.
|
|
98
|
+
- Keep control structures out of test bodies; put logic into keywords.
|
|
99
|
+
- No `Sleep` for synchronization; use the library's waiting mechanism.
|
|
100
|
+
- Never overwrite existing project files; extend them.
|
|
101
|
+
- Name the library and the reason for every library choice in your plan.
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
// Robot Framework plugin hooks for OpenCode.
|
|
2
|
+
// Generated by scripts/build-agent-variants.py from plugins/rf-core/hooks/hooks.json. Do not edit.
|
|
3
|
+
//
|
|
4
|
+
// OpenCode has no Claude-style hooks.json; plugins are JS modules. This one runs
|
|
5
|
+
// the same hook scripts as the other agents, from ../rf-core-files/scripts/
|
|
6
|
+
// next to this file (the installer puts both there, project or user scope):
|
|
7
|
+
//
|
|
8
|
+
// tool.execute.after edits of .robot/.resource files -> validate_robot.mjs;
|
|
9
|
+
// bash output -> rf_error_hints.mjs; findings and hints
|
|
10
|
+
// are appended to the tool output.
|
|
11
|
+
// session.created -> check_rf_environment.mjs; its report is appended to the
|
|
12
|
+
// session's first tool output (OpenCode cannot inject
|
|
13
|
+
// text at session start).
|
|
14
|
+
//
|
|
15
|
+
// Not ported (no OpenCode event can inject text at that point):
|
|
16
|
+
// Stop * -> maybe_remind_robot_tests.mjs
|
|
17
|
+
// Stop * -> report_pending_errors.mjs
|
|
18
|
+
// Stop * -> validate_robot_project.mjs
|
|
19
|
+
// UserPromptSubmit * -> maybe_inject_rf_context.mjs
|
|
20
|
+
import { spawnSync } from "node:child_process";
|
|
21
|
+
import { existsSync } from "node:fs";
|
|
22
|
+
import { fileURLToPath } from "node:url";
|
|
23
|
+
|
|
24
|
+
const SCRIPTS = fileURLToPath(new URL("../rf-core-files/scripts/", import.meta.url));
|
|
25
|
+
const EDIT_SCRIPT = "validate_robot.mjs";
|
|
26
|
+
const SHELL_SCRIPT = "rf_error_hints.mjs";
|
|
27
|
+
const SESSION_SCRIPT = "check_rf_environment.mjs";
|
|
28
|
+
const TIMEOUT_MS = 60000;
|
|
29
|
+
const EDIT_TOOLS = { edit: "Edit", write: "Write", multiedit: "MultiEdit", patch: "apply_patch", apply_patch: "apply_patch" };
|
|
30
|
+
|
|
31
|
+
/** Run a hook script with Claude-shaped stdin; return the text it reports, or "". */
|
|
32
|
+
export function runHook(script, payload) {
|
|
33
|
+
const path = SCRIPTS + script;
|
|
34
|
+
if (!script || !existsSync(path)) return "";
|
|
35
|
+
const r = spawnSync("node", [path], {
|
|
36
|
+
input: JSON.stringify(payload), encoding: "utf-8", timeout: TIMEOUT_MS, windowsHide: true,
|
|
37
|
+
env: { ...process.env, TOOL_INPUT: "" },
|
|
38
|
+
});
|
|
39
|
+
if (r.error || r.status === null) return "";
|
|
40
|
+
if (r.status === 2) return (r.stderr ?? "").trim();
|
|
41
|
+
try {
|
|
42
|
+
return JSON.parse(r.stdout || "null")?.hookSpecificOutput?.additionalContext ?? "";
|
|
43
|
+
} catch {
|
|
44
|
+
return "";
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
export const RfAgentSkills = async ({ directory }) => {
|
|
49
|
+
const pendingArgs = new Map(); // callID -> tool args (tool.execute.after has none)
|
|
50
|
+
const sessionReports = new Map(); // sessionID -> environment report not yet shown
|
|
51
|
+
|
|
52
|
+
const append = (output, text) => {
|
|
53
|
+
if (text) output.output = `${output.output ?? ""}\n\n${text}`;
|
|
54
|
+
};
|
|
55
|
+
|
|
56
|
+
return {
|
|
57
|
+
"tool.execute.before": async (input, output) => {
|
|
58
|
+
if (EDIT_TOOLS[input.tool] || input.tool === "bash") pendingArgs.set(input.callID, output.args ?? {});
|
|
59
|
+
},
|
|
60
|
+
"tool.execute.after": async (input, output) => {
|
|
61
|
+
const report = sessionReports.get(input.sessionID);
|
|
62
|
+
if (report) {
|
|
63
|
+
sessionReports.delete(input.sessionID);
|
|
64
|
+
append(output, report);
|
|
65
|
+
}
|
|
66
|
+
if (input.tool === "bash") {
|
|
67
|
+
append(output, runHook(SHELL_SCRIPT, {
|
|
68
|
+
hook_event_name: "PostToolUse", session_id: input.sessionID, cwd: directory,
|
|
69
|
+
tool_name: "Bash", tool_input: pendingArgs.get(input.callID) ?? {},
|
|
70
|
+
tool_response: String(output.output ?? ""),
|
|
71
|
+
}));
|
|
72
|
+
pendingArgs.delete(input.callID);
|
|
73
|
+
return;
|
|
74
|
+
}
|
|
75
|
+
const toolName = EDIT_TOOLS[input.tool];
|
|
76
|
+
if (!toolName) return;
|
|
77
|
+
const args = pendingArgs.get(input.callID) ?? {};
|
|
78
|
+
pendingArgs.delete(input.callID);
|
|
79
|
+
const toolInput = { ...args };
|
|
80
|
+
if (typeof args.patchText === "string") toolInput.input = args.patchText;
|
|
81
|
+
append(output, runHook(EDIT_SCRIPT, {
|
|
82
|
+
hook_event_name: "PostToolUse", session_id: input.sessionID, cwd: directory,
|
|
83
|
+
tool_name: toolName, tool_input: toolInput,
|
|
84
|
+
}));
|
|
85
|
+
},
|
|
86
|
+
event: async ({ event }) => {
|
|
87
|
+
if (event?.type !== "session.created") return;
|
|
88
|
+
const id = event.properties?.info?.id ?? event.properties?.sessionID;
|
|
89
|
+
const text = runHook(SESSION_SCRIPT, { hook_event_name: "SessionStart", session_id: id, cwd: directory });
|
|
90
|
+
if (id && text) sessionReports.set(id, text);
|
|
91
|
+
},
|
|
92
|
+
};
|
|
93
|
+
};
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "rf-desktop",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "PlatynUI skill for Robot Framework desktop UI tests.",
|
|
5
|
+
"author": {
|
|
6
|
+
"name": "manykarim",
|
|
7
|
+
"email": "manykarim@users.noreply.github.com"
|
|
8
|
+
},
|
|
9
|
+
"homepage": "https://github.com/MarketSquare/robotframework-plugins",
|
|
10
|
+
"repository": "https://github.com/MarketSquare/robotframework-plugins",
|
|
11
|
+
"license": "Apache-2.0",
|
|
12
|
+
"keywords": [
|
|
13
|
+
"robotframework",
|
|
14
|
+
"testing",
|
|
15
|
+
"desktop-testing",
|
|
16
|
+
"platynui"
|
|
17
|
+
],
|
|
18
|
+
"dependencies": [
|
|
19
|
+
{
|
|
20
|
+
"name": "rf-core",
|
|
21
|
+
"version": "^1.0"
|
|
22
|
+
}
|
|
23
|
+
]
|
|
24
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
The `rf-desktop` plugin, versioned on its own (`rf-desktop--v<version>` tags); see `RELEASING.md` at the repository root.
|
|
4
|
+
|
|
5
|
+
## 1.0.0 (2026-11-18)
|
|
6
|
+
|
|
7
|
+
First release, split out of `rf-agentskills` 3.0.0: `rf-platynui`. It depends on `rf-core` `^1.0`. Skill names are unchanged; their plugin prefix is now `rf-desktop:` instead of `rf-agentskills:`, for example `/rf-desktop:rf-platynui`.
|
|
8
|
+
|
|
9
|
+
- **Install steps moved here** from `rf-setup`: `rf-platynui` has `references/install.md`, with the pre-release pin.
|
|
10
|
+
- **`rf-platynui` names `robotcode doc keyword PlatynUI.BareMetal "<Keyword>"`** in its Library Import section, as the way to check a keyword and its arguments.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# rf-desktop plugin
|
|
2
|
+
|
|
3
|
+
Robot Framework skills for desktop tests. Install instructions for every agent are in the [repository README](https://github.com/MarketSquare/robotframework-plugins#install).
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
/plugin install rf-desktop --marketplace MarketSquare/robotframework-plugins
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
That one step works on Claude Code 2.1.275 or later. The commands for other agents and older versions are in the repository README.
|
|
12
|
+
|
|
13
|
+
| Skill | Library and package |
|
|
14
|
+
|---|---|
|
|
15
|
+
| `rf-platynui` | PlatynUI: `robotframework-PlatynUI` |
|
|
16
|
+
|
|
17
|
+
## Needs rf-core
|
|
18
|
+
|
|
19
|
+
This plugin depends on `rf-core`, which holds Robot Framework syntax, environment setup, the subagents and the validation hooks. Claude Code installs `rf-core` with it. Copilot CLI and Codex don't install plugin dependencies, so install `rf-core` there too:
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
copilot plugin install rf-core@robotframework-plugins
|
|
23
|
+
codex plugin add rf-core@robotframework-plugins
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
The `robotframework-plugins` installer adds `rf-core` for you. Don't install this plugin next to the `rf-agentskills` bundle: the bundle carries its own copy of every skill, and you would see each skill twice.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Programme manifest: see schemas/catalog.schema.json and CONTRIBUTING.md.
|
|
2
|
+
name: rf-desktop
|
|
3
|
+
summary: PlatynUI skill for desktop UI tests.
|
|
4
|
+
tier: verified
|
|
5
|
+
status: active
|
|
6
|
+
maintainers:
|
|
7
|
+
- github: manykarim
|
|
8
|
+
name: Many Kasiriha
|
|
9
|
+
libraries:
|
|
10
|
+
- name: PlatynUI
|
|
11
|
+
package: robotframework-PlatynUI
|
|
12
|
+
versions: ">=0.12.0.dev0"
|
|
13
|
+
skills: [rf-platynui]
|
|
14
|
+
robotframework: ">=7.0"
|
|
15
|
+
agents:
|
|
16
|
+
- claude-code
|
|
17
|
+
- copilot-cli
|
|
18
|
+
- vscode-copilot
|
|
19
|
+
- codex
|
|
20
|
+
- cursor
|
|
21
|
+
- opencode
|
|
22
|
+
- goose
|
|
23
|
+
- claude-desktop
|