app-common-workflow-generator

在应用层生成端口（出站端口/存储/网关），明确重试与错误处理语义，同时尽量减少耦合度。

SKILL.md

--- frontmatter

name: app-common-workflow-generator
description: "Generates/extends the workflow engine in app-common: step handlers, retry policies, processors, and unit tests."

App Common Workflow Generator

Follow .codex/skills/GENERATOR_SKILL_STRUCTURE.md.

Use For

•{{basePackage}}.app.common.workflow.*

Inputs Required

•workflowType (stable string)
•Step list (linear): ordered stepSeq + stepType
•Retry policy requirements (max attempts, backoff)
•WAITING semantics (deadline + wake-up event type) if used

Outputs

•
App/common workflow:
- •step handler(s) implementing WorkflowStepHandler
- •optional retry policy implementation + unit tests
- •services that start/tick/signal workflows

Naming & Packaging

•Handler names: <WorkflowType><StepType>Handler or <StepType>WorkflowStepHandler
•Keep engine types in app/common/workflow/**; business-specific in app/biz/** if needed.

Implementation Rules

•Linear execution (responsibility chain) unless explicitly requested otherwise.
•Steps must be idempotent (replay safe).
•Retry policy must be configurable and unit-tested.
•State transitions must be guarded (status predicates at store boundary).

Reference Implementations

•{{appModuleDir}}/src/main/java/{{basePackagePath}}/app/common/workflow/service/WorkflowRunner.java
•{{appModuleDir}}/src/main/java/{{basePackagePath}}/app/common/workflow/service/WorkflowTaskProcessorImpl.java
•{{infraModuleDir}}/src/main/java/{{basePackagePath}}/infra/repository/workflow/store/MybatisWorkflowStore.java
•{{domainModuleDir}}/src/main/java/{{basePackagePath}}/domain/common/workflow/WorkflowStepStatus.java

Tests

•Unit tests for definition/registry/step results/policies.
•Integration tests for store lease + state transitions.

Pitfalls

•Forgetting to insert steps up front (breaks recovery after restart).
•Updating step status without lock owner predicates.