SuperAPI AI 工具集

resource-curator

写作与研究

查看项目

更新于 10-15 15:12

技能介绍

用途

该技能用于为 JavaScript 概念文档页面查找、评估、添加和维护高质量的外部资源(文章、视频、课程),并审计现有资源中的失效链接和过时内容。

主要能力

技能围绕五个阶段展开资源管理工作:

  1. 审计现有资源:检查链接可访问性(是否返回 200)、验证内容准确性、检查发布日期、识别过时内容、审查描述是否具体。
  2. 识别资源缺口:对照目标数量(参考 2-4 个 MDN 链接、文章 4-6 篇、视频 3-4 个、课程 1-3 个可选、书籍 1-2 本可选)检查是否覆盖初学者和进阶学习者、是否包含可视化内容、是否包含官方参考、教学风格是否多样。
  3. 查找新资源:使用定向搜索查询在可信来源中查找文章、视频和 MDN 文档。
  4. 撰写描述:每条资源需要具体且有价值的描述,公式为:第一句说明资源独特之处或具体覆盖内容,第二句说明读者点击的理由(能获得什么、适合谁)。
  5. 格式化与组织:使用正确的 Card 语法和图标,按逻辑排序(基础在前,进阶在后),保持格式一致。

可信来源

技能列出了参考来源、文章来源、视频创作者和课程来源的优先级列表。参考来源包括 MDN Web Docs、ECMAScript 规范、Node.js 文档、Web.dev、Can I Use。文章来源包括 javascript.info、MDN Guides、freeCodeCamp、2ality、CSS-Tricks、dev.to、LogRocket Blog、Smashing Magazine、Digital Ocean、Kent C. Dodds。视频创作者包括 Fireship、Web Dev Simplified、Fun Fun Function、Traversy Media、JSConf/dotJS、Academind、The Coding Train、Wes Bos、The Net Ninja、Programming with Mosh。课程来源包括 javascript.info、Piccalilli、freeCodeCamp、Frontend Masters、Egghead.io、Udemy、Codecademy。

质量准则

必须具备:链接有效(返回 200)、以 JavaScript 为主、技术准确、可访问(免费或有有意义的免费预览)。

最好具备:足够新近、来源可靠、视角独特、深度适当、互动良好。

拒绝标志:到处使用 var、教授反模式、主要涉及其他语言、硬付费墙、现代主题使用 2015 年前内容、低质量评论、事实错误、标题党且内容单薄。

发布日期指南

针对时间敏感主题,优先选择最近 3-5 年的内容;对于基础概念(闭包、作用域、this),较老的经典内容通常也很好。具体最低年份要求:ES6+ 特性 2015+、Promises 2015+、async/await 2017+、ES Modules 2018+、可选链 2020+、空值合并 2020+、顶层 await 2022+、DOM 操作 2018+、Fetch API 2017+。

描述撰写指南

提供了好例子和坏例子对比,以及应避免的词汇(如“comprehensive guide to...”“learn all about...”“everything you need to know...”)和推荐使用的短语(如“step-by-step walkthrough”“visual explanation”“deep dive into”“finally makes X click”)。

链接审计流程

包括检查每个链接的 HTTP 状态(200 保留、301/302 更新为最终 URL、404 移除或替换、403 手动检查、5xx 稍后重试)、内容验证、描述审查和缺口分析。

资源区块模板

提供了参考、文章、视频、书籍、课程等区块的 Card 语法模板,以及资源审计报告模板,包含摘要、资源数量对比目标、失效链接、重定向、过时资源、描述改进、缺失资源、非 JavaScript 资源、行动项和验证清单。

适用场景

  • 向新概念页面添加资源
  • 刷新现有页面的资源
  • 审计失效或过时链接
  • 审查社区贡献的资源
  • 定期链接维护

限制

该技能主要针对 JavaScript 概念文档的资源管理,不涉及其他编程语言的资源管理。技能中未提供具体的收费、价格或平台信息。