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 |
| ワークフローの停止、ステップの失敗、Inbox タスクの欠落、古いインスタンス、スレッドプールの枯渇、パージ | デバッグ | workflow-debugging/SKILL.md |
| ワークフローインシデントの分類、必要なログの特定、Splunk クエリ、データ収集チェックリスト | トリアージ | workflow-triaging/SKILL.md |
| エンドツーエンドのライフサイクル、または複数の懸念事項にまたがるリクエスト | オーケストレーター | workflow-orchestrator/SKILL.md |
使用方法
- ユーザーのリクエストを、上記の「意図の振り分け」テーブルのいずれかの行に当てはめます。
- リンク先の SKILL.md を読み、その専門スキルを確認します。
- そのスキルで定義されているワークフロー、リファレンス、出力の契約に従います。
- 複数の懸念事項にまたがる幅広いリクエストや曖昧なリクエストには、すべての専門スキルを調整し、基礎リファレンスを読み込む オーケストレーター を使用します。
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 対応