mcpField
C
codia-design-skills

codia-design-skills

github.com/codia-ai创意与媒体042 次安装13 周前更新
代码仓库

关于 codia-design-skills

Codia Design Skills 是一组供 Agent 使用的设计技能，通过本地 `codia-design` 命令行调用 Codia Open API。顶层技能负责识别需求并路由到对应流程或图像、文档等单项能力。

主要功能

  1. 01按需求路由到子技能
  2. 02生成及编辑图像相关设计
  3. 03将图像或 PDF 转为可编辑设计数据
  4. 04创建 PDF 转换的 PPTX
  5. 05检查额度、用量和充值设置

适用场景

  1. 01制作电商商品素材或营销视觉
  2. 02将 PDF 页面转成设计数据或 PPTX
  3. 03根据图片生成、修改或检查设计
  4. 04查看账户额度和近期 API 用量

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/codia-ai/codia-design-skills --skill codia-design-skills

安装后在 Claude Code 中输入/codia-design-skills确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.gitignore
AGENT_INSTALL.md
README.md
LICENSE
SECURITY.md

详细介绍

Codia Design Skills

这是 Codia Design Skills 套件的根路由技能。在常规的 npx skills add 安装流程中，Agent 会首先加载此顶层技能。skills/ 下的功能和工作流技能是配套说明，本路由技能会在请求需要特定功能时读取它们。

通过本地 codia-design CLI 使用 Codia。CLI 会向 Codia Open API 发起经过身份验证的请求，并在命令返回文件时将其下载到本地。

运行时设置

运行 Codia 命令前，请检查 CLI 是否可用。

macOS / Linux：

command -v codia-design

Windows PowerShell：

Get-Command codia-design -ErrorAction SilentlyContinue

如果缺少 codia-design，且用户允许全局 npm 安装，请安装运行时：

npm install -g @codia-ai/codia-design-cli

然后验证：

codia-design --help
codia-design auth status

如果全局 npm 安装受阻，请告知用户手动运行相同的安装命令，然后在用户确认安装完成后继续。

身份验证

执行计费操作前，请检查身份验证状态：

codia-design auth status

如果未连接，优先使用浏览器登录：

codia-design auth login --platform codex

如果无法使用浏览器登录，且用户提供了 API 密钥，请在不回显密钥值的情况下进行绑定：

codia-design auth set --api-key api_key_xxx

CLI 将身份验证状态存储在 ~/.codia/design-skills/config.json 中。切勿打印此文件或 API 密钥。

路由规则

运行需要参数、模型选择、轮询行为或多步排序的命令前，请先阅读对应的子技能。路径相对于此根目录下的 SKILL.md 解析。

用户意图阅读
广泛的 Codia 设置、身份验证、账户检查或备用路由skills/codia-design/SKILL.md
产品发布套件、电商商品列表素材、市场视觉素材skills/codia-product-assets/SKILL.md
活动海报、发布视觉素材、社交媒体创意套件、多尺寸适配skills/codia-campaign-assets/SKILL.md
将 PDF／报告／文档转换为可编辑设计数据、PPTX 演示文稿或两者兼有skills/codia-document-deck/SKILL.md
文生图、海报、活动视觉素材、背景skills/codia-image-generate/SKILL.md
基于一个或多个参考图进行图生图skills/codia-image-image-to-image/SKILL.md
基于现有图像生成可控的视觉变体skills/codia-image-remix/SKILL.md
将图像重新构图或适配为新的宽高比skills/codia-image-reframe/SKILL.md
放大图像或提升最终图像质量skills/codia-image-upscale/SKILL.md
移除图像背景或创建透明 PNG 抠图skills/codia-remove-bg/SKILL.md
将背景替换为影棚、生活方式或活动场景skills/codia-image-replace-bg/SKILL.md
从已获授权的图像中擦除不需要的物体、杂物或瑕疵skills/codia-image-object-erase/SKILL.md
从已获授权的图像中移除水印或叠加层skills/codia-image-watermark-remove/SKILL.md
描述、检查、添加说明或分析图像skills/codia-image-describe/SKILL.md
将屏幕截图、UI 模型图、海报或图像转换为可编辑设计数据skills/codia-image-to-design/SKILL.md
将图像转换为 Codia 分层 DSLskills/codia-image-layering/SKILL.md
将选定的 PDF 页面转换为可编辑设计数据skills/codia-pdf-to-design/SKILL.md
将选定的 PDF 页面转换为可下载的 PPTX 演示文稿skills/codia-pdf-to-ppt/SKILL.md
将徽标、图标或图像矢量化为 SVGskills/codia-svg/SKILL.md
检查积分余额skills/codia-credits/SKILL.md
检查使用记录和近期任务费用skills/codia-usage/SKILL.md
查看或更新自动充值设置skills/codia-auto-recharge/SKILL.md

用户需要多个交付成果的实际结果时，优先使用工作流技能。请求是单一且明确的操作时，优先使用功能技能。

常见工作流选择

当用户需要产品或电商交付物（例如商品图片套图、产品发布素材包、商店横幅、白底商品图或生活场景变体）时，使用 skills/codia-product-assets/SKILL.md。

当用户需要营销活动或社交媒体创意素材（例如海报，以及适配后的 1:1、4:5、9:16、横幅或缩略图版本）时，使用 skills/codia-campaign-assets/SKILL.md。

当用户希望将 PDF、报告、截图或现有设计文件转换为可编辑设计数据、PPTX 演示文稿，或两者兼有时，使用 skills/codia-document-deck/SKILL.md。

命令规则

  • 用户提供本地素材时，优先使用本地文件路径。
  • 对于较大的 JSON 响应，使用 --out。
  • 用户指定输出位置时，使用 --download-dir DIR。
  • 只有在用户明确要求仅返回 JSON 时，才使用 --no-download。
  • 对于 PDF，Codia 页码从 0 开始：第 0 页是第一页。
  • 对于 pdf-to-ppt，使用 CLI 轮询和下载流程，并验证返回的 PPTX。除非用户明确要求本地备用方案，否则不要在本地将 PDF 栅格化，也不要创建替代演示文稿。
  • 对于图像生成，如果用户未指定模型或尺寸，首次调用应保持简单。CLI 默认使用 seedream_5，尺寸为 2560x1440。
  • 只有当图像归用户所有或已获得授权时，才进行水印或对象移除。

账户与费用检查

CLI 使用公共 Open API v2 接口（/v2/open/*），并会在付费操作前估算可计费额度。执行可计费命令后，CLI 可能会查询额度，并在余额较低时发出警告。除非 API 本身拒绝请求，否则该警告不应阻止用户要求的工作。

常用命令：

codia-design credits
codia-design usage --page 1 --page_size 20
codia-design limits

输出要求

报告具体结果：本地输出文件路径、已下载的 PPTX 路径、图像文件、返回的 URL、任务 ID，以及任何 API 错误消息。不要包含密钥、原始身份验证配置；如简要概述已足够，也不要提供不必要的完整 JSON。

评论

支持 Markdown