brand-persona-skill 是一个编排技能，用于把任何商业实体转化为一个个性化的品牌智能体。它从已有内容中提炼品牌身份（或引导从零进行声明），把品牌的服务能力定义为技能，并生成完整的 OpenPersona 包，供外部智能体发现和调用。它的定位不是创建一个“关于某品牌”的智能体，而是把品牌本身生成为一个智能体。
依赖链：brand-persona-skill → skills/anyone-skill（仅 Phase 1A——从已有内容提炼时必需；Path B 声明路径不需要）；brand-persona-skill → skills/open-persona（Phase 4——两条路径都用于人格包生成）。当安装后，persona-knowledge 会通过 anyone-skill 透明集成，无需额外工作。
生成产物：一个自包含的 {slug}-skill/ 人格包，包含品牌灵魂、声明的服务技能、用于 A2A 发现的 agent-card，以及面向外部智能体的服务契约。
触发短语：/create-brand-agent；“help me create a brand agent”；“generate a persona for my brand / shop / studio / institution”；“I want to create a personalized agent for my brand / shop / institution”；“distill my brand into an agent”；“turn my business into a persona”。
事实来源：预设基础 presets/commercial-base/persona.json；字段映射模板 skills/brand-persona-skill/assets/brand.persona.template.json；服务契约模板 skills/brand-persona-skill/references/SERVICE-CONTRACT.template.md；生成包路径 ./{slug}-skill/。
Phase 0 — 路径选择：询问用户品牌是否已有以下任一内容：[A] 有 → 品牌指南/客服记录/网站文案/创始人访谈/营销素材/社交媒体存档（任意格式：.md / .txt / .pdf / 聊天导出 / .json）；[B] 没有或极少 → 直接声明品牌参数。选 A 进入 Phase 1A，选 B 进入 Phase 1B。
Phase 1A — 品牌灵魂提炼（主路径）：加载 skills/anyone-skill/SKILL.md 并遵循其指示。当 anyone-skill 询问“Who do you want to distill?”时，选择 [6] Archetype——无单一真实主体的复合人格，这是品牌人格的正确类型。品牌内容到 anyone-skill 数据类型的映射：品牌指南/VI 规范/品牌手册 → .md / .pdf 通用适配器；客服记录/销售话术 → 聊天导出适配器；网站文案/微信公众号文章 → .txt / .md 通用适配器；创始人访谈/品牌故事 → .txt 通用适配器；社交媒体存档（X/Instagram）→ 存档目录社交适配器；产品目录/FAQ 文档 → .md / .pdf 通用适配器。若 skills/persona-knowledge/SKILL.md 存在，anyone-skill 会自动将品牌知识路由到 MemPalace 持久存储。输出：一个结构化品牌人格草稿，提炼四个维度：价值观（品牌主张什么）、声音（品牌如何说话）、边界（品牌会做什么与不会做什么）、背景（品牌历史、语境、定位）。
Phase 1B — 品牌灵魂声明（次路径）：逐一向用户收集以下内容：品牌名称、Slug（URL 安全标识，仅小写字母、数字、连字符）、行业/领域、一句话简介、个性关键词（3–5 个词）、说话风格、核心价值观（2–3 条）、硬性限制。可选：如用户需要灵感，可用 WebSearch 研究竞品或行业语气参考。输出：结构化品牌灵魂字段。
Phase 2 — 服务技能声明（两条路径必需）：服务即技能。品牌智能体提供的每项服务能力直接映射到 persona.json 中的 skills[] 条目。问题 1：智能体能自主做什么（信息类服务 / 行动类服务）。问题 2：每项服务如何实现（实现方式对本技能透明）：知识应答、本地脚本、MCP 工具、A2A 协议、Webhook / API、人工转接、A2A delegate、混合。A2A delegate 需要额外收集三个字段：第三方智能体地址、路由参数、客户端能力。这构成一个三层执行模型：Tier 1（优先）客户智能体已安装 capability_needed 技能 → 使用本品牌智能体提供的路由参数直接执行；Tier 2（可用时）第三方品牌智能体在 ACN 上 → A2A delegate；Tier 3（兜底）都不可用 → 人工转接或平台链接。问题 3：智能体绝对不能做什么（硬性限制与升级触发条件）。问题 4：确认 A2A delegate 路由表（仅当问题 2 选择了 A2A delegate）。输出映射：每项声明服务 → skills[] 中一条目；A2A delegate 服务 → 记录在路由表；硬性限制 → 追加到 soul.character.boundaries。
Phase 3 — 写 persona.json：以 presets/commercial-base 为基础合并品牌灵魂与服务技能，并应用字段映射。使用 brand.persona.template.json 作为书写指南，不要直接复制该模板文件（它含 _comment 字段会导致 schema 校验错误）。Gate——Soul Gate：验证 soul.identity.personaName 非空、slug 匹配 ^[a-z0-9-]+$、bio 非空、personality 非空；任一缺失则返回 Phase 1。Gate——Service Gate：验证 skills[] 至少一条 name 非空、soul.character.boundaries 非空；否则返回 Phase 2。
Phase 4 — 生成人格包：加载 skills/open-persona/SKILL.md。Step 4a 运行生成器：npx openpersona create --config persona.json --output ./{slug}-skill。Gate——Generate Gate：若非零退出，读校验错误、修 persona.json 并重试。Step 4b 写行为指南：用品牌特定值填充 behavior-guide.template.md 并写入 ./{slug}-skill/soul/behavior-guide.md，覆盖框架默认。映射占位符包括 {{brandName}}、{{oneLinerBio}}、{{onboardingQuestion_1/2/3}}、{{blindspotRedirect}}、{{confirmationRequiredOps}}、{{brandVibe}}、{{speakingStyleNote}}、{{brandBoundaries}}。Step 4c 生成触发映射表：从 skills[] 写入触发映射表并追加到 ./{slug}-skill/SKILL.md 的新章节 ## Trigger Scenarios，左列用自然客户语言，右列用技能名 + 实现方式；A2A delegate 技能右列展开为三个执行层级。Step 4d 写服务契约：复制 SERVICE-CONTRACT.template.md → ./{slug}-skill/references/SERVICE-CONTRACT.md，填入所有 {{placeholder}}；第三方智能体路由部分使用 Phase 2 问题 4 的路由表：ACN 地址已知则填 acn://{slug} 并置状态 active；仅知平台链接则填 URL 并置状态 link-fallback；都未知则置状态 tbd 并填人类可读的兜底说明。
Phase 5 — 校验与发布：Gate——Contract Gate：验证 ./{slug}-skill/agent-card.json 有非空 skills[] 数组（由 openpersona create 自动生成，直接映射自 persona.json 的 skills[]）。向用户确认生成包结构：{slug}-skill/ 含 SKILL.md（品牌智能体行为规则）、persona.json（品牌声明）、agent-card.json（A2A 发现凭证）、acn-config.json（ACN 注册配置）、soul/（injection.md、constitution.md、behavior-guide.md）、scripts/state-sync.js（跨会话状态管理）、references/（SERVICE-CONTRACT.md、SIGNAL-PROTOCOL.md）。可选——在 ACN 注册：npx openpersona acn-register {slug} --endpoint https://your-agent-endpoint.example.com。
失败路由：Soul Gate 失败 → 返回 Phase 1 收集缺失字段；Service Gate 失败 → 返回 Phase 2 至少添加一项服务技能；Generate Gate 失败 → 读 openpersona validate 错误、修 persona.json 字段并重试；Contract Gate 失败 → 返回 Phase 2 确认 skills[] 已填充并重新生成。