Skip to content

KamiJeong/tech-bridge-book / .agents/skills/speckit-gh-issue-runner

speckit-gh-issue-runner

Verified

Find up to three open GitHub issues marked for $speckit-auto, inspect them, and run the existing speckit-auto workflow sequentially with issue labels and comments.

FileKindSize
SKILL.mdskill md4.2 KB
scripts/list-speckit-auto-issues.shexecutablescript1.9 KB

scripts/list-speckit-auto-issues.sh

View on GitHub
#!/usr/bin/env bash
set -euo pipefail

limit="${1:-3}"
fetch_limit="${SPECKIT_GH_ISSUE_FETCH_LIMIT:-100}"

case "$limit" in
  ''|*[!0-9]*)
    echo "limit must be a positive integer" >&2
    exit 2
    ;;
esac

if [ "$limit" -gt 3 ]; then
  limit=3
fi

case "$fetch_limit" in
  ''|*[!0-9]*)
    echo "SPECKIT_GH_ISSUE_FETCH_LIMIT must be a positive integer" >&2
    exit 2
    ;;
esac

if [ "$fetch_limit" -lt "$limit" ]; then
  fetch_limit="$limit"
fi

if ! command -v gh >/dev/null 2>&1; then
  echo "GitHub CLI 'gh' is not installed or not on PATH" >&2
  exit 127
fi

if ! command -v jq >/dev/null 2>&1; then
  echo "jq is required to rank and filter speckit-auto issues" >&2
  exit 127
fi

rank_filter='
  def has_label($name): any(.labels[].name; . == $name);
  def excluded_status:
    has_label("status:in-progress") or
    has_label("status:blocked") or
    has_label("status:waiting-review") or
    has_label("status:done") or
    has_label("status:failed");
  def priority_rank:
    if has_label("priority:P1") then 0
    elif has_label("priority:P2") then 1
    elif has_label("priority:P3") then 2
    else 3 end;

  [.[] | select(excluded_status | not)]
  | sort_by(priority_rank, .updatedAt)
'

queued_json="$(
  gh issue list \
    --state open \
    --label "trigger:speckit-auto" \
    --label "status:queued" \
    --limit "$fetch_limit" \
    --json number,title,labels,url,updatedAt \
    --jq "$rank_filter | .[:$limit]"
)"

queued_count="$(jq 'length' <<<"$queued_json")"

if [ "$queued_count" -ge "$limit" ]; then
  printf '%s\n' "$queued_json"
  exit 0
fi

fallback_json="$(
  gh issue list \
    --state open \
    --label "trigger:speckit-auto" \
    --limit "$fetch_limit" \
    --json number,title,labels,url,updatedAt \
    --jq "$rank_filter"
)"

jq -s --argjson limit "$limit" '
  add
  | unique_by(.number)
  | .[:$limit]
' <(printf '%s\n' "$queued_json") <(printf '%s\n' "$fallback_json")
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall