justinwetch/HIGAgentSkills

它是什么

apple-hig 是一个面向对话式 AI 代理的 技能（插件），让代理能够回答关于苹果人机界面指南（HIG）的问题。该仓库附带一套精简且经源审核的 157 条 HIG 参考（从约 26.2 万字缩减至约 9 万字），以及一个特殊的 /duo 斜杠命令，指导 iOS 开发者将现有应用适配到新的可折叠 iPhone Duo（iOS 27）。该技能不包含任何机器学习模型；它仅提供精选文本和宿主代理可调用的确定性工作流。

核心功能

功能	作用
HIG 参考语料库	157 个主题文件（references/hig/*.md），包含苹果官方指南中的确切措辞、数值和条件，重写为更短但保持保真度。
/duo 命令	多步骤工作流（commands/duo.md）：1️⃣ 评估应用代码中的屏幕，2️⃣ 将其与苹果的 Duo 指南匹配，3️⃣ 提供带 SwiftUI 预览的选项，4️⃣ 生成所需的 SwiftUI/UIKit 更改，5️⃣ 在 iPhone Duo 模拟器中验证。
强制模式（可选）	当被要求时，技能可运行“审查并修复”循环，由两个独立审查者评分 UI（要求 90/100 通过）。最多重复三个周期，如果宿主提供必要的子代理和工件访问权限，则自动修复问题。
路由辅助	一个小型 Python 脚本（scripts/hig_route.py），根据字面匹配将用户请求映射到适当的参考文件，保持令牌负载较低。
打包	一个确定性 ZIP 构建器（scripts/package_runtime_zip.py）创建仅包含所需文件（SKILL.md、routing-index.md、references/、commands/）的运行时包。

如何安装

1. 复制粘贴提示 – 将提供的文本块粘贴到 AI 代理的聊天中。代理将克隆仓库，将 apple-hig/ 文件夹放入其技能目录，并注册 /duo 命令。
2. 手动安装 – 下载 ZIP，将整个 apple-hig/ 文件夹解压到代理的技能位置，并确保存在 SKILL.md 和 commands/ 文件夹。
3. 斜杠命令注册 – 某些代理自动检测 commands/duo.md；其他代理需要您将该文件复制到代理的自定义斜杠命令目录并重启宿主。
4. 验证 – 要求代理定位技能并报告其版本（2026-09-27）以及 /duo 是否可用。

典型用法

使用 apple-hig 审查此 iOS 应用的导航和可访问性。

代理将加载相关基础文件、平台特定的 HIG 部分以及任何一跳相关指南，然后使用源条款的直接引用和简洁建议进行回答。

Duo 工作流示例

/duo 图书馆和阅读流程

该命令引导开发者完成：

1. 评估 – 扫描应用的 SwiftUI/Storyboard 文件。
2. 匹配 – 将每个屏幕与 Duo 检查清单进行比较。
3. 决定 – 显示 SwiftUI 预览选项并请求确认。
4. 构建 – 编写必要的代码更改。
5. 验证 – 在 iPhone Duo 模拟器中运行应用（如果可用）。 项目中保留 duo-notes.md 文件，以便后续 /duo continue 可以从中断处继续。

强制模式示例

使用 apple-hig 强制模式审查并修复此界面。

技能生成两个审查子代理，对 UI 评分，应用修复，并重复直到达到通过阈值或三个周期耗尽。

技术要求

• Python 3.10+ – 用于路由辅助和强制模式评分。
• 无需特殊硬件；技能可在任何能读取纯文本 Markdown 文件的宿主上工作。
• 代理必须支持自定义斜杠命令或能够从技能目录加载文件。

许可证与归属

• 代码和精简参考文件根据 MIT 许可证 发布。
• 底层苹果 HIG 材料仍归苹果所有；仓库包含 NOTICE 文件，澄清该项目与苹果无关。

---

本摘要仅基于仓库的 README；未推断任何额外功能。