在管理 AEM Edge Delivery…

适用于已接入 admin.hlx.page 的 AEM Edge Delivery Services 项目，按自然语言完成管理操作。

适用场景

解决思路

1. 沟通准则：绝不使用 EDS 缩写，始终使用全称 Edge Delivery Services 或 AEM Edge Delivery Services；操作失败时显示清晰、可执行的错误消息；执行破坏性操作前必须确认，参考 resources/security.md。
2. 欢迎消息：当用户未提供具体命令（如仅输入 /ops 或 help me with ops）时，显示 Edge Delivery Services Operations 欢迎信息，列出快捷命令：list pages、who am i、list sites、show site config、preview /path、show logs；并提示输入 help、/ops help 或 what can you do? 查看完整命令。
3. 跨平台处理：Shell 命令使用 POSIX 兼容语法（适用于 macOS/Linux）；Windows 上使用 Git Bash 或 WSL 可原样运行；agent 应根据用户环境调整语法。
4. Step 0 获取 org 和 site（必须先做）：检查 ~/.aem/ops-config.json 中之前存储的 org 和 site；用 node -e 读取并输出 ORG、SITE。
5. 若 ORG 和 SITE 都已设置，向用户确认是否继续使用；如果用户不继续，让其提供不同 site URL（如 https://main--mysite--myorg.aem.page/）；若用户提供 URL，则解析 org 和 site 并保存新值。
6. 若 ORG 或 SITE 为空，询问用户要执行 ops 的 site preview/live URL（如 https://main--mysite--myorg.aem.page/）。
7. URL 解析：若 URL 包含 .aem.page 或 .aem.live，则从 host 部分解析 ORG 和 SITE；若用户提供的不是有效 .aem.page 或 .aem.live URL，则再次询问。
8. 保存 org 和 site：执行 mkdir -p "${HOME}/.aem"，再用 node -e 将 org 和 site 写入 ~/.aem/ops-config.json。
9. 只使用 ~/.aem/ops-config.json 或用户直接输入中的 org/site，绝不从 git remote、fstab.yaml 或 folder/repo 名称推断；直到 org 和 site 都确认后才继续。
10. Step 1 认证（必须）：在任何 API 调用前检查 auth token 是否存在；从 ~/.aem/ims-token.json 读取 authToken，并确认 authTokenExpiry > Math.floor(Date.now()/1000)+60。
11. 若 AUTH_TOKEN 为空，先调用 Skill({ skill: "aem-project-management:auth" })；所有 admin.hlx.page API 调用使用 -H "x-auth-token: ${AUTH_TOKEN}" header。
12. 对敏感端点和破坏性操作，先读 resources/security.md 和 resources/sensitive.md。
13. Step 2 加载完整配置并验证角色：读取 ~/.aem/ops-config.json 中的 org、site、ref（默认 main）和 authToken，打印配置。
14. 用 curl 获取 profile 验证认证并记录身份：GET https://admin.hlx.page/profile，带 x-auth-token header；若 HTTP 401，则需重新认证，调用 auth skill 并重试；若 HTTP 非 200，则报错并检查网络/API 状态。
15. 解析 profile JSON 得到 USER_EMAIL 和 USER_NAME；为确定用户角色，检查站点访问配置：curl -s -H "x-auth-token: ${AUTH_TOKEN}" "https://admin.hlx.page/config/${ORG}/sites/${SITE}.json"。
16. 若操作返回 403，告知所需角色：Preview 需要 basic_author、author、publish 或 admin；Publish to live 需要 basic_publish、publish 或 admin；Unpublish 需要 publish 或 admin；Code sync 需要 develop 或 admin；Config read 需要 config、config_admin 或 admin；Config write 需要 config_admin 或 admin；Snapshot manage 需要 author、publish 或 admin。
17. 保存 email 到 ~/.aem/ops-config.json；若缺少 site 或其他值，读 resources/config.md。
18. Step 3 按意图路由：根据用户意图选择资源模块：preview/publish/unpublish/status/delete preview → resources/content.md；cache/purge/clear cache/invalidate → resources/cache.md；sync code/deploy code/update code → resources/code.md；reindex/index/remove from index/search → resources/index.md；sitemap/generate sitemap → resources/sitemap.md；snapshot/staged release/bundle → resources/snapshots.md；logs/audit/activity → resources/logs.md；user/access/permission/who am i/add user/remove user → resources/users.md；job/bulk operation/stop job → resources/jobs.md；site/branch/switch/list sites → resources/sites.md；org config/site config/robots.txt → resources/config-api.md；secret/secrets/create secret/delete secret → resources/secrets.md；API key/apikey/create key/revoke key → resources/apikeys.md；token/tokens/access token → resources/tokens.md；profile config/profile settings → resources/profiles.md；index config/helix-index/search config → resources/index-config.md；sitemap config/helix-sitemap/sitemap rules → resources/sitemap-config.md；version/versions/history/rollback/restore → resources/versioning.md；pages/list pages/indexed pages/all pages → resources/pages.md；da/da list/da source/da copy/da move/da delete/da config/da versions → resources/da.md；destructive operation/confirmation required → resources/security.md；sensitive endpoint (emails, credentials, API keys) → resources/sensitive.md。
19. Step 4 读取资源并执行：从 resources/ 读取对应资源文件；遵循该资源说明；更新配置时总是先 GET 当前配置并展示给用户，再修改；代码同步时总是先检查 repoless 状态（见 code.md）；破坏性操作时读 resources/security.md 并遵循 Confirmation Protocol——说明动作、解释影响、询问 yes/no，仅在用户回答 yes 后执行（无例外）；执行 API 调用；按完成标准处理响应。
20. 完成标准：200/201 成功，显示结果和完整 URL（https://{ref}--{site}--{org}.aem.page{path}）；202 异步任务启动，报告 job name，并指示用 check job status {jobName} 跟踪进度；204 成功无 body，确认「{action} completed for {path}」；4xx/5xx 逐字显示 API 错误，然后按 resources/errors.md 建议修复。
21. 报告成功前：内容操作包含 preview 和 live URL（如适用）；批量操作不要说过 published 或 previewed，直到任务完成前说 job started；破坏性操作确认删除了什么以及还有什么仍存在。
22. URL 解析助手：如果用户提供 AEM URL 而不是分开的 org/site/path，按模式 https://{ref}--{site}--{org}.aem.page{path} 解析；用 bash 脚本从 DOMAIN、HOST_PART 解析 REF、ORG、SITE、URL_PATH，默认 URL_PATH 为 /；示例：uat--hmns-uat-kw--alshaya-axp.aem.page → ref=uat、site=hmns-uat-kw、org=alshaya-axp。
23. 前置条件：项目必须已接入 Admin Service（可访问 admin.hlx.page）；用户必须有账号（支持 federated login）；用户必须有站点角色，角色在站点配置 access.admin.role 中定义，共八种：admin、author、publish、develop、basic_author、basic_publish、config、config_admin；若缺少角色，API 返回 403；网络必须能访问 admin.hlx.page。
24. 帮助响应：当用户想要命令列表（触发词 help、what can you do?、/ops help、list commands）时，输出命令清单：Content Operations：preview /path、publish /path、unpublish /path、status /path；Cache Operations：clear cache /path、force clear cache；Code Operations：sync code；Index Operations：reindex /path；Sitemap：generate sitemap；Snapshots：create snapshot {name}、publish snapshot {name}；Logs：show logs、show logs last hour；Users：add user@email as role、remove role user@email、who am i；Jobs：list jobs、stop job {name}；Sites：list sites、switch to site-x、use branch feat-x；Config：show org config、show site config、update robots.txt；Secrets：list secrets、create secret {name}、delete secret {name}；API Keys：list API keys、create API key {name}、revoke API key {id}；Profiles：show profile config、create profile {id}、delete profile {id}；Index Config：show index config、update index config；Sitemap Config：show sitemap config、update sitemap config；Versioning：list versions、restore version {id}；Pages：list pages、list pages /blog；Document Authoring (DA)：da auth、da list、da list /path、da source /path、da copy /src to /dest、da move /src to /dest、da delete /path、da upload /path、da upload media /path、da config、da update config、da versions /path、da create version、da restore version X、da preview /path、da publish /path。
25. 命令速查表：支持 Content：preview /path、publish /path、unpublish /path、status /path；Cache：clear cache /path、force clear cache；Code：sync code、deploy code；Index：reindex /path、remove from index；Sitemap：generate sitemap；Snapshots：create snapshot X、publish snapshot X、approve snapshot X；Logs：show logs、show logs last hour；Users：add user@email as author/publish/develop、remove admin user@email、who am i；Jobs：list jobs、job status X、stop job X；Sites：list sites、switch to site-X、use branch feature-X；Config：show org config、show site config、update robots.txt；Secrets：list secrets、create secret、delete secret；API Keys：list API keys、create API key、revoke API key；Tokens：list tokens、create token、revoke token；Profiles：show profile config、create profile、delete profile；Index Config：show index config、update index config (query.yaml)；Sitemap Config：show sitemap config、update sitemap config (sitemap.yaml)；Versioning：list versions、restore version、rollback config；Pages：list pages、list all pages、show indexed pages；DA：da list、da source /path、da copy、da move、da delete、da config、da update config、da versions、da create version、da upload media、da auth。

适用边界 · 注意事项

• 项目未接入 Admin Service（无 admin.hlx.page 访问权限）时不要使用。
• 用户没有账号或没有对应站点角色（如 admin、author、publish、develop、config_admin 等）时不要使用，API 会返回 403。
• 无法访问 admin.hlx.page 或无法完成认证（auth skill）时不要使用。