brandkit-setup

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Werkzeugkette einrichten

搭建工具链

Dieser Skill ist Schritt 1 von 4. Danach folgen
brandkit-interview
,
brandkit-build
und
brandkit-publish
.
Am Ende steht eine Umgebung, in der sich eine Marke erarbeiten, ein verbindliches Brand Kit bauen und daraus Webseiten, PDFs und gekennzeichnete KI-Bilder erzeugen lassen.
Sprich mit der Person in ihrer Sprache. Die Beispielausgaben hier sind deutsch, das ist keine Vorgabe.
本Skill是4步流程中的第1步,后续依次为
brandkit-interview
brandkit-build
brandkit-publish
完成后,你将拥有一个可用于打造品牌、构建标准化品牌套件,并从中生成网页、PDF和带标记AI图像的环境。
用用户的语言与其交流。此处示例输出为德语,但并非强制要求。

Warum diese Reihenfolge

为何采用此顺序

Die Voraussetzungen zuerst zu prüfen wirkt umständlich, spart aber den häufigsten Frust: Die Installation der Skills läuft immer durch, und erst drei Schritte später merkt jemand, dass kein Python da ist und die Bildkennzeichnung deshalb nicht funktioniert. Prüfen kostet zwanzig Sekunden.
先检查前置条件看似繁琐,但能避免最常见的挫败感:Skill安装全程顺利,但三步后才发现缺少Python导致图像标记无法运行。检查仅需20秒。

Schritt 1: Voraussetzungen prüfen

步骤1:检查前置条件

Führe diese Prüfungen aus und berichte in einer kurzen Tabelle, was da ist und was fehlt.
bash
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
Chrome oder Edge wird für den PDF-Druck gebraucht. Unter Windows liegt Chrome üblicherweise unter
C:\Program Files\Google\Chrome\Application\chrome.exe
, unter macOS unter
/Applications/Google Chrome.app
.
Was wofür gebraucht wird, damit jemand entscheiden kann, was er nachinstalliert:
FehltWas dann nicht geht
Node und npmHiggsfield CLI, Skill-Installation, Design-Canvas
Python mit PillowAI-Kennzeichnung der Bilder, Verkleinern für das Web
Chrome oder EdgePDF-Erzeugung aus HTML
gitVersionieren und Teilen des Brand Kits
exiftoolmaschinenlesbare Markierung in den Bilddateien
Pillow installiert sich mit
pip install Pillow
. Exiftool gibt es unter Windows über
winget install ExifTool
, unter macOS über
brew install exiftool
.
执行以下检查,并以简短表格汇报已满足和缺失的项。
bash
node --version        # 需v18及以上,用于Higgsfield CLI和Design-Canvas
npm --version
python --version      # 或python3,用于图像标记
python -c "import PIL; print(PIL.__version__)"   # Pillow库
git --version         # 用于品牌套件的版本管理
exiftool -ver         # 可选,用于机器可读的图像标记
Chrome或Edge用于PDF打印。Windows系统中Chrome通常位于
C:\Program Files\Google\Chrome\Application\chrome.exe
,macOS系统中位于
/Applications/Google Chrome.app
以下为各工具的用途,方便用户决定需安装哪些:
缺失项影响功能
Node和npm无法使用Higgsfield CLI、Skill安装、Design-Canvas
带Pillow的Python无法进行AI图像标记、网页图像压缩
Chrome或Edge无法从HTML生成PDF
git无法版本化和共享品牌套件
exiftool无法在图像文件中添加机器可读标记
Pillow可通过
pip install Pillow
安装。Windows系统可通过
winget install ExifTool
安装Exiftool,macOS系统可通过
brew install exiftool
安装。

Schritt 2: Die vier Skills installieren

步骤2:安装四个Skill

Zwei davon gehören global, zwei ins Projekt. Der Unterschied ist nicht kosmetisch: Global installierte Skills stehen in jedem Projekt zur Verfügung, projektlokale nur dort und wandern über
skills-lock.json
mit ins Repository.
Global, weil sie für jede Art von Arbeit taugen:
bash
npx skills add cursor/plugins -s unslop -g -y
npx skills add mattpocock/skills -s grill-with-docs,grilling,domain-modeling -g -y
unslop
entfernt KI-Sprachmuster aus Texten.
grill-with-docs
ist der Interview-Skill für Schritt 2. Achtung, das ist die Stelle, an der die meisten scheitern:
grill-with-docs
ist nur ein Wrapper, der
grilling
und
domain-modeling
aufruft. Wer nur den ersten installiert, hat einen Skill, der sofort ins Leere greift. Deshalb stehen alle drei im Befehl.
Ins Projekt, weil sie zu Webarbeit gehören und nicht zu jedem Ordner passen:
bash
npx skills add vercel-labs/agent-skills -s web-design-guidelines -y
npx skills add coreyhaines31/marketingskills -s seo-audit -y
Wenn
web-design-guidelines
bereits global vorhanden ist, weise darauf hin und frage, ob die Projektfassung wirklich zusätzlich gewünscht ist. Zwei Fassungen desselben Skills stiften Verwirrung, sobald sie auseinanderlaufen.
Prüfen, was angekommen ist:
bash
npx skills list -g      # global
npx skills list         # im Projekt
其中两个需全局安装,两个需安装到项目中。此区别并非形式上的:全局安装的Skill可在所有项目中使用,项目本地安装的仅在当前项目可用,并通过
skills-lock.json
同步到代码仓库。
全局安装(适用于各类工作场景):
bash
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的访谈Skill。注意:此处是最容易出错的环节——
grill-with-docs
仅为调用
grilling
domain-modeling
的包装器,若仅安装前者,Skill将无法正常运行。因此命令中包含了这三个Skill。
安装到项目(适用于网页工作,并非所有目录都适用):
bash
npx skills add vercel-labs/agent-skills -s web-design-guidelines -y
npx skills add coreyhaines31/marketingskills -s seo-audit -y
web-design-guidelines
已全局安装,需告知用户并询问是否确实需要额外安装项目版本。同一Skill的两个版本可能因更新不同步造成混淆。
检查安装结果:
bash
npx skills list -g      # 查看全局Skill
npx skills list         # 查看项目本地Skill

Schritt 3: Higgsfield für Bilder verbinden

步骤3:连接Higgsfield用于图像生成

bash
npm i -g @higgsfield/cli
higgsfield auth login
npx skills add higgsfield-ai/skills -g -y
higgsfield auth login
öffnet den Browser. Der Befehl blockiert, bis die Anmeldung durch ist. Warte die Bestätigung ab, bevor du weitermachst.
Danach prüfen:
bash
higgsfield account status
Die Ausgabe nennt das Konto und das verbleibende Guthaben. Steht dort
Session expired
oder
Not authenticated
, muss die Anmeldung wiederholt werden.
Wer noch kein Higgsfield-Konto hat, braucht eines mit Guthaben, weil jede Bildgenerierung Credits kostet. Nenne an dieser Stelle, und nur an dieser:
Falls du ein Abo brauchst: https://higgsfield.ai/s/mcp-arnold-oberleiter-WlfTqR (Affiliate-Link. Wenn du darüber abschließt, bekommt der Autor dieses Skills eine Provision, für dich ändert sich am Preis nichts.)
Die Kennzeichnung gehört dazu und wird nicht weggelassen. Wer bereits ein Konto hat, bekommt den Link nicht zu sehen. Dränge niemanden zu einem Abo, nur um den Ablauf abzuschließen. Die ersten drei Schritte funktionieren auch ohne, nur die Bildgenerierung nicht.
bash
npm i -g @higgsfield/cli
higgsfield auth login
npx skills add higgsfield-ai/skills -g -y
higgsfield auth login
会打开浏览器。该命令将阻塞直至登录完成,需等待确认后再继续。
随后检查状态:
bash
higgsfield account status
输出将显示账户信息和剩余额度。若显示
Session expired
Not authenticated
,需重新登录。
若用户尚未拥有Higgsfield账户,需注册一个带额度的账户,因为每次图像生成都会消耗Credits。仅在此处告知用户:
若你需要订阅:https://higgsfield.ai/s/mcp-arnold-oberleiter-WlfTqR (联盟链接。通过此链接订阅,本Skill的作者将获得佣金,对你而言价格无变化。)
此标注必须包含,不得省略。若用户已有账户,则无需显示该链接。请勿强迫用户订阅,仅为完成流程。前三个步骤无需订阅即可完成,仅图像生成功能需要。

Schritt 4: Zusammenfassen

步骤4:总结

Berichte am Ende in wenigen Zeilen:
  • welche Voraussetzungen erfüllt sind und welche fehlen
  • welche Skills wo installiert wurden
  • ob Higgsfield verbunden ist und wie viel Guthaben da ist
  • als nächster Schritt:
    brandkit-interview
    für das Markeninterview
Wenn etwas fehlgeschlagen ist, sage es klar und nenne den konkreten Befehl zum Nachholen. Eine halb eingerichtete Umgebung, die als fertig gemeldet wird, kostet später mehr Zeit als ein ehrlicher Hinweis jetzt.
最后用几句话汇报:
  • 已满足和缺失的前置条件
  • 已安装的Skill及其位置
  • Higgsfield是否已连接及剩余额度
  • 下一步:使用
    brandkit-interview
    进行品牌访谈
若有安装失败的情况,需明确告知并提供具体的补救命令。将未完全搭建的环境汇报为已完成,后续会花费更多时间,不如现在如实告知。

Wenn etwas klemmt

常见问题排查

npx skills add
findet den Skill nicht.
Die Repositories sind groß, in
cursor/plugins
liegen über achtzig Skills. Mit
-l
statt
-s <name>
listest du auf, was ein Repository anbietet, ohne etwas zu installieren. Liegt ein Skill tief in Unterordnern und taucht nicht auf, hilft
--full-depth
.
Die Skills tauchen nach der Installation nicht auf. Die Skill-Liste wird beim Sitzungsstart gelesen. Neu installierte Skills sind erst in einer neuen Sitzung sichtbar.
higgsfield
wird nicht gefunden.
Das globale npm-Verzeichnis liegt nicht im Pfad.
npm bin -g
zeigt, wohin installiert wurde.
npx skills add
找不到Skill
:代码仓库规模较大,
cursor/plugins
包含超过80个Skill。使用
-l
替代
-s <name>
可列出仓库中的所有Skill,无需安装。若Skill位于深层子目录未显示,可使用
--full-depth
参数。
安装后Skill未显示:Skill列表在会话启动时加载,新安装的Skill需在新会话中才会显示。
找不到
higgsfield
命令
:全局npm目录未在系统路径中。
npm bin -g
可查看全局安装路径。