nova-d2c design handoff CLI
GPT 5.5 Ready · Handoff v2 · @nova-infra/d2c 2.2

nova-d2c把 Figma 设计交给 Agent 前，先整理成可执行 handoff

CLI 优先，不调用模型，不直接生成业务代码。nova-d2c 负责把 Figma 设计整理成清晰、可交接、可校验的任务包，让后续 Agent 少猜、少漏、按参考图对齐。

开始使用 查看命令文档
install + build handoff codegen/react 
$ npm install -g @nova-infra/d2c
$ nova-d2c --json handoff build <figma-url|file-key> \
  --node-id 1:2 \
  --out ./handoff \
  --profile codegen \
  --target react
设计参考与上下文覆盖 visual handoff
Figma Reference visual input
nova-d2c reference asset preview
Agent Context node trace
nova-d2c context overlay preview 结构 文本 资源 校验
结构层级摘要
文本内容提取
资源引用对齐
样式视觉线索
校验还原检查
Figma to Agent

把设计交接变成可执行任务

输入 Figma URL 和目标节点，nova-d2c 整理结构、文案、资源和参考图，输出给 Agent 可直接接手的 handoff，减少猜测和遗漏。

nova-d2c 从 Figma URL 到 Agent 实现和参考验收的 handoff flow 链路示意图
Agent 消费路径 clear handoff
任务说明

把目标、输出期望、边界和优先级交代清楚，减少实现前的来回确认。

页面上下文

把页面结构、组件层级、主要文案和视觉关系整理成 Agent 容易读取的说明。

资源引用

把参考图和导出资源放在稳定位置，避免实现时路径混乱或引用丢失。

验收清单

围绕视觉还原、内容完整、移动端适配和资源引用做可执行检查。

结构摘要让 Agent 先理解页面骨架和重点区域。
视觉对照保留可检查的参考输入，突出还原效果。
资源路径把实现需要的图片和引用整理到稳定位置。
验收标准把交付检查变成明确步骤，而不是口头感觉。
CLI first

常用命令一页看完

从环境检查到节点定位，再到资源导出和 handoff 生成，入口保持稳定，适合本地脚本、CI 和 Agent 工作流直接调用。

命令速查

nova-d2c doctor检查 token、API 和本地缓存状态。
nova-d2c init初始化本地配置。
nova-d2c --json files get <figma-url|file-key>获取文件级上下文。
nova-d2c --json nodes explore <figma-url|file-key>浏览页面和组件层级。
nova-d2c --json nodes resolve <figma-url|file-key> [--name <keyword>]按名称关键词定位节点。
nova-d2c --json nodes get <figma-url|file-key> --node-id 1:2读取指定节点上下文。
nova-d2c --json tree get <figma-url|file-key> --node-id 1:2读取节点树结构。
nova-d2c --json tokens styles <figma-url|file-key> --node-id 1:2提取样式信息。
nova-d2c --json tokens variables <figma-url|file-key> --node-id 1:2提取变量信息。
nova-d2c --json assets export <figma-url|file-key> --node-id 1:2 --out ./assets导出实现需要的资源。
nova-d2c --json handoff build <figma-url|file-key> --node-id 1:2 --out ./handoff --profile codegen --target react生成 Agent handoff 任务包。
nova-d2c --describe --format skill输出给 Agent 使用的命令说明。
Product boundary

专注 handoff，不接管代码生成

nova-d2c 负责把设计整理成稳定输入；具体实现仍交给你的工程栈和 Agent 流程，边界清楚，结果更容易验收。

nova-d2c 做什么

  • 抽取 Figma 文件、节点、树、tokens 和 assets
  • 生成 handoff 任务包和验收输入
  • 为 Agent 实现、评审和脚本化流程提供稳定输入

nova-d2c 不做什么

  • 不在 CLI 里直接生成 React / Vue / SwiftUI 代码
  • 不引入 MCP server、Express server 或模型 API 依赖
  • 不把无法追溯的截图猜测当作设计事实

先把 Figma 变成可靠上下文，再让 Agent 开工

安装 npm 包，生成 handoff，把任务说明、页面上下文和参考资源交给你的实现 Agent。

npm install 查看命令