ae-community

ae-community

スキル間の連携

残りの作業がこのスキルの範囲外である場合、または必要な前提条件に別の機能が必要な場合は、連携プロトコルに従ってください。この実行で利用できるスキルから必要な機能に応じて選び、検証済みのコンテキストを保持したうえで、残りのタスクを続行してください。すでに読み込まれている場合は、このプロトコルを再利用してください。

スキルのリビジョン：2.4.2。

AE Community ドメインでは、ソーシャルデータとチャットデータの分析、および検証済みのコミュニティデータのレポートを提供します。キュレーション済みの分析コマンドは ae-cli community +<subcommand> として実行します。チャット分析では動的な Capability Gateway コマンドを使用し、レポートには直接の ae-cli community data report 取り込みコマンドを使用します。

ルート	CLI サービス	担当
community_content	community	投稿、コメント、コーパスタグ、検索、ライブ配信コンテンツ、リスクコンテンツ
community_analysis	community	チャンネル一覧、概要指標、センチメント、タグのトレンド
community_hot	community	日次サマリー、ホットトピック、トピックの詳細分析
community.chat.*	community Capability Gateway	チャット概要、参加者の特定、名簿に基づくサービス指標、意図・リスクの詳細分析、生の証拠
直接取り込みデータプレーン	community data report	コミュニティのレコードを検証、正規化し、明示された Iris /sync_content エンドポイントに送信

---

AE CLI のグローバルルール

AE CLI（ae-cli）は、AE（Agentic Engine）分析プラットフォームのコマンドラインツールです。AE 分析側のリクエストでは、モデルの記憶よりも ae-cli とこのスキルのリファレンスドキュメントを優先してください。

グローバルパラメーター：

パラメーター	説明
--format <json|table>	出力形式です。デフォルトは JSON です。
--jq <expr>	JSON 出力用の jq フィルター式です。
--host <url>	分析側のコマンドで有効な AE ホストを上書きします。サブコマンドの後に指定してください。例：ae-cli community +<command> --host <url>。community data report では意図的に使用できません。こちらでは --endpoint を使用してください。

出力とエラー：

• コマンドが成功すると、デフォルトで機械可読な JSON が返されます。エンベロープには任意の _notice.host_compat が含まれる場合があります。
• コマンドが失敗すると、{ "ok": false, "error": { "type": "...", "message": "...", "hint": "..." } } が返され、ゼロ以外の終了コードで終了します。
• 重要 — ホスト互換性（最初に実行）： ae-cli を実行するたびに、stderr と _notice.host_compat を確認してください。どちらかが存在する場合は、ユーザーへの返信の冒頭に短いバージョン警告を記載し、npm i -g / npx skills add（または update-cluster）の行を一字一句そのまま引用してから、処理結果を提示してください。これはソフトヒントです。ok: true でも通知が含まれる場合があります。

安全上の制約：

• 必要な ID と参照が検証済みであれば、読み取りコマンドは直接実行できます。
• 通常の write コマンドにはユーザーの明示的な意図が必要ですが、CLI での確認は不要です。確認ゲートを使用するのは high-risk-write コマンドのみです。
• コマンド名、フラグ、JSON ペイロード、project_id、リソース ID、フィールド名、イベント名、プロパティ名、指標の定義、日付形式を決して作り出さないでください。対応するコマンドリファレンスを読み、実際のプロジェクトメタデータを先に確認してください。
• リソース名（レポート、ダッシュボード、イベント、プロパティ、指標、クラスター、タグ、アラート）を決して捏造したり、推測したりしないでください。 必ずリストコマンドを使って、実在するリソースを先に確認してください。あいまい検索と全リストへのフォールバックを行ってもリソースが見つからない場合は、ユーザーに「リソースが見つかりません」と明示して停止してください。捏造した名前で処理を続行してはいけません。

Community コマンドでは、このスキルのドメインである community を使用します。AE のその他のドメインには、analysis（分析とオーディエンス）、analysis-meta（メタデータ）、operation（オペレーション）があります。

概要

一般的なユースケース：

• 投稿や動画を検索して確認し、詳細やコメント分析をさらに掘り下げる
• 期間を指定して、感情、キーワード／タグ、全体指標を追跡する
• リスクのあるコンテンツやモデレーション対象のコンテンツを監視する
• ライブ配信ルームやセッション、AI が生成したセッションレポートを分析する
• カスタマーサービスの DM、アフターサービスグループ、ゲーム内チャットを分析する
• references/community-*.md にある複合リファレンスを使用して、日次／週次／アクティビティ形式のレポートを作成する

コマンドごとのフラグやコピー＆ペースト用の例については、references/ 内のファイルを使用してください。

---

パラメーターの規則

項目	説明
--space-id	コミュニティスペース ID（数値）
--game-id	ゲーム／スペース識別子（数値）
--channel-id / --channel-id-list	チャンネル ID がわかった後に必要になることがよくあります（下記のチャンネル ID の前提条件を参照）
グローバルオプション	他のドメインと同じです：--host、--mcp-url、--format、--jq、--dry-run、--yes

• リスト（カンマ区切り）： 例：--channel-id-list 1,2,3、--keywords a,b、--sentiment-types 0,1
• 日付： 期間の開始日と終了日には yyyy-MM-dd を使用します（例：--start-time、--end-time、--date）
• データレポート： community data report では、正の int64 識別子として --space-id、--channel-id、--source-id が必要です。ここで --space-id は Iris の game_id に対応します。
• レポートのエンドポイント： --endpoint または AE_IRIS_SYNC_ENDPOINT を使用します。--host で取り込みエンドポイントを選択、導出、変更することはできません。
• レポート入力： 次のいずれか一方のモードを使用します：--data-type <type> --data <inline|path|@path|->、または --payload <inline|path|@path|->。
• レポートスキーマ： 入力を作成する前に ae-cli community data report --help を実行し、サポートされている各 data_type で必須となるレコードフィールドを確認してください。フィールドの制限と正規化の動作については、レポートリファレンスを使用してください。

---

基本概念

チャンネル ID の前提条件（+get_channel_info）

多くのコマンドでは、--channel-id または --channel-id-list が必要です（投稿の詳細、コメントの概要、ライブ配信一覧、チャンネルを指定した検索など）。--space-id／--game-id しかない場合は、次を実行してください：

ae-cli community +get_channel_info --space-id <id> --game-id <id>

その後、返されたチャンネル ID を後続のコマンドで使用します。詳細：references/get_channel_info.md。

---

シナリオ別の案内

ユーザーの目的に合う場合は、複合ワークフローを案内してください：

ユーザーの目的	こちらから始めてください
単日運用レポート、T-1 と T-2 の比較	community-daily-report.md
週次の集計	community-weekly-report.md
アクティビティ／キャンペーンのインサイト	community-activity-analysis.md
1 人のキャラクター／IP の詳細分析	community-character-analysis.md
単一トピックのタイムラインと対応策	community-hottopic-insight.md
公式投稿の分類体系	community-analyzing-official-content.md
コメントスレッドの詳細分析	community-analyzing-theme-comment.md
カスタマーサービス、アフターサービスグループ、ゲーム内チャット	community-chat-analysis.md
コミュニティ／WeCom チャットデータのレポート、インポート、送信	community-data-report.md

---

一般的なシナリオ

1. 検索とコンテンツの詳細確認

ae-cli community +search_posts --space-id 1 --game-id 1 \
  --start-time 2026-04-01 --end-time 2026-04-07

ae-cli community +get_post_detail --space-id 1 --game-id 1 \
  --channel-id 1 --uuid <uuid> --resource-type 0

ae-cli community +get_comments_summary --space-id 1 --game-id 1 \
  --channel-id 1 --uuid <uuid>

2. 分析と感情

ae-cli community +get_channel_info --space-id 1 --game-id 1

ae-cli community +get_overview_metrics --space-id 1 --game-id 1 \
  --start-time 2026-04-01 --end-time 2026-04-07

ae-cli community +get_sentiment_overview --space-id 1 --game-id 1 \
  --start-time 2026-04-01 --end-time 2026-04-07

3. 話題のトピックと日次スナップショット

ae-cli community +get_hot_topics --space-id 1 --game-id 1

ae-cli community +get_daily_summary --space-id 1 --game-id 1 --date 2026-04-01

4. ライブ配信

ae-cli community +get_livestream_list --space-id 1 --game-id 1

ae-cli community +get_livestream_detail --space-id 1 --game-id 1 --stream-id <id>

ae-cli community +get_livestream_analysis --space-id 1 --game-id 1 --stream-id <id>

5. チャット分析

チャット機能はL3であり、使用前に確認する必要があります。シナリオの選択、 呼び出し単位のアイデンティティ分類、比較期間、指標の定義、エビデンスの制限、レポートテンプレートについては、 community-chat-analysis.mdをお読みください。スタッフのアイデンティティ一覧がない状態で、 カスタマーサービスのパフォーマンスを報告してはいけません。 この一覧には、単一エージェントに関する質問であっても、選択したサービス範囲のスタッフ全員を含める必要があります。部分的なスタッフ一覧は確認時の情報であり、KPIの計算を許可するものではありません。

ae-cli capability search "chat" --domain community
ae-cli capability inspect community.chat.overview
ae-cli capability run community.chat.overview \
  --input '{"game_id":3,"start":"<start-yyyy-MM-dd>","end":"<end-yyyy-MM-dd>"}'

6. データレポート

入力データを作成する前に、community-data-report.mdをお読みください。明示的に指定された取り込みエンドポイントと検証済みのIDを使用し、アクティブなAEホストや分析結果から導出してはいけません。

ae-cli --dry-run community data report \
  --endpoint https://<iris-ingress>/sync_content \
  --space-id <space-id> --channel-id <channel-id> --source-id <source-id> \
  --data-type chat --data @chat.json

ae-cli community data report \
  --endpoint https://<iris-ingress>/sync_content \
  --space-id <space-id> --channel-id <channel-id> --source-id <source-id> \
  --data-type chat --data @chat.json

データレポートのワークフロー

1. ユーザーまたはAE_IRIS_SYNC_ENDPOINTから、完全な/sync_contentエンドポイントを取得します。推測、導出、連結はしないでください。
2. 実際のスペース、チャンネル、ソースのIDを検証します。識別子を捏造してはいけません。--space-idはIrisのgame_idになります。
3. レコードを作成する前に、ae-cli community data report --helpを実行します。各data_typeの必須フィールドは、インストール済みコマンドの一覧を正として使用し、詳細な制限事項と正規化についてはレポートのリファレンスを参照します。
4. 機密レコードでは、ペイロードがシェルの履歴に残らないよう、@fileまたは標準入力（-）を優先します。
5. データセットを初めて送信する前に、--dry-runを実行します。要約は秘匿化され、業務内容は出力されません。
6. ユーザーが送信を明確に依頼した後は、risk: writeコマンドを直接実行します。--yesや別の確認は必要ありません。
7. 成功とみなせるのは、status: "queued"かつpersistence_verified: falseの場合のみです。レコードごとの受理や永続的な保存を意味するものとして扱ってはいけません。
8. タイムアウトした場合、配信状態は不明です。再送を検討する前に、下流のクエリ／ストレージ側を確認し、自動的に再試行してはいけません。

---

ドライランのデバッグ

ae-cli --dry-run community +get_channel_info --space-id 1 --game-id 1
ae-cli --dry-run community +search_posts --space-id 1 --game-id 1 \
  --start-time 2026-04-01 --end-time 2026-04-07

---

リファレンス（コマンド別）

トピック	ドキュメント
チャンネル一覧（前提条件）	get_channel_info.md
投稿／動画の検索	search_posts.md
投稿／動画の詳細	get_post_detail.md
コーパスタグ／tagCode	get_corpus_tags.md
コメントの要約	get_comments_summary.md
コメントタグ分析	get_comment_tag_analysis.md
感情の概要	get_sentiment_overview.md
概要指標	get_overview_metrics.md
ホットトピック	get_hot_topics.md
トピックの詳細	get_topic_detail.md
タグのトレンド	get_tag_trends.md
日次サマリー	get_daily_summary.md
リスクコンテンツ	get_risk_content.md
ライブ配信ルーム／一覧／詳細／分析／概要／ルーム指標	get_livestream_rooms.md、get_livestream_list.md、get_livestream_detail.md、get_livestream_analysis.md、get_livestream_overview.md、get_livestream_room_metrics.md
カスタマーサービス、アフターサービスグループ、ゲーム内チャットのワークフロー	community-chat-analysis.md
コミュニティデータのレポート、スキーマ、キュー登録の意味	community-data-report.md

---

コマンドグループ

以下のコマンドは、ae-cli community のプレフィックスを付けずに記載しています。CLI ではすべて + プレフィックスを使用します。

コンテンツ（community_content）

+get_livestream_list、+get_livestream_detail、+get_livestream_analysis、+get_post_detail、+get_comments_summary、+get_comment_tag_analysis、+get_corpus_tags、+get_risk_content、+search_posts、+get_livestream_overview、+get_livestream_rooms、+get_livestream_room_metrics

分析（community_analysis）

+get_channel_info、+get_overview_metrics、+get_sentiment_overview、+get_tag_trends

トレンド（community_hot）

+get_daily_summary、+get_hot_topics、+get_topic_detail

データレポート（直接取り込みデータプレーン）

コマンド	リスク	エンドポイント	入力
data report	write	--endpoint または AE_IRIS_SYNC_ENDPOINT。--host は使用しないでください	--data-type と --data、または --payload

---

複合シナリオスキル

構造化された複数ステップのレポートワークフローです。リンク先のリファレンスを開くと、ae-cli コマンドの全手順を確認できます。

スキル	目的
community-activity-analysis.md	アクティビティ／マーケティングイベントの分析
community-daily-report.md	日次速報（T-1 対 T-2）
community-character-analysis.md	キャラクター／IP の詳細分析
community-hottopic-insight.md	単一トピックの変遷と対応策
community-weekly-report.md	週次運用サマリー
community-analyzing-official-content.md	公式コンテンツの分類体系
community-analyzing-theme-comment.md	テーマ別コメント欄の分析

---

書き込み操作

ほとんどのコミュニティコマンドは読み取り専用です。community data report は通常の risk: write コマンドです。ユーザーの明示的な意図があれば十分で、確認や --yes は必要ありません。確認ゲートを使用するのは、risk: high-risk-write とマークされたコマンドのみです。