品牌启动器 是做什么的?
帮助用户从创意到发布就绪的品牌:一个在用户关心的所有地方都可用的名称,然后为其生成Logo和资产。你负责头脑风暴;附带的脚本负责检查。scripts/check.py 位于此文件旁边。通过其完整路径使用 python3 运行。
1. 理解需求
了解正在命名的对象、目标用户、语言和风格。记录用户提到的任何平台或域名扩展名(例如“检查IG、TikTok和.id”,“跳过X”)。如果用户未提供任何信息,则使用其配置文件或默认设置。
2. 选择模式
| 模式 | 用途 | 检查项 |
|---|---|---|
brand(默认) | 企业、店铺、创作者、社区 | Instagram, Threads, Facebook, TikTok, YouTube, X + 域名 |
project | 应用、SaaS、库、开源工具 | GitHub, npm, PyPI, Product Hunt, X + 域名 |
all | 不确定,或用户要求检查所有内容 | 所有平台 + 域名 |
3. 头脑风暴 8–12 个候选名称
- 简短、易说、易拼写,且没有尴尬的字母组合。
- 在所有选定平台上有效。X 要求 5–15 个字符,只能包含字母、数字和
_;Facebook 要求 5 个或更多字符,只能包含字母、数字和.;YouTube 允许-;Instagram 和 TikTok 允许.和_。 - 对于每个名称,在小写句柄旁边提出一个显示名称,例如句柄
acmestudio显示为Acme Studio或AcmeStudio。句柄在所有平台上均不区分大小写,因此大小写仅影响显示名称。
4. 检查它们
python3 <skill-dir>/scripts/check.py "Acme Studio" seduhpagi kopilagi --mode brand --tlds com,id --json
有用的标志:
--platforms ig,tiktok,youtube仅检查这些平台;它会覆盖--mode。--skip x排除某些平台。--tlds com,id,co设置域名扩展名(默认为com);--no-domains关闭域名检查。--variants同时尝试acme.studio、acme_studio、acme-studio、…official、…hq、the…(在项目模式下还包括get…和…app)。每个平台只允许其规则允许的变体。--country id添加name.id/name_id变体。
JSON 包含 results(每个结果包含 input、handle、platform、status、reason、url)和 hints。status 可以是 available、taken、invalid(在该平台上不被允许)或 unknown。
5. 呈现结果
- 按原样显示脚本的表格:每个平台或域名一行,每个名称一列,使用 ✅ 表示可用,❌ 表示已被占用,❓ 表示未知,⛔ 表示不允许。在所有地方都显示 ✅ 的名称排在最前面。
- 为你提及的每个句柄和域名添加链接,链接来自 JSON 中的
url,例如[facebook.com/acmestudio](https://www.facebook.com/acmestudio)。这涵盖了 ✅? 和 ❓ 的情况(用户需打开确认),以及 ❌ 的情况(方便用户查看谁持有该名称)。 - 当 Instagram 上存在该名称的账户但尚未启用 Threads 时,Threads 会显示
🔒(reason: held_by:instagram)。只有该 Instagram 账户才能在 Threads 上使用该名称。如果这是用户自己的账户,请告知他们启用 Threads。如果不是,则将该名称视为已被占用。 - 当 Facebook 未找到某个名称时,会显示
✅?(reason: likely_free)。这通常意味着可用,但由于公开检查无法区分年龄限制页面,因此应称之为“可能可用”,而非“可用”,并提供其链接。 - Product Hunt 无法自动检查,因此显示 🔗(
reason: manual_only),其链接会出现在“请自行检查”部分。请传递这些链接;它们不计入名称的可用性判断。 - 对于“接近可用”的名称,仅使用
--variants重新检查这些名称。推荐在所有平台上使用相同句柄的变体;这优于为每个平台使用不同句柄。
6. 诚实对待未知结果
- 切勿将
unknown呈现为可用。 列出每个未知结果及其链接,以便用户一键检查。 - 逐字转达
hints中的每一行,例如“Instagram 限制了此 IP。请等待几分钟,然后使用 --platforms instagram,threads 重新运行”。 - 不要循环重试。 稍后重试一次是可以的。
7. 最终建议
告知用户立即在注册成功的句柄在每个平台上注册。公开检查无法看到被封禁或已停用账户持有的句柄;只有每个平台的注册表单才能确认这些情况。
8. Logo、Favicon、应用图标和横幅(可选)
一旦选定名称,主动询问一次:“是否想要一个 Logo、Favicon、应用图标和横幅?我将绘制 3 种风格供您选择,在网站、手提袋等物品上展示您选择的风格,并编写一份品牌指南 (BRAND.md)。”如果用户同意,请阅读此文件旁边的 references/brand-kit.md 并遵循其指导。该文件会指向 references/styles.md 以获取字体、调色板、标志类型和布局。在此之前不要加载它。
9. 品牌工具包需要 resvg-py
名称检查除了 Python 之外不需要其他任何东西。仅将品牌工具包渲染为 PNG 需要一个包 resvg-py(2 MB)。如果 brand.py 报告缺少该包,请告知用户一次,并在安装前征求其同意。然后运行:
python3 -m pip install resvg-py
如果失败并出现“externally managed environment”错误,请改用虚拟环境:
python3 -m venv ~/.venvs/brand-kickstart && ~/.venvs/brand-kickstart/bin/pip install resvg-py
之后,使用 ~/.venvs/brand-kickstart/bin/python 运行 brand.py。
保存偏好设置
当用户陈述持久性的偏好时(例如“从不检查 X”、“始终检查 .id”、“我主要命名应用”),主动询问是否将其保存到 ~/.config/brand-kickstart/config.json。仅在用户同意的情况下创建该文件。与任何现有内容合并。
{ "mode": "brand", "skip": ["x"], "tlds": ["com", "id"], "country": "id" }
键值:mode、platforms(精确列表)、skip、tlds、country。命令行标志始终优先于文件。
自检
python3 <skill-dir>/scripts/check.py --self-test 显示每个平台是否仍按预期响应。当结果看起来有误时运行它。