shepherd-sync

Solid

Sync triage results back into Jira, Linear, or GitHub Issues using the matching tracker adapter. Use after a triage run to update the tracker.

AI & Automation 17 stars 4 forks Updated today MIT

Install

View on GitHub

Quality Score: 80/100

Stars 20%
42
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# /shepherd-sync — Backlog Synchronization Pull all open bugs from your tracker into a local backlog file for offline triage. ## Workflow ### 1. Load Configuration Read `.claude/triage.config.yaml` to get tracker type, project key, and team settings. If config file is missing: ``` "Config not found. Run the Bug Shepherd installer or create .claude/triage.config.yaml manually." "See: https://github.com/YOUR_USERNAME/bug-shepherd#configuration" ``` ### 2. Detect Tracker and Load Adapter Based on `project.tracker` in config, load the matching adapter bundled with this skill in `references/`: - `jira`: Read `references/jira.md` for Jira-specific query patterns - `linear`: Read `references/linear.md` for Linear-specific patterns - `github-issues`: Read `references/github-issues.md` for GitHub Issues patterns ### 3. Pull Open Bugs Execute the tracker-specific query to fetch ALL open bugs. Handle pagination. **For Jira** (via Atlassian MCP): - Use JQL: `project = {tracker_project} AND issuetype = Bug AND status NOT IN (Done, Cancelled) ORDER BY created ASC` - Paginate: fetch up to 100 per page, continue with `created > {last_date}` until no more results **For Linear** (via Linear MCP): - Query: open issues with label "bug" in the configured team - Paginate using cursor **For GitHub Issues** (via gh CLI): - Query: `gh issue list --repo {repo} --label bug --state open --limit 500 --json number,title,state,labels,createdAt,assignees,body` ### 4. Detect Current Sprint (if a...

Details

Author
mshadmanrahman
Repository
mshadmanrahman/pm-pilot
Created
5 months ago
Last Updated
today
Language
TypeScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category