用途
ae-analysis 是 ae-cli 中面向分析侧意图与命令执行的单一入口技能，用于处理 AE 分析类数据问题、资产操作与资产治理。它负责分析查询与资产、元数据发现、受众定义、本地输入文件上传，以及治理、项目与埋点相关工作流。
主要能力
该技能覆盖以下 CLI 服务：
- analysis：报表、看板、BI 面板、即席分析、下钻、明细数据、告警、分群、标签，以及异步运行/产物。
- analysis-meta：网关元数据资产、事件、属性、虚拟元数据、指标、数据表、交换规则与超级元数据。跨源资产配置使用元数据 L3 目录。
- analysis-governance：网关资产治理操作，包括受治理资产列表/导出、血缘、依赖、影响、查询历史、规则模式/列表/创建/更新/删除、批量资产操作与操作记录。
- tracking：网关埋点计划、检查、摄取、实时数据与事件黑名单操作。
- personal-semantic-preference：当前用户项目范围内的个人语义偏好，用于在解析模糊业务措辞、资产选择或重复用户偏好前作为 Agent 上下文。
- project-semantic：为明确的项目知识库构建或刷新导出资产包。
使用方式
该技能以 ae-cli 作为唯一执行路径。使用前需在工作目录根部的 .ae/cli-agent-context.json 中维护当前 Agent 上下文，除非用户明确要求不发送意图遥测。上下文文件需使用 intent_source: "agent_context_file"，并包含简洁的任务级 user_intent、当前 session_goal、稳定的 agent_session_id、可用的 agent_turn_id、intent_relation 与 intent_revision。session_initial_intent、user_intent 与 session_goal 应使用用户原始语言。
路由流程：先将请求映射到命令族，再打开对应参考文档。已知命令族直接打开其专用参考；未知命令族使用 rg 或等效文本搜索工具在 references/command_index.md 中搜索匹配行，该文件仅作搜索回退，不得整文件读取或打印。选定命令后，在编写命令前阅读其专用参考文档。
数据查询流程：获取当前项目与请求的指标、窗口、分组和过滤器；在选择知识库或分析路由前应用项目语义知识与发现门控；复用已知资产与定义，通过元数据解析发现未知业务度量，再选择所需的已保存报表或即席命令/模型引用。新业务映射需确认一次，填写必需参数并执行适用的已保存报表或完成即席定义。依赖查询中复用已确认含义。
适用场景
适用于分析侧数据查询、报表与看板发现、即席分析、下钻与明细数据、告警、分群与标签管理、元数据发现、资产治理、埋点计划与检查、个人语义偏好查询，以及项目知识库构建或刷新等场景。
限制
- 互动操作与元数据数据表写入/维度绑定不在该技能工作流范围内。
- 查询行不会自动成为持久化受众。
- 已保存报表写入遵循分析页面产品边界：analysis report create/update 最多接受一个复合过滤层级，该组 items 中每个条目必须是叶子过滤器。
- 若命令缺失、不支持、未实现或确认存在能力缺口，应报告该缺口，不得切换到直接 MCP 执行。
- 传输失败（如 fetch failed）表示结果不可用：应报告错误及已获得的结果并停止依赖请求，不得启动路由探测、休眠或后台网络轮询。
- 对于 CLI Agent 资产认证与指标推荐审查，仅在用户明确要求自动审查或自动认证时调用 auto-review。
- 预授权的无人值守任务只能提交审查提案，不得自动调用 agent-review review|retry、旧版 governance-recommendation submit、governance-recommendation auto-review 或直接认证/指标变更。
- 不得使用 project-semantic、project-KB 或 personal-semantic-preference 命令作为该工作流的前置上下文。
- 不得使用 asset-authentication list|export|update 等管理命令或指标 CRUD 命令来合成推荐。
- 不得绕过精选命令使用 ae-cli capability inspect|validate|dry-run|run 处理 governance.asset_authentication.dashboard_package、metadata.metric.recommended_scan 或 metadata.metric.recommended_create。
- 报告审查详情必须解释计算逻辑与统计度量，而不仅是业务目的。
- 不得猜测 SQL、别名、列、公式、时间范围、时区或成功执行。
跨技能协作
当剩余工作超出该技能范围，或必要前置条件需要其他能力时，遵循协作协议：从本次运行中可用的技能中按能力选择，保留已验证上下文，并继续剩余任务。若协议已加载则复用。