编辑 | blame | 历史 | 原始文档

FormationCommonStackerCraneJob Refactor Implementation Plan

For agentic workers: REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (- [ ]) syntax for tracking.

Goal: 在不改变业务行为的前提下,降低 FormationCommonStackerCraneJob 复杂度,拆分“任务选择”和“命令构建”职责。

Architecture: 保留 FormationCommonStackerCraneJob 作为 Quartz Job 入口,仅负责调度;将任务选择和命令构建下沉到同目录新类,通过构造函数组装依赖,改动限定在 FormationStackerCraneJob 目录。

Tech Stack: .NET 6, Quartz, 现有 WCS Task/Router 服务接口


Chunk 1: 结构拆分

Task 1: 拆分任务选择器

Files:
- Create: WIDESEAWCS_Tasks/FormationStackerCraneJob/FormationStackerCraneTaskSelector.cs
- Modify: WIDESEAWCS_Tasks/FormationStackerCraneJob/FormationCommonStackerCraneJob.cs

  • [ ] Step 1: 迁移任务挑选和站台可用性逻辑
  • [ ] Step 2: Job 中改为调用任务选择器

Task 2: 拆分命令构建器

Files:
- Create: WIDESEAWCS_Tasks/FormationStackerCraneJob/FormationStackerCraneCommandBuilder.cs
- Modify: WIDESEAWCS_Tasks/FormationStackerCraneJob/FormationCommonStackerCraneJob.cs

  • [ ] Step 1: 迁移命令转换与地址解析逻辑
  • [ ] Step 2: Job 中改为调用命令构建器

Chunk 2: 清理与验证

Task 3: Job 入口瘦身

Files:
- Modify: WIDESEAWCS_Tasks/FormationStackerCraneJob/FormationCommonStackerCraneJob.cs

  • [ ] Step 1: 删除迁移后的私有方法和无用 using
  • [ ] Step 2: 补关键流程注释

Task 4: 编译验收

Files:
- Modify: WIDESEAWCS_Tasks/FormationStackerCraneJob/*.cs(如需微调)

  • [ ] Step 1: 运行 dotnet build WIDESEAWCS_Tasks/WIDESEAWCS_Tasks.csproj -c Debug
  • [ ] Step 2: 最小修复直到通过