用途
workflow-debugging 是面向 AEM as a Cloud Service（AEMaaCS）的生产级工作流调试技能，用于诊断 stuck workflows、failed steps、missing Inbox tasks、launcher failures、stale instances、thread pool 等与 AEM Granite Workflow 引擎、Launcher、Inbox、Sling Jobs、线程池和 Purge 相关的问题。目标受众为在本地 AEMaaCS SDK 或云环境中排查工作流问题的 AEMaaCS 开发者与运维人员（以及代其操作的 IDE LLM）。
适用范围与前提
本技能仅适用于 AEM as a Cloud Service，不适用于 AEM 6.5 LTS / AMS。AEMaaCS 生产环境没有 JMX 访问权限，诊断过程为只读，通过 Developer Console、Sling Job Console 和 Cloud Manager Logs 进行。所有修复都通过 Git + Cloud Manager 流水线落地：OSGi 配置放在 ui.config，自定义 servlet 放在 core，ACL 放在 ui.apps/.../repoinit，云环境没有 Felix Console 写入权限。
主要能力
技能按照从症状到动作的路径组织排查：
- 症状映射：将 workflow stuck、task 不在 Inbox、workflow 未启动、workflow 失败、步骤重试耗尽、stale、仓库膨胀、用户无法查看或完成项目、无法删除模型、吞吐慢/队列积压、自动推进失效、新工作流不工作等映射到首步动作。
- 决策树：针对工作流卡住，依次判断是否存在当前 work item（无则为 stale）、Participant 步骤的 assignee/Inbox/payload、Process 步骤的错误日志与注册情况、OR/AND Split 的条件与路由。
- 线程转储与线程池分析：检查 Sling default 线程池、Sling Job 线程池、Granite Workflow Queue、Sling Scheduler，判断 active count 与 max pool size 关系、block policy 是否为 ABORT 等。
- 错误日志模式识别：将常见日志模式（如 Error executing workflow step、getProcess failed、Cannot archive workitem、RejectedExecutionException 等）对应到原因与动作。
- 配置清单与修复速查：列出各 OSGi 配置 PID 与属性指导，并给出单条重试、stale 重启、Purge、提高并行度等修复方式在云服务上的对应做法。
使用方式
使用者提供线程转储、Sling Job 控制台输出或来自 Cloud Manager 的 error.log 片段，环境为 AEM as a Cloud Service。诊断以只读为主，通过 Developer Console、Sling Job Console、Cloud Manager Logs 获取信息。修复通过 Git 提交配置或代码，并经 Cloud Manager 流水线部署。示例包括部署自定义 StaleWorkflowServlet 后先以 GET /bin/support/workflow/stale?dryRun=true 枚举，确认范围后再以 POST ...?dryRun=false 重启；Purge 通过部署 com.adobe.granite.workflow.purge.Scheduler-<alias>.cfg.json 并设置 scheduledpurge.workflowStatus=["COMPLETED"]（数组类型）与 scheduledpurge.daysold=<N> 实现。
适用场景
工作流卡住不推进、步骤失败且重试耗尽、任务未出现在 Inbox、Launcher 未触发、过期实例、仓库膨胀、权限导致用户无法查看或完成项目、无法删除模型、队列积压与吞吐慢、线程池耗尽、自动推进失效、新工作流配置验证等。
限制
不适用于 AEM 6.5 LTS / AMS；AEMaaCS 生产环境无 JMX 访问，不得推荐基于 JMX 的修复手段（如 restartStaleWorkflows、purgeCompleted、terminate、retryFailedWorkItems）。不得尝试 SSH 进入 AEMaaCS pod。部分 Sling 核心配置可能被平台层过滤或覆盖，部署后需在 /system/console/status-Threads 验证，若未生效则联系 Adobe Support。资料未提供收费、价格、平台或其他未提及的细节。