技能介绍

内容创作里被反复消耗的那部分精力

写一篇要被搜索引擎接住的文章，真正的难点从来不是动笔。你要先翻 Ahrefs 里的关键词数据，判断哪个词有搜索量、哪个词的排名难度更现实；再打开 SurferSEO 看 NLP 分析结果，搞清楚同类排名页面都在覆盖哪些语义词；最后还得对照 Clearscope 的内容评分，确认自己写的东西在覆盖广度上没有被甩开。三个工具，三套界面，一套词汇表。把它们手动拼成一份能指导写作的简报，往往比写初稿本身更花时间——而且拼出来的结果经常不完整：字数目标凭感觉定，标题结构缺依据，语义关键词东一个西一个。

这个技能实际做什么

Content Brief Architect 把上面这条链路收进一次调用里，直接产出一份结构化的内容简报。核心流程分三步：

取数：通过 Ahrefs API 拉取关键词数据，确定目标主词与相关词的候选集；同时接入 SurferSEO 的 NLP 分析结果，拿到排名靠前页面在语义层面的覆盖情况。
打分与提炼：用 Clearscope 对候选内容做内容评分，把「该写多深、该覆盖哪些相关词」变成可量化的指标，而不是凭经验拍脑袋。
产出简报：生成一份带目标字数、标题层级和语义关键词集群的完整大纲。关键词被归入集群而不是平铺，写作者能看出哪些词是主轴、哪些是自然穿插的支撑。

对工程师来说，这相当于把一次跨工具的信息整理任务，变成一条可复用的处理流水线。

适用边界与注意点

输出质量直接依赖上游数据源的质量。Ahrefs 的关键词库对某些长尾或新兴垂直领域覆盖有限，SurferSEO 的 NLP 样本也偏向英语大词。如果你的选题落在小众语言或全新赛道，简报里的语义集群可能偏薄，需要人工补数据。
这份简报给的是结构与覆盖建议，不是写作本身。它告诉你目标字数、标题怎么分层、关键词怎么分布，但怎么把这些组织成读起来顺畅的文章，仍然是写作者的工作。
按 SKILL.md 的说明，该技能在执行过程中需要接入 Notion 工作区，并且必须经过用户明确授权才能访问 Notion 页面与数据库。如果你不想在会话中授予这部分权限，需要在调用前做好隔离，或者改用不落库的临时方式处理简报内容。
内容评分本质上是历史排名页面的统计映射，它描述的是「现在有效的做法」，不能保证对未来的算法变化免疫。把它当作决策参考而非绝对规则更稳妥。