Communitygithub.com

Alessiawondering/ielts-learning-studio-skill

可复用的 Codex 技能,用于从 Google Drive 材料构建个性化雅思学习工作室。

ielts-learning-studio-skill 是什么?

该技能专为 Codex 等 AI 编程助手设计,旨在根据用户提供的 Google Drive 学习材料(如 DOCX 高亮文本、PDF 词汇表),自动化构建一个功能完备、个性化的雅思学习网站。它严格遵循“为当前学习者定制”的原则,不会复用或暴露其他学习者的数据。技能的核心工作流程包括:引导用户配置学习偏好(如学习类别、存储方式)、解析并标准化学习材料中的知识点(如提取词汇、搭配,并规范化其形式)、构建完整的学习闭环(包括笔记、闪卡、语音回放、测试等模块),并确保学习状态在设备本地持久化。该技能最终会生成一个独立、可访问的学习站点,并附带各功能的简要说明,非常适合需要基于个人材料进行系统化雅思备考的学习者。支持的平台包括 Codex 及其他遵循类似技能规范的 AI 代理。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add Alessiawondering/ielts-learning-studio-skill

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

构建雅思学习工作室

为当前学习者创建一个完整、可用的学习站点。将任何现有的雅思网站仅作为行为参考。切勿复制其他学习者的 Drive URL、文档、日期、主题、保存点、收藏夹、错误或部署身份。

从学习者开始

在一组最多三个问题中,收集仅缺失的决策:

  1. 询问学习者的 Google Drive 文件夹 URL,或是否从本地上传/手动粘贴开始。
  2. 确认学习类别和启用的模式。默认为听力、阅读、口语、写作、笔记、闪卡、中译英测试、收藏夹和错误笔记本。
  3. 确认存储预期:默认为设备本地持久化,或在明确请求时使用经过身份验证的跨设备持久化。

当请求已回答这些问题时立即继续。在生成可用的第一个屏幕之前,不需要示例文档。

在实施之前,请阅读 product-contract.md。在配置 Drive、持久化、共享或部署时,请阅读 customization-and-privacy.md。使用 acceptance-tests.md 进行最终验证。

构建工作流

  1. 检查工作区并保留其框架和设计约定。当 .openai/hosting.json 存在时,使用 Sites 构建和托管工作流。
  2. 创建一个首次运行设置,用于存储当前学习者的文件夹 URL 和偏好。不要将参考学习者的值硬编码为默认值。
  3. 在打磨次要 UI 之前实施摄入管道:
    • 列出学习者 Drive 文件夹中的支持文件;
    • 解析 DOCX 的黄色高亮和修订跟踪,不限制数量;
    • 从 PDF 中提取工作表词汇;
    • 当没有高亮或更正时,从普通文本中提取有价值的语言;
    • 为文件创建指纹,以便添加、编辑和删除能干净地更新站点。
  4. 在提取的每个知识点到达笔记、卡片或测试之前进行标准化:
    • 使用可复用的词元或词典形式;
    • 除非语法要求复数,否则使用单数名词;
    • 保留被动分词,例如 be accompanied by;
    • 保留所需的动名词,例如 prevent someone from doing something;
    • 将依赖介词和完整搭配保持在一起;
    • 将包含多个可学习单词或搭配的句子拆分为单独的知识点;
    • 排除名称、格式垃圾和低价值更正。
  5. 为每个接受的知识点补充准确的中文含义、用法、示例、发音、搭配、来源句子、日期、主题以及一个或多个雅思类别。当丰富失败时,切勿显示占位符解释;重试或标记该项目以供审查。
  6. 当相同的表达出现在多个类别中时,保留一个逻辑知识点,但在每个适用的类别中显示它。
  7. 构建完整的学习循环:笔记本、学习卡片、语音播放、收藏夹、限定范围测试、提示、三次错误后揭示、持久化错误笔记本以及每日/主题存档。
  8. 持久化学习者状态。设备本地存储必须能在刷新和浏览器退出后存活。仅当用户请求基于帐户或跨设备行为时,才使用服务器持久化。
  9. 验证 acceptance-tests.md 中的行为,成功构建,并私有发布,除非学习者明确选择另一种访问模式。

适配规则

  • 允许学习者更改标签、启用的类别、主题命名约定、测试范围以及视觉方向,而不会削弱提取的正确性。
  • 从文件名和文档标题推断日期、主题和类别。当推断不明确时,提供可编辑的回退选项。
  • 偏好安静、专注工作型的界面,适合日常重复。保持控件紧凑且响应迅速;不要将产品变成营销登录页面。
  • 当学习者尚未拥有 Drive 文件夹时,保持上传和粘贴文本的完全可用性,并将 Drive 连接作为可选的下一步。
  • 诚实地解释公共链接的限制。公共 Drive 文件夹 MVP 不等同于私有 OAuth 访问。

完成标准

以学习者的独立站点 URL 和已启用功能的简要总结结束。坦率说明任何不可用的集成。不要暴露源凭据、内部项目 ID、参考学习者数据或部署内部信息。

相关技能