Agent Skills
返回列表
AEM 站点运维管家

AEM 站点运维管家

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据官方安装指南 https://skillhub.cn/install/skillhub.md,将 @user_fccf428b/ops-jianshiai 安装到AI助手中。

技能介绍

解决的问题

AEM Edge Delivery Services 的运维散落在大量 REST 端点上:内容发布、缓存回源、索引重建、代码同步、快照晋升,以及 DA(Document Authoring)里的源文档浏览、复制、移动和版本维护。人工操作时容易记错端点参数、混淆预览与正式环境地址,也缺少统一的审计入口。这个技能把命令行式的后台管理收口为自然语言指令,用 preview /path、publish /path、da move 等方式直接触发对应操作。

它典型地落在两类工程师身上:负责站点交付、需要反复验证发布效果的前端或全栈工程师,以及需要审核快照、清理缓存、管理 secrets 和 API keys 的平台负责人。

核心能力与工作流程

技能内部把每一步拆成可审计的链路:

  • 身份与目标确认:先检查 ~/.aem/ops-config.json 里缓存的 org 与 site。如果有历史记录,会先向用户确认;没有或用户主动换了地址,就从 .aem.page / .aem.live URL 里解析出 org 与 site 并落盘。只有这两项都被确认后,流程才会继续。
  • 认证与权限校验:每次调用 admin.hlx.page 都会带上 x-auth-token。认证失效时自动唤起 auth 流程。随后拉取 profile 记录身份,再根据站点 access 配置判定当前用户拥有哪种角色——从 basic_author 到 admin 的 8 种之一。
  • 意图路由到资源模块:preview、publish 会进入 resources/content.md;clear cache 进入 cache.md;da list 或 da copy 会路由到 resources/da.md。每个资源模块封装了对应端点的参数构造、响应解析与错误推荐。
  • 安全与反馈闭环:代码同步前先检查 repoless 状态;配置更新前总是 GET 当前值并展示给用户;破坏性操作强制读取 resources/security.md,先说明影响并等用户说 yes 再执行。收到 200 时输出带有完整 URL 的结果,收到 202 时提示异步任务已启动,并引导用户后续 check job status 来跟进。

适用边界与注意事项

技能目前只针对 Edge Delivery Services 的 admin 域,不涉及通用 AEM 内容管理,也不覆盖静态站点外的云资源。它要求组织已经接入 admin.hlx.page,且在线用户必须拥有匹配的站点角色——缺少 publish 角色就直接调发布会得到 403,技能会把所需角色明确指出。DA 操作需要额外登录认证,不能当成匿名工具使用。

破坏性操作(删除、撤销 token、移除 index)的处理规则写死在流程里:动作、影响和二次确认缺一不可。跨平台方面,内部 shell 片段基于 POSIX,在 Windows 上需要 Git Bash 或 WSL 环境,且调用者必须能访问 admin.hlx.page。

使用场景

  • 上线前预览指定路径,确认样式无误后直接发布,并输出预览与生产双地址
  • 站点改版后某页面无法被搜索到,对指定路径触发 reindex 并重建索引
  • 收到缓存异常反馈后,对指定路径执行 clear cache 并强制刷新边缘节点
  • 排查站点异常时查看最近一小时日志并定位本次发布具体报错来源

适合人员

  • 负责 AEM Edge Delivery 站点交付的前端或全栈工程师,需要频繁发布内容并验证预览效果
  • 负责生产稳定性的平台负责人,需要跟踪作业状态、查看日志并推进快照晋升
  • 负责站点权限管理的运维工程师,需要日常维护用户角色与 API keys、tokens 等敏感凭证
  • 使用 DA 的文档编辑人员,需要在分支间复制、移动源文档并创建版本快照