安装
/plugin marketplace add Kimeur/duology
/plugin install duology@duology适合谁
- 在 Mac(Apple silicon)上用 Claude Code 开发 iPhone Duo 折叠屏 App 的开发者。官方把 Duology 定位为一组“在 iPhone Duo 上设计、构建、测试并交付 App”的 Claude Code skills,以
duology插件形式分发,内容覆盖四块:layout patterns(折叠布局模式)、app recipes(应用配方)、一个 fold linter 和 pose checks(姿态检查)。这些内容服务于官方所说的设计、构建、测试与交付流程;如果你的工作是把界面适配到 iPhone Duo 的折叠形态上,这套 skills 针对的就是这类任务。它是面向 App 开发流程的工具集,不是通用的文本检查或写作助手。 - 环境前提有三样:Apple silicon 的 Mac、Xcode 27.1(27A9275 或更高版本)和 Claude Code。官方列出的环境要求即这三项,缺任一项时能否使用未说明,应视为未确认。
- 主力 agent 是 Cursor、Codex、Copilot、Gemini CLI 或其他客户端的用户:官方对这类环境标注为 skills only,即只安装 skills 本身;slash 命令与 lint hook 属于 Claude Code 特性,安装路径也不同。这些 skills 在此类客户端里能完成哪些任务,官方未说明;如果你的客户端里无法触发相应检查,官方也没有给出替代方案。
- 官方未说明它是否适用于 iPhone Duo 以外的设备,也未说明对自然语言或注释语言的支持范围,这两点不要自行假设。
3 分钟完成第一次尝试
主路径只有一条:在 Claude Code 中通过插件市场安装 duology——官方把插件市场列为主安装路径——然后对 App 做一次折叠屏设计检查。
前提:一台 Apple silicon 的 Mac,装好 Xcode 27.1(27A9275 或更高版本)与 Claude Code,并准备一个 iPhone Duo App 项目。
- 在 Claude Code 会话中依次执行两条官方命令:
/plugin marketplace add Kimeur/duology添加插件市场,/plugin install duology@duology安装duology插件。duology是官方建议最先安装的插件。 - 安装完成后,在同一会话里让 agent 检查你的 App 的折叠屏设计。官方对这项检查的说明是:它会运行
duo-lint和 15 点检查清单(15-point checklist)。 - 观察成功信号:agent 返回待修问题清单,“列出需要修复的内容,最严重的排在最前”。如果只得到安装确认而没有问题清单,说明检查没有真正执行,应重新发起任务。
动作前须知:官方对这项检查的描述止于运行 duo-lint 与 15 点检查清单并列出待修问题;它是否还会读写文件、执行命令或访问网络,官方未写明。首次运行时留意 agent 的实际动作,确认输出符合预期后再继续。
使用案例
案例一:一轮大改之后给折叠屏布局做体检。场景:你的 App 刚完成一轮 iPhone Duo 适配改动,想知道当前最严重的问题是什么、先修哪一个。发起:在 Claude Code 中让 agent 检查当前 App 的折叠屏设计;按官方说明,检查对象就是你的 App。用到的真实工作流:检查会运行 duo-lint 与 15 点检查清单。可期待结果:一份按严重程度从高到低排列的待修问题清单,可以按顺序逐项处理;清单条数、具体格式与是否附修复代码,官方未说明,清单之后如何逐项修复也没有官方流程。
案例二:在非 Claude Code 客户端中引入这套 skills。场景:你日常主要在 Cursor、Codex、Copilot 或 Gemini CLI 里工作,希望这套 skills 就近可用。发起:在对应环境执行 npx skills add Kimeur/duology。用到的真实工作流:官方标注的 skills only 安装,即只装入 skills 本身。可期待结果:官方说明 CLI 会把 skills 放到 agent 查找的位置;可确认到安装这一步,之后能触发哪些任务、结果与 Claude Code 是否一致,需在你的客户端里自行验证。如果 skills 无法按预期触发,先回到 Claude Code 主路径确认功能本身正常。
使用边界
- 平台差异要分开对待:插件市场是 Claude Code 的安装面,上面两条命令以斜杠命令形式在 Claude Code 内执行;Cursor、Codex、Copilot、Gemini CLI 等走
npx skills add Kimeur/duology,且仅为 skills only。不要把后者当成插件市场安装,也不要假设两条路径能力一致。 - 副作用与确认点:官方未写明检查是否会修改文件、执行命令或访问网络,也没有关于确认点的官方说明;这些属未确认信息,动手前以第一次尝试中的注意事项为准。
- 依赖关系:
duology-recipes与duology-ship依赖duology,后者提供/duo-doctor;duology-design与duology-features可单独安装,但其 skills 指向duology的 skills(duo-layout、duo-continuity、duo-scenes),官方建议先安装duology。 - 运行环境:skills 面向 iPhone Duo 折叠屏上的 App 开发;模拟器与真机的差别、对具体 Xcode 项目结构的要求,官方未说明。
- 版本:官方写明 Xcode 27.1(27A9275 or later),即以 27A9275 为最低要求;后续是否调整以官方页面为准。
- 尚未确认的关键信息:
/duo-doctor的具体功能、各 skill 与各扩展插件的具体用途和触发方式、iPhone Duo 之外设备的适配情况、检查输出的详细格式,官方页面均未写明;在官方补充之前,任何一项都不要当成已支持。