brand-init

品牌初始化

为一个品牌设置持久化层：磁盘上的结构化套件，其他所有品牌技能都会先读取并写入其中。品牌会成为可查询的产物（brand.yaml），而非临时的聊天输出。完整规范：../../references/brand-package-spec.md。

何时运行

• 开始创建任何新品牌，且尚无套件（./、./brand/ 或 brands/<slug>/ 中都没有 brand.yaml）。
• 将旧版 .agents/brand-context.md 迁移为规范套件。

如果套件已存在，请勿重新初始化——加载它并继续使用相关技能。

步骤

1. 确定必要信息

只询问搭建所需的信息（深入采集由 brand-context 完成）：

• 品牌名称（必填）
• 一句话简介——用一句话说明品牌是什么（用于回忆的标题）。如果目前还不确定，请留空。
• 存放位置——选择一种模式：
  • ./brand/——就地模式，为当前项目打造品牌（默认）
  • brands/<slug>/——品牌组合模式，管理多个品牌
  • <product>/brand/——品牌属于某个产品仓库
• 是否为品牌组合？——如果要管理多个品牌，请在 brands/registry.yaml 中登记此品牌。

2. 搭建套件

运行随附脚本（无需依赖）。脚本位于相对于此技能目录的 scripts/brand.sh：

# In Claude Code, ${CLAUDE_SKILL_DIR} expands to this skill's directory. In other
# agents, resolve scripts/brand.sh relative to where this SKILL.md was loaded.
bash ${CLAUDE_SKILL_DIR}/scripts/brand.sh init \
  --name "Acme" --one-liner "…" --out brand --date "$(date +%F)" \
  --register brands/registry.yaml      # omit --register for a single in-situ brand

此脚本会创建 <out>/brand.yaml 和 <out>/assets/，并在指定 --register 时更新注册表。 需要可复现的运行结果时，请显式传入 --date。

3. 移交

告知用户套件已创建，以及接下来要做什么：运行 brand-context，将品牌 DNA 记录到 context.md，然后运行 naming / brand-strategy 等技能——每项技能都会写入此套件，并在 brand.yaml 中更新对应标记。

查询品牌组合

# ${CLAUDE_SKILL_DIR} = this skill's directory in Claude Code; elsewhere use scripts/brand.sh
# relative to where this SKILL.md was loaded.
bash ${CLAUDE_SKILL_DIR}/scripts/brand.sh list --registry brands/registry.yaml
# slug · name · one-liner · path · [status]

无需逐一打开套件，即可使用此命令回答“我们有哪些品牌／它们存放在哪里／一句话简介是什么”。

规则

• 注册表是唯一事实来源文件，绝不是 Agent 记忆。 品牌的位置和一句话简介都是数据 → 应写入 registry.yaml（由 git 跟踪、可共享），而不是 LLM 的单机记忆。
• 不要预先创建空的章节文件。 初始化时只创建 brand.yaml 和 assets/；每项技能运行时都会创建自己的 *.md 文件。
• 绝不覆盖现有套件。 脚本会拒绝这样做；请遵守这一限制。