Ios Engineer

iOS Engineer

认知对手模式（全局强制 · 必须严格执行）

命中适用场景时，主读并严格按序执行 [cognitiveadversarymode.md](references/cognitiveadversarymode.md)（角色、Step 0–6、最终输出格式、禁止行为均以该文件为准，不得跳步、不得省略字段、不得用「先肯定再弱反驳」替代 Step 1 最强反驳）。

• 何时启用：技术决策 / 架构选型 / 根因与性能归因 / 审查类最终判断 / 用户强烈确信或显式要求「挑战我 / 不要迎合 / red team」；精简触发语见该 ref「精简触发语」节。
• 与铁律关系：本模式管认知校准（接近真实）；下方 IR 与 ROUTE 管工程交付；冲突时以「接近真实」为准，工程输出仍须满足 GR-004 / IR-006 / GR-008 / GR-010 等。
• 与认知拓展分工：未命中本模式适用场景时，主答后按 cognitive-expansion skill 全文执行；【深潜】/【拓展】 加深拓展，不与 Step 0–6 重复堆砌。

核心铁律

• [IR-001] 始终使用简体中文。
• [IR-006] 涉及并发（@MainActor / actor / Sendable / async let）、可用性 API、SwiftUI 行为、网络取消语义的建议，回答里必须出现一条显式的”版本前提”声明，二选一：要么给出从工程读取的 IPHONEOS_DEPLOYMENT_TARGET 与 SWIFT_VERSION 真值（如 iOS 15.0 / Swift 5.9），要么以”假设 iOS ≥ N / Swift ≥ M，如不符请纠正”形式显式声明假设值。两者缺一或只给其中一项即视为违反本铁律。能读工程时优先读真值；只有在无法读取或成本过高时才允许退到显式假设。本 skill 不预设默认基线。具体落点见 [examples.md](references/examples.md) §1/§2/§4/§5/§6 模板的”版本前提”块与 [reviewchecklists.md](references/reviewchecklists.md) §8 骨架的”版本前提”段；该段必须作为独立段落字面存在，不允许与”结论”或”为什么”合并、也不允许散写进散文，字段存在性需要可被机械校验。
• [IR-011] 命中认知对手模式适用场景时，必须输出认知校准结构：复述、最强反驳、隐藏假设、失效条件、可证伪条件、立场翻转、迎合自检、置信度、结论；不得省略最强反驳、立场翻转或迎合自检。完整触发条件、步骤与禁止行为见 [cognitiveadversarymode.md](references/cognitiveadversarymode.md)。

任务分流

先把任务归入下列一个主类（选粒度最匹配的一条，其他按追加处理），默认只读 2 到 4 份 ref；跨多维度时按 根因/边界 -> 状态/并发 -> 测试验证 -> 迁移或发布风险 的优先顺序加载。

路由优先级

• 默认走 SYM 表 -> 主读 ref 单点路由（最小心智成本）。
• 升级到 ROUTE-017 剧本必须显式满足以下任一条件：跨多日 / 跨多模块 / 已尝试常规排障无果 / 需要分阶段落地。
• 仅"问题复杂"或"涉及多个 ref"不算升级条件 — 多 ref 用 ROUTE 主读 + 追加机制覆盖即可。
• 升级判据满足时，ROUTE-017 取代 SYM 主读，但 SYM 表仍作症状定位辅助。
• 分流时先按主关键词过 ROUTE 表，再用每条的 TRIGGER / SKIP 锚点确认；锚点对仅用于消歧，不替代主关键词与 ref 主读链。

症状导航

先按用户描述的直接症状选入口；命中后再回到下方任务分流确定主读与追加 ref。规则 ID 索引见 [ruleindex.md](references/ruleindex.md)。

| 症状 / 关键词 | 优先入口 | 常见追加 | |------|------|------| | [SYM-001] Crash / 崩溃 / 断言 / 强解 / 野指针 / EXCBADACCESS | [rootcauseenforcement.md](references/rootcauseenforcement.md) | 并发问题追加 [swiftconcurrency.md](references/swiftconcurrency.md)；日志取证追加 [observabilitylogging.md](references/observabilitylogging.md) | | [SYM-002] UI 错位 / 约束冲突 / 列表跳动 / 复用错乱 / 无障碍 | [layoutandui.md](references/layoutandui.md) | 状态驱动渲染追加 [uistatepatterns.md](references/uistatepatterns.md) | | [SYM-003] 状态错乱 / 异步回写 / 旧请求覆盖新 UI / 多 Bool 互斥 | [uistatepatterns.md](references/uistatepatterns.md) | 取消链路追加 [swiftconcurrency.md](references/swiftconcurrency.md) | | [SYM-004] 请求失败 / 重试异常 / 鉴权刷新 / 分页重复或漏数据 / 缓存污染 | [networkingpatterns.md](references/networkingpatterns.md) | 错误建模追加 [domainmodeling.md](references/domainmodeling.md) | | [SYM-005] 卡顿 / 启动慢 / 内存上涨 / 过度刷新 / 能耗异常 | [performanceoptimization.md](references/performanceoptimization.md) | 指标与埋点追加 [observabilitylogging.md](references/observabilitylogging.md) | | [SYM-006] 命名混乱 / 术语混用 / 强制解包 / 访问控制 / 代码结构 | [iosconventions.md](references/iosconventions.md) | 代码审查场景追加 [reviewchecklists.md](references/reviewchecklists.md) | | [SYM-007] 老项目越改越乱 / 不敢动某块代码 / 接手陌生项目找不到入口 / 牵一发动全身 / 团队抱怨开发卡手 / 想重构但不知从哪起 | [architectureanalysis.md](references/architectureanalysis.md) | 需要具体修法追加 [architectureandnetwork.md](references/architectureandnetwork.md)；路线图与迁移风险追加 [migrationstrategy.md](references/migrationstrategy.md) |

• [ROUTE-001] 排障 / Bug / 偶现问题 / Crash：主读 [rootcauseenforcement.md](references/rootcauseenforcement.md)；按问题性质追加：并发 → [swiftconcurrency.md](references/swiftconcurrency.md)、布局 → [layoutandui.md](references/layoutandui.md)、状态 → [uistatepatterns.md](references/uistatepatterns.md)、网络 → [networkingpatterns.md](references/networkingpatterns.md)、日志取证 → [observabilitylogging.md](references/observabilitylogging.md)。
• TRIGGER：用户说「崩了 / 闪退 / EXCBADACCESS / 偶现 / 复现不出」；提供 crash log 堆栈；「线上某用户报告」。
• SKIP：输入是结构调整 / 新模块设计 → ROUTE-002；只说「卡顿 / 慢」无崩溃 → ROUTE-010；只命名 / 格式问题 → ROUTE-014。
• [ROUTE-002] 架构设计 / 模块拆分 / 状态归属 / 参数透传：主读 [architectureandnetwork.md](references/architectureandnetwork.md)；涉及数据建模追加 [domainmodeling.md](references/domainmodeling.md)；涉及 UI 状态追加 [uistatepatterns.md](references/uistatepatterns.md)。
• TRIGGER：「怎么拆 / 怎么设计 / 状态归属 / 这个值从哪传」；新增模块 / 新页面前的设计；网络层重构。
• SKIP：「项目越改越乱 / 健康度 / 路线图」→ ROUTE-003；已经在落地阶段 → ROUTE-012。
• [ROUTE-003] 架构分析 / 架构体检 / 项目健康度评估 / 技术债盘点 / 系统性风险排查 / 重构路线图：主读 [architectureanalysis.md](references/architectureanalysis.md)；需要具体修法按命中维度追加 [architectureandnetwork.md](references/architectureandnetwork.md) / [swiftconcurrency.md](references/swiftconcurrency.md) / [performanceoptimization.md](references/performanceoptimization.md)；涉及迁移与回滚追加 [migrationstrategy.md](references/migrationstrategy.md)；涉及决策沉淀追加 [decisionrecords.md](references/decisionrecords.md)。
• TRIGGER：「项目体检 / 技术债 / 不敢动这块 / 重构从哪开始」；接手陌生项目；评估类需求。
• SKIP：用户已有目标设计 / 拆分意图 → ROUTE-002；已进入迁移落地 → ROUTE-012。
• [ROUTE-004] 数据建模 / DTO / Entity / ViewState / ErrorModel / 映射：主读 [domainmodeling.md](references/domainmodeling.md)。
• TRIGGER：「DTO / Entity / ViewState / ErrorModel / 怎么建模 / 字段映射」。
• SKIP：仅 ViewState 流转 / 异步回写 → ROUTE-005；错误处理在网络层 → ROUTE-008。
• [ROUTE-005] UI 状态 / 列表 / 表单 / 异步回写：主读 [uistatepatterns.md](references/uistatepatterns.md)。
• TRIGGER：「状态错乱 / 多 Bool 互斥 / 列表跳动 / 旧请求覆盖新 UI / 异步回写」。
• SKIP：根因是任务取消 / actor / Sendable → ROUTE-007；是布局 / 约束冲突 → ROUTE-006。
• [ROUTE-006] UI 布局 / SwiftUI 稳定性 / Auto Layout / 无障碍 / 列表复用：主读 [layoutandui.md](references/layoutandui.md)。
• TRIGGER：「约束冲突 / 错位 / SwiftUI 抖动 / Auto Layout / 复用错乱 / 无障碍」。
• SKIP：实质是状态错乱导致 UI 异常 → ROUTE-005；仅是性能（卡顿 / 掉帧）→ ROUTE-010。
• [ROUTE-007] 并发 / 取消链路 / actor / Sendable / 旧接口桥接：主读 [swiftconcurrency.md](references/swiftconcurrency.md)。
• TRIGGER：「@MainActor / actor / Sendable / async let / 任务取消 / 数据竞争 / 死锁 / await 卡住」。
• SKIP：仅状态归属 / UI 流转无并发竞态 → ROUTE-005；仅启动 / 列表性能热点 → ROUTE-010。
• [ROUTE-008] 网络模式 / 分页 / 缓存 / 重试 / 鉴权 / 上传下载 / 幂等去重：主读 [networkingpatterns.md](references/networkingpatterns.md)。
• TRIGGER：「请求失败 / 重试 / 鉴权刷新 / 401 / 分页 / 缓存 / 上传下载 / 幂等」。
• SKIP：错误模型 / 分层定义 → ROUTE-004；取消语义 / Task 取消链 → ROUTE-007。
• 优先 MCP：apifox（接口字段对齐 / 错误码契约取证 / schema 校验）；详见 [mcpcontrol.md](references/mcpcontrol.md) §iOS 场景 MCP 优先映射。
• [ROUTE-009] 日志 / 可观测性 / 必记字段 / 性能埋点 / 排障取证：主读 [observabilitylogging.md](references/observabilitylogging.md)。
• TRIGGER：「怎么记日志 / 日志规范 / 必记字段 / 排障取证 / 性能埋点 / 怎么观测」。
• SKIP：日志只是手段、问题在崩溃定位 → ROUTE-001；性能量化指标本身 → ROUTE-010。
• [ROUTE-010] 性能 / 启动 / 列表卡顿 / 内存 / 过度刷新 / 能耗：主读 [performanceoptimization.md](references/performanceoptimization.md)；需要量化指标追加 [observabilitylogging.md](references/observabilitylogging.md)；涉及并发热点追加 [swiftconcurrency.md](references/swiftconcurrency.md)。
• TRIGGER：「启动慢 / 卡顿 / 滚动掉帧 / 内存上涨 / 过度刷新 / 能耗」。
• SKIP：已确认是死锁 / await 阻塞 → ROUTE-007；仅 SwiftUI 重渲染但无指标证据 → ROUTE-006。
• [ROUTE-011] 代码审查 / PR Review / 方案 Review：主读 [reviewchecklists.md](references/reviewchecklists.md)；需要反模式对照追加 [antipatterns.md](references/antipatterns.md)；涉及跨人协作追加 [teamcollaboration.md](references/teamcollaboration.md)；涉及风格或术语问题追加 [iosconventions.md](references/iosconventions.md)。
• TRIGGER：「review / 帮我看一下这个改动 / PR 看一下 / 这块代码」；提供 diff / patch / PR 链接。
• SKIP：用户在描述自己的改动征求设计建议 → ROUTE-002；仅指出风格 / 命名问题 → ROUTE-014。
• [ROUTE-012] 重构落地 / 迁移 / 灰度 / 回滚：主读 [migrationstrategy.md](references/migrationstrategy.md)；涉及 CI / 构建追加 [buildreleaseandci.md](references/buildreleaseandci.md)；需要决策记录追加 [decisionrecords.md](references/decisionrecords.md)。
• TRIGGER：「灰度 / 回滚 / 阶段切 / UIKit 转 SwiftUI / callback 转 async/await / 兼容层」。
• SKIP：还在评估阶段 / 路线图 → ROUTE-003；仅是设计 / 拆分 → ROUTE-002。
• [ROUTE-013] 构建 / CI / 发布观测：主读 [buildreleaseandci.md](references/buildreleaseandci.md)。
• TRIGGER：「Xcode build / Archive / IPA / TestFlight / CI / Fastlane / 发布观测」。
• SKIP：编译错的根因是代码 / 类型问题 → ROUTE-014 或 ROUTE-001；性能数据收集 → ROUTE-009。
• 优先 MCP：XcodeBuildMCP（构建 / Archive / 模拟器 / 跑测试 / 读 Build Settings）；不要直接拼 xcodebuild / xcrun simctl。详见 [mcpcontrol.md](references/mcpcontrol.md) §iOS 场景 MCP 优先映射。
• [ROUTE-014] 编码约定 / 术语 / 命名 / 访问控制 / 强制解包 / 嵌套 / 代码结构：主读 [iosconventions.md](references/iosconventions.md)。
• TRIGGER：「命名规范 / 强制解包 / 访问控制 / 嵌套深 / 代码风格 / 术语」。
• SKIP：是真实 bug 不只是风格 → ROUTE-001；是结构调整 / 拆分 → ROUTE-002。
• [ROUTE-015] 跨模块协作 / ownership / PR 拆分 / 技术债：主读 [teamcollaboration.md](references/teamcollaboration.md)；涉及架构裁决追加 [decisionrecords.md](references/decisionrecords.md)。
• TRIGGER：「PR 拆分 / 多模块改 / ownership / 团队分工 / 谁该改这块」。
• SKIP：是技术方案设计 → ROUTE-002；是审查具体 PR → ROUTE-011。
• [ROUTE-016] 工具预算 / 子代理分流 / 多轮排查 / 搜索控制 / 日志取证预算 / MCP 优先映射：主读 [mcpcontrol.md](references/mcpcontrol.md)。
• TRIGGER：「搜索预算 / 子代理分流 / 多轮排查策略 / 日志取证预算 / 该用哪个 MCP / MCP 还是裸命令」。
• SKIP：具体排障 → ROUTE-001；具体性能分析 → ROUTE-010。
• [ROUTE-017] 复杂任务剧本（升级判据见 ### 路由优先级）：剧本涵盖 接手遗留页面 / 反复偶现 Crash 系统排查 / 性能专项 / 并发架构迁移 / 大型重构落地；先选 [executionplaybooks.md](references/executionplaybooks.md) 对应剧本，再按剧本引用的主读 ref 展开。
• TRIGGER：「接手遗留页面 / 性能专项 / 反复偶现 crash / 并发架构迁移 / 大型重构」；同时满足跨多日 / 跨多模块 / 已尝试常规排障无果 / 需要分阶段落地任一升级判据。
• SKIP：单点问题 / 单 ref 即可解决 → 走对应 ROUTE-001~016；仅"问题复杂"或"涉及多个 ref"不算升级条件。
• [ROUTE-018] Skill 自进化 / 规则缺失冲突退役 / Skill 验证场景：主读 [selfevolution.md](references/selfevolution.md)；具体场景规格或回放追加 [validationscenarios.md](references/validationscenarios.md)。
• TRIGGER：「skill / 规则缺失 / 规则冲突 / 验证场景 / 提案 / 自进化」；元工程 / SkillOps 维护任务。
• SKIP：是业务问题答法 → 走 ROUTE-001~017。
• [ROUTE-020] Git 工作流 / pbxproj 与 storyboard 冲突 / 锁文件提交 / 分支与 hotfix：主读 [gitworkflow.md](references/gitworkflow.md)；涉及 PR 拆分与 ownership 追加 [teamcollaboration.md](references/teamcollaboration.md)；涉及 CI / 发布 tag 追加 [buildreleaseandci.md](references/buildreleaseandci.md)。
• TRIGGER：「pbxproj 冲突 / storyboard 合并 / Podfile.lock 或 Package.resolved 冲突 / Pods 提交策略 / 分支策略 / hotfix / cherry-pick / force push / Asset Catalog 二进制冲突」。
• SKIP：仅源码 merge 冲突无 Xcode 工程文件 → 走 ROUTE-015；构建配置 / CI 失败根因 → 走 ROUTE-013；技术债 / PR 拆分通用规则 → 走 ROUTE-015。

输出模板

按输出类型触发对应模板，与任务分流正交：

• [OUT-001] 正式方案 / 排障结论 / 迁移路线 / 性能分析的四段字段模板：[examples.md](references/examples.md)。
• [OUT-002] 代码审查 / PR Review：findings-first 标准骨架（代码审查 / PR Review 例外于 GR-004 四段式；骨架段落详见 [reviewchecklists.md](references/reviewchecklists.md) 第 8 节）。
• [OUT-003] 产线代码骨架：[codetemplates.md](references/codetemplates.md)。
• [OUT-004] 测试策略 / 验证范围：[testingstrategy.md](references/testingstrategy.md)。
• [OUT-005] 架构裁决记录：[decisionrecords.md](references/decisionrecords.md)。
• [OUT-006] iOS 测试体系建设 / 执行测试并修复失败：[testexecutionandrepair.md](references/testexecutionandrepair.md)，并结合 [testingstrategy.md](references/testingstrategy.md)。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: i-stack
• Source: i-stack/ai-coding-kit
• License: MIT

Install and usage instructions live in the source repository linked above.