Communitygithub.com

sixers/fakturownia-cli

AI 에이전트를 위한 Go 기반 Fakturownia API CLI

fakturownia-cli란 무엇인가요?

이 스킬은 Fakturownia API와 상호작용하기 위해 설계된 AI 에이전트 친화적인 Go CLI인 `fakturownia`를 사용하는 방법을 설명합니다. 청구서, 제품, 고객, 창고, 웹훅 등과 같은 엔티티를 포함한 Fakturownia 플랫폼의 거의 모든 측면을 다루는 다양한 하위 스킬로 구성된 번들입니다. 이 스킬을 사용하면 에이전트는 인증, 계정 관리, 송장 처리, 창고 작업 등을 수행할 수 있습니다. 이 CLI는 JSON 출력, 필드 선택, 스키마 검색 및 프로필 관리를 지원하여 에이전트가 단계별 지침과 구조화된 데이터를 사용하여 작업을 효율적으로 수행할 수 있도록 합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add sixers/fakturownia-cli

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

go run ./cmd/gen-skills로 자동 생성되었습니다. 수동으로 편집하지 마세요.

fakturownia

이것을 생성된 Fakturownia CLI 스킬 번들의 진입점으로 사용하십시오.

시작하기

  1. 스킬 인덱스를 열어 적절한 하위 스킬을 선택합니다.
  2. fakturownia-shared를 읽어 인증 전제 조건, 전역 플래그, 출력 동작 및 스키마 검색을 확인합니다.
  3. 그런 다음 작업 영역과 일치하는 하위 스킬을 엽니다.

사용 전 확인 사항

  • 작업별 명령을 시도하기 전에 fakturownia --version을 사용하여 fakturownia가 PATH에 이미 있는지 확인합니다.
  • fakturownia auth login --prefix acme --api-token "$FAKTUROWNIA_API_TOKEN"으로 API 호출 전에 자격 증명을 저장합니다.
  • 환경에 이미 자격 증명이 제공된 경우에도 fakturownia auth status --json을 실행하여 확인된 프로필, 접두사 및 토큰 소스를 확인합니다.
  • 작업별 쓰기 또는 읽기를 시도하기 전에 첫 번째 인증된 스모크 테스트로 fakturownia account get --json을 실행합니다.

하위 스킬

  • fakturownia-shared: Fakturownia CLI 공통 패턴: 인증 전제 조건, 전역 플래그, 출력 모드, --fields vs --columns, --raw, 스키마 검색, 바이너리 유지 관리. 영역별 fakturownia 작업 전에 사용합니다.
  • fakturownia-auth: Fakturownia CLI auth: 프로필 및 API 토큰을 유지, 검사 및 제거합니다(fakturownia auth ... 사용).
  • fakturownia-accounts: Fakturownia CLI accounts: README 기반 계정 규약을 사용하여 시스템 계정을 생성, 검사, 삭제 및 연결 해제합니다(정리된 구조화된 출력 및 선택적 프로필 유지 포함).
  • fakturownia-departments: Fakturownia CLI departments: 부서 로고를 나열, 가져오기, 생성, 업데이트, 삭제 및 업로드합니다(README 기반 요청 및 출력 검색 포함).
  • fakturownia-issuers: Fakturownia CLI issuers: README 기반 필드 및 페이로드 검색을 사용하여 발행자를 나열, 가져오기, 생성, 업데이트 및 삭제합니다.
  • fakturownia-users: Fakturownia CLI users: README 기반 add-user 엔드포인트를 통해 계정 사용자를 생성 또는 초대하고 허용된 사용자 페이로드 모양을 검사합니다.
  • fakturownia-webhooks: Fakturownia CLI webhooks: 보수적인 README 기반 요청 및 출력 검색을 사용하여 웹훅을 나열, 가져오기, 생성, 업데이트 및 삭제합니다.
  • fakturownia-categories: Fakturownia CLI categories: README 기반 카테고리 필드 및 요청 스키마를 검사하면서 카테고리를 나열, 가져오기, 생성, 업데이트 및 삭제합니다.
  • fakturownia-clients: Fakturownia CLI clients: README 기반 클라이언트 필드 및 요청 스키마를 검사하면서 클라이언트를 나열, 가져오기, 생성, 업데이트 및 삭제합니다.
  • fakturownia-payments: Fakturownia CLI payments: README 기반 include=invoices 목록 모드 및 요청 본문 검색을 포함하여 은행 결제를 나열, 가져오기, 생성, 업데이트 및 삭제합니다.
  • fakturownia-bank-accounts: Fakturownia CLI bank accounts: 은행 계좌를 나열, 가져오기, 생성, 업데이트 및 삭제하고 송장 페이로드에도 영향을 미치는 bank-account 추가 필드를 검사합니다.
  • fakturownia-products: Fakturownia CLI products: 창고 인식 읽기 및 README 기반 요청 스키마를 포함하여 제품을 나열, 가져오기, 생성, 업데이트 및 삭제합니다.
  • fakturownia-price-lists: Fakturownia CLI price lists: 업스트림 형태의 포지션 페이로드 및 스키마 기반 검색을 포함하여 가격표를 나열, 가져오기, 생성, 업데이트 및 삭제합니다.
  • fakturownia-invoices: Fakturownia CLI invoices: 송장을 나열, 가져오기, 생성, 업데이트, 삭제, 이메일 전송, 취소, API 네이티브 gov 흐름을 통해 KSeF로 전송하고 송장 첨부 파일을 다운로드하며 스키마 출력을 통해 송장 필드 및 페이로드를 검색합니다.
  • fakturownia-recurrings: Fakturownia CLI recurrings: README 기반 요청 및 출력 검색을 사용하여 반복 송장 정의를 나열, 생성, 업데이트 및 삭제합니다.
  • fakturownia-warehouses: Fakturownia CLI warehouses: README 기반 창고 필드 및 요청 스키마를 검사하면서 창고를 나열, 가져오기, 생성, 업데이트 및 삭제합니다.
  • fakturownia-warehouse-actions: Fakturownia CLI warehouse actions: 명시적인 README 기반 필터를 사용하여 창고 작업을 나열하고 스키마 출력을 통해 보수적인 작업 필드를 검사합니다.
  • fakturownia-warehouse-documents: Fakturownia CLI warehouse documents: 종류 선택 및 페이로드 필드를 통한 송장 연결을 포함하여 창고 문서를 나열, 가져오기, 생성, 업데이트 및 삭제합니다.
  • fakturownia-schema: Fakturownia CLI schema discovery: fakturownia schema ...로 지원되는 명령, 플래그, 예제, 종료 코드 및 출력 스키마를 검사합니다.
  • fakturownia-doctor: Fakturownia CLI diagnostics: fakturownia doctor run으로 구성 해석, 자격 증명 저장소 액세스, 연결 가능성, 인증된 API 액세스 및 릴리스 무결성을 검증합니다.

레시피

  • 상위 README의 고급 송장 및 반복 워크플로를 보려면 레시피 인덱스를 엽니다.

CLI 진입점

fakturownia --help

관련 스킬