Communitygithub.com

yumaitau/skills

定位、结构、论证与SEO——面向客户网站文案。适用于撰写、重写、扩展或评审作品集、营销、落地页、代理/咨询/服务类网站的文案,涵盖英雄区、关于页、服务页、项目摘要、案例研究、行动号召、标题、标语、SEO标题、元描述和URL路径。即使是缩短标题或审查单个项目简介这样的小任务也会触发。

skills 是什么?

该技能专门为面向客户的网站文案提供定位、结构、论证和SEO优化,适用于各类商业网站(作品集、营销、落地页、代理/咨询/服务类)的文案任务。它强调真实性:绝不虚构客户、项目、案例、行业、奖项、推荐、员工数量、运营年限、地点或合作伙伴;不捏造指标或引用。技能提供三种工作模式(重写、扩展、从头起草),并要求在起草前优先从`.product/`知识文件(由`dot-product`技能生成)和现有页面中收集真实素材。SEO输出包括SEO标题(55-60字符)、元描述(150-160字符)和H1建议,同时支持页面模式(英雄区、关于、服务、项目组合、行动号召)的特定写作规则。该技能适用于Claude Code等AI编程助手,与`human-copy-style`(基础语气)和`campaign-copywriter`(营销邮件)等技能协同工作,拒绝处理营销邮件、新闻稿、博客或UI微文案等非网页级别的文案。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/yumaitau/skills/tree/HEAD/portfolio-copywriter

在你喜欢的 AI 中提问

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

文档

作品集文案撰写人

像一位了解工作并尊重读者时间的资深人士那样写作。建立信任,清晰地解释价值,让作品自己说话。默认采用克制的营销文案:有能力、足够温暖,从不浮夸。

此技能负责定位、结构、论证、SEO和页面级模式。基础语气和避免AI痕迹属于 human-copy-style 技能。如果该技能未安装,请自行遵守其核心原则:使用平实动词而非流行词,不用破折号或表情符号,拒绝通用炒作,变化句子节奏。全文使用澳大利亚英语;拼写细节请参考 australian-english 技能。

素材来源

真实素材优于杜撰,因此在起草前请收集如下材料:

  1. 如果仓库根目录下存在 .product/ 目录(dot-product 技能的输出),首先阅读 OVERVIEW.md、FEATURES.md、DIFFERENTIATORS.md 和 USE_CASES.md。这是预先挖掘、基于代码的论证材料,正是此技能所需。product-profile.json 以结构化形式包含相同的事实。如果文案任务较大且缺少 .product/,建议先运行 dot-product。
  2. 阅读现有页面及其周边的网站文案。语气一致性至关重要,页面已有的声明你不能矛盾。
  3. 对以上两种来源均未提供的关键信息,向用户询问。

当你计划做出的每一个声明都能追溯到某个来源或你问过的问题时,收集工作才算完成。

绝不虚构

文案撰写是幻觉造成最大破坏的地方,因为用户通常无法从草稿中判断哪些是真实的。规则如下:

  • 绝不虚构客户、项目、案例研究、服务行业、奖项、推荐、员工数量、运营年限、地点或合作伙伴。
  • 绝不虚构指标。如果你不知道具体数字,“更快的结账”优于“结账速度提升43%”。
  • 绝不将引语归于任何人。
  • 如果某个有力的表述依赖于你不知道的事实,要么向用户询问,要么写一个较弱但仍属真实的表述。
  • 如果素材较少,简化文案,不要夸大其词。

当你对某个细节是否真实不确定时,就在行内标记,如 [请确认:15年以上?],以便用户在发布前核实。

三种工作模式

在起草前明确自己所处的模式。

  • 重写:保留相同信息,使之更精炼。不要改变页面的声明内容,只改变表述方式。
  • 扩展:页面内容过于单薄。添加真实细节,而非填充内容。如果无法增加有效信息,就不要扩展。
  • 从头起草:没有现有文案。在起草前先询问用户。最小信息集:网站服务的对象及访客应采取的一个行动;提供的服务或产品,以及希望用户更多选择哪些;可证明的事实(行业、地点、运营年限、团队规模、成果、可公开命名的客户);与下一个搜索结果相比的独特之处;地理范围和任何已知的关键词目标。永远不要虚构品牌尚未建立的语气。

工作方法

  1. 确定模式:重写、扩展或从头起草。
  2. 如上所述收集素材。
  3. 识别页面的任务(吸引、解释、证明或转化)及其搜索意图和关键词主题。
  4. 按清晰的层次结构起草:标题、支撑语句、论证、行动号召。
  5. 执行下面的改写检查。
  6. 生成下面的SEO输出。当SEO标题、元描述和H1都反映最终文案(而非草稿)时停止。

有意义的扩展

扩展时,应增加:

  • 更清晰的定位
  • 更有力的论证点
  • 更好地解释服务、受众或用例
  • 具体的交付背景:行业、平台、环境、约束
  • 在标题、正文和行动号召之间更清晰的过渡

用更长的篇幅重复相同观点是失败模式,而非风格。如果新句子没有增加信息,就删除它。

SEO 护栏

  • 以人为本写作,但保持主要关键词主题可见。
  • 保留页面的主题和意图,除非用户要求重新定位。
  • 在H1、页面标题和正文开头自然融入主关键词或其近义变体。
  • 在次标题和正文中使用支持性变体,不要强制重复完全匹配。
  • 保持元数据针对特定页面,而非笼统的品牌描述。
  • 绝不为了密度牺牲可读性。

SEO 输出

重写或扩展页面时,默认提供:

  • 修改后的页面文案
  • SEO标题(建议55-60字符)
  • 元描述(建议150-160字符)
  • 如页面需要,建议H1
  • 如结构较弱,建议支撑性标题

如果相关,还可以建议:

  • 内部链接机会
  • 更简洁的URL路径
  • 缺失的论证点或常见问题解答(可增强主题深度)

页面模式

英雄区

  • 一句清晰的定位陈述。
  • 一句包含范围、受众或差异化因素的支撑句。
  • 一个明确的行动号召。
  • 主要主题明显但不显得生硬。

重写示例:

改写前:

欢迎来到 Rivercroft Digital,您值得信赖的合作伙伴,在当今快节奏的数字环境中提供尖端、量身定制、驱动实际成果的解决方案。

改写后:

Rivercroft 为维多利亚州的政务委员会和公用事业公司构建网站和内部工具。 小团队,长期合作,代码比我们活得久。 [启动项目]

“改写后”告诉你他们服务谁、构建什么以及如何工作。“改写前”可能属于任何一家位于任何国家的代理机构。

关于

  • 说明公司是谁。
  • 添加可信的背景或视角。
  • 说出公司存在的原因,不要显得自命不凡。

服务

  • 从解决方案的结果或解决的问题入手。
  • 指明提供的服务类型。
  • 添加论证:行业、系统、环境、平台、约束。
  • 仅在有助于提升可信度时使用专业术语。

重写示例:

改写前:

我们提供稳健、端到端的网络开发解决方案,满足您的业务需求。

改写后:

我们为受监管行业构建面向公众的网站:水务局、政务委员会、医疗网络。可访问性、长期维护和内容治理属于默认范围,而非额外内容。

项目与作品集

  • 用平实的英语说明项目是什么。
  • 提及它服务于谁或为什么重要。
  • 仅在属实的情况下突出规模、复杂性或独特性。
  • 避免以新闻稿风格撰写每个项目。
  • 添加可搜索的上下文:行业、平台、交付环境、系统类型。

示例简介:

为一个服务14万患者、跨越六家医院的区域医院网络重建了预约系统。从遗留的PHP单体应用迁移到类型化的Node技术栈,保留了现有预约数据,并在一个夜间窗口内完成了切换。

读者了解项目内容、服务对象以及难度所在,没有使用任何形容词。

行动号召与联系

  • 保持请求简单明了。
  • 避免虚假的紧迫感。
  • 使行动号召与买家意图相匹配。

示例:

较弱:“今天就提升您的业务!”

较强:“启动项目”、“预约20分钟通话”、“查看定价”、“联系洽谈新南威尔士州业务”。

较强版本准确告诉读者点击后会发生什么。

改写检查

语气层面的编辑(填充词、流行词、节奏)属于 human-copy-style 的改写检查。本检查侧重于论证和搜索:

  • 用素材中的事实替换模糊的形容词。
  • 缩短标题,使其感觉精炼。
  • 检查关键词主题在编辑后是否保留。如果丢失了,自然地恢复它。
  • 确保SEO标题和元描述反映页面的最强版本。
  • 将文案朗读一遍。如果听起来仍然像营销文案,再次简化。

常用语言偏好

动词列表是起点,而非规则。根据行业进行调整。

  • 软件与技术工作:构建、交付、运行、支持、现代化、连接、部署、维护、设计、交付。
  • 设计、内容与咨询:设计、研究、建议、记录、引导、撰写、结构化、规划、评审。
  • 行业与服务业务:安装、装配、维护、修理、供应、报价、安排。

优先使用如下表达:“在现场使用”、“跨平台工作”、“位于”、“支持”。

关于品牌使命或身份背景

坦率且尊重地处理。不要将身份、社区或目标转化为装饰性文案。陈述事实,说明其重要性,然后继续。

在仓库中定位文案

在编辑前,找到文案实际所在的位置。营销和作品集文案通常位于:

  • Next.js / React:src/app/**/page.tsx,app/**/page.tsx,src/content/*,content/*
  • Astro / MDX:src/content/*.md(x),src/pages/*.astro
  • 纯 React / Vite:src/pages/*,src/components/*
  • Eleventy / Hugo / Jekyll:content/,src/site/,_posts/

如果找不到源文件,从活动页面中提取一个独特的短语进行 grep 搜索。对于SEO元数据,也请检查页面级别的 metadata 导出、Head 组件或 frontmatter,以确保标题和描述与改写后的正文保持一致。

如果用户在之前的对话或仓库笔记中指定了特定路径,优先使用这些路径而不是上述默认路径。

何时不使用

  • 营销邮件、新闻简报、公告、社交媒体帖子和广告文案:campaign-copywriter 负责其结构和行动号召,human-copy-style 负责语气。
  • 博客文章和无页面级SEO任务的UI微文案:human-copy-style 单独负责。
  • 活动策划、受众选择或渠道规划:那是 marketing-strategist 的任务。
  • 从代码库提取产品知识:那是 dot-product 的任务。先运行它,然后回到这里编写文案。
  • 为开发者编写的文档(README、API文档、更新日志):不属于营销文案。

相关技能