release-analyze ยท diff
git:20260725.11dd3e7 to git:20260807.4fb0cdd
1 added, 1 removed. Audit A to A.
---
- description: Analyze Katalon True Platform/TestOps release readiness from testing quality data. Use when you need to use Katalon MCP metrics and results to assess whether a release, sprint, iteration, version, test plan, suite, or repository is ready to ship; summarize requirement coverage, execution health, defect risk, test stability, configuration coverage, release blockers, quality gaps, and produce a Ready / Ready with risk / Not ready recommendation.
+ description: Analyze Katalon True Platform/TestOps release readiness from testing quality data. Use when you need to use Katalon MCP metrics and results to assess whether a release, sprint, iteration, version, test plan, suite, or repository is ready to ship; summarize requirement coverage, execution health, defect risk, test stability, configuration coverage, release blockers, quality gaps, and produce a Ready / Ready with risk / Not ready recommendation. Written for the test manager who owns the ship call and the test lead who has to defend it.
alwaysApply: false
---
<!-- GENERATED by scripts/build-adapters.mjs from skills/. Do not edit by hand. -->
# Katalon Release Analyze
Use this skill to assess release readiness from Katalon MCP data. The output must be a testing-quality decision, not just a metric dump.
## Availability Boundary
State the MCP boundary before promising an assessment:
- Available through Katalon MCP: project/repository discovery, requirements, test cases, test suites, executions/results, quality summaries, defect data, stability data, and configuration coverage when tools are exposed.
- Not directly available: create formal Test Plan entities, inspect live AUT UI, guarantee AI execution completion, or decide product/business readiness beyond test evidence.
- If MCP tools are unavailable, provide only a framework/template and mark release confidence as Low until data is verified.
Read `references/capability-boundaries.md` when capability scope is unclear.
## Required Scope
Resolve or ask for the minimum missing scope:
- Katalon project and repository/Test Project.
- Release identifier, sprint, iteration, version, test suite, suite collection, execution ID, or date range.
- Target environment/configuration matrix when readiness depends on browsers, devices, OS, or deployment environments.
- Quality gate thresholds when the team has defined them.
If the user gives only a release name or issue key, use MCP discovery first. Ask only when multiple equally plausible scopes remain.
## MCP Data Collection
Always resolve context before analysis:
1. Call `list_projects`.
2. Call `list_repositories`.
3. Resolve the repository/Test Project.
4. Find the release scope using available requirement, suite, execution, iteration, or result tools.
Collect evidence with the available Katalon MCP tools:
- Requirement and traceability: `find_requirements`, `read_requirement`, `fetch_requirement_data`.
- Test case quality: `find_test_cases`, `find_test_cases_by_requirement`, `fetch_test_case_data`.
- Suites and executable scope: `find_test_suites`, `read_test_suite`.
- Executions and results: `read_execution`, `read_execution_test_results`, `read_test_result`, `find_test_results`.
- Defect risk: `fetch_defect_data`.
- Stability: `fetch_test_stability_data`.
- Configuration coverage: `fetch_test_configuration_data`.
Use the freshest data available for the requested release. If comparing trend or stability, include the date range used.
## Key Metrics
Report the metrics that are available and relevant:
- Requirement coverage: total, covered, uncovered, linked test cases, requirements without passing evidence.
- Test coverage: total tests, automated/manual split, unexecuted, blocked, stale, missing ownership or incomplete cases.
- Execution health: latest executions, pass/fail/blocked/skipped/not-run counts, pass rate, failed P0/P1 tests.
- Defect risk: open critical/high defects, release blockers, reopened defects, failed tests with linked defects, untriaged failures.
- Stability: flaky tests, repeated failures, unstable suites/configurations, recent trend.
- Configuration coverage: environments, browsers, devices, OS, execution profiles, and missing target combinations.
- Data confidence: missing MCP data, stale executions, ambiguous release scope, or incomplete links.
Read `references/release-quality-gates.md` before making the final readiness decision.
## Readiness Decision
Return one of:
- `Ready`: no testing blocker remains; critical requirements have coverage and recent passing evidence; target configurations are sufficiently tested.
- `Ready with risk`: no hard blocker remains, but moderate gaps or accepted risks exist.
- `Not ready`: release-blocking defects, failed/blocked/unrun critical tests, missing critical coverage, stale evidence, or untested required configurations remain.
If thresholds are provided, apply them. If not, use risk-based judgment and state assumptions.
Never mark `Ready` when:
- Critical/high release-blocking defects remain open.
- P0/P1 tests are failed, blocked, or not run without accepted risk.
- Critical requirements have no tests or no passing evidence.
- Required target configurations are untested.
- MCP data is unavailable or too incomplete to support confidence.
## Response Format
Respond with:
```text
Release Readiness: Ready | Ready with risk | Not ready
Confidence: High | Medium | Low
Key Metrics:
- Requirement coverage:
- Test execution:
- Defect risk:
- Stability:
- Configuration coverage:
Blocking Issues:
- ...
Risks / Gaps:
- ...
Recommendation:
- ...
Evidence:
- ...
```
Evidence should include execution IDs, suite names, requirement keys, defect IDs, or links when returned by the platform.
## Follow-Up Actions
Recommend concrete next steps:
- Create or link missing tests for uncovered critical requirements.
- Re-run failed, flaky, or stale suites.
- Resolve or accept specific defects.
- Expand configuration coverage for missing release targets.
- Use `execute-test` when execution is needed.
- Use `create-test-cases` when coverage gaps require new manual cases.
- Use `upload-report` when external automation results must be uploaded before assessment.
---
## Bundled references
_The reference material the skill points to is inlined below so this file is self-contained._
### references/capability-boundaries.md
# Katalon MCP Capability Boundaries
## Available
- Project discovery: `list_projects`.
- Repository/Test Project discovery: `list_repositories`.
- Requirement discovery: `find_requirements`, `read_requirement`.
- Requirement coverage: `fetch_requirement_data`.
- Test case operations: `create_test_case`, `read_test_case`, `update_test_case`, `duplicate_test_case`, `delete_test_case`, `move_test_case`, `find_test_cases`.
- Test folder operations: `find_test_folders`, `manage_test_folder`.
- Test suite operations: `find_test_suites`, `read_test_suite`, `manage_test_suite`.
- Requirement links: `link_requirements_to_test_case`, `unlink_requirements_from_test_case`, `find_test_cases_by_requirement`.
- Manual execution: `read_auts`, `create_manual_test_run`, `create_manual_ai_session`, `read_manual_ai_session`.
- Automated execution: `find_execution_profiles`, `list_test_cloud_environments`, `build_run_configuration`, `build_schedule`, `schedule_test_run`.
- Execution results: `read_execution`, `read_execution_test_results`, `read_test_result`, `find_test_results`.
- Quality data: requirement, defect, test case, test stability, and configuration coverage fetch tools.
- ALM defects: `find_alm_integration_projects`, `create_defect`.
## Not Directly Available
- Create requirements in Katalon True Platform. Requirements are synced from Jira/Azure and can be found/read/linked.
- Create a formal Test Plan entity. Use test suites/folders/executions as the executable planning structure.
- Guarantee Run with AI completion. The platform may block, fail, or require AUT/account state.
- Inspect AUT pages through Katalon MCP. Use Browser/Playwright for website exploration.
- Create defects without a failed test result ID and ALM integration details.
## Recommended Workarounds
- Requirement creation: create in Jira/Azure first, then sync/find/link in Katalon.
- Test plan: create a named folder and/or test suite, link to sprint/release, and create execution from that suite.
- AUT exploration: use Browser/Playwright to understand the product, then import manual cases into Katalon.
- AI execution blocked: report blocked state with required fixture, AUT, account, or environment action.
### references/release-quality-gates.md
# Release Quality Gates
Use this reference to turn Katalon MCP quality data into a release readiness assessment.
## Core Metrics
- Requirement coverage: total in-scope requirements, linked requirements, unlinked requirements, requirements with no tests, and requirements with no recent passing result.
- Test coverage: total test cases, automated/manual split when available, unexecuted tests, stale tests, and blocked tests.
- Execution health: latest execution status, pass/fail/blocked/skipped/not-run counts, pass rate, failed critical tests, and rerun status.
- Defect risk: open defects, critical/high defects, defects linked to failed tests, reopened defects, and unresolved release-blocking bugs.
- Stability: flaky tests, repeated failures, recent pass/fail trend, and unstable configurations.
- Configuration coverage: tested browsers/devices/environments/OS combinations versus the release target matrix.
- Data quality: missing execution data, missing requirement links, missing test ownership, incomplete test steps, and ambiguous release scope.
## Suggested Readiness Decision
Use `Ready` only when:
- No open critical/high release-blocking defects remain.
- Critical requirements have test coverage and recent passing execution evidence.
- Latest execution pass rate is acceptable for the release context.
- No P0/P1 tests are failed, blocked, or not run without accepted risk.
- Target configurations have enough coverage for the supported release matrix.
Use `Ready with risk` when:
- No known hard blocker remains, but moderate risks exist.
- Some lower-priority requirements, configurations, or tests are unexecuted.
- Flaky tests exist but are understood and not tied to critical paths.
- Risk owners or mitigations are clear.
Use `Not ready` when:
- Critical/high release-blocking defects are open.
- Critical requirements lack tests or passing execution evidence.
- P0/P1 tests are failed, blocked, or not run.
- Execution results are too stale or incomplete to support a release decision.
- Required environments/configurations are untested.
## Output Template
```text
Release Readiness: Ready | Ready with risk | Not ready
Confidence: High | Medium | Low
Key Metrics:
- Requirement coverage:
- Test execution:
- Defect risk:
- Stability:
- Configuration coverage:
Blocking Issues:
- ...
Risks / Gaps:
- ...
Recommendation:
- ...
Evidence:
- ...
```
## Practical Rules
- Prefer specific counts and links over generic statements.
- Distinguish actual risk from missing data.
- Do not mark a release Ready when MCP data is unavailable; mark confidence Low and say what must be verified.
- If thresholds are not provided, use risk-based judgment and state assumptions.
- If a release/sprint/version scope is unclear, ask for it before making a final readiness call.