跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

issue

Complete GitHub issue creation workflow with required type, area, and priority labels

mrveiss · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add mrveiss/AutoBot-AI --skill issue

技能说明


name: issue description: Complete GitHub issue creation workflow with required type, area, and priority labels

Create GitHub Issue

Creates a well-labeled GitHub issue with all required metadata for filtering and triage.

Step 1 — Gather details

If not provided upfront, collect:

  • Title: concise, action-oriented ("Fix X", "Add Y", "Refactor Z")
  • Description: what's broken or needed, where it is in the codebase, severity/impact
  • Discovered during: which issue or PR surfaced this (if applicable)

Step 2 — Choose labels

Every issue requires at minimum: one Type + one Priority.

Type (pick one)

LabelWhen
bugSomething broken
enhancementNew feature or improvement
technical-debtCleanup, refactoring
securitySecurity vulnerability or hardening
performanceSpeed, memory, efficiency
testingMissing or broken tests
documentationDocs gap

Area — coarse (pick one or more)

backend · frontend · testing · infrastructure · docs · ci · security database · deployment · configuration · monitoring · mcp · rag · agents memory · analytics · ai-ml · error-handling · optimization

Area — cluster (pick exactly one)

Every issue also carries its area: <cluster> label from the backlog dependency waves — 32 clusters, coloured by wave, listed with gh label list --search "area: ". The cluster says which body of work the issue belongs to; the coarse label says which part of the stack it touches. An issue that fits no existing cluster gets the coarse label only, and says so in the report.

Priority (pick one)

LabelWhen
priority: criticalData loss, security breach, production down
priority: highMajor feature broken, significant user impact
priority: mediumImportant but workaround exists
priority: lowCosmetic, nice-to-have, minor inconvenience

Step 3 — Create issue

gh issue create \
  --title "<title>" \
  --body "$(cat <<'EOF'
## Problem
<what's wrong or needed>

## Location
<file paths, function names, line numbers>

## Impact
<who is affected and how>

## Discovered During
Working on #<original-issue> (if applicable)

## Acceptance Criteria
- [ ] <criterion 1>
- [ ] <criterion 2>
EOF
)" \
  --label "<type>,<area>,<priority>"

Step 4 — Link relationships (native, not prose)

A checklist item and a Depends on: #N line are prose — GitHub's hierarchy and dependency graphs cannot see them. Record the real edges immediately after creating the issue. sub_issue_id / issue_id take the issue's id, never its number.

REPO=mrveiss/AutoBot-AI

# Attach to its umbrella
gh api -X POST repos/$REPO/issues/$UMBRELLA/sub_issues \
  -F sub_issue_id=$(gh api repos/$REPO/issues/$NEW -q .id)

# One edge per blocker, recorded on the BLOCKED issue
gh api -X POST repos/$REPO/issues/$NEW/dependencies/blocked_by \
  -F issue_id=$(gh api repos/$REPO/issues/$BLOCKER -q .id)

# Read back
gh api repos/$REPO/issues/$UMBRELLA/sub_issues         -q '.[].number'
gh api repos/$REPO/issues/$NEW/dependencies/blocked_by -q '.[].number'
  • One parent per child — re-parenting is DELETE .../sub_issue -F sub_issue_id=… then POST.
  • Backfilling from an existing checklist: a row owns at most one issue. Refs in parentheses, or after blocked by / depends on / unblocks / sub-tree / PR, are commentary — linking them re-parents another umbrella's child, and one-parent-per-child then blocks the real parent.
  • A duplicate POST returns 422; that means already-linked, not a failure.
  • Hierarchy and dependency are separate graphs — never encode one as the other.
  • Issue types are an org-only GitHub feature and 404 here; labels stay the taxonomy.

Step 5 — Report and ask

gh issue view <new-number>   # Confirm creation

Then report:

Created #<number>: <title>
Labels: <type> · <area> · <priority>
Parent: #<umbrella> (native sub-issue) · Blocked by: #<n>, #<n>
Should I: a) Fix now  b) Finish current issue first  c) Leave for later

Examples

# Bug discovered during implementation
gh issue create \
  --title "Bug: query_cache has no max size limit" \
  --label "bug,backend,rag,priority: medium"

# New feature
gh issue create \
  --title "feat: add BM25 scoring to keyword search" \
  --label "enhancement,backend,rag,performance,priority: medium"

# Security issue
gh issue create \
  --title "Security: python-ecdsa Minerva timing attack" \
  --label "security,backend,priority: high"

Post-task Gap Check (ALWAYS after completing any task)

"Were there any gaps or issues discovered while implementing? Do all discoveries have a GitHub issue?"

If yes → run this skill immediately for each discovery before closing the original issue.