技能介绍

解决什么问题

调用 DA Admin API（admin.da.live）时，每个请求都需要在 Authorization 头中携带有效的 Adobe IMS 访问令牌。令牌有效期约 1 小时，过期后所有后续调用都会返回 401。手动管理这个生命周期很繁琐：你需要记住令牌何时过期、在需要时重新走一遍 OAuth 流程、还要确保不同 skill 之间共享同一个令牌。da-auth 把这件事收敛成一条流程：拿到令牌、缓存到 ~/.aem/da-token.json、存入 DA_TOKEN，后续 skill 直接读取。

核心能力与关键步骤

第一步：检查缓存。 技能启动时先检查 DA_TOKEN 是否已有值。如果有，直接跳过登录流程，进入验证阶段。这一步避免了在单次会话中重复触发 OAuth，节省时间也减少用户交互。

第二步：获取令牌（三种方式）。 如果没有缓存，技能按优先级尝试以下路径：

da-auth-helper CLI（首选）：通过 npx 调用 adobe-rnd/da-auth-helper，自动完成 Adobe IMS OAuth 2.0 implicit flow，弹出浏览器窗口让用户登录，成功后令牌写入缓存并输出到 stdout。
DA MCP server：如果会话中已配置 DA MCP server，直接调用其认证工具获取令牌。
手动粘贴（兜底）：让用户从浏览器 DevTools 的 Network 面板中复制 Authorization 头的值，粘贴给技能。

第三步：验证令牌。 拿到令牌后，技能会发起一次测试请求确认令牌被 DA API 接受（返回 HTTP 200）。这一步很重要——OAuth 流程成功不代表令牌对当前 org/repo 有权限，提前验证可以避免后续 skill 在推送内容时才遇到 403。

适用边界与注意点

令牌有效期：约 1 小时，附带 60 秒缓冲。如果单次会话超过这个时长，需要重新获取。
不要重复调用：如果同一会话中 create-site skill 已经处理了认证，不要单独调用 da-auth。
MCP server 优先：如果 DA MCP server 处于活跃状态，使用其认证工具而非本技能。
前置条件：需要 Node.js 18+、可从机器访问的浏览器（用于 OAuth 流程）、网络可访问 ims-na1.adobelogin.com。
相关技能协作：snowflake 在 Phase 5 推送页面前需要 DA_TOKEN 已就绪；da-content 负责令牌获取后的实际内容操作；content-driven-development 和 building-blocks 在推送内容前都需要先调用本技能。