brandkit-setup

设置工具链

这是 4 个步骤中的第 1 步。接下来依次是 brandkit-interview、 brandkit-build 和 brandkit-publish。

完成后，你将拥有一套环境，可用于打造品牌、构建规范的 Brand Kit，并据此生成网站、PDF 和带有标记的 AI 图片。

请用对方使用的语言交流。这里的示例输出是德语，并非要求你也使用德语。

为什么按这个顺序

先检查前提条件看起来有些麻烦，却能避免最常见的挫败：技能总能顺利安装，直到三个步骤之后，才有人发现没有 Python，导致图片标记功能无法使用。检查只需 20 秒。

步骤 1：检查前提条件

执行以下检查，并用简短的表格报告已安装和缺少的项目。

node --version        # ab v18, für die Higgsfield CLI und den Design-Canvas
npm --version
python --version      # oder python3, für die Bildkennzeichnung
python -c "import PIL; print(PIL.__version__)"   # Pillow
git --version         # zum Versionieren des Brand Kits
exiftool -ver         # optional, für die maschinenlesbare Bildmarkierung

打印 PDF 需要 Chrome 或 Edge。Windows 上的 Chrome 通常位于 C:\Program Files\Google\Chrome\Application\chrome.exe，macOS 上则位于 /Applications/Google Chrome.app。

下面说明缺少哪些项目会导致什么功能无法使用，以便对方决定要安装哪些项目：

缺少	无法使用的功能
Node 和 npm	Higgsfield CLI、技能安装、设计画布
Python 和 Pillow	AI 图片标记、缩小图片以用于 Web
Chrome 或 Edge	从 HTML 生成 PDF
git	为 Brand Kit 做版本控制和分享
exiftool	在图片文件中添加机器可读的标记

Pillow 可通过 pip install Pillow 安装。Windows 上可通过 winget install ExifTool 安装 Exiftool，macOS 上则可通过 brew install exiftool 安装。

步骤 2：安装四个技能

其中两个全局安装，两个安装到项目中。区别并非表面上的差异：全局安装的技能可用于每个项目，项目级技能只能在对应项目中使用，并会通过 skills-lock.json 一并进入代码仓库。

全局安装，因为它们适用于各种工作：

npx skills add cursor/plugins -s unslop -g -y
npx skills add mattpocock/skills -s grill-with-docs,grilling,domain-modeling -g -y

unslop 用于去除文本中的 AI 语言模式。grill-with-docs 是步骤 2 中使用的访谈技能。注意，多数人会在这里出错：grill-with-docs 只是一个调用 grilling 和 domain-modeling 的封装。只安装前者，技能就会立即因找不到依赖而失效。因此，命令中包含了这三个技能。

安装到项目中，因为它们与 Web 工作相关，并不适用于每个文件夹：

npx skills add vercel-labs/agent-skills -s web-design-guidelines -y
npx skills add coreyhaines31/marketingskills -s seo-audit -y

如果 web-design-guidelines 已全局安装，请说明这一点，并询问是否确实还需要安装项目版本。同一技能的两个版本一旦出现差异，就会造成混淆。

检查安装结果：

npx skills list -g      # global
npx skills list         # im Projekt

步骤 3：连接 Higgsfield 以生成图片

npm i -g @higgsfield/cli
higgsfield auth login
npx skills add higgsfield-ai/skills -g -y

higgsfield auth login 会打开浏览器。该命令会一直等待，直到登录完成。等待确认后再继续。

然后进行检查：

higgsfield account status

输出会显示账户和剩余余额。如果显示 Session expired 或 Not authenticated，则必须重新登录。

如果还没有 Higgsfield 账户，需要注册一个并充值，因为每次生成图片都会消耗积分。只有在此处提及，而且只能在此处提及：

如果你需要订阅：https://higgsfield.ai/s/mcp-arnold-oberleiter-WlfTqR （联盟营销链接。如果你通过此链接订阅，作者会获得佣金，你支付的价格不会因此改变。）

必须保留这项标记，不得省略。已有账户的用户不会看到此链接。不要为了完成整个流程而催促任何人订阅。前 3 个步骤无需账户也能完成，只有图片生成功能无法使用。

第 4 步：总结

最后用几行报告：

• 哪些前提条件已满足，哪些尚未满足
• 哪些技能安装在了什么位置
• Higgsfield 是否已连接，以及还有多少额度
• 下一步：使用 brandkit-interview 进行品牌访谈

如果有任何步骤失败，请明确说明，并给出用于补做的具体命令。与其把只配置了一半的环境报告为已完成，不如现在如实说明，这样可以避免之后浪费更多时间。

遇到问题时

npx skills add 找不到该技能。 这些仓库很大，cursor/plugins 中有八十多个技能。使用 -l 而不是 -s <name>，即可列出仓库提供的内容，而不会安装任何东西。如果某个技能藏在很深的子目录中，未能显示出来，可以使用 --full-depth。

安装后没有看到这些技能。 技能列表会在会话启动时读取。新安装的技能只有在新会话中才会显示。

找不到 higgsfield。 全局 npm 目录不在路径中。npm bin -g 会显示安装位置。