企业官网建设流程全解析

如何给Swift Agent Skills贡献技能：入选目录必须满足的5个条件

【免费下载链接】Swift-Agent-SkillsA curated directory of open-source AI agent skills for Swift and Apple platform development.项目地址: https://gitcode.com/gh_mirrors/sw/Swift-Agent-Skills

Swift Agent Skills 是一个精选的开源 AI Agent 技能目录，收录专为 Swift 和 Apple 平台开发打造的 Agent 技能，可直接用于 Claude Code、Codex、Cursor、Windsurf 等 AI 编程工具。如果你写好了一项 Swift 开发技能，想把它贡献进这个目录，这篇文章会带你完整走一遍流程，并重点讲清入选必须满足的 5 个硬性条件，避免你的贡献被拒绝 🚀

先了解：Swift Agent Skills 收录什么？

这个仓库本身不存放技能代码，而是一个按框架和主题分类的链接目录。打开 README.md 可以看到，技能被组织成十几个板块，包括：

• SwiftUI Skills：视图构建、UI 模式、重构
• SwiftData Skills：数据建模与持久化
• Swift Concurrency Skills：Swift 并发编程
• Swift Testing Skills：测试框架
• App Store、Accessibility、Security、Performance等专题

每个条目的格式都很统一：技能名 + 作者仓库链接 + 作者姓名 + 作者主页链接。你的贡献，本质上就是往这个结构里加一行高质量的链接。

为什么入选门槛这么严格？

项目在 README 开头就有一条醒目的安全提示：安装第三方 Agent 技能前，务必通读内容并确认信任作者，被收录不等于官方背书（见 README.md 的安全警告章节）。

正因为技能会被 AI 编程工具直接读取和执行，目录方明确表态：这里不是"半成品材料的倾倒场"。严格的入选标准，保护的是每一位使用这些技能的开发者。

入选目录必须满足的 5 个条件 📋

以下 5 条规则完整来自 README.md 的 Contributing 章节，缺一不可。

条件一：技能必须是人写的，不是 AI 写的

这是最核心的一条。Agent 技能的价值在于补充 AI 自身不知道的知识——用 AI 去生成这些内容，等于南辕北辙，完全违背了技能存在的意义。

检查方法：你的技能文档里是否包含真实项目中的踩坑经验、具体的 API 边界情况、只有"做过"才写得出的判断？如果删掉这些只剩通用套话，大概率不合格。

条件二：不得抄袭他人的作品

你的技能仓库必须是原创内容。目录方特别强调：应该尊重他人的劳动成果，自己写而不是照搬别人的技能。这一点看似不言而喻，却是最容易被忽视的合规红线。

条件三：使用与 App Store 兼容的开源许可证

技能仓库的 License 必须允许在 App Store 场景下使用，例如：

• MIT
• Apache 2.0
• BSD（2 条款和 3 条款）
• ISC
• Unlicense

⚠️GPLv2、GPLv3 和 LGPL 不被接受。如果你的仓库还没加许可证文件，参考本仓库的 LICENSE（MIT 协议）即可快速配置。

条件四：README 条目的文字长度要与其他条目相当

提交时你往 README 里加的那行文字，长度需要和现有条目保持一致。这条规则的目的是避免某个人或某个团队"占领"整个页面，让目录保持对所有人的公平展示。

条件五：附上可验证身份的个人主页链接

条目格式要求你在姓名旁附上你的个人主页链接（如 README.md 中各条目所示），这样使用者可以核实作者身份、建立信任。没有可追溯的署名，条目无法通过审核。

贡献实操：3 步完成提交 🔧

满足以上 5 个条件后，贡献流程非常简单：

1. 克隆仓库：git clone https://gitcode.com/gh_mirrors/sw/Swift-Agent-Skills
2. 编辑 README.md：找到你技能所属的主题小节（如 SwiftUI、Swift Concurrency），按现有格式追加一行：技能名称、你的仓库链接、你的姓名、你的个人主页链接
3. 提交 Pull Request：附上简短说明，等待审核合入

两个容易被忽视的附加要求 📌

• 遵守行为准则：所有贡献者都同意遵循 CODE_OF_CONDUCT.md，即 Contributor Covenant 社区行为准则
• 技能很多时要做减法：README 特别提醒，如果你有多项技能，请只挑最重要的几个加入，不要让目录看起来像广告轰炸

另外，如果你更习惯用AGENTS.md/CLAUDE.md文件而非 Agent 技能，也可以看看 README.md 的 AGENTS.md files 板块，那里收录了同类资源。

总结：一张清单自查

全部打勾后，你就可以放心提交 Pull Request 了。你的技能一旦入选，就能被全球使用 AI 编程工具的 Swift 开发者所发现 👏

【免费下载链接】Swift-Agent-SkillsA curated directory of open-source AI agent skills for Swift and Apple platform development.项目地址: https://gitcode.com/gh_mirrors/sw/Swift-Agent-Skills