AI 学习资料推荐文章应该怎么写，才不是链接搬运

AI 学习资料推荐稿的任务不是证明作者收藏很多，而是替读者完成一次投入判断：资料讲什么、适合谁、从哪开始、要花什么成本、做完能留下什么，以及哪些结论仍未验证。

先看一段失败稿

“这个 GitHub 项目非常全面，包含大量 AI 工程内容，适合所有开发者收藏。项目更新活跃，建议从头学完。”

这段话没有原始链接、核验日期、前置要求、课程结构、学习产物，也没有解释“全面”和“活跃”的证据。它只能制造收藏冲动，不能帮助行动。

把它改成资料导读

“该仓库面向已有 Python、Linux 和 Docker 基础的工程师，目录覆盖容器、Kubernetes、MLOps、GPU 与 LLM Infra。第一次不要通读：先查看 prerequisites，再选择 Project 01，交付镜像、部署资源、监控和 CI 记录。仓库公开时长是维护者估算，本站未独立计时。”

这里对应的真实资料入口是 AI Infra Engineer Learning 仓库、课程目录与前置自测。示例只转述公开页面能支持的结构，不声称本站已经完成整套课程。

改写后，读者知道了进入门槛、目录边界、第一步和证据性质。推荐变成一条可执行路线。

一句话解读：好的资料稿不是替读者说“值得”，而是让他知道在什么条件下值得。

一句话解读：来源链接解决“事实从哪里来”，作者判断解决“这件事实对当前读者意味着什么”。

本站 skill 的来源边界

写作规范位于项目内 content/skills/learning-resource.md，它是本站仓库的相对路径说明，不声称存在可公开访问的 GitHub 页面。此前指向外部分支的链接已删除，避免把 404 写成“已核验可访问”。

写作前核验表

至少确认原始 URL、推荐来源、资料类型、维护信号、许可证、目录/模块、前置要求、作业或项目、预计投入。无法确认的数字写“未标明”；仓库最近推送只算维护信号，不算质量证明。

正文不必固定十章

课程导读可以先讲项目和学习曲线；工具清单可以按问题分组；路线图可以按阶段与产物展开；两门课程对照则应直接展示证据和评分。skill 规定的是读者必须得到的信息，不是要求所有文章复制同一组标题。

三类“一句话解读”怎样避免口号

总判断要指出资料的真实用途；模块判断要解释某部分解决什么工程问题；曲线判断要说明困难为何上升。比如“进入评估阶段后，难点从调用工具转为定义正确答案”，它能回到具体学习动作，比“从入门到精通”更有信息。

一句话解读：学习曲线写得合格的标志，是读者能据此预留环境排错、项目实践或团队协作的时间。

完整曲线至少分三段：第一段写前置和最快反馈，说明读者应产出什么小结果；第二段写概念或工具开始叠加的拐点，说明必须用哪个项目支撑；第三段写生产、评估或协作责任，说明哪些结论不能仅靠课程证明。只写“适合初学者到进阶者”，没有信息价值。

质量审核门槛

发布前逐项检查：外部事实有链接和日期；资料卡说明适合与不适合；项目或作业有具体产物；学习路线有止损点；许可区分代码、文档与商业部分；没有虚构运行结果；跨稿扫描没有整段复用。任何一项不满足都退回修订。

最常见的失败

把 README 自述当成本站实测；用 star、排行榜或精确时长制造权威感；列十个链接却没有分配任务；每篇文章都套“结论、模块、曲线、误区、下一步”同一文案；为了金句牺牲事实边界。这些问题会让内容看似完整，实际无法信任。

例如一篇稿子写“维护活跃、两周学会”，审核时却只能找到一次最近提交，找不到课程官方时长和作者的实际计时。这不是措辞问题，而是证据等级被抬高了：应改成带日期的维护信号，并删除“两周学会”。另一个边界是许可证，代码可复用不等于文档可全文搬运。

一篇稿子的最低可行学习与生产路径

回到原始资料并记录核验日期；写一句读者问题；选择一个最小项目或作业；围绕它解释目录、难点与投入；补适合/不适合和许可；最后让另一名审核者检查事实、原创度和可执行性。编辑不能只检查错别字。

把流程压成五个可验收步骤：保存原始 URL 与推荐来源；截取目录、项目、维护和许可四类证据；写三种一句话解读；给出 3–5 步最低学习路径与停止条件；最后逐项标注“来源事实、作者判断、未实测”。前置知识必须写到具体能力，例如 Python、Linux、Docker，而不是“有一定基础”。

可发布的完成状态

读者看完能做三件事：决定是否进入，选出第一项行动，说明何时停止。文章也应诚实区分公开文档证据、作者推论和实际运行结果。做到这一步，资料推荐才不是链接搬运。

下一步拿站内一篇现有资料稿做逆向审核：先遮住形容词，只看 URL、项目产物、曲线、最低路径和边界是否仍能支持推荐。若不能，先补证据，不继续润色标题。

编辑退回示例

若稿件写“最近很火”却没有样本范围，退回补来源；写“亲测可用”却没有运行记录，改成公开文档判断；十篇文章共享同一段学习曲线，则整段删除后按题目重新论证。审核意见必须指出证据缺口，不能只写“再深入一点”。