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 生成的场次报告
• 分析客服私信、客户售后群和游戏内聊天
• 通过 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 需要 --space-id、--channel-id 和 --source-id，这些参数的值须为正 int64 标识符。此处的 --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
单个角色／IP 深度分析	community-character-analysis.md
单个话题的时间线及行动	community-hottopic-insight.md
官方帖子分类	community-analyzing-official-content.md
评论串深入分析	community-analyzing-theme-comment.md
客服、售后群或游戏内聊天	community-chat-analysis.md
报告、导入或提交社区／企业微信聊天数据	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，了解场景选择、按调用范围划分身份、 对比时间窗口、指标定义、证据限制和报告模板。没有员工身份列表时，绝不要报告客服绩效。 对于所选服务范围，即使问题只涉及单个 Agent，也必须提供完整的员工名册；不完整的名册仅用于发现， 不能据此计算 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 或标准输入（-），避免载荷进入 shell 历史记录。
5. 首次提交数据集前，运行 --dry-run。其摘要已脱敏，不会输出业务内容。
6. 用户明确要求提交后，直接运行 risk: write 命令。无需使用 --yes 或再次确认。
7. 仅当返回 status: "queued" 且 persistence_verified: false 时，才将其视为成功；这绝不代表逐条记录已被接受或已持久化存储。
8. 超时意味着投递状态未知。考虑再次提交前，请检查下游查询/存储端；绝不要自动重试。

---

Dry-run 调试

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 的命令才需要经过确认。