AEM 站点运维管家
将以下提示词粘贴到你的 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.liveURL 里解析出 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 的文档编辑人员,需要在分支间复制、移动源文档并创建版本快照