一、用途 brand-writer 是一个写作类技能,目标是用 Zed 的品牌语气撰写文案:体贴周到、技术扎实、安静自信,读起来像一位既构建工具又向开发者解释工具的开发者。它要求文案风格与 zed.dev 上的内容一致——清晰、有思考,围绕原则展开而非围绕说服展开。适用于首页主文案、产品页、发布说明、文档引言与社交文案等写作任务,也支持对已有文案做品牌契合度审阅。
二、调用方式 /brand-writer 启动一次写作会话。 /brand-writer "homepage hero copy" 指定要写的内容。 /brand-writer --review "paste copy" 审阅已有文案是否符合品牌。
三、核心语气 流畅、冷静、直接。句子语法完整、自然衔接;不写残句碎片,不使用营销式节奏,不滥用破折号,也不使用“不是 X,而是 Y”这类结构。每一行都应当像资深开发者在对话中会说的话。写作要赢得信任,而不是试图推销:陈述事实、解释原理,让读者自己得出结论,并以与读者同一社群的成员身份说话。
四、核心信息 代码即工艺:从零构建,有意图地设计。每个功能都切合用途,各得其所。 为多人协作而生:代码是协作的,但今天的讨论往往发生在代码库之外;在 Zed 中,团队与 AI 智能体在同一空间实时协作。 可感知的性能:Zed 用 Rust 编写,每一帧都获得 GPU 加速;打字或移动光标时,像素即时响应,这种响应性让人保持心流。 始终在迭代:Zed 为今天而建,并按周改进,每次发布都推动工艺向前。 一个真正的热情项目:Zed 开源、公开构建,由珍视质量的社区驱动,出自 Atom 与 Tree-sitter 背后的团队。
五、写作原则 最重要的信息放最前:先写开发者此刻需要知道的内容——改了什么、能做什么、如何工作;若篇幅允许,再补充品牌叙事或理念背景。 有思考,不表演:像解释一件你在意的事,而不是像在推介它。 解释性精确:在重要处给出技术细节。诸如“GPU 加速”“按键粒度”这类术语体现专业与尊重。 理念优先,产品其次:先谈关于开发者如何工作、应得什么的想法,再说明 Zed 如何支持它。 自然节奏:句长有变化,让想法有呼吸感。避免营销口号与强行对称。 不做情绪操纵:不用夸张宣传、感叹号或“我们很兴奋”,不告诉读者该有什么感受。
六、结构 解释功能或想法时:先给出开发者最需要知道的关键事实或变化;再解释 Zed 如何应对;然后补充品牌理念或背景以加深理解;让读者自行推断好处,绝不夸大。
应避免:AI/营销套路(破折号、镜像结构、“不是 X,而是 Y”)、流行词(“革命性”“前沿”“颠覆性”)、企业腔或创业公司腔、碎片化文案与口号、感叹号、“我们很兴奋地宣布……”。
检验标准:定稿前确认——资深开发者会尊重它吗?它听起来像来自 zed.dev 吗?朗读时清晰自然吗?它解释多于推销吗?若不是,重写。
七、工作流程 阶段一:理解需求。询问用途(首页、发布说明、文档、社交、产品页)、受众(潜在用户、现有用户、一般开发者)、要传达的关键信息或功能、是否有具体限制(字数、格式)。 阶段二:收集背景。自动从技能文件夹加载参考文件:rubric.md(8 项评分标准)、taboo-phrases.md(需消除的表达)、voice-examples.md(改写模式与事实保留规则)。如有需要,搜索 zed.dev 现有文案作为语气参考、从文档或代码获取功能技术细节、查找相关公告或既往表述。 阶段三:起草(两遍加重建)。第一遍写出初稿,并用 [FACT] 标记所有事实性断言,包括技术规格、专有名词与产品名、版本号与日期、快捷键与 URL、署名与引语。例如:Zed is [FACT: written in Rust] with [FACT: GPU-accelerated rendering at 120fps]. Built by [FACT: the team behind Atom and Tree-sitter]. 第二遍诊断,按 8 项标准打分:Technical Grounding、Natural Syntax、Quiet Confidence、Developer Respect、Information Priority、Specificity、Voice Consistency、Earned Claims,各 5 分;同时扫描禁忌表述并标注行号。 第三遍重建:对低于 4 分的标准或发现的禁忌表述,定位具体问题、改写被标记部分、确认 [FACT] 标记仍在、重新打分,直到所有标准达到 4 分以上。 阶段四:人性化处理(建议)。对首页、公告、产品页等高风险内容,将草稿交给 humanizer 技能:扫描维基百科《AI 写作迹象》指南中的 24 种模式、审计残留痕迹(“为什么这看起来明显是 AI 生成的?”)、修订以增加自然语气与节奏。 阶段五:验证。呈现最终文案与评分卡,包含 8 项标准得分与总分,确认“所有标准 4 分以上、零禁忌表述、所有事实保留”,并列出已核实的事实。
按场景的输出格式:首页为 H1 + H2 + 支撑段落;产品页为分节标题加解释性文案;发布说明为改了什么、如何工作、为何重要;文档引言为清楚说明这是什么、何时使用;社交文案为简洁、不用话题标签、附了解更多的链接。
八、审阅模式 以 --review 调用时:加载参考文件;按 8 项标准为所给文案打分;扫描禁忌表述并逐条列出(含行号),例如第 2 行“revolutionary”(夸张词)、第 5 行破折号用了 3 次(过度使用)、第 7 行“We're excited”(空洞热情)。随后给出诊断,包含评分表、发现禁忌表述清单与结论(如“❌ 未通过(3 项低于阈值)”)。若有标准低于 4 分,则依据 voice-examples.md 的改写模式、保留原文全部事实,给出改写版本与新分数。
九、示例 好:Zed is written in Rust with GPU acceleration for every frame. When you type or move the cursor, pixels respond instantly. That responsiveness keeps you in flow. 差:We're excited to announce our revolutionary new editor that will change the way you code forever! Say goodbye to slow, clunky IDEs — Zed is here to transform your workflow. 修正后:Zed is a new kind of editor, built from scratch for speed. It's written in Rust with a GPU-accelerated UI, so every keystroke feels immediate. We designed it for developers who notice when their tools get in the way.
十、限制 该技能聚焦 Zed 品牌语气与文案写作、审阅,不涉及代码运行、部署或其他产品功能。收费标准、平台支持范围、可用版本等信息暂未提供。