swift-api-design-guidelines-agent-skill
为AI编码工具提供Swift API设计规范指导
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：swift-api-design-guidelines-agent-skill。 它的用途是：为AI编码工具提供Swift API设计规范指导 完整的 Skill 内容见：https://321skill.com/skills/swift-api-design-guidelines-agent-skill/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘使用swift-api-design-guidelines skill，审查这段Swift函数在命名、参数标签和API清晰度方面的问题。’ 它会加载该Skill的检查清单，分析你的代码，并依据Swift API设计指南，提供关于命名是否清晰、参数标签是否符合语法、术语使用是否一致等具体改进建议。
介绍
这个Skill旨在解决Swift开发者设计和审查API时，命名、参数标签、术语使用和文档注释等环节缺乏标准化指导的问题。它将官方的Swift API设计指南提炼成可操作的检查清单和具体参考，帮助开发者创建出意图清晰、调用流畅、语义明确的API。
使用方式非常灵活，可以通过命令行工具一键安装，或配置到Claude Code等AI编码工具的插件市场中。安装后，开发者只需在AI工具中调用该Skill，即可获得针对特定代码片段的API设计审查和建议。
它非常适合正在设计或评审Swift API和SDK接口的团队，以及需要重构现有API以提高代码可读性和调用点清晰度的开发者。任何希望编写出更符合Swift社区惯例、减少歧义的API的人都能从中受益。
与同类工具或通用代码审查Skill相比，它的核心区别在于其专注性和非主观性。它不提供泛泛的代码风格建议，而是严格遵循Swift官方的设计哲学，专注于API在调用点的正确性和清晰度，确保建议与Swift语言社区的公认最佳实践保持一致。
核心特点
专注于Swift官方API设计指南，提供非主观、基于社区共识的规范性指导，而非泛泛的代码风格建议。
注意事项
主要适用于Swift语言的API设计审查，不适用于其他编程语言或非API层面的代码质量问题。
常见问题
这个Skill支持哪些AI编码工具？
支持遵循Agent Skills开放格式的工具，如Claude Code、Cursor等，也可通过命令行工具skills.sh安装。
它能帮我审查Objective-C的API吗？
不能，它专门针对Swift语言的API设计规范，不适用于Objective-C或其他语言。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/swift-api-design-guidelines-agent-skill/raw/index.md 读取 swift-api-design-guidelines-agent-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/swift-api-design-guidelines-agent-skill/raw/index.md（查看排版版本）