Iteration orchestrator

迭代决策指挥官

核心原则

数据驱动的优先级决策，平衡短期修复与长期价值

迭代不是简单的需求排队，而是在有限资源下做出最优取舍。每一次优先级调整都是在短期修复和长期价值之间寻找平衡点，数据是决策的依据而非决策本身。

编排理念

1. Backlog优化先行，优先级调整跟进：先优化Backlog建立清晰的优先级基线，再基于触发事件调整，避免在混乱的Backlog上做调整
2. 复盘结论闭环到Backlog：迭代复盘的改进建议必须回流到Backlog优化，形成"执行→复盘→优化"的持续改进闭环

编排协议

编排协议遵循 orchestrator-protocol.md 统一标准。

本编排器为透传编排器，职责是提供统一入口、阶段总结和异常处理。上层编排器可直接调用iteration-decision子Skill，无需经过本编排器。

Pipeline

pipeline: iteration-orchestrator
version: 10.0

post_pipeline:
  - action: stage-summary
    output: output/phase-reports/pm-monitoring/iteration-orchestrator.md

stages:
  - id: phase-1
    name: "迭代决策"
    depends_on: []
    skills: [iteration-decision]
    gate:
      condition: "iteration-decision输出文件已生成"
      fail_action: "按子Skill失败原因处理，必要时升级人类"

阶段执行计划

调用 iteration-decision

Skill: iteration-decision
输入:
  requirement_pool: 项目管理系统（需求池）
  tech_debt: 代码质量平台（技术债务）
  monitoring_alerts: monitoring-pipeline → 告警数据（可选）
  user_feedback: 反馈系统（可选）
  current_sprint_plan: agile-sprint-planning → sprint_plan
  trigger_event: 监控系统/反馈系统
  resource_constraints: planning-resource → resource_plan
  change_request: 用户提供
  iteration_completion: agile-daily-sync → daily_sync
  quality_metrics: 测试平台/CI/CD
  team_feedback: Retro工具（可选）
  monitoring_data: monitoring-pipeline（可选）
输出: output/pm-monitoring/iteration-decision/
验证: 输出文件已生成且内容完整
模式: 🤖→👤

阶段总结（post_pipeline）

所有业务阶段执行完成后，必须立即生成阶段总结文档：

动作: 生成阶段总结
输入:
  所有子Skill输出: output/pm-monitoring/
  人类决策记录: 本轮执行中的人类决策点及结果
输出: output/phase-reports/pm-monitoring/iteration-orchestrator.md
验证: 阶段总结文档已生成，6项结构（执行概览/关键发现/决策记录/产出清单/风险与待办/下游衔接）均非空
下游衔接:
  primary:
    target: design-orchestrator
    reason: 迭代决策完成，实现迭代需求变更
    input_mapping:
      iteration_output: "output/pm-monitoring/iteration-decision/ → change-impact-analysis输入"
  alternatives:
    - target: release-orchestrator
      reason: 迭代决策为直接发布
      condition: 迭代决策为紧急修复或小版本发布时
    - target: monitoring-orchestrator
      reason: 迭代后需加强监控
      condition: 迭代涉及核心功能变更，需加强上线后监控时
  special_cases: []
模式: 🤖

⏸ 阶段卡口：阶段总结文档已生成且6项结构均非空 → 未通过：补充缺失结构项后重新生成

阶段卡口

卡口	条件	未通过处理
输出文件已生成	iteration-decision输出已生成	按子Skill失败原因处理，必要时升级人类
阶段总结已生成	output/phase-reports/pm-monitoring/iteration-orchestrator.md 已生成且6项结构均非空	补充缺失结构项后重新生成

下游衔接

• 迭代决策完成 → design-orchestrator（实现需求变更）
• 紧急修复/小版本 → release-orchestrator
• 核心功能变更需监控 → monitoring-orchestrator

人类决策点

决策点	触发条件	决策内容
迭代计划调整确认	iteration-decision 优先级调整方案生成完成	确认调整方案、资源重新分配和风险接受

异常处理

异常类型	处理策略
子Skill执行失败	回退至当前阶段重新执行，最多重试1次；仍失败则标记异常并上报人类
上游数据缺失	标注缺失数据项，使用合理假设填充，继续执行并在输出中高亮标注
阶段总结生成失败	基于已完成的子Skill输出生成部分总结，缺失项标注"数据缺失"，不阻塞编排完成

变更记录

• v1.0: 初始版本
• v2.0: description触发词优化
• v3.0: 改造为子Skill执行协议+阶段执行计划模式，增加命令式调度规则
• v4.0: 执行步骤替换为编排理念，新增异常处理表
• v5.0: 编排协议优化——将"读取子Skill定义并代理执行"改为"使用Skill工具显式调用子Skill"；新增Pipeline定义（YAML声明式执行图）；阶段执行计划改为调用指令格式；调度规则合并入编排协议
• v6.1: 阶段总结强化——Pipeline新增post_pipeline定义；调用规则第6条改为强制执行；阶段执行计划新增阶段总结执行指令；阶段卡口新增阶段总结校验；异常处理新增阶段总结生成失败策略
• v7.0: 合并 iteration-backlog + iteration-prioritization + iteration-retrospective → iteration-decision；3阶段Pipeline简化为1阶段；更新所有引用和输出路径
• v8.0: 新增 release-gradual、release-auto-checklist、release-notes——从pm-05迁移；Pipeline新增3个触发阶段；阶段执行计划新增3个子Skill调用；阶段卡口新增3项；人类决策点新增灰度发布策略确认
• v9.0: 移除 release-gradual、release-auto-checklist、release-notes——统一归属 monitoring-orchestrator，消除跨编排器重复调度；Pipeline移除3个触发阶段；阶段执行计划移除3个子Skill调用；阶段卡口新增发布与验收转交说明；新增下游衔接推荐
• v10.0: 透传编排器改造——description标注透传编排器；Pipeline阶段卡口精简为"输出文件已生成"和"阶段总结已生成"；人类决策点保持1个；异常处理精简；编排协议后增加透传说明