Communitygithub.com

设计交接

将已定稿文案转换为设计规范,涵盖区块类型、用途、内容层级、组件、响应式意图、视觉层级、强调、首屏优先级和浏览路径。

设计交接 是什么?

该技能(AI Agent技能)旨在将已定稿的营销文案转化为可直接用于设计交接的结构化规范,适用于 Claude Code、Cursor 等 AI 编码/设计辅助工具。其核心价值在于弥合文案团队与设计团队之间的鸿沟:文案定稿后,设计师或线框图生成器需要的不仅是文字本身,更是每个文字区块对读者施加的具体心理作用、顺序,以及哪些效果必须在小屏设备上保留。技能通过四个步骤实现转化:首先,根据每个区块的规格(类型、用途、内容层级、组件、响应式意图)将其映射到具体组件;其次,撰写不关注外观、只关注结构与内容功能的线框图简报;然后,编写涵盖视觉层级、强调、首屏优先级和浏览路径的精化规范;最后,仅在指定了构建平台(如 WordPress)时,才加载特定的平台注意事项。技能明确区分了“推断的”与“意图的”规格,避免设计师基于错误意图进行布局。它不重写文案、不选择视觉风格、不评估已发布页面,也不实际构建页面。最终输出一份包含组件映射、线框图简报、精化规范和平台注意事项(如适用)的单一交接文档。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ianrexexanes/nca-conversion/tree/HEAD/skills/design-handoff

在你喜欢的 AI 中提问

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

文档

设计交接 是做什么的?

文案已定稿。设计师或线框图生成器从文案中需要的并非词语本身——而是每个词语区块需要如何影响读者、以何种顺序影响、以及哪些影响必须在手机端保留。此技能将前者转化为后者,且不对文案已决定的内容做任何额外决定。

前提:已定稿文案 + 每个区块一份区块规格

两个输入,第二个常被遗漏。

已定稿文案,而非草稿。 围绕仍在争论中的段落构建的布局会被重建,而重建结果总是更糟,因为它变成了对原有形状的修补——而原有形状是为不同词语选择的。如果文案仍在变动,请停止操作并明确告知。

每个区块一份区块规格。 ../conversion-page-build/SKILL.md 在与文案一同输出的同时,在其 ## 区块规格 标题下生成了这份规格,本技能仅通过五个关键名称读取它:section_type、purpose、content_hierarchy、components、responsive_intent。该文件拥有规格的形式以及其在文案之后而非之前编写的理由。

没有规格就到达的文案仍然可以交接——首先根据文案编写规格,并在输出中将其标记为推断的。从已完成文案反向工程的规格记录了文案看起来要做的事,这与它原本被构建要做的事并非同一回事。两者不一致时,设计师将忠实地布局错误的意图,且下游无法捕捉到该错误。

执行顺序

四个步骤。前三步始终执行,第四步通常不执行。

  1. 将每个区块规格映射到组件——references/section-to-component.md。将五个关键名称转化为每个区块的组件列表,外加该区块中约束布局的那一个特性。
  2. 编写线框图简报——references/relume-brief.md。页面级框架,然后每个区块一个段落:结构与内容功能,不涉及外观。
  3. 编写精化规范——references/figma-refinement-spec.md。视觉层级、强调、首屏优先级和扫描路径:这四个线框图无法确定的事项。
  4. 平台注意事项,有条件地——见下文。

第2步和第3步故意保持为两个独立的文档,且按此顺序。原因在 references/figma-refinement-spec.md 的开头有说明,此处不再重复。

平台检查仅在指定平台名称时运行

除非构建目标已被明确指定且为 WordPress,否则不要打开 references/platform-notes-wordpress.md。 Webflow 构建、Framer 构建、手写代码构建以及未命名构建在此均不加载任何内容。

这并非归档整洁性问题。平台注意事项描述的是在一个平台上真实、在另一平台上虚假的约束,因此携带不适用约束的规格会使设计师解决一个本不存在的问题——然后在有人质疑时为该解决方案辩护。错误的注意事项比没有注意事项代价更高。

如果目标尚未命名,请询问。如果答案是“尚未决定”,则编写无平台的手稿输出,并在输出中记录平台检查未运行,以便后续接手构建的人知道该检查尚未完成,而非认为它已通过。

每个平台文件具有完全相同的结构且不包含其他内容: 每个行为一条备注,每条备注说明三件事——平台行为、该行为导致的失败、以及可避免该失败的措辞。本技能中没有对应文件的平台不获取备注;切勿默认使用 WordPress 的备注,这正是条件检查所要防止的具体错误。

工具名称写在门上,而非方法中

两个参考文件以工具命名——references/relume-brief.md 和 references/figma-refinement-spec.md——因为这是人们要求的名称。两者均不依赖于工具,且均不声称任何工具会如何对待它所收到的内容。

此限制是刻意的。声称“工具 X 接受如此形状的描述”的技能是在对别人的产品做出声明,该声明会悄然过时,而读者无法区分当前声明与两年前的声明。因此,这些文件描述文档包含的内容以及其形状的成因。当某件关于工具的事项确实经过验证时,文件会注明验证日期,并仅说明验证所涵盖的内容。

注册信息仅在唯一位置进入设计

注册信息继承自转换简报,此处不再重新决定;其背后的理由属于 ../audience-research/SKILL.md。五个配置文件本身位于 ../audience-research/references/register-profiles.md。

它触及本技能中的一个决策:页面允许花费多少强调。 其他所有内容都是结构性的且保持不变——相同的区块无论对谁都必须对读者施加相同的作用。references/figma-refinement-spec.md 承载了这一个交叉点,并且它是本技能中唯一读取注册行数据的文件。

本技能不做什么

  • 不重写文案。 如果某个区块因文案从未说明其用途而无法布局,当问题在于措辞时,这是 ../copy-sweeps/SKILL.md 的职责;当问题在于缺少参数时,这是 ../conversion-page-build/SKILL.md 的职责。明确指出属于哪一种,并停止操作。
  • 不选择视觉风格。 没有调色板、没有字体比例、没有间距值、没有断点数值。它设定层级和关系;设计系统提供数值。references/figma-refinement-spec.md 完整说明了拒绝的原因以及当没有可提供数值的设计系统时应如何处理。
  • 绝不处理已发布的页面。 此技能向前运行,从已定稿文案朝向尚未构建的布局。评判现有布局则反向运行,需要本技能不包含的证据——../conversion-page-audit/SKILL.md。
  • 不进行构建。 平台注意事项的存在使得规格不会要求构建目标无法低成本实现的某些内容。它们不是构建说明,也不会使本技能成为构建技能。

未解决事项

任何手稿无法根据文案和简报解决的内容,在文档中统称为 未建立 — <可解决该问题的事项>,而非猜测。此原则及理由在整个插件中的 ../audience-research/SKILL.md 中说明一次,此处适用不变。最常见的两种情况是:布局依赖但尚未生成的素材;以及文案承诺但尚不存在的证据元素。

输出结果

一份单一的手稿文档。在本库的文件系统中,它位于 03 Projects/<项目>/<页面>/[C] 设计手稿 — <页面>.md;在其他位置,则放置于项目保存规格之处。它按顺序包含:每个区块的组件映射、线框图简报、精化规范,以及——仅当指定了平台时——适用的平台注意事项。

请说明您将其归档的位置,并说明平台检查是否已运行。对平台保持沉默的手稿,会被解读为平台已做过检查的手稿。

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

ianrexexanes/nca-conversion

Use before writing landing/sales page or campaign copy when the audience isn't documented. Produces a Conversion Brief: ICP, personas, ranked problems, voice-of-customer, competitors, differentiation, objections, proof, register. Required before conversion-page-build; optional for conversion-page-audit.

ianrexexanes/nca-conversion

Use when auditing a live landing page, sales page, pricing page or signup flow for conversion problems — given a URL or a page the user wants reviewed. Produces a ranked report: Fix now, Test don't guess, Not a problem, and Could not check. Also use when the user says 'audit this page', 'why isn't this converting', 'review my landing page', 'CRO audit', 'conversion audit', or pastes a URL and asks what is wrong with it. Works without a Conversion Brief but notes its absence as a limitation.

ianrexexanes/nca-conversion

Use when writing or rewriting copy for a landing page, sales page, homepage, pricing page or opt-in page — after the audience is documented. Walks hero, problem, outcome, solution, mechanism, value stack, proof, objections, guarantee, CTA and FAQ, deciding what each section must accomplish before writing it. Also use when the user says 'write the landing page', 'rewrite this page', 'page copy', 'sales page', 'I need copy for', or hands over an offer and asks for a page. Requires a Conversion Brief — runs audience-research first if none exists.

ianrexexanes/nca-conversion

Use when editing or tightening any written marketing copy — page copy, an email, a proposal, an ad, a post. Runs seven passes: Clarity, Voice, So What, Prove It, Specificity, Heightened Emotion, Zero Risk. Also use when the user says 'edit this', 'tighten this copy', 'make this better', 'this reads flat', 'punch this up', or pastes copy and asks for a second look. Optional expert-panel mode.

ianrexexanes/nca-conversion

Use when writing hooks, headlines, hero lines, subject lines, ad hooks or CTA copy, including quick one-off variant requests. Crosses eight hook types (outcome, time, effort, callout, contrarian, pain, mechanism, transformation) with register. Also use when the user says 'give me headlines', 'hook ideas', 'hero line', 'subject line', 'CTA copy', 'punchier headline', or asks for variants of a line.

ianrexexanes/nca-conversion

Use when designing, packaging or pricing an offer — before any page exists. Covers Value Equation diagnosis, obstacle mapping, value stack, guarantees and risk reversal, price anchoring, and pitch formats. Also use when the user says 'design an offer', 'package this', 'what should I charge', 'pricing', 'guarantee', 'value stack', 'grand slam offer', or describes a service and asks how to sell it.

相关技能