github/create-github-action-workflow-specification

create-github-action-workflow-specification은(는) 무엇을 하나요?

기존 GitHub Actions CI/CD 워크플로에 대한 공식 명세를 생성하여, AI 소비와 워크플로 유지보수에 최적화합니다.

개요

이 작업(스킬)은 주어진 GitHub Actions 워크플로 파일을 분석하고, 구조화된 명세서를 자동으로 생성합니다. 명세서에는 다음 정보가 포함됩니다:

• 워크플로 이름 및 설명
• 트리거 이벤트(on: push, pull_request, schedule 등)
• 실행 환경(runs-on) 및 매트릭스
• 각 잡(job)의 의존성 및 조건
• 모든 스텝의 상세 설명
• 사용된 액션, 스크립트, 셸 명령
• 환경 변수, 시크릿 및 출력

사용 방법

1. 워크플로 파일 내용을 제공하거나 저장소 내 .github/workflows/ 폴더의 경로를 지정합니다.
2. 이 스킬은 제공된 파일을 구문 분석하여 마크다운 형식의 명세를 반환합니다.
3. 결과 명세는 AI 에이전트가 워크플로를 이해하고 수정하거나 최적화할 때 사용할 수 있습니다.

입력

• workflow_content (선택): 워크플로 파일의 전체 YAML 내용입니다.
• workflow_path (선택): 저장소 내 .github/workflows/ 기준 상대 경로입니다. (예: deploy.yml)

출력

생성된 명세는 다음 구조를 따릅니다:

# 워크플로 이름

**설명**: ...

## 트리거

- `push`: `main` 브랜치
- `pull_request`: `develop` 브랜치

## 잡

### build

- **runs-on**: ubuntu-latest
- **의존성**: 없음
- **스텝**:
  1. `actions/checkout@v4` - 저장소 체크아웃
  2. Run `npm ci` - 의존성 설치

예시

다음은 ci.yml 워크플로에 대한 명세 예시입니다:

name: CI
on: [push]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm test

명세:

요소	값
이름	CI
트리거	push
잡	test
환경	ubuntu-latest
액션	actions/checkout@v4
스크립트	npm test

참고 사항

• 명세는 원본 워크플로의 정확한 동작을 유지하며, 문서화만 추가합니다.
• 파일에 주석이 있는 경우 명세에 포함하여 설명을 보강할 수 있습니다.
• 이 명세는 AI 어시스턴트가 워크플로를 수정할 때 참조용으로 사용됩니다.

관련 자료

• GitHub Actions 문서
• 워크플로 구문