| 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，而是规定默认交付闭环：
- 先应用
xxf-aaa-vibe-coding-governor 的任务定义卡与硬门禁框架（治理前置层）。
- 识别是否涉及 XXF 模块或工程约束。
- 读取对应模块 skill 与相关工程 skill。
- 实现最小必要改动。
- 需要时补最小有效单测。
- 执行最小相关验证。
- 对结果做一次以 findings 为中心的审查。
- 最后给出放行风险结论。
职责边界（避免语义冲突）
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-stylexxf-aaa-coding-archxxf-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 设计问题
- 不把编码任务拆成过多显式确认步骤
