rudrankriyam/asc-workflow

asc-workflow은(는) 무엇을 하나요?

저장소 내에서 멀티스텝 자동화를 정의, 검증, 실행, 재개 및 감사합니다. asc workflow 명령어와 .asc/workflow.json 설정 파일을 사용하며, 스텝 출력 및 안전한 릴리스/TestFlight 워크플로우를 지원합니다.

개요

이 스킬은 개발자가 반복적이거나 복잡한 작업(예: 앱 빌드, 코드 서명, 앱 스토어 커넥트 업로드, TestFlight 배포)을 안전하고 감사 가능한 방식으로 자동화할 수 있도록 설계되었습니다. 각 워크플로우는 .asc/workflow.json 파일에 정의된 여러 스텝으로 구성됩니다.

설치

저장소 루트에 .asc/workflow.json 파일을 생성하세요. 그런 다음 asc workflow 명령어를 실행하여 워크플로우를 관리합니다.

사용법

워크플로우 정의

.asc/workflow.json 파일에서 워크플로우를 정의합니다:

{
  "workflows": {
    "release": {
      "description": "앱 스토어 릴리스 워크플로우",
      "steps": [
        {
          "name": "버전 번호 설정",
          "command": "agvtool new-marketing-version $(cat VERSION)"
        },
        {
          "name": "앱 아카이브",
          "command": "xcodebuild archive -scheme MyApp -archivePath build/MyApp.xcarchive"
        },
        {
          "name": "앱 스토어 커넥트 업로드",
          "command": "xcodebuild -exportArchive -archivePath build/MyApp.xcarchive -exportPath build/ -exportOptionsPlist exportOptions.plist"
        }
      ]
    },
    "testflight": {
      "description": "TestFlight 배포 워크플로우",
      "steps": [
        {
          "name": "TestFlight 빌드",
          "command": "xcodebuild -scheme MyApp -configuration Debug -destination 'generic/platform=iOS' build"
        },
        {
          "name": "TestFlight 업로드",
          "command": "xcrun altool --upload-app -f build/MyApp.ipa -u $APP_STORE_CONNECT_USERNAME -p $APP_STORE_CONNECT_PASSWORD"
        }
      ]
    }
  }
}

워크플로우 실행

asc workflow run release

워크플로우 재개

실패한 워크플로우를 중단된 지점부터 재개하려면:

asc workflow resume <workflow-id>

워크플로우 감사

과거 워크플로우 실행 내역을 보려면:

asc workflow audit

스텝 출력 사용

각 스텝의 출력을 캡처하고 후속 스텝에서 참조할 수 있습니다. 스텝에서 outputs 필드를 정의하면 됩니다:

{
  "steps": [
    {
      "name": "버전 계산",
      "command": "echo \"1.2.3\"",
      "outputs": {
        "version": "stdout"
      }
    },
    {
      "name": "아카이브 생성",
      "command": "echo \"Building version ${{ steps.버전_계산.outputs.version }}\""
    }
  ]
}

환경 변수

다음 환경 변수를 설정하여 워크플로우에서 사용할 수 있습니다:

• APP_STORE_CONNECT_USERNAME: 앱 스토어 커넥트 사용자 이름
• APP_STORE_CONNECT_PASSWORD: 앱 스토어 커넥트 비밀번호
• ASC_WORKFLOW_DIR: 워크플로우 정의 파일의 디렉토리 (기본값: .asc/)

지원 플랫폼

• Claude Code
• 기타 asc workflow 명령어를 지원하는 AI 에이전트

보안 참고사항

민감한 자격 증명(예: 비밀번호, API 키)을 워크플로우 정의 파일에 직접 저장하지 마십시오. 대신 환경 변수 또는 안전한 비밀 저장소를 사용하세요.

라이선스

이 스킬은 MIT 라이선스에 따라 제공됩니다.