swift-formatstyle-agent-skill
帮助AI助手生成现代Swift格式化代码的Agent Skill
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：swift-formatstyle-agent-skill。 它的用途是：帮助AI助手生成现代Swift格式化代码的Agent Skill 完整的 Skill 内容见：https://321skill.com/skills/swift-formatstyle-agent-skill/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“/swift-format-style 请审查并替换这个Swift文件里所有旧的数字和日期格式化代码。” 它会自动扫描代码，识别出像`String(format: "%.2f", value)`或`DateFormatter`这样的旧模式，并将其转换为使用`Decimal.FormatStyle`或`Date.FormatStyle`的现代等价实现。你也可以说：“用Swift Format Style技能把这段时长计算代码改成使用`Duration.FormatStyle`。”
介绍
这个Skill旨在解决AI助手（如Claude、Cursor、Gemini）在生成Swift代码时，因训练数据滞后而频繁使用旧式格式化API的问题。LLM的训练数据大多早于iOS 15，导致其倾向于生成String(format:)、DateFormatter、NumberFormatter等传统代码，而非苹果官方推荐的现代FormatStyle和.formatted() API。
使用方式非常便捷。在支持的AI助手（如Claude Code、Cursor）中，通过输入特定命令（如/swift-format-style或$swift-format-style）即可触发该Skill。你可以让它审查整个项目的格式化代码，或针对特定指令（如“修复日期格式化”）进行局部优化。它还能通过自然语言指令调用，例如“使用Swift Format Style技能审查这个项目的格式化代码”。
它非常适合Swift/iOS/macOS开发者，尤其是那些希望代码库保持现代、可维护且遵循苹果最新最佳实践的团队或个人。当你在使用AI助手编写或审查涉及数字、日期、货币、度量单位、列表、人名、字节数等格式化需求的Swift代码时，这个Skill能提供极大帮助。
与同类工具或技能相比，它的核心区别在于其精准的“纠偏”定位。它不是泛泛的代码质量检查工具，而是专门针对Swift格式化这一具体领域，主动识别并替换那些过时但AI又极易生成的“反模式”代码，引导开发者使用更安全、更本地化、更符合Swift设计理念的现代API。
核心特点
该Skill专门针对LLM因训练数据滞后而产生的“历史惯性”进行纠偏，能精准识别并替换`String(format:)`、旧式`Formatter`子类等过时代码，引导使用Swift 5.7+和iOS 15+的现代`FormatStyle` API。它不是通用的代码检查工具，而是聚焦于Swift格式化这一具体领域的“现代化”助手。
注意事项
该Skill主要适用于Swift项目，且要求项目目标平台为iOS 15+、macOS 12+或相应版本的Swift 5.7+，对于需要支持更早系统版本或使用其他编程语言的项目不适用。
常见问题
这个Skill支持哪些AI助手？
支持Claude Code、Cursor、Gemini、Codex等遵循Agent Skills格式的AI编码助手。
使用这个Skill需要安装Node.js吗？
推荐使用`npx`命令安装，这需要Node.js环境。但也可通过AI助手特定的插件命令（如Claude Code的`/plugin install`）或直接克隆仓库来安装。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/swift-formatstyle-agent-skill/raw/index.md 读取 swift-formatstyle-agent-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/swift-formatstyle-agent-skill/raw/index.md（查看排版版本）