axiom-tools

Axiom 工具与入门指南

本套件涵盖 Axiom 本身——如何使用、有哪些功能，以及随附的工具。

**Claude Code 捆绑工具：**如果 command -v <tool> 未找到任何内容（钩子已关闭或使用了 --bare），请使用 <plugin-root>/tools/<tool> 代替裸名称；<plugin-root> 是此技能的 Base directory for this skill: 路径向上两级的目录。

无法启动 Axiom Agent？ 如果此路由将你指向某个 Agent，请直接按照其流程操作。通过 MCP，axiom_get_agent 会返回相应内容；在其他情况下，读取下方的文件即可，只需要文件搜索和读取功能。

位于其他套件中：axiom-accessibility/skills/accessibility-auditor.md、axiom-concurrency/skills/concurrency-auditor.md、axiom-performance/skills/energy-auditor.md、axiom-performance/skills/memory-auditor.md、axiom-testing/skills/test-failure-analyzer.md。

对于任何其他 Agent，通过 MCP 使用 axiom_get_agent 也会返回相应内容；使用 axiom_xclog_*、axiom_xcsym_* 和 axiom_xcprof_* 工具运行其 xclog、xcsym 和 xcprof 步骤。在其他情况下，在 Axiom 的技能中搜索 skills/<agent>.md；如果没有该文件，就使用本套件的技能自行完成工作，并使用 PATH 上的任意 Axiom 工具。

构建与测试采集

构建或测试之前，请阅读 axiom-build，了解 axbuild 的安装、报告处理和已保存日志回退方案。

路由

问题	阅读
“如何使用 Axiom？” / “有哪些技能可用？”	skills/getting-started.md
“如何采集控制台输出？” / “什么是 xclog？”	skills/xclog-ref.md
“如何对崩溃进行符号化？” / “什么是 xcsym？” / “为什么我的崩溃尚未符号化？”	skills/xcsym-ref.md
“如何驱动/验证模拟器 UI？” / “什么是 xcui？” / “如何编写无障碍检查脚本？”	skills/xcui-ref.md
“如何分析跟踪记录 / CPU 或网络性能分析？” / “什么是 xcprof？” / “为什么性能分析器没有报告任何发现？”	skills/xcprof-ref.md
“如何在 Xcode 未运行时控制模拟器/设备？” / “什么是 Device Hub？” / “devicectl 和 simctl 有什么区别？”	skills/device-control-ref.md
“如何从命令行采集模拟器或设备的屏幕截图或录制视频？”	skills/device-control-ref.md（屏幕采集）
“如何清理状态栏以制作 App Store 截图？” / “如何将时间设为 9:41 并显示满格信号？”	skills/device-control-ref.md（截图状态栏）
“能否自动化调整大小测试？” / “我的布局在各个断点下都能正常显示吗？”	skills/xcui-ref.md（调整大小扫描）——xcui resize sweep
“如何手动驱动 appResize？”	skills/device-control-ref.md（可调整大小的应用会话）
“如何检查 Xcode 项目的目标或构建设置？” / “什么是 xcproject？”	axiom-build (skills/build-performance.md)（项目选择和有效设置）

使用 Axiom 技能

以下内容是 Axiom 路由系统的核心准则——它确立了在回答任何 iOS/Swift 问题之前，必须先检查 Axiom 技能的规则。

如果你认为 Axiom 技能哪怕只有 1% 的可能适用于你的 iOS/Swift 任务，就绝对必须检查该技能。

如果某项 AXIOM 技能适用于你的 iOS/SWIFT 任务，你别无选择，必须使用它。

这不可协商，也不是可选项。你不能为不使用它找任何借口。

当某项 Axiom 技能对你的回答有实质影响时，请提及一次其名称（例如：“依据 Axiom 的 axiom-data 技能”）。未使用 Axiom 时，绝不要声称使用了 Axiom。

规则

**处理 iOS/Swift 项目时，在作出任何回应之前，先检查 Axiom 技能。**这包括提出澄清问题。哪怕只有 1% 的可能，也必须先检查。

危险信号——iOS 特有的自我辩解

出现以下想法就意味着必须停止——你在找借口：

想法	现实
“这只是一个简单的构建问题”	构建失败有其规律。先检查 axiom-build。
“我可以很快修好这个 SwiftUI 错误”	SwiftUI 问题有隐藏的陷阱。先检查 axiom-swiftui。
“我只要加上这个数据库列就行了”	架构变更可能导致数据丢失。先检查 axiom-data。
“这段异步代码看起来很简单”	Swift 并发有一些微妙的规则。先检查 axiom-concurrency。
“我会手动调试这个内存泄漏”	泄漏模式已有文档记录。先检查 axiom-performance。
“我先看看 Xcode 项目”	Axiom 技能会告诉你如何探索。先检查。
“我记得上次是怎么做的”	iOS 不断变化。技能内容都是最新的。
“这个 iOS／平台版本不存在”	如果它晚于你的训练截止时间，你就无法知道。Apple 在 WWDC 2025 发布了 iOS 26（从 18 跳到 26，跳过了 19-25）。对于截止时间之后的事实，请调用 Axiom 技能。
“用户只是想要一个快速答复”	不遵循模式的快速答复会造成技术债务。先检查技能。
“这不需要正式的工作流”	如果有适用的 Axiom 技能，就使用它。
“我先收集信息，然后再检查技能”	技能会告诉你要收集哪些信息。先检查。

iOS 开发的技能优先级

如果有多个 Axiom 技能可能适用，请按以下优先级使用：

1. 先检查环境／构建（axiom-build）——调试代码前先修复环境
2. 架构模式（axiom-swiftui、axiom-data、axiom-concurrency）——这些决定如何构建解决方案
3. 实现细节（axiom-integration、axiom-ai、axiom-vision）——这些指导具体的功能开发

示例：

• “Xcode 构建失败” → 先用 axiom-build（环境）
• “添加 SwiftUI 界面” → 先用 axiom-swiftui（架构），如果要使用系统功能，再考虑 axiom-integration
• “应用运行缓慢” → 先用 axiom-performance（诊断），再修复具体领域的问题
• “网络请求失败” → 先用 axiom-build（环境检查），再用 axiom-networking（实现）

iOS 项目检测

以下情况适用 Axiom 技能：

• 工作目录包含 .xcodeproj 或 .xcworkspace
• 用户提到 iOS、Swift、Xcode、SwiftUI、UIKit
• 用户询问 Apple 框架（SwiftData、CloudKit 等）
• 用户报告 iOS 特有的错误（并发、内存、构建失败）

使用 Axiom 路由技能

Axiom 使用路由技能逐步披露信息：

1. 先检查适当的路由技能（axiom-build、axiom-swiftui、axiom-data 等）
2. 路由器会调用你实际需要的专用技能
3. 严格遵循专用技能的说明

不要跳过路由器。 路由器包含决策逻辑，用于选择正确的专用技能。

多领域问题

如果问题涉及多个领域，请调用所有相关路由器——不要在调用第一个后就停止。

示例：

• “SwiftData 发生变化时，我的 SwiftUI 视图不会更新” → 同时调用 axiom-swiftui 和 axiom-data
• “我的小组件没有显示来自 SwiftData 的最新数据” → 同时调用 axiom-integration 和 axiom-data
• “我的 Foundation Models 会话导致 UI 卡住” → 同时调用 axiom-ai 和 axiom-concurrency
• “Core Data 在后台任务中保存时丢失数据” → 同时调用 axiom-data 和 axiom-concurrency

判断方法：如果问题提到来自两个不同领域的症状，或涉及两个不同的框架，就调用两个路由器。每个路由器都包含常见交叉问题的跨领域路由指南。

向后兼容性

• 仍可直接调用技能：/skill axiom-concurrency
• 命令保持不变：/axiom:fix-build、/axiom:audit accessibility
• Agent 可通过路由或直接调用命令来使用

Axiom 技能不适用的情况

以下情况请跳过 Axiom 技能：

• 非 iOS/Swift 项目（Android、Web、后端）
• 与 Apple 平台无关的通用编程问题
• 关于 Claude Code 本身的问题（请使用 claude-code-guide 技能）

但如果不确定 iOS/Swift 工作是否适用：先检查，再决定。

Device Hub（Xcode 27）

在 Xcode 27 中，Device Hub 是一款独立应用，会在构建并运行时自动启动，用来取代 Simulator.app GUI，并在一个地方管理模拟器和实体设备（Xcode 26 及更早版本仍使用 Simulator.app）。每项操作都有不依赖 Xcode 的 CLI 对应功能，因此 Axiom 工具和脚本不会受到影响。

完整的工具映射（Device Hub / devicectl / simctl / xcui 与 mcpbridge 的对比，以及各自的运行开销）、经过验证的子命令矩阵、统一的 devicectl device capture 截图/屏幕录制路径（适用于模拟器和设备，Xcode 26.6+）、用于准备截图的状态栏覆盖设置（statusBar preset screenshot 和对应的 simctl 命令），以及 Device Hub GUI 参考，请参阅 skills/device-control-ref.md。

资源

技能：axiom-swiftui、axiom-concurrency、axiom-data、axiom-build、axiom-performance

Axiom 工具：axbuild（构建/测试诊断，axiom-build）、xclog（模拟器控制台采集，skills/xclog-ref.md）、xcsym（.ips、MetricKit、旧版 .crash 文本文件和 Xcode Organizer .xccrashpoint 捆绑包的崩溃符号化，skills/xcsym-ref.md）、xcui（可脚本化的模拟器 UI 和无障碍测试，skills/xcui-ref.md）、xcprof（结构化 xctrace CPU 和网络配置文件分析，skills/xcprof-ref.md）、xcproject（只读项目和构建设置检查，axiom-build (skills/build-performance.md)）