Skip to content

feat(jira): add risk type to /jira:create skill - #687

Merged
openshift-merge-bot[bot] merged 4 commits into
openshift-eng:mainfrom
katherinekeane:feat/jira-risk-type
Aug 14, 2026
Merged

openshift-merge-bot[bot] merged 4 commits into
openshift-eng:mainfrom
katherinekeane:feat/jira-risk-type

Conversation

@katherinekeane

@katherinekeane katherinekeane commented Aug 10, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Adds risk as a supported issue type in the /jira:create skill
  • New reference/create-risk.md with 9-step interactive workflow: qualifying criteria, summary pattern, probability/impact assessment (option IDs fetched at runtime), component, assignee, optional mitigation plan, and optional fields
  • Description template matches the GCP team's existing italic-label format (_What could go wrong:_ etc.) with an _Originally raised:_ footer — validated against existing GCP Risk issues
  • SKILL.md updated: type routing table, arguments list, error messages, usage example
  • Risk Score (customfield_10976) and Risk Score Assessment (customfield_10974) explicitly excluded — ScriptRunner auto-calculates both from Probability × Impact
  • Plugin version bumped 0.9.0 → 0.9.2; marketplace.json synced

Test plan

  • Run /jira:create risk GCP and verify qualifying check redirects non-risks to appropriate type
  • Confirm Probability and Impact prompts show level tables and fetch option IDs via getJiraIssueTypeMetaWithFields
  • Confirm Risk Score and Risk Score Assessment are absent from the MCP create call
  • Verify created ticket has ai-generated-jira label and description in italic-label format
  • Confirm Risk Score auto-populates in Jira after Probability + Impact are saved

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Added support for creating Jira Risk issues.
    • Added guidance for required fields, optional fields, validation, and interactive Risk issue creation.
    • Added a Risk issue creation example and clearer handling for unsupported issue types.
  • Documentation

    • Added Risk templates covering qualification, field requirements, formatting, and risk-tracking references.
  • Chores

    • Updated the Jira plugin version to 0.9.2.

@openshift-ci openshift-ci Bot added the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Aug 10, 2026
@openshift-ci openshift-ci Bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Aug 10, 2026
@coderabbitai

coderabbitai Bot commented Aug 10, 2026 •

Copy link
Copy Markdown
Contributor

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: f7b1eec9-0399-49da-833f-b3b1969fd914

📥 Commits

Reviewing files that changed from the base of the PR and between 3058ee1 and e914891.

📒 Files selected for processing (2)
  • plugins/jira/reference/create-risk.md
  • plugins/jira/skills/create/SKILL.md
🚧 Files skipped from review as they are similar to previous changes (2)
  • plugins/jira/skills/create/SKILL.md
  • plugins/jira/reference/create-risk.md

Walkthrough

The Jira plugin now supports Risk issue creation. It adds Risk guidance and templates, accepts risk as an issue type, adds a usage example, and updates both plugin manifests to version 0.9.2.

Changes

Jira Risk Creation

Layer / File(s) Summary
Risk guidance and templates
plugins/jira/reference/create-risk.md, plugins/jira/reference/gcp-hcp.md
Adds Risk qualification rules, field requirements, metadata lookup steps, prompts, description templates, mitigation handling, upstream source mapping, and prohibited manual updates.
Risk type skill integration
plugins/jira/skills/create/SKILL.md
Adds risk to supported and validated issue types, links the Risk reference guide, and adds a GCP Risk example.
Plugin version updates
.claude-plugin/marketplace.json, plugins/jira/.claude-plugin/plugin.json
Updates the Jira plugin version to 0.9.2 in both manifests.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

Suggested reviewers: prashanth684, theobarberbany, bryan-cox

🚥 Pre-merge checks | ✅ 5 | ❌ 5

❌ Failed checks (5 inconclusive)

Check name Status Explanation Resolution
No Real People Names In Style References ❓ Inconclusive Repository clone failed, so this custom check could not run with code access. Retry the review run. If this persists, inspect pre-merge custom-check logs for infrastructure or agent runtime failures.
No Assumed Git Remote Names ❓ Inconclusive Repository clone failed, so this custom check could not run with code access. Retry the review run. If this persists, inspect pre-merge custom-check logs for infrastructure or agent runtime failures.
Git Push Safety Rules ❓ Inconclusive Repository clone failed, so this custom check could not run with code access. Retry the review run. If this persists, inspect pre-merge custom-check logs for infrastructure or agent runtime failures.
No Untrusted Mcp Servers ❓ Inconclusive Repository clone failed, so this custom check could not run with code access. Retry the review run. If this persists, inspect pre-merge custom-check logs for infrastructure or agent runtime failures.
Ai-Helpers Overlap Detection ❓ Inconclusive Repository clone failed, so this custom check could not run with code access. Retry the review run. If this persists, inspect pre-merge custom-check logs for infrastructure or agent runtime failures.
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly identifies the main change: adding the risk issue type to the Jira create skill.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Warning

Tools execution failed with the following error:

Failed to run tools: 14 UNAVAILABLE: read ECONNRESET


Comment @coderabbitai help to get the list of available commands.

@katherinekeane
katherinekeane marked this pull request as draft August 10, 2026 11:46
@openshift-ci openshift-ci Bot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Aug 10, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@plugins/jira/reference/create-risk.md`:
- Around line 84-88: Update the fallback issue-type list in the qualifying check
to remove Spike, since the create workflow does not support it; retain only
supported types such as Story, Task, or Epic.
- Around line 28-30: Update the fenced code block containing the risk summary
pattern to specify the text language tag, preserving its existing content and
closing fence.
- Around line 148-156: Update the footer in the risk template to italicize only
the “Originally raised” and “Raised by” labels, matching the other labeled
fields. Replace the date and reporter placeholders with explicit instructions
requiring the actual creation date and reporter display name before creating the
issue.

In `@plugins/jira/skills/create/SKILL.md`:
- Around line 31-34: Update the missing-project validation error in the
jira:create skill to include risk alongside the existing bug and feature-request
exceptions, while preserving the current project-key requirement behavior for
all other types.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: c89180e6-01ab-43a8-8b64-d562887f67cf

📥 Commits

Reviewing files that changed from the base of the PR and between 0b9c562 and b980ef2.

📒 Files selected for processing (4)
  • .claude-plugin/marketplace.json
  • plugins/jira/.claude-plugin/plugin.json
  • plugins/jira/reference/create-risk.md
  • plugins/jira/skills/create/SKILL.md

Comment thread plugins/jira/reference/create-risk.md Outdated
Comment thread plugins/jira/reference/create-risk.md
Comment on lines +148 to +156
_What could go wrong:_ <Describe the risk event in detail>

_What triggers it:_ <Conditions or events that would cause the risk to materialize>

_What would be affected:_ <Teams, services, milestones, or customers impacted>

_Mitigation/contingency plan:_ <Actions to reduce probability or impact; how to respond if it materializes. Omit this line if not yet assessed.>

_Originally raised: YYYY-MM-DD. Raised by: <reporter display name>._

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🗄️ Data Integrity & Integration | 🟡 Minor | ⚡ Quick win

Match the footer to the italic-label format.

Lines 148-154 italicize only each label. Line 156 italicizes the entire footer and leaves two placeholders without an explicit substitution rule. Use separate label spans and require the actual creation date and reporter display name before issue creation.

Proposed fix
-_Originally raised: YYYY-MM-DD. Raised by: <reporter display name>._
+_Originally raised:_ YYYY-MM-DD. _Raised by:_ <reporter display name>.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugins/jira/reference/create-risk.md` around lines 148 - 156, Update the
footer in the risk template to italicize only the “Originally raised” and
“Raised by” labels, matching the other labeled fields. Replace the date and
reporter placeholders with explicit instructions requiring the actual creation
date and reporter display name before creating the issue.

Comment thread plugins/jira/skills/create/SKILL.md

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@plugins/jira/reference/gcp-hcp.md`:
- Line 165: Update the Jira risk template reference in gcp-hcp.md to point to an
existing canonical upstream source, or add the missing
docs/jira-risk-template.md file in the upstream repository and keep the
reference valid; ensure both references are consistent and resolve successfully.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 456e7813-a9db-498e-b36c-a535a17bf2cb

📥 Commits

Reviewing files that changed from the base of the PR and between b980ef2 and d2b74e5.

📒 Files selected for processing (1)
  • plugins/jira/reference/gcp-hcp.md


### Risk Template

Source: [jira-risk-template.md](https://github.com/openshift-online/gcp-hcp/blob/main/docs/jira-risk-template.md)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -u

printf '%s\n' '--- local references ---'
cat -n plugins/jira/reference/gcp-hcp.md | sed -n '158,238p'

printf '%s\n' '--- direct upstream URL ---'
curl -L -sS -o /tmp/jira-risk-template.body -D /tmp/jira-risk-template.headers \
  -w 'http_status=%{http_code}\nfinal_url=%{url_effective}\n' \
  'https://github.com/openshift-online/gcp-hcp/blob/main/docs/jira-risk-template.md'
sed -n '1,20p' /tmp/jira-risk-template.headers
printf 'body_bytes='
wc -c < /tmp/jira-risk-template.body

printf '%s\n' '--- repository tree candidates ---'
curl -L -sS 'https://api.github.com/repos/openshift-online/gcp-hcp/git/trees/main?recursive=1' |
  jq -r '.tree[]?.path' |
  rg -i 'jira|risk|template' || true

Repository: openshift-eng/ai-helpers

Length of output: 10957


Fix the upstream Risk template references.

The upstream repository has no docs/jira-risk-template.md. Add the file, or update both references to an existing canonical source.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugins/jira/reference/gcp-hcp.md` at line 165, Update the Jira risk template
reference in gcp-hcp.md to point to an existing canonical upstream source, or
add the missing docs/jira-risk-template.md file in the upstream repository and
keep the reference valid; ensure both references are consistent and resolve
successfully.

Source: MCP tools

@katherinekeane
katherinekeane marked this pull request as ready for review August 10, 2026 15:25
@openshift-ci openshift-ci Bot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Aug 10, 2026
@openshift-ci
openshift-ci Bot requested review from bryan-cox and celebdor August 10, 2026 15:25
Adds `risk` as a supported issue type in the /jira:create skill:

- `plugins/jira/reference/create-risk.md`: new type-specific guidance
  with qualifying criteria, summary pattern, probability/impact tables,
  auto-calculated field warnings, 9-step interactive workflow (including
  component and assignee prompts), and description template matching
  the team's italic-label format.
- `plugins/jira/skills/create/SKILL.md`: adds `risk` to the type
  routing table, arguments list, error messages, and usage examples.
- Bumps plugin version 0.9.0 → 0.9.2.

Assisted-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Adds Risk Template section to gcp-hcp.md with summary format, description
format (italic inline labels), required field IDs, and link to
risk-tracking-process.md. Also adds jira-risk-template.md to the upstream
sources table.

Assisted-by: Claude Sonnet 4.6 <noreply@anthropic.com>
@openshift-ci openshift-ci Bot removed the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Aug 11, 2026
Score is calculated by ScriptRunner with non-linear impact weights
(range 1-250), not a simple Probability × Impact multiplication.
Aligns with updated risk-tracking-process.md.

Assisted-by: Claude Sonnet 4.6 <noreply@anthropic.com>
- Add language tag to summary pattern code block
- Add risks to missing-project-key error message

Assisted-by: Claude Sonnet 4.6 <noreply@anthropic.com>
adamminter added a commit to adamminter/ai-helpers that referenced this pull request Aug 14, 2026
- Add /jira:create to When to Use section
- Fix Activity Type format to {"value": "..."} in ROSAENG custom fields table
- Add Risk pointer to openshift-eng#687 since risk conventions are deferred
- Add Maintenance section with upstream source links for team directory updates

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

@apahim apahim left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/lgtm

@openshift-ci

openshift-ci Bot commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

@apahim: changing LGTM is restricted to collaborators

Details

In response to this:

/lgtm

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@adamminter

Copy link
Copy Markdown

/lgtm

@openshift-ci openshift-ci Bot added the lgtm Indicates that a PR is ready to be merged. label Aug 14, 2026
@openshift-ci

openshift-ci Bot commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: adamminter, apahim, katherinekeane

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@openshift-merge-bot
openshift-merge-bot Bot merged commit d390c5a into openshift-eng:main Aug 14, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. lgtm Indicates that a PR is ready to be merged.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants