Agent Skills: list-bugs Skill

🔔 시스템 메시지: 이 Skill이 호출되면 [SEMO] Skill: list-bugs 호출 시스템 메시지를 첫 줄에 출력하세요.

list-bugs Skill

Supabase DB 기반 버그 이슈 조회

Purpose

SEMO Office Supabase의 issues 테이블에서 issue_type = 'bug' 이슈를 조회합니다.

🔴 데이터 소스 변경 (v2.0.0)

| 버전 | 데이터 소스 | 방식 | |------|------------|------| | v1.x | GitHub Issues | gh issue list CLI | | v2.0 | Supabase | bug_list 뷰 조회 |

기존 방식의 문제점 (GitHub CLI)

# 기존: 라벨 기반 (레포마다 naming이 다름)
gh issue list --label "bug" --state open
gh issue list --label "BugFix" --state open

• 레포마다 라벨 naming이 다름 (bug, BugFix, 🐛, fix 등)
• GitHub API 호출 비용
• 일관된 조회 불가

새 방식: Supabase bug_list 뷰

Supabase에 미리 정의된 bug_list 뷰를 사용합니다.

Configuration

Supabase 연결 정보

SEMO Office Supabase 프로젝트를 사용합니다.

| 항목 | 값 | |------|-----| | Project | SEMO Office | | Table | issues | | View | bug_list | | Filter | type = 'bug' AND state = 'open' |

issues 테이블 스키마

| 컬럼 | 타입 | 설명 | |------|------|------| | id | UUID | PK | | office_id | UUID | 오피스 FK | | number | SERIAL | 이슈 번호 | | title | TEXT | 제목 | | body | TEXT | 본문 | | type | VARCHAR(20) | task, bug, feature, epic | | state | VARCHAR(20) | open, closed | | status | VARCHAR(30) | backlog, todo, in_progress, review, done | | assignee_id | UUID | 담당자 FK | | created_at | TIMESTAMPTZ | 생성일 |

Workflow

1. Supabase로 버그 조회

// Supabase 클라이언트를 사용한 버그 조회
const { data: bugs, error } = await supabase
  .from('bug_list')
  .select('*')
  .order('created_at', { ascending: false });

2. SQL 직접 조회 (MCP Server)

-- bug_list 뷰 조회
SELECT * FROM bug_list;

-- 또는 issues 테이블 직접 조회
SELECT
  i.number,
  i.title,
  i.status,
  ap.name as assignee_name,
  i.created_at
FROM issues i
LEFT JOIN agent_personas ap ON i.assignee_id = ap.id
WHERE i.type = 'bug'
  AND i.state = 'open'
ORDER BY i.created_at DESC;

3. Office별 버그 조회

-- 특정 Office의 버그만 조회
SELECT * FROM bug_list
WHERE office_id = '{office_uuid}';

Output Format

## 🐛 버그 이슈 현황 (Supabase DB 기준)

| # | 제목 | 상태 | 담당자 | 생성일 |
|---|------|------|--------|--------|
| #123 | API 응답 지연 | in_progress | Developer | 2025-12-01 |
| #456 | 버튼 클릭 안됨 | todo | Frontend | 2025-12-05 |

---
**총 2개의 Open 버그 이슈**

전체 조회 쿼리

-- bug_list 뷰를 사용한 전체 버그 조회
SELECT
  number AS "#",
  title AS "제목",
  status AS "상태",
  assignee_name AS "담당자",
  TO_CHAR(created_at, 'YYYY-MM-DD') AS "생성일"
FROM bug_list
ORDER BY created_at DESC;

상태별 필터링

-- 진행 중인 버그만 조회
SELECT * FROM bug_list
WHERE status = 'in_progress';

-- 백로그에 있는 버그 조회
SELECT * FROM bug_list
WHERE status = 'backlog';

담당자별 조회

-- 특정 담당자의 버그 조회
SELECT * FROM bug_list
WHERE assignee_name = 'Developer';

-- 미할당 버그 조회
SELECT * FROM bug_list
WHERE assignee_id IS NULL;

No Bugs Case

## 🐛 버그 이슈 현황 (Supabase DB 기준)

✅ 현재 Open 상태의 버그 이슈가 없습니다.

Error Handling

Supabase 연결 오류

⚠️ **Supabase 연결 오류**

Supabase 프로젝트에 연결할 수 없습니다.
- MCP 서버 설정을 확인해주세요.
- Supabase URL과 API 키를 확인해주세요.

권한 오류

⚠️ **테이블 접근 오류**

issues 테이블에 접근할 수 없습니다.
- RLS 정책을 확인해주세요.
- 서비스 키 사용 여부를 확인해주세요.

SEMO Message Format

[SEMO] Skill: list-bugs 호출

[SEMO] Skill: list-bugs 완료 - {N}개 버그 이슈 발견

GitHub CLI Fallback

Supabase 연결이 불가능한 경우 GitHub CLI로 폴백:

# Fallback: GitHub Issue Type 기반 조회
gh issue list --repo semicolon-devteam/semo --state open \
  --json number,title,issueType,createdAt,assignees \
  --jq '.[] | select(.issueType.name == "Bug")'

Related

• issues 테이블 마이그레이션
• check-feedback Skill - 피드백 이슈 수집
• project-status Skill - 이슈 상태 변경