Skip to content

feat(claude): add fxa-ai-fixme-create-issue skill - #21317

Merged
vbudhram merged 1 commit into
mainfrom
feat-ai-fixme-create-issue-skill
Sep 25, 2026
Merged

vbudhram merged 1 commit into
mainfrom
feat-ai-fixme-create-issue-skill

Conversation

@vbudhram

@vbudhram vbudhram commented Sep 25, 2026 •

Copy link
Copy Markdown
Contributor

Because

  • Create issues that are better for ai-fixme to pickup

This pull request

  • Adds the fxa-ai-fixme-create-issue skill. It grounds the request on origin/main, asks the engineer every open decision before it drafts, checks the blockers that the pipeline refuses (frozen paths, DB migrations, published packages, tooling files), sizes the work for one PR, and writes the ticket from one template.
  • Keeps security vulnerabilities out of the pipeline, because the agent's PR is public.
  • Asks for the paths to cover, the environments and consumers outside the repo, and what the VM cannot verify. Review comments on auto PRs traced these gaps to the ticket.
  • Files the ticket only after the engineer approves the draft, through the Atlassian MCP or acli.
  • Adds one line to the skill list in CLAUDE.md.

Issue that this pull request solves

Closes: none

Checklist

Put an x in the boxes that apply

  • My commit is GPG signed.
  • If applicable, I have modified or added tests which pass locally.
  • I have added necessary documentation (if appropriate).
  • I have verified that my changes render correctly in RTL (if appropriate).
  • I have manually reviewed all AI generated code.

How to review (Optional)

  • Key files/areas to focus on: .claude/skills/fxa-ai-fixme-create-issue/SKILL.md
  • Suggested review order: the procedure, then the template.
  • Risky or complex parts: none. The skill files a Jira ticket only after explicit approval.

Screenshots (Optional)

Other information (Optional)

@vbudhram
vbudhram marked this pull request as ready for review September 25, 2026 17:33
@vbudhram
vbudhram requested a review from a team as a code owner September 25, 2026 17:33
Copilot AI balanced review requested due to automatic review settings September 25, 2026 17:33
@vbudhram
vbudhram force-pushed the feat-ai-fixme-create-issue-skill branch from 894452f to 2979808 Compare September 25, 2026 17:35

Copilot AI 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.

Copilot review overview

🟡 Changes recommended

The procedure contains unreliable lookup commands and conflicts with repository command and migration safeguards.

Get a fresh assessment by requesting another Copilot review.

Review effort: Balanced
Findings: 1 High severity · 3 Medium severity · 1 Low severity

Open (5)
What changed in this PR

Adds a skill for drafting implementation-ready Jira tickets for the ai-fixme coding-agent pipeline.

Changes:

  • Defines ticket investigation, decision, blocker, and approval procedures.
  • Adds a standardized Jira ticket template.
  • Registers the skill in repository guidance.
File Description
.claude/​skills/​fxa-ai-fixme-create-issue/​SKILL.md Adds the ticket-creation skill and template.
CLAUDE.md Registers the new skill.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread .claude/skills/fxa-ai-fixme-create-issue/SKILL.md Outdated
Comment thread .claude/skills/fxa-ai-fixme-create-issue/SKILL.md
Comment thread .claude/skills/fxa-ai-fixme-create-issue/SKILL.md Outdated
Comment thread .claude/skills/fxa-ai-fixme-create-issue/SKILL.md Outdated
Comment thread .claude/skills/fxa-ai-fixme-create-issue/SKILL.md Outdated
Copilot AI review requested due to automatic review settings September 25, 2026 17:37
@vbudhram
vbudhram force-pushed the feat-ai-fixme-create-issue-skill branch from 2979808 to c669e23 Compare September 25, 2026 17:38

Copilot AI 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.

Copilot review overview

🔵 Needs a closer look

The workflow contains unreliable PR overlap detection and allows sign-off to bypass hard repository blockers.

Review effort: Balanced
Findings: 1 High severity · 3 Medium severity · 1 Low severity

Open (5)

Copilot AI review requested due to automatic review settings September 25, 2026 17:45
@vbudhram
vbudhram force-pushed the feat-ai-fixme-create-issue-skill branch from c669e23 to 7e2d245 Compare September 25, 2026 17:45

Copilot AI 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.

Copilot review overview

🟡 Changes recommended

Frozen-path handling, upstream selection, and Jira summary mapping can produce invalid or inaccurate tickets.

Get a fresh assessment by requesting another Copilot review.

Review effort: Balanced
Findings: 3 Medium severity

Open (3)
Resolved since last review (5)

Comment on lines +44 to +45
1. **Ground on current main.** In the repo root, run `git fetch origin main`. Read code
only with `git grep -n <pat> origin/main -- <path>` and `git show origin/main:<file> | cat -n`,
Comment on lines +67 to +69
For each other item that applies, either remove it from scope or get the engineer's explicit
sign-off and quote it in the ticket:
- a path listed in `_scripts/check-frozen.ts` on origin/main
Comment on lines +87 to +90
7. **Show the draft and file only after approval.** With the Atlassian MCP, call
`createJiraIssue` with project `FXA`, issue type `Task`, label `ai-fixme`, and a markdown
description. Or use the Atlassian CLI:
`acli jira workitem create -p FXA -t Task -s "<summary>" --description-file <file> -l ai-fixme`
The ai-fixme agent works alone and cannot ask questions before its PR, so a ticket with an open decision gets skipped or costs a feedback round. The skill grounds the request on origin/main, confirms the target is live and not a duplicate, asks the engineer every open decision before it drafts, and checks the blockers the pipeline refuses. It keeps security vulnerabilities out, because the agent's PR is public. The template asks for the paths to cover, the environments and consumers outside the repo, and what the VM cannot verify.
Copilot AI review requested due to automatic review settings September 25, 2026 18:19
@vbudhram
vbudhram force-pushed the feat-ai-fixme-create-issue-skill branch from 7e2d245 to e0a89b7 Compare September 25, 2026 18:19

Copilot AI 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.

Copilot review overview

🟡 Changes recommended

The CLI fallback permits shell injection, and the prerequisite ordering and published-package check need correction.

Get a fresh assessment by requesting another Copilot review.

Review effort: Balanced
Findings: 1 High severity · 4 Medium severity · 1 Low severity

Open (6)

Comment on lines +90 to +91
description. Or use the Atlassian CLI:
`acli jira workitem create -p FXA -t Task -s "<summary>" --description-file <file> -l ai-fixme`
Comment on lines +70 to +71
- an API that another repo consumes, such as exported `fxa-shared` code. `fxa-auth-client` is
internal to this repo, so its methods may change
Comment on lines +14 to +16
Evidence (100 merged `auto` PRs, 29 skips): tickets that merged with no feedback round state one
decided outcome, name files, give a root cause, and list what is out of scope. Length does not
matter. The top skip reason is "two routes offered or no target named". The top feedback reason is
@vbudhram
vbudhram merged commit 89a6de9 into main Sep 25, 2026
18 of 20 checks passed
@vbudhram
vbudhram deleted the feat-ai-fixme-create-issue-skill branch September 25, 2026 19:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants