Communitygithub.com

sixers/fakturownia-cli

Fakturownia API 向けのエージェントファーストなGo CLIです。

fakturownia-cli とは?

このスキルは、Fakturownia API と対話するためのエージェントファーストなGo CLI「fakturownia」を提供します。認証、アカウント、請求書、製品、倉庫管理など、幅広いビジネス機能をカバーするサブスキルが用意されており、エージェントはタスクの内容に応じて適切なサブスキルを選択して実行できます。スキルを使う前に、`fakturownia --version` でバイナリが利用可能であることを確認し、`fakturownia auth login` で認証情報を保存する必要があります。各サブスキルは README に基づいたリクエストとレスポンスのスキーマを提供し、エージェントはそれを参考にAPI呼び出しを生成します。JSON 出力、フィールド指定、Raw モードなど、複数の出力モードに対応しており、エージェントによる自動処理を強力に支援します。

対応✓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 上で利用可能であることを確認してください。
  • API コールの前に fakturownia auth login --prefix acme --api-token "$FAKTUROWNIA_API_TOKEN" で認証情報を保存してください。
  • 環境が既に認証情報を提供している場合でも、fakturownia auth status --json を実行して、解決されたプロファイル、プレフィックス、トークンのソースを確認してください。
  • タスク固有の書き込みや読み取りを行う前に、認証済みの動作確認として fakturownia account get --json を最初に実行してください。

サブスキル

  • fakturownia-shared: Fakturownia CLI 共有パターン: 認証の前提条件、グローバルフラグ、出力モード、--fields と --columns、--raw、スキーマ探索、バイナリメンテナンス。特定の Fakturownia タスクの前に使用します。
  • fakturownia-auth: Fakturownia CLI 認証: fakturownia auth ... でプロファイルと API トークンを永続化、確認、削除します。
  • fakturownia-accounts: Fakturownia CLI アカウント: README ベースのアカウント契約に従い、整形された構造化出力とオプションのプロファイル永続化を用いて、システムアカウントを作成、確認、削除、リンク解除します。
  • fakturownia-departments: Fakturownia CLI 部門: 部門の一覧表示、取得、作成、更新、削除、ロゴのアップロードを、README ベースのリクエストおよび出力探索で行います。
  • fakturownia-issuers: Fakturownia CLI 発行者: README ベースのフィールドとペイロード探索により、発行者の一覧表示、取得、作成、更新、削除を行います。
  • fakturownia-users: Fakturownia CLI ユーザー: README ベースのユーザー追加エンドポイントを通じてアカウントユーザーを作成または招待し、受け入れられたユーザーペイロードの形状を検査します。
  • fakturownia-webhooks: Fakturownia CLI Webhook: README ベースの控えめなリクエストおよび出力探索により、Webhook の一覧表示、取得、作成、更新、削除を行います。
  • fakturownia-categories: Fakturownia CLI カテゴリ: カテゴリの一覧表示、取得、作成、更新、削除、および README ベースのカテゴリフィールドとリクエストスキーマの検査を行います。
  • fakturownia-clients: Fakturownia CLI クライアント: クライアントの一覧表示、取得、作成、更新、削除、および README ベースのクライアントフィールドとリクエストスキーマの検査を行います。
  • fakturownia-payments: Fakturownia CLI 支払い: README ベースの include=invoices リストモードとリクエストボディ探索を含む、銀行支払いの一覧表示、取得、作成、更新、削除を行います。
  • fakturownia-bank-accounts: Fakturownia CLI 銀行口座: 銀行口座の一覧表示、取得、作成、更新、削除、および請求書ペイロードにも影響する銀行口座の補足フィールドの検査を行います。
  • fakturownia-products: Fakturownia CLI 製品: 倉庫対応の読み取りと README ベースのリクエストスキーマを含む、製品の一覧表示、取得、作成、更新、削除を行います。
  • fakturownia-price-lists: Fakturownia CLI 価格リスト: アップストリーム形状のポジションペイロードとスキーマベースの探索を含む、価格リストの一覧表示、取得、作成、更新、削除を行います。
  • fakturownia-invoices: Fakturownia CLI 請求書: 一覧表示、取得、作成、更新、削除、電子メール送信、キャンセル、API ネイティブの gov フローによる KSeF 送信、請求書添付ファイルのダウンロード、およびスキーマ出力による請求書フィールドとペイロードの探索を行います。
  • fakturownia-recurrings: Fakturownia CLI 定期請求書: README ベースのリクエストおよび出力探索により、定期請求書定義の一覧表示、作成、更新、削除を行います。
  • fakturownia-warehouses: Fakturownia CLI 倉庫: README ベースの倉庫フィールドとリクエストスキーマの検査を含む、倉庫の一覧表示、取得、作成、更新、削除を行います。
  • fakturownia-warehouse-actions: Fakturownia CLI 倉庫操作: 明示的な README ベースのフィルターを使用して倉庫操作を一覧表示し、スキーマ出力を通じて控えめな操作フィールドを検査します。
  • fakturownia-warehouse-documents: Fakturownia CLI 倉庫文書: 種類選択とペイロードフィールドによる請求書リンクを含む、倉庫文書の一覧表示、取得、作成、更新、削除を行います。
  • fakturownia-schema: Fakturownia CLI スキーマ探索: fakturownia schema ... でサポートされているコマンド、フラグ、例、終了コード、出力スキーマを検査します。
  • fakturownia-doctor: Fakturownia CLI 診断: fakturownia doctor run で設定解決、認証情報ストアへのアクセス、到達可能性、認証済み API アクセス、リリース整合性を検証します。

レシピ

  • レシピインデックス を開き、アップストリームの README から高レベルの請求書および定期請求書ワークフローを確認します。

CLI エントリポイント

fakturownia --help

関連スキル