xxf-aaa-delivery-loop

name	xxf-aaa-delivery-loop
description	处理 XXF iOS 项目中的通用编码任务交付流程。用于 bugfix、功能开发、重构、回归修复等未显式指明测试或 review 的日常 coding 请求；负责自动串起模块 skill、补测、验证、代码审查与风险门禁。
allowed-tools	Read, Glob, Grep, Edit, Write, Bash

交付总控（Delivery Loop）

触发场景

• 普通编码任务，但用户没有单独点名测试、review、风险评估
• bugfix、功能开发、局部重构、回归修复
• “把这个问题修掉”“改一下这里”“做完为止”这类日常 coding 请求

核心职责

本 skill 不是替代具体模块 skill，而是规定默认交付闭环：

1. 先应用 xxf-aaa-vibe-coding-governor 的任务定义卡与硬门禁框架（治理前置层）。
2. 识别是否涉及 XXF 模块或工程约束。
3. 读取对应模块 skill 与相关工程 skill。
4. 实现最小必要改动。
5. 需要时补最小有效单测。
6. 执行最小相关验证。
7. 对结果做一次以 findings 为中心的审查。
8. 最后给出放行风险结论。

职责边界（避免语义冲突）

• xxf-aaa-vibe-coding-governor：负责通用治理框架（任务定义、门禁思想、证据化交付、全局禁止池）。
• xxf-aaa-delivery-loop：负责在 XXF 仓库中自动编排执行顺序（实现、补测、验证、review、risk gate）。
• xxf-aaa-ios-performance-gate：负责性能风险主动鉴别、最小性能验证与性能门禁结论。
• xxf-aaa-test-strategy / unit-test-writer / auto-test-orchestrator：负责“测什么、怎么补、怎么跑”。
• xxf-aaa-code-reviewer / risk-gate：负责 findings 细化与放行结论。

规则：delivery-loop 不重复定义专项细则；只负责触发与串联下游 skill。

默认工作流

0. 治理前置

• 先按 xxf-aaa-vibe-coding-governor 生成最小任务定义卡：
  • 目标
  • 边界（不改项）
  • 验收标准
  • 关键约束
  • 风险点
• 若任务定义卡缺失，先补齐再进入实现。

1. 路由到正确上下文

• 如果任务涉及具体 XXF 模块，先读对应 skills/xxf-*/SKILL.md
• 代码修改默认同时受这些工程 skill 约束：
  • xxf-aaa-coding-style
  • xxf-aaa-coding-arch
  • xxf-aaa-class-declaration-guidelines（任务涉及 ViewController 或 ViewModel 时）
  • xxf-aaa-test-strategy（需要判断最小必测集时）

2. 实现阶段

• 优先最小改动，不做顺手重构
• 如果是 bugfix，优先保留可验证的复现路径
• 如果存在明显缺测试风险，进入 xxf-aaa-unit-test-writer

3. 验证阶段

• 代码有改动时，默认进入 xxf-aaa-auto-test-orchestrator
• 优先最小相关测试范围
• 没有可测入口时，至少做编译级验证并说明残余风险

4. 审查阶段

• 出现以下任一情况时，进入 xxf-aaa-code-reviewer：
  • 改动跨文件或跨层
  • 涉及错误处理、状态、并发、生命周期
  • 有潜在回归面
  • 补了测试但仍存在边界不确定性

5. 门禁阶段

• 出现以下任一情况时，进入 xxf-aaa-risk-gate：
  • 影响发布或合并决策
  • 有残余风险无法靠当前验证完全证明
  • 涉及数据库、路由、缓存、权限、隐私、兼容性

6. 性能门禁阶段（主动执行）

• 出现以下任一情况时，自动进入 xxf-aaa-ios-performance-gate（无需用户额外提示）：
  • 改动触及 UI 渲染/布局/列表滚动路径
  • 改动触及图片加载、解码、缓存
  • 改动触及主线程任务调度、并发模型、网络与数据库热路径
  • 改动触及启动链路或全局初始化
  • 用户反馈卡顿、掉帧、启动慢、内存上涨、耗电异常
• 性能门禁执行后，若结果为 Block / Warn，再交由 xxf-aaa-risk-gate 汇总放行结论。

自动进入下游 skill 的条件

进入 xxf-aaa-unit-test-writer

• bugfix
• 逻辑分支新增或修改
• 原有测试失效
• 当前改动明显缺少回归保护

进入 xxf-aaa-auto-test-orchestrator

• 任何代码改动完成后
• 补完测试后
• 需要确认修复有效时

进入 xxf-aaa-code-reviewer

• 改动不止一个文件
• 改动触及边界层或共享逻辑
• 用户没有要求 review，但该改动本身有明确回归风险

进入 xxf-aaa-risk-gate

• 用户问能否放行
• 已有 findings 或验证残余风险
• 需要决定是否必须灰度、回滚、防护或补测

进入 xxf-aaa-ios-performance-gate

• 改动涉及 UI/列表/图片/启动/并发/缓存/网络热路径
• 出现“性能退化”信号或用户性能投诉
• 虽功能正确但存在中高概率性能回归面

升级给开发者的条件

只有在以下情况才停止自动闭环并升级澄清：

• 需要密钥、签名、生产配置、外部敏感环境
• 测试或构建入口依赖不明确且无法安全推断
• 是否正确属于敏感业务规则或产品决策
• 改动已触及 framework/core architecture 且超出已批准边界

输出要求

最终至少包含：

• 实现了什么
• 是否补了测试
• 跑了哪些验证
• 是否发现 review findings
• 风险结论和残余风险

非目标

• 不要求用户显式说“顺便跑测试 / 做 review / 做风险评估”
• 不把所有任务都升级成完整 CI 设计问题
• 不把编码任务拆成过多显式确认步骤