[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6ACDZWW85YHH8R4CMK1P5G3":3,"skill-same:01M6ACDZWW85YHH8R4CMK1P5G3":66},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":21,"linkOnly":22,"markdownContent":23,"markdownBody":23,"frontMatter":24,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":30,"ownerHtmlUrl":31,"ownerBlogUrl":32,"ownerDescription":6,"updatedAt":33,"install":34,"resources":47},"01M6ACDZWW85YHH8R4CMK1P5G3","groovy-jira",null,"apache\u002Fgroovy","apache","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F47359?v=4","01M6AC83E6K4FDKK7HZ8WNMQKE","The Apache Software Foundation","01M6ACDPCXGWGWJN1KV90SHDQB",5482,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fapache\u002Fgroovy\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fgroovy-jira\u002FSKILL.md",[],[18,19,20],"jira","groovy","groovy jira","2026-11-10 10:12:30",false,"\u003C!--\n  Licensed to the Apache Software Foundation (ASF) under one\n  or more contributor license agreements.  See the NOTICE file\n  distributed with this work for additional information\n  regarding copyright ownership.  The ASF licenses this file\n  to you under the Apache License, Version 2.0 (the\n  \"License\"); you may not use this file except in compliance\n  with the License.  You may obtain a copy of the License at\n\n    http:\u002F\u002Fwww.apache.org\u002Flicenses\u002FLICENSE-2.0\n\n  Unless required by applicable law or agreed to in writing,\n  software distributed under the License is distributed on an\n  \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n  KIND, either express or implied.  See the License for the\n  specific language governing permissions and limitations\n  under the License.\n-->\n---\nname: groovy-jira\ndescription: AI-tooling guardrails for working with JIRA on the GROOVY project — points at the project's JIRA conventions in CONTRIBUTING.md (states, fields, components, JQL recipes, the commit ↔ JIRA link), and adds the AI-specific constraints on top: never propose a workflow transition, never set committer-owned fields, never post comments or open formal issue links autonomously, refetch live state rather than citing trained memory, hand drafts back to a human for review. Use when constructing a JQL query, suggesting a Component, drafting a JIRA comment, or producing any AI output that touches JIRA.\nlicense: Apache-2.0\ncompatibility: claude, codex, copilot, cursor, gemini, aider\nmetadata:\n  audience: contributors to apache\u002Fgroovy\n  scope: ai-tooling-jira-guardrails\n---\n\n# Groovy JIRA\n\nThis skill is the **AI-tooling layer** over the project's JIRA\nconventions. The conventions themselves — states, fields, components,\nJQL recipes, the commit ↔ JIRA link — live in\n[`CONTRIBUTING.md`'s \"Working with JIRA\" section](..\u002F..\u002F..\u002FCONTRIBUTING.md#working-with-jira).\nThis skill cites them and adds the AI-specific guardrails: no\nautonomous comments, no proposed transitions, no fabricated field\nvalues, no trained-memory citations of live state. The output is a\ndraft a human committer reviews and posts.\n\n- [`groovy-triage`](..\u002Fgroovy-triage\u002FSKILL.md) — sister skill that\n  drives a full triage pass; pair with this one.\n- [`groovy-fix-workflow`](..\u002Fgroovy-fix-workflow\u002FSKILL.md) — hand off\n  to once a triage finding becomes a fix in flight.\n- [`CONTRIBUTING.md`](..\u002F..\u002F..\u002FCONTRIBUTING.md) — the canonical\n  source for every JIRA convention this skill cites; load alongside\n  this skill.\n\n## When to use this skill\n\n**Use it for:**\n\n- Drafting JIRA-related output (comments, field suggestions, query\n  results) that a human will review before posting.\n- Constructing a JQL query for grooming, duplicate hunting,\n  release-notes mining, or a triage pass.\n- Suggesting a `Component\u002Fs` value or interpreting one already set.\n- Producing or reading a `GROOVY-NNNNN` reference in a commit, branch\n  name, or comment.\n\n**Don't use it for:**\n\n- Posting to JIRA on the project's behalf, transitioning workflow\n  state, setting committer-owned fields, or opening formal issue\n  links. The hand-back contract (below) is firm.\n- Triage workflow itself (reproducing, drafting findings, PR-readiness\n  checks) — that's [`groovy-triage`](..\u002Fgroovy-triage\u002FSKILL.md).\n- Security-sensitive issues. Suspected vulnerabilities are reported\n  privately per [`SECURITY.md`](..\u002F..\u002F..\u002F.github\u002FSECURITY.md), not into\n  JIRA or a public comment. If a public JIRA appears to disclose a\n  vulnerability, flag privately to a committer and stop.\n- Workflow administration (creating versions, renaming components,\n  editing the workflow itself) — that's a project-admin action.\n\n## Read first\n\n- [`CONTRIBUTING.md`](..\u002F..\u002F..\u002FCONTRIBUTING.md) \"Working with JIRA\"\n  — fields, states, components, JQL recipes, commit-reference\n  convention. The canonical source for everything below; the skill\n  restates only what AI tooling specifically needs.\n- [`GOVERNANCE.md`](..\u002F..\u002F..\u002FGOVERNANCE.md) — JIRA's role as the\n  project's canonical record.\n- Live JIRA project page:\n  \u003Chttps:\u002F\u002Fissues.apache.org\u002Fjira\u002Fprojects\u002FGROOVY> — components,\n  versions, and the workflow are configured there, not in this repo.\n\n## Top failure modes\n\nThese are the recurring mistakes when AI tooling reaches for JIRA:\n\n1. **Proposing a workflow transition.** State changes are committer\n   actions tied to actual code shipping. AI tooling never recommends\n   or performs a transition — surface a recommendation in a comment\n   instead: \"appears fixed on master at `\u003Crev>` — proposing a\n   committer close this as Cannot Reproduce after a second look.\" The\n   contributor norm is \"comment, don't transition\" (see\n   [`CONTRIBUTING.md`](..\u002F..\u002F..\u002FCONTRIBUTING.md#working-with-jira));\n   for AI tooling it tightens to \"never.\"\n\n2. **Setting or proposing a committer-owned field.** `Fix Version\u002Fs`,\n   `Resolution`, and `Priority` are committer territory; AI tooling\n   does not propose values for them. `Affects Version\u002Fs` is the\n   reporter's domain; ask if missing, don't fabricate. `Component\u002Fs`\n   AI may *suggest* — but only from a real area of the codebase, not\n   a plausible-sounding name. See the field-ownership table in\n   [`CONTRIBUTING.md`](..\u002F..\u002F..\u002FCONTRIBUTING.md#working-with-jira)\n   for who sets what.\n\n3. **Fabricating a Component.** AI tooling reaches for\n   plausible-sounding component names that aren't in the live list.\n   Refetch the\n   [components page](https:\u002F\u002Fissues.apache.org\u002Fjira\u002Fprojects\u002FGROOVY?selectedItem=com.atlassian.jira.jira-projects-plugin:components-page)\n   rather than guessing. If the bug doesn't map cleanly to an\n   existing component, say so in the comment — don't manufacture one.\n\n4. **Posting a comment, link, or assignment without explicit\n   instruction.** Even when the draft is clean and the recommendation\n   obvious, AI tooling produces drafts; humans post. Formal \"Linked\n   Issues\" relationships are committer territory regardless; AI\n   cross-references stay in comment text only.\n\n5. **Quoting a stale JIRA snapshot.** Trained memory and cached\n   search results lag the live project. For decisions that hinge on\n   current state (open vs. closed, latest comment, current\n   `Fix Version\u002Fs` on a related issue), refetch — don't cite from\n   memory. This bites AI tooling harder than humans, because humans\n   typically load JIRA in a browser before commenting.\n\n6. **JQL that drops `project = GROOVY` or mis-quotes values.** The\n   contributor rules (lead with `project = GROOVY`, quote multi-word\n   values, use `in` for multi-value fields) are in\n   [`CONTRIBUTING.md`](..\u002F..\u002F..\u002FCONTRIBUTING.md#working-with-jira) —\n   AI output is held to them too. A query that's \"right in principle\n   but produces cross-project noise\" is wrong output.\n\n7. **Bare or malformed JIRA references in drafted output.** Commits,\n   comments, and branch names use `GROOVY-NNNNN` — uppercase, no\n   brackets, no prefix. Drafts that emit `#12345`, `JIRA-12345`, or\n   lowercase `groovy-12345` break the search-by-grep workflow\n   contributors and tooling rely on.\n\n## Helper scripts\n\nThree vetted helpers ship in this skill's directory so the agent does\nnot re-derive the ASF JIRA REST calls on every run — per the\n[Helper mechanisms and token economy](..\u002F..\u002F..\u002FAGENTS.md#helper-mechanisms-and-token-economy)\npolicy (the JIRA REST v2 API is stable and these change rarely; the\n`curl` + `jq` inside each script is the documented manual\nequivalent if you need to adapt it):\n\n- [`jira-search.sh`](jira-search.sh) — `jira-search.sh '\u003CJQL>'\n  [max]` → tab-separated candidate list (key, dates, type,\n  attachment count, components, summary). Use for the\n  candidate-set selection in\n  [`groovy-reassess`](..\u002Fgroovy-reassess\u002FSKILL.md) and the\n  duplicate \u002F related-issue scans in triage.\n- [`jira-issue.sh`](jira-issue.sh) — `jira-issue.sh GROOVY-NNNNN\n  [out-dir]` → `issue.json` + a rendered `description.md`\n  (fields, description, every comment), and lists attachment URLs\n  for manual download.\n- [`jira-recent.sh`](jira-recent.sh) — `jira-recent.sh [days]` →\n  unresolved issues updated in the last `days` (default 30), each\n  linked to the GitHub PRs whose title names its key, grouped as\n  merged-PR-but-still-open \u002F open PR \u002F no open PR, plus open PRs in\n  the window naming none of the listed issues. The merged group also\n  shows each issue's affects versions and which of `GROOVY_4_0_X`,\n  `GROOVY_5_1_X`, `GROOVY_6_0_X` and `master` mention its key (read\n  from the local remote-tracking refs, so `git fetch` first). Needs an\n  authenticated `gh` and a clone of the repo in addition to `curl`\n  and `jq`.\n- [`pr-shortlist.sh`](pr-shortlist.sh) — `pr-shortlist.sh\n  [max-size]` → open GitHub PRs grouped by how close they are to\n  merging: approved \u002F approved-but-pushed-since \u002F small and waiting\n  for a reviewer (yours vs. others') \u002F open discussion \u002F CI failing\n  or pending \u002F larger than `max-size` lines (default 600); drafts and\n  conflicting PRs are only counted. Each row's `since-commit:` column\n  names who has commented since the PR's last commit (author and\n  automated accounts left out; `(replied)` when the author answered\n  after them). Use it to pick which PRs to progress next. Needs an authenticated `gh` and `jq` (no JIRA call).\n\nAll are read-only (no mutation, and anonymous against JIRA) — they do\nnot change the read-only \u002F hand-back posture this skill enforces.\nPrefer them over an ad-hoc `curl`; fall back to the inline command\nonly if a script is unavailable or the query needs a field they\ndon't request.\n\n## Drafting a JIRA comment\n\nWhen the task is to produce a JIRA comment a human will review and\npost:\n\n1. **Refetch live state for any factual claim.** The issue's current\n   status, the latest comments, the `Component\u002Fs` and `Fix Version\u002Fs`\n   fields, related issues — pull from the live JIRA, not from\n   training memory or stale cache.\n2. **Use plain `GROOVY-NNNNN` for any cross-reference**; let JIRA\n   auto-link.\n3. **Surface recommendations, not directives.** \"Looks fixed on\n   master at `\u003Crev>` — may be a candidate for closing as Cannot\n   Reproduce\" reads as a recommendation; \"Closing this as Cannot\n   Reproduce\" reads as an action. The committer makes the call.\n4. **Cite evidence.** A reproduction outcome on `master` cites the\n   revision and JDK (see [`groovy-reproducer`](..\u002Fgroovy-reproducer\u002FSKILL.md));\n   a duplicate citation names the linked JIRA; a `Component\u002Fs`\n   suggestion names the package path it derives from.\n5. **No security-sensitive content** in a public JIRA comment.\n   Vulnerabilities are reported privately per\n   [`SECURITY.md`](..\u002F..\u002F..\u002F.github\u002FSECURITY.md).\n6. **Stop at the draft.** Output is text for a human to review and\n   post. The human assesses tone, accuracy, and timing.\n\n## Hand-back contract\n\nAI tooling working with JIRA produces drafts; it does not act on\nJIRA. Specifically, AI tooling does **not**:\n\n- Post comments to JIRA.\n- Transition workflow state (any of `Open \u002F In Progress \u002F Resolved \u002F\n  Closed \u002F Reopened`).\n- Set or change any field (`Fix Version\u002Fs`, `Resolution`, `Priority`,\n  `Component\u002Fs`, `Affects Version\u002Fs`, `Assignee`, `Labels`,\n  `Summary`, `Description`).\n- Create formal \"Linked Issues\" relationships.\n- Assign issues to anyone, including the user.\n\nWith explicit instruction, AI tooling *may*:\n\n- Produce a draft comment, draft `Component\u002Fs` suggestion, or draft\n  cross-reference for the human to post.\n- Run a JQL query and return the result set (read-only).\n- Cite a `GROOVY-NNNNN` in a commit message or branch name the human\n  is authoring.\n\nThe committer \u002F contributor decides what gets posted and when.\n\n## Validation checklist\n\nBefore declaring a JIRA-related output ready for human review:\n\n- [ ] No proposed workflow transition; recommendations only.\n- [ ] No proposed `Fix Version\u002Fs`, `Resolution`, or `Priority`.\n- [ ] Any suggested `Component\u002Fs` maps to a real area of the codebase\n      and matches a component on the live list (refetched, not from\n      memory).\n- [ ] Any `Affects Version\u002Fs` ask routes back to the reporter; no\n      fabricated value.\n- [ ] If the output relies on issue state: refetched from the live\n      JIRA in this session, not cited from memory.\n- [ ] Any JIRA reference uses the full `GROOVY-NNNNN` key (uppercase,\n      no brackets, no prefix).\n- [ ] Any JQL leads with `project = GROOVY`, quotes multi-word\n      values, and uses the right operator for multi-value fields.\n- [ ] No security-sensitive content in a draft destined for a public\n      comment.\n- [ ] The output is a draft for a human to review and post — not a\n      payload to be sent automatically.\n\n## References\n\n- [`CONTRIBUTING.md`](..\u002F..\u002F..\u002FCONTRIBUTING.md) \"Working with JIRA\"\n  — the canonical source for every convention restated above (states,\n  fields, components, JQL recipes, commit references). Update this\n  skill if a divergence appears.\n- [`GOVERNANCE.md`](..\u002F..\u002F..\u002FGOVERNANCE.md) — JIRA as the project's\n  canonical record.\n- `.agents\u002Fskills\u002Fgroovy-triage\u002FSKILL.md` — sister skill; drives a\n  full triage pass and defers to this skill for the AI-specific JIRA\n  bits.\n- `.agents\u002Fskills\u002Fgroovy-fix-workflow\u002FSKILL.md` — hand off to once a\n  triage finding becomes a fix in flight.\n- Live JIRA project: \u003Chttps:\u002F\u002Fissues.apache.org\u002Fjira\u002Fprojects\u002FGROOVY>\n  — components, versions, workflow.\n",{},"master","572ab04fdf5d84d77079f4e350eb6c5b20290685",".agents\u002Fskills\u002Fgroovy-jira",1914,"https:\u002F\u002Fgithub.com\u002Fapache\u002Fgroovy","https:\u002F\u002Fgroovy-lang.org","https:\u002F\u002Fgithub.com\u002Fapache","https:\u002F\u002Fwww.apache.org\u002F","2026-11-15 01:42:11",{"source":7,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add apache\u002Fgroovy --skill groovy-jira",{"tool":40,"command":41},"bunx","bunx skills add apache\u002Fgroovy --skill groovy-jira",{"tool":43,"command":44},"pnpm","pnpm dlx skills add apache\u002Fgroovy --skill groovy-jira","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fapache\u002Fgroovy\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fgroovy-jira\u002FSKILL.md",true,[48,54,58,62],{"path":49,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":52,"sourceHtmlUrl":53},"jira-issue.sh","SCRIPT","脚本",3871,"https:\u002F\u002Fgithub.com\u002Fapache\u002Fgroovy\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fgroovy-jira\u002Fjira-issue.sh",{"path":55,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":56,"sourceHtmlUrl":57},"jira-recent.sh",6192,"https:\u002F\u002Fgithub.com\u002Fapache\u002Fgroovy\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fgroovy-jira\u002Fjira-recent.sh",{"path":59,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":60,"sourceHtmlUrl":61},"jira-search.sh",2522,"https:\u002F\u002Fgithub.com\u002Fapache\u002Fgroovy\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fgroovy-jira\u002Fjira-search.sh",{"path":63,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":64,"sourceHtmlUrl":65},"pr-shortlist.sh",6915,"https:\u002F\u002Fgithub.com\u002Fapache\u002Fgroovy\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fgroovy-jira\u002Fpr-shortlist.sh",[67,73,81,89,96,104],{"skillNo":68,"name":69,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":21},"01M6ACEDS969D6ZXE8SGZSPR3B","groovysh","https:\u002F\u002Fgithub.com\u002Fapache\u002Fgroovy\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fgroovysh\u002FSKILL.md",[],[69],{"skillNo":74,"name":75,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":21},"01M6ACEBR5V55F0X8YS9EJGRW2","groovy-triage","https:\u002F\u002Fgithub.com\u002Fapache\u002Fgroovy\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fgroovy-triage\u002FSKILL.md",[],[79,19,80],"triage","groovy triage",{"skillNo":82,"name":83,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":21},"01M6ACE9Y7AFJV4ZERD6WPF8QS","groovy-tests","https:\u002F\u002Fgithub.com\u002Fapache\u002Fgroovy\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fgroovy-tests\u002FSKILL.md",[],[19,87,88],"groovy tests","tests",{"skillNo":90,"name":91,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":21},"01M6ACE7HZNK305VJGV3WN4P5N","groovy-skills","https:\u002F\u002Fgithub.com\u002Fapache\u002Fgroovy\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fgroovy-skills\u002FSKILL.md",[],[19,95],"groovy skills",{"skillNo":97,"name":98,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":21},"01M6ACE5BJCXWJPMZD0M12H3D5","groovy-reproducer","https:\u002F\u002Fgithub.com\u002Fapache\u002Fgroovy\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fgroovy-reproducer\u002FSKILL.md",[],[19,102,103],"groovy reproducer","reproducer",{"skillNo":105,"name":106,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":21},"01M6ACE2M14SX17HE4JKR57DCC","groovy-reassess","https:\u002F\u002Fgithub.com\u002Fapache\u002Fgroovy\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fgroovy-reassess\u002FSKILL.md",[],[19,110,111],"groovy reassess","reassess"]