codecell-germany/facilioo-agent-skill

facilioo-agent-cli

使用するタイミング

このスキルは、Facilioo 内で実際の作業が必要であり、Web UI よりもターミナルワークフローが適している場合に使用します。

特に、エージェントが以下のタスクを実行する場合に使用します：

• ターミナルから Facilioo に対して認証を行う
• 物件、入り口、住戸、連絡先に関するコンテキストを構築する
• 問い合わせ、プロセス、作業指示、予定、ユーザータスク、通知、告知を確認する
• ドキュメントをダウンロードまたはアップロードする
• 会議の議題や議事録を操作する
• 生の HTTP 呼び出しをアドホックに行わず、ガード付きの更新を実行する

前提条件

• facilioo-agent-cli をプロダクトの操作面として扱います。
• まず、PATH 上に存在することを確認してください：
  • facilioo-agent-cli --help
  • facilioo-agent-skill --help
• 不足している場合は、公開パッケージからインストールします：
  • npm install -g @codecell-germany/facilioo-agent-skill
  • facilioo-agent-skill install --force
• レポジトリ内の dist/ フォルダ、隠れた Codex ツールフォルダ、古いローカル shim を介して公開 CLI をバイパスしないでください。
• CLI がすでにワークフローを提供しているのに、アドホックな Swagger 呼び出しから始めないでください。

初回実行の検出

Facilioo の実際の作業を行う前に、以下を実行します：

facilioo-agent-cli auth status --json
facilioo-agent-cli doctor --profile auth --json

以下のいずれかに該当する場合、環境は準備できていないと見なします：

• CLI が存在しない
• 永続化されたセッションがない
• 設定された認証方法が API キーログインであるが、API キーが利用できない
• doctor が失敗する
• ユーザーが初回セットアップであると述べている

セットアップが不完全な場合は、すぐにオンボーディングモードに切り替えます。 context、ops、documents、conferences から開始しないでください。

オンボーディングモード

新規または部分的に設定されたユーザー向けの正確な初回実行順序は次のとおりです：

1. セットアップがまだ完了していないことをユーザーに伝えます。
2. ユーザーの希望する言語で組み込みのセットアップガイドを表示します：
   • 英語: facilioo-agent-cli setup --language en
   • ドイツ語: facilioo-agent-cli setup --language de
3. まず静的な値のみを収集します：
   • FACILIOO_BASE_URL
   • FACILIOO_API_VERSION
   • FACILIOO_AUTH_METHOD
4. ターミナルに人間がいる場合は、ローカルパスワードフローをデフォルトとします：
   • facilioo-agent-cli auth login --method password --interactive --persist
5. ユーザーが技術的または自動化指向のセットアップを明示的に希望する場合のみ、APIキーログインを使用します：
   • FACILIOO_API_KEY
   • facilioo-agent-cli auth login --method api-key --persist
6. 以下のものを決して要求しないでください：
   • アクセストークン
   • リフレッシュトークン
   • 生のブラウザクッキー
7. ログイン後、以下を再実行します：
   • facilioo-agent-cli auth status --json
   • facilioo-agent-cli doctor --profile core-read --json
8. その後、ビジネスコマンドに進みます。

コアワークフロー

1. セットアップを検証する：
   • facilioo-agent-cli auth status --json
   • facilioo-agent-cli doctor --profile core-read --json
2. コンテキストを構築する：
   • facilioo-agent-cli context lookup --search "Musterstraße 12" --json
   • facilioo-agent-cli context property --id 123 --include entrances,units,tenant,documents,ops --json
   • facilioo-agent-cli context unit --id 456 --include documents,ops --json
3. 運用キューを処理する：
   • facilioo-agent-cli ops inbox --property-id 123 --json
   • facilioo-agent-cli ops processes search --property-id 123 --open-only --json
   • facilioo-agent-cli ops tasks mine --json
   • facilioo-agent-cli ops notifications mine --json
4. ドキュメントを操作する：
   • facilioo-agent-cli documents search --property-id 123 --search "Versicherung" --json
   • facilioo-agent-cli documents download --id 5001 --output /absolute/path/file.pdf --json
5. 会議を操作する：
   • facilioo-agent-cli conferences search --property-id 123 --json
   • facilioo-agent-cli conferences protocol --id 7001 --json

ガードレール

• 読み取り操作はデフォルトで安全です。
• 書き込みには以下が必要です：
  • --execute --confirm-write yes
• 公開されたすべての削除には以下が必要です：
  • --execute --allow-delete --confirm-delete yes
• センシティブな変更や削除の前には --preview を使用します。
• パスワードログインはインタラクティブのみであり、実際の TTY で人間がローカルに完了する必要があります。
• auth export はオプトインであり、別のプロセスが明示的に env エクスポートを必要とする場合にのみ使用します。
• トークンをプロンプト、チケット、チャット、スクリーンショットに貼り付けないでください。
• 高レベルコマンドが存在する場合、生の API パスを通常のルートとして扱わないでください。

削除ルール

削除ルールはこのスキルにおいてグローバルであり、プロセス固有のものだけではありません。

例：

facilioo-agent-cli ops processes delete --id 987 --preview --json
facilioo-agent-cli ops processes delete --id 987 --execute --allow-delete --confirm-delete yes --json

facilioo-agent-cli documents delete --id 5001 --preview --json
facilioo-agent-cli documents delete --id 5001 --execute --allow-delete --confirm-delete yes --json

ユーザーが明示的に削除を承認していない場合は、実行しないでください。

参考資料

• エージェントオンボーディング実行手順書: references/agent-onboarding.md
• 概要: references/overview.md
• コマンドチートシート: references/command-cheatsheet.md
• 初回実行セットアップ: references/facilioo-first-run.md