feat(jira): add create-initiative skill#434
Conversation
Add AI helper skill for creating Jira initiatives following Platform Engineering initiative template pattern. Supports strategic architectural and improvement-focused work spanning ~6 months. Related to: - openshift-online/platform-engineering-enhancements#29 Skill provides: - Interactive workflow for initiative creation - SMART success criteria guidance - Scope definition (included/NOT included) - Validation and error handling - Complete working example Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
|
[APPROVALNOTIFIER] This PR is NOT APPROVED This pull-request has been approved by: katherinekeane The full list of commands accepted by this bot can be found here. DetailsNeeds approval from an approver in each of these files:Approvers can indicate their approval by writing |
WalkthroughAdds a new comprehensive skill guide describing how to create Jira "initiatives": definitions, distinctions from features/epics, a Markdown issue-template, an interactive data-collection workflow, validation and security rules, MCP Jira payload/template, examples, error-handling, best practices, anti-patterns, and cross-references. Changes
Estimated code review effort🎯 2 (Simple) | ⏱️ ~10 minutes Important Pre-merge checks failedPlease resolve all errors before merging. Addressing warnings is optional. ❌ Failed checks (1 inconclusive)
✅ Passed checks (9 passed)
✨ Finishing Touches🧪 Generate unit tests (beta)
Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 2
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@plugins/jira/skills/create-initiative/SKILL.md`:
- Line 63: Several fenced code blocks in SKILL.md are unlabeled and trigger
markdownlint MD040; update each unlabeled opening fence (the triple-backtick
blocks used around examples like the Goal/Problem/Acceptance sections) to
include a language identifier such as text (i.e., change ``` to ```text). Locate
the unlabeled fences referenced in the review (examples at the blocks that
currently open with ``` near the Goal, Fix CI/CD, and the other flagged ranges)
and replace their opening fences with ```text consistently across the file so
all MD040 warnings are resolved.
- Line 12: The SKILL.md line claiming auto-invocation by `/jira:create
initiative` is inaccurate; either remove or rewrite that line and then choose
one of two fixes: (A) Add "initiative" as a supported type to the `/jira:create`
command dispatcher and its documentation (update the create command’s supported
types list and plugin registration so `/jira:create initiative` is valid), or
(B) reframe this SKILL.md entry as a standalone guide (remove the
auto-invocation wording and state it is a manual/standalone initiative creation
reference). Update the SKILL.md text accordingly and ensure the `/jira:create`
command dispatcher and docs (if choosing A) include "initiative" so references
stay consistent.
🪄 Autofix (Beta)
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: 539f29c1-5a17-411e-bbce-0f844476c81a
📒 Files selected for processing (1)
plugins/jira/skills/create-initiative/SKILL.md
- Remove auto-invocation claim (command doesn't exist yet) - Add markdown language identifiers to code blocks (fixes MD040) Addresses review feedback from openshift-eng#434
|
Thanks @coderabbitai for the review! I've addressed both issues in commit 77d270d: ✅ Fixed auto-invocation claim - Removed the inaccurate statement about ✅ Fixed unlabeled code blocks - Added The skill is now ready for human review. |
|
Tip For best results, initiate chat on the files or code changes.
The skill is well-structured and ready for human review. 🚀 |
There was a problem hiding this comment.
♻️ Duplicate comments (1)
plugins/jira/skills/create-initiative/SKILL.md (1)
733-753:⚠️ Potential issue | 🟡 MinorFix remaining unlabeled fenced code blocks (MD040).
Lines 733, 739, 745, and 751 still open fenced blocks without a language identifier, which keeps markdownlint warnings active.
Suggested patch
-``` +```text "Add security scanning to pipeline" (single capability, 1-2 months)@@
-+text
"Fix CI/CD problems"@@ -``` +```text "Pipeline works better"@@
-+text
"Modernize everything"🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@plugins/jira/skills/create-initiative/SKILL.md` around lines 733 - 753, The markdown has unlabeled fenced code blocks causing MD040 warnings at the example lines containing the phrases "Add security scanning to pipeline", "Fix CI/CD problems", "Pipeline works better", and "Modernize everything"; update each triple-backtick fence to specify a language (e.g., use ```text) so the blocks are properly labeled, ensuring the opening and closing fences match for the blocks that include those exact strings in SKILL.md (lines showing those quoted phrases).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Duplicate comments:
In `@plugins/jira/skills/create-initiative/SKILL.md`:
- Around line 733-753: The markdown has unlabeled fenced code blocks causing
MD040 warnings at the example lines containing the phrases "Add security
scanning to pipeline", "Fix CI/CD problems", "Pipeline works better", and
"Modernize everything"; update each triple-backtick fence to specify a language
(e.g., use ```text) so the blocks are properly labeled, ensuring the opening and
closing fences match for the blocks that include those exact strings in SKILL.md
(lines showing those quoted phrases).
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Enterprise
Run ID: e2c4eeba-6387-4367-800d-ce20e2d1f8f1
📒 Files selected for processing (1)
plugins/jira/skills/create-initiative/SKILL.md
1 participant
Summary
Add AI helper skill for creating Jira initiatives, following Platform Engineering initiative template from platform-engineering-enhancements#29.
What this PR does
Creates
/jira:create initiativeskill for strategic architectural and improvement-focused work spanning ~6 months.Pattern
Follows same pattern as existing
create-featureskill with adaptations for initiative-specific content:Feature focus: Customer value, market problems, product capabilities
Initiative focus: Technical excellence, architectural improvements, operational excellence
Skill provides
Template structure
Related work
Testing
🤖 Generated with Claude Code
Summary by CodeRabbit