diff --git a/.claude/skills/create-issue/SKILL.md b/.claude/skills/create-issue/SKILL.md index 12ab7cf8..1edfa7bb 100644 --- a/.claude/skills/create-issue/SKILL.md +++ b/.claude/skills/create-issue/SKILL.md @@ -30,20 +30,7 @@ $ARGUMENTS ### Title Format -**`Type: Title Case Description`** - -Use Title Case for the description portion. The type prefix is followed by a colon and space. - -| Prefix | When to Use | Example | -| ---------------- | ----------------------------------------------------- | ------------------------------------------------ | -| `Feature:` | New capability or behavior | Feature: Add OAuth Support | -| `Bug:` | Something broken or not working as expected | Bug: Playback Stalls on iOS Safari | -| `Docs:` | Documentation additions or improvements | Docs: Add Getting Started Guide | -| `Architecture:` | Internal structure, design patterns, core refactoring | Architecture: Redesign State Management Layer | -| `Chore:` | Maintenance, deps, tooling, CI | Chore: Upgrade Vitest to v3 | -| `Design:` | Design docs, component specs, visual design | Design: Component Spec for Slider | - -**Not** conventional commit prefixes (`feat:`, `fix:`, `docs:`) -- those are for commits only. +Use Title Case. The triage bot will add the appropriate type prefix (`Bug:`, `Feature:`, etc.) automatically. ### Labels @@ -118,15 +105,14 @@ When creating **Feature**, **Architecture**, or **Design** issues, research how ### Step 1: Gather Information If $ARGUMENTS provides enough detail, extract: -1. **Type** -- Which prefix applies (Feature, Bug, Docs, Architecture, Chore, Design) -2. **Title** -- Short, descriptive, Title Case -3. **Description** -- The what and why +1. **Title** -- Short, descriptive, Title Case +2. **Description** -- The what and why If details are missing, use the `question` tool to ask the user. ### Step 2: Format Title -Construct the title as `Type: Title Case Description`. +Construct the title in Title Case (no type prefix — the triage bot adds that). **Title Case rules:** - Capitalize the first and last word @@ -159,7 +145,7 @@ Ask for confirmation using the `question` tool. ```bash gh issue create --repo videojs/v10 \ - --title "Type: Title Case Description" \ + --title "Title Case Description" \ --body "body content" ``` @@ -167,7 +153,7 @@ Use a HEREDOC for the body to preserve formatting: ```bash gh issue create --repo videojs/v10 \ - --title "Feature: Add OAuth Support" \ + --title "Add OAuth Support" \ --body "$(cat <<'EOF' Description text here. diff --git a/.github/ISSUE_TEMPLATE/2.feature_request.yml b/.github/ISSUE_TEMPLATE/2.feature_request.yml index 599d342f..8efd0a28 100644 --- a/.github/ISSUE_TEMPLATE/2.feature_request.yml +++ b/.github/ISSUE_TEMPLATE/2.feature_request.yml @@ -2,7 +2,7 @@ name: 💎 Feature Request description: Request a new feature or enhancement type: enhancement labels: [triage] -title: 'Feature Request: ' +title: 'Feature: ' body: - type: markdown attributes: diff --git a/.github/workflows/issue-triage.yml b/.github/workflows/issue-triage.yml index af9ddf41..0fa50573 100644 --- a/.github/workflows/issue-triage.yml +++ b/.github/workflows/issue-triage.yml @@ -45,8 +45,16 @@ jobs: ${{ github.event.issue.body }} Triage responsibilities: - 1. Set issue type: - - Assign the correct GitHub issue type: Bug, Enhancement, or Task. + 1. Ensure title prefix: + - Every issue title must start with a type prefix. If the prefix is missing or wrong, fix the title. Preserve the rest of the title as-is. + - Use Title Case for the description after the prefix (e.g., "Bug: Playback Stalls on iOS Safari"). + - Prefixes: + - `Feature:` — New capability or behavior + - `Bug:` — Something broken or not working as expected + - `Docs:` — Documentation additions or improvements + - `Architecture:` — Internal structure, design patterns, core refactoring + - `Chore:` — Maintenance, deps, tooling, CI + - `Design:` — Design docs, component specs, visual design 2. Classify and label: - Determine best-fit labels from issue content and template sections. - Review labels used on related/cross-referenced issues before deciding.