关于 aem-workflow
aem-workflow 是面向 AEM Cloud Service 工作流任务的技能,按意图分派至设计、开发、触发、启动器、调试和分类等专门指导,并列出 Cloud Service 约束。
主要功能
- 01按意图路由至专门技能
- 02工作流模型设计指导
- 03自定义流程步骤开发
- 04工作流触发与启动器配置
- 05故障调试与事件分类
- 06Cloud Service 实施约束
适用场景
- 01设计含步骤、分支和变量的模型
- 02实现自定义 WorkflowProcess 步骤
- 03启动工作流或配置启动器
- 04排查失败或卡住的工作流实例
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ adobe/ skills --skill aem-workflow安装后在 Claude Code 中输入/aem-workflow确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdworkflow-debugging/reference.mdworkflow-development/references/workflow-development/participant-step-patterns.mdprocess-step-patterns.mdvariables-and-metadata.mdworkflow-development/references/workflow-foundation/api-reference.mdarchitecture-overview.mdcloud-service-guardrails.mdjcr-paths-reference.mdquick-start-guide.mdREADME.mdworkflow-launchers/references/workflow-foundation/api-reference.mdarchitecture-overview.mdcloud-service-guardrails.mdjcr-paths-reference.mdquick-start-guide.mdREADME.mdworkflow-launchers/references/workflow-launchers/condition-patterns.mdlauncher-config-reference.mdworkflow-model-design/references/workflow-foundation/api-reference.mdarchitecture-overview.mdcloud-service-guardrails.mdjcr-paths-reference.mdquick-start-guide.mdREADME.mdworkflow-model-design/references/workflow-model-design/model-design-patterns.mdmodel-xml-reference.mdstep-types-catalog.mdworkflow-orchestrator/references/workflow-foundation/api-reference.mdarchitecture-overview.md详细介绍
AEM Cloud Service 工作流
根据用户请求的意图,将其路由到相应的专业技能。
意图路由器
| 用户意图 | 技能 | 路径 |
|---|---|---|
| 创建工作流模型、添加步骤、设计 OR/AND 分支、配置变量 | 模型设计 | workflow-model-design/SKILL.md |
| 实现自定义 WorkflowProcess 步骤、ParticipantStepChooser、OSGi 服务注册 | 开发 | workflow-development/SKILL.md |
| 通过代码、HTTP API、Timeline UI、Manage Publication 启动工作流 | 触发 | workflow-triggering/SKILL.md |
| 配置启动器、在上传资源时自动启动、覆盖 OOTB 启动器 | 启动器 | workflow-launchers/SKILL.md |
| 工作流卡住、步骤失败、缺少收件箱任务、实例过期、线程池耗尽、清理 | 调试 | workflow-debugging/SKILL.md |
| 对工作流事件分类、确定所需日志、Splunk 查询、数据收集检查清单 | 分诊 | workflow-triaging/SKILL.md |
| 端到端生命周期或涉及多个方面的请求 | 编排器 | workflow-orchestrator/SKILL.md |
使用方法
- 将用户请求与上方意图路由器表中的一行匹配。
- 阅读相应专业技能链接的 SKILL.md。
- 遵循该技能中定义的工作流、参考资料和输出规范。
- 对于涉及多个方面的宽泛或模糊请求,使用 Orchestrator,它会协调所有专业技能并加载基础参考资料。
Cloud Service 限制
| 限制 | 详情 |
|---|---|
| 不支持 JMX | 不支持通过 JMX 执行 retryFailedWorkItems、countStaleWorkflows、restartStaleWorkflows、purgeCompleted |
/libs 不可变 | 切勿写入 /libs;使用 /conf/global/ 或 /apps/ 覆盖 |
| 模型设计时路径 | /conf/global/settings/workflow/models/<id> |
| 模型运行时路径(用于 API 调用) | /var/workflow/models/<id> |
| 启动器配置路径 | /conf/global/settings/workflow/launcher/config/ |
| 服务用户 | 始终使用 workflow-process-service 子服务;切勿使用管理员凭据 |
| OSGi 注解 | DS R6(来自 org.osgi.service.component.annotations 的 @Component、@Reference) |
| 部署方式 | Cloud Manager 管道 — 生产环境中不使用 Package Manager |
专业技能
- workflow-model-design/SKILL.md — 模型结构、步骤类型、变量和模型 XML
- workflow-development/SKILL.md — WorkflowProcess、ParticipantStepChooser、元数据和错误处理
- workflow-triggering/SKILL.md — Timeline UI、Manage Publication、WorkflowSession API 和 HTTP API
- workflow-launchers/SKILL.md — 启动器配置、JCR 事件绑定和 OOTB 覆盖
- workflow-debugging/SKILL.md — 卡住的工作流、失败的步骤、线程池、Sling Jobs 和清理
- workflow-triaging/SKILL.md — 症状分类、日志模式、Splunk 查询和数据收集
- workflow-orchestrator/SKILL.md — 跨所有技能的完整生命周期编排
评论
支持 Markdown