jira-task-test

jira-task-test: Run Tests & Report to Jira

Language Rule

모든 출력을 한국어로 작성한다: 사용자 응답, 생성 문서, Jira 코멘트 내용 등 모든 텍스트가 대상이다. 예외: 코드, 변수명, 브랜치명, 파일명, 명령어는 영어를 유지한다. Jira 코멘트: 섹션 제목(##, ###)은 영어로, 내용(설명·요약·노트)은 한국어로 작성한다.

Prerequisites

• Implementation should be complete for the task
• Test framework should be installed in the project

Workflow

Step 1: Detect Test Environment

Scan the project to determine the test setup:

# Check for test frameworks
ls package.json 2>/dev/null       # Node.js project
ls playwright.config.* 2>/dev/null # Playwright
ls vitest.config.* 2>/dev/null     # Vitest
ls jest.config.* 2>/dev/null       # Jest
ls pytest.ini 2>/dev/null          # Python pytest
ls pyproject.toml 2>/dev/null      # Python pyproject

Also check package.json for test scripts:

cat package.json | grep -A5 '"scripts"'

Determine available test types:

• E2E (Playwright): If playwright.config.* exists
• Unit (Vitest/Jest): If vitest.config.* or jest.config.* exists
• Custom: If package.json has a test script

Step 1.5: Check for Existing Tests

이 태스크와 관련된 테스트가 이미 있는지 Glob/Grep으로 확인:

• 테스트 파일에서 TASK-ID 또는 기능 키워드 검색
• tests/, e2e/, __tests__/, *.test.*, *.spec.* 패턴 탐색

관련 테스트가 없으면: 사용자에게 테스트 생성을 먼저 제안:

1. Design 문서의 Test Plan 섹션 참조
2. Jira 이슈의 Acceptance Criteria 참조
3. Playwright 또는 unit 테스트 파일 생성 (아래 구조 참고)

import { test, expect } from '@playwright/test';

test.describe('<Feature Name> - <TASK-ID>', () => {
  test('should <acceptance criterion 1>', async ({ page }) => {
    // Test implementation
  });
});

사용자가 테스트 생성을 원하면 생성 후 Step 2로 진행. 원치 않으면 바로 Step 2로.

Step 2: Run Tests

Execute tests in order of speed (unit first, then E2E):

Unit Tests

# Vitest
npx vitest run --reporter=verbose 2>&1

# Jest
npx jest --verbose 2>&1

# pytest
python -m pytest -v 2>&1

Playwright E2E Tests

# Install browsers if needed
npx playwright install --with-deps 2>&1

# Run all E2E tests
npx playwright test --reporter=list 2>&1

# Or run specific tests related to the task (search by TASK-ID or feature name)
npx playwright test --grep "<feature-keyword>" --reporter=list 2>&1

Custom Test Command

npm test 2>&1

Capture ALL output (stdout + stderr) for the report.

Step 3: Analyze Results

Parse the test output to extract:

• Total tests: Count of all tests run
• Passed: Count of passing tests
• Failed: Count of failing tests (with details)
• Skipped: Count of skipped tests
• Duration: Total execution time

For failed tests, capture:

• Test name
• Error message
• Stack trace (truncated if very long)
• Screenshot path (Playwright auto-captures on failure)

Step 4: Generate Test Report

Create a test report at docs/test/<TASK-ID>.test-report.md:

# Test Report: <TASK-ID>

**Date**: <date>
**Branch**: feature/<TASK-ID>

## Summary

| Metric | Value |
|--------|-------|
| Total Tests | <count> |
| Passed | <count> |
| Failed | <count> |
| Skipped | <count> |
| Duration | <time> |
| Result | PASS / FAIL |

## Unit Tests
<results>

## E2E Tests (Playwright)
<results>

## Failed Tests Detail
### <test name>
- **Error**: <error message>
- **File**: <test file:line>
- **Stack**: <truncated stack trace>

## Screenshots
<list of failure screenshots if Playwright>

Step 5: Post Results to Jira

Use mcp__atlassian__jira_add_comment to post the test summary:

## Test Results: <TASK-ID>

**결과**: PASS / FAIL
**날짜**: <날짜>

| 유형 | 전체 | 통과 | 실패 |
|------|-------|--------|--------|
| Unit | <n> | <n> | <n> |
| E2E (Playwright) | <n> | <n> | <n> |

### Duration
- Unit: <시간>
- E2E: <시간>

### Failed Tests
<실패한 테스트 이름 및 간단한 오류, 없으면 "없음">

전체 리포트: docs/test/<TASK-ID>.test-report.md

테스트 리포트와 실패 스크린샷을 Jira 이슈에 첨부파일로 업로드:

# 1. 자격증명 확보 (환경변수 → .mcp.json → ~/.claude.json → settings)
JIRA_URL="${JIRA_URL:-}"
JIRA_USERNAME="${JIRA_USERNAME:-}"
JIRA_API_TOKEN="${JIRA_API_TOKEN:-}"

if [ -z "$JIRA_URL" ]; then
  _root="$(git rev-parse --show-toplevel 2>/dev/null)"
  # worktree인 경우 .jira-context.json의 repoRoot 사용
  if [ -f ".jira-context.json" ]; then
    _ctx_root=$(node -e "try{console.log(require('./.jira-context.json').repoRoot||'')}catch{console.log('')}" 2>/dev/null)
    [ -n "$_ctx_root" ] && _root="$_ctx_root"
  fi
  _top='const m=s.mcpServers?.atlassian||s.mcpServers?.jira||{};'
  _proj='const p=Object.values(s.projects||{}).find(p=>p.mcpServers?.atlassian||p.mcpServers?.jira);const pm=p?(p.mcpServers.atlassian||p.mcpServers.jira):{};'
  _env='const e=(m.env&&m.env.JIRA_URL?m:pm).env||{}'
  _extract="${_top}${_proj}${_env}"
  # $HOME(MSYS2: /c/Users/...)도, os.homedir()(Win: C:\Users\...)도
  # Node.js require() 안에서 문제 발생 → 슬래시 변환 필수
  _home=$(node -p "require('os').homedir().split(String.fromCharCode(92)).join('/')")
  for _f in "${_root}/.mcp.json" "${_home}/.claude.json" "${_root}/.claude/settings.local.json" "${_home}/.claude/settings.json"; do
    [ -f "$_f" ] || continue
    JIRA_URL=$(node -e "const s=require('$_f');${_extract};console.log(e.JIRA_URL||'')" 2>/dev/null)
    [ -n "$JIRA_URL" ] || continue
    JIRA_USERNAME=$(node -e "const s=require('$_f');${_extract};console.log(e.JIRA_USERNAME||'')" 2>/dev/null)
    JIRA_API_TOKEN=$(node -e "const s=require('$_f');${_extract};console.log(e.JIRA_API_TOKEN||'')" 2>/dev/null)
    break
  done
fi

AUTH=$(printf '%s:%s' "$JIRA_USERNAME" "$JIRA_API_TOKEN" | base64 | tr -d '\n')

# 2. 테스트 리포트 첨부
curl -s -o /dev/null -w "%{http_code}" -X POST \
  -H "Authorization: Basic $AUTH" \
  -H "X-Atlassian-Token: no-check" \
  -F "file=@docs/test/<TASK-ID>.test-report.md" \
  "${JIRA_URL}/rest/api/3/issue/<TASK-ID>/attachments"

# 3. Playwright 실패 스크린샷 첨부 (있는 경우)
find test-results/ playwright-report/ -name "*.png" -type f 2>/dev/null | while read -r screenshot; do
  curl -s -o /dev/null -w "%{http_code}: $screenshot\n" -X POST \
    -H "Authorization: Basic $AUTH" \
    -H "X-Atlassian-Token: no-check" \
    -F "file=@${screenshot}" \
    "${JIRA_URL}/rest/api/3/issue/<TASK-ID>/attachments"
done

• 리포트 및 각 스크린샷 업로드 결과를 확인하고 성공/실패 요약
• 업로드 실패한 파일은 로컬 경로를 코멘트에 추가

Step 6: Completion Summary

테스트 통과 시 .jira-context.json의 completedSteps에 "test" 추가 (실패 시 추가하지 않음). 테스트 결과에 따라 분기하여 완료 요약 출력:

테스트 통과 시:

---
✅ **Test Complete** — <TASK-ID>

- 전체: <N>개, 통과: <N>개, 실패: 0개
- 테스트 리포트: `docs/test/<TASK-ID>.test-report.md`
- Jira 코멘트 게시됨
- Jira 첨부파일: 리포트 + 스크린샷 <N>개 (또는 실패 시 로컬 경로 안내)

**Progress**: init → start → plan → design → impl → **test ✓** → review → merge → pr → done

**Next**: `/jira-task review <TASK-ID>` — 코드 리뷰를 실행합니다
---

테스트 실패 시:

---
⚠️ **Test Failed** — <TASK-ID>

- 전체: <N>개, 통과: <N>개, 실패: <N>개
- 실패 목록:
  - <test name>: <error summary>
- 테스트 리포트: `docs/test/<TASK-ID>.test-report.md`

**Progress**: init → start → plan → design → impl → **test ✗** → review → merge → pr → done

**Next**: 실패 항목 수정 후 `/jira-task test <TASK-ID>` 재실행
---