Skip to content

feat(aif-estimate-issue): story point calibration and blindspot detection skill - #89

Draft
guangshinhaha wants to merge 1 commit into
mainfrom
feat/aif-estimate-issue
Draft

feat(aif-estimate-issue): story point calibration and blindspot detection skill#89
guangshinhaha wants to merge 1 commit into
mainfrom
feat/aif-estimate-issue

Conversation

@guangshinhaha

Copy link
Copy Markdown

Summary

  • Adds aif-estimate-issue skill that calibrates story point estimates against a repo's historical SP-labeled issues and surfaces a blindspots checklist for grooming discussions
  • Auto-detects the repo's SP label convention (e.g. sp:3, points:5), reads the codebase for complexity analysis, and outputs a structured estimate with comparable issues, a 6-dimension complexity breakdown, and missing considerations
  • Posts the analysis as an issue comment and applies an ai-sp:N label so the team can reference the AI recommendation alongside their own estimate

Closes #87

Test plan

  • Run aif-estimate-issue against an issue in a repo with existing SP labels (e.g. teacher-workspace) and verify it finds calibration anchors
  • Run against an issue in a repo with no SP labels and verify graceful fallback (complexity + blindspots only, low confidence noted)
  • Verify the ai-sp:N label is created and applied correctly
  • Verify re-running on the same issue replaces the old ai-sp:* label
  • Verify the comment is posted via --body-file without shell interpolation issues

🤖 Generated with Claude Code

…etection skill

Closes #87

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

@natashaannn natashaannn left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Follow up: to make groom-issue skill and this skill more of a prompt/dialogue skill to prompt user thinking and align better with grooming ritual. Test both and see what works better.


Display the issue title and current body so the user can confirm this is the right issue before continuing.

### Step 2: Detect the SP label convention and fetch calibration data

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Unnecessary step to check for convention, skip checking for convention and use established story point convention of sp:<n>.


If no SP labels are found in the repo, note this and skip calibration. The skill will still produce a complexity breakdown and blindspots checklist, but will flag that confidence is low due to missing historical data.

### Step 3: Read the codebase

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Replace this step with: If issue does not have relevant technical context and/or is still pending grooming, flag out for user and leave comment on github issue that this is still pending grooming and hence story points cannot be estimated.


If no calibration data exists, base the estimate on the complexity analysis alone and clearly state that the estimate is uncalibrated.

### Step 6: Generate blindspots checklist

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Consider putting into aif-groom-issue skill; also consider folding whole skill into groom-issue-skill as these two skills are usually done in same grooming session .

@natashaannn

Copy link
Copy Markdown
Collaborator

@guangshinhaha Will convert this to draft, and will edit from here!

@natashaannn
natashaannn marked this pull request as draft July 8, 2026 03:38
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.

feat(aif-estimate-issue): story point calibration and blindspot detection during grooming

2 participants