AgentSkillsCN

board-overview

用于查看 Guidr GitHub 项目板并追踪项目进展的命令。支持按状态、负责人、标签筛选,还可进行板级健康检查,帮助您全面了解项目当前状况。

SKILL.md
--- frontmatter
name: board-overview
description: Commands for viewing the Guidr GitHub Projects board and tracking progress. Includes filtering by status, assignee, labels, and board health checks to understand project status.

Board Overview Skill

Commands for viewing the Guidr GitHub Projects board and tracking progress.

View Project Board

Board URL: https://github.com/users/stevendejongnl/projects/3

View directly in GitHub UI for full board visualization.

Command Line Overview

bash
# List all issues with project status
gh issue list --json number,title,state,assignees,projectItems

# Filter by status (requires labels or project fields)
gh issue list --json number,title,assignees --state open

# List issues assigned to you
gh issue list --assignee @me --json number,title,state

# Count issues by state
gh issue list --json state | jq '.[] | .state' | sort | uniq -c

Check Your Active Tickets

bash
# View all your assigned issues
gh issue list --assignee @me --state open

# View detailed info on your tickets
gh issue list --assignee @me --json number,title,state,updatedAt

# View specific ticket
gh issue view 123

Board Statuses

The Guidr project board has three statuses:

  1. Todo - Not yet started
  2. In Progress - Currently being worked on
  3. Done - Completed and merged

Progress Tracking

bash
# Get count of open issues
gh issue list --state open | wc -l

# Get issues needing attention (no assignee)
gh issue list --state open --json number,title | jq '.[] | select(.assignees | length == 0)'

# Check recently updated issues
gh issue list --state open --json number,title,updatedAt --sort updated --limit 10

Review Issues by Category

bash
# Mobile issues
gh issue list --label "mobile" --json number,title,assignees

# API issues
gh issue list --label "api" --json number,title,assignees

# Bug reports
gh issue list --label "bug" --json number,title,state

# Features in progress
gh issue list --state open --label "feature" --json number,title,assignees

Board Insights

bash
# Who's working on what?
gh issue list --state open --json assignees,number,title

# What's blocked?
gh issue list --label "blocked" --json number,title

# What's high priority?
gh issue list --label "priority:high" --json number,title

# How many items per person?
gh issue list --state open --json assignees | jq -r '.[] | .assignees[].login' | sort | uniq -c

Filter by Project Field

For detailed project board queries (requires advanced gh CLI):

bash
# View raw project data
gh api repos/stevendejongnl/guidr/projects/3/columns

# List project items with status
gh api graphql -f query='
  query {
    repository(owner: "stevendejongnl", name: "guidr") {
      projectNext(number: 3) {
        items(first: 20) {
          nodes {
            title
            content {
              __typename
              ... on Issue {
                number
                title
              }
            }
          }
        }
      }
    }
  }
'

Quick Status Check

bash
# Show all open issues in one view
gh issue list --state open --limit 50

# Show issues you should be working on
gh issue list --assignee @me --state open

# Show recently closed issues (celebrating wins!)
gh issue list --state closed --limit 10 --json number,title

Board Health

  • Ideal: Most items are assigned and have statuses
  • Watch for: Items stuck in "In Progress" with no updates
  • Good practice: Regularly review "Todo" items to prioritize

Integration with Development

When starting work:

  1. View the board to see available "Todo" items
  2. Assign yourself to a ticket
  3. Update status to "In Progress"
  4. Link commits to the issue number
  5. Move to "Done" when PR is merged

Tips

  • Check the board regularly for blocked items
  • Keep statuses updated so others know what's happening
  • Use labels to categorize work
  • Review project board before starting a new task