品牌技能构建器 是做什么的?
此技能帮助您构建和维护一个品牌技能库:一组小型技能,使任意模型能够为特定公司生成符合品牌的 作品。它承载了来自生产库的架构、模板、脚本和经验教训;它本身不携带任何品牌。所有品牌价值均来源于用户的资料。
在开始任何模式之前,请先阅读 references/architecture.md。当以下步骤中提及其他参考资料时,请阅读它们。
文件夹。 在每个命令中,SKILL_DIR 是存放此文件的文件夹,LIB 是用户选择的库文件夹。
在每个命令中都要完整写出两者;不要将它们设置为 shell 变量(在某些平台上,一个命令中设置的变量在下个命令中会消失)。
选择模式
| 用户想要 | 模式 |
|---|---|
| 为一个尚无任何品牌技能的品牌创建技能 | A. 新建库 |
| 在现有库中再添加一个技能 | B. 添加技能 |
| 审查现有的品牌技能或库 | C. 审查 |
| 在构建前先了解方法 | 从 references/architecture.md 中解释并停止 |
只有当请求未明确说明模式时才询问。
A. 新建库
- 收集资料。 索要品牌手册以及任何规范品牌的文件:设计团队的模板、语音指南、 消息文档、商标规则、样式指南、logo 文件、字体及其许可、任何图标或 照片库。询问谁拥有该品牌(将批准决策的人员)。标记缺失内容;不要自行补充。
- 搭建框架。
python3 SKILL_DIR/scripts/scaffold.py library LIB --brand "<Brand>" --era <era>。era 是 此版本品牌的简短标签(例如2027-brand)。将资料放入LIB/reference/。 - 编写基础规范 根据
references/brand-foundations.md,基于资料将内容写入LIB/shared-context/brand-foundations/context/。 填写每个 TODO(来自资料)或将其记录为空白。测量对比度;引用手册中包含规则的措辞; 为每个文件注明来源。当资料涵盖时,在logo/下添加logo 图稿,以及logo-policy.md、imagery-policy.md和chart-palette.json。 - 与所有者一起审查。 以简短摘要形式展示基础规范:颜色模型、字体角色、标志性元素、发布检查清单、空白项,以及每个提议的“内部决策”及其一个建议和理由。等待 他们的决定;将每个决策记录在“内部决策”表和开发日志中。
- 构建语音技能(使用
--kind voice的模式 B)。它很小,可以验证快照、预检和打包路径。 - 构建第一个格式技能(使用
--kind format的模式 B),即人们最需要的格式。先走最小的端到端路径,然后进行试点循环。 - 一次添加一个格式,首先确定每个格式的“内部决策”(
references/process.md,“工作顺序”)。 - 构建审计技能(使用
--kind audit的模式 B),一旦存在可供审计的格式规范。
B. 添加技能
- 命名为
<brand>-<format>(小写,连字符),或<brand>-voice,<brand>-audit。确认一个技能只做一件事:如果 请求与现有技能重叠,请明确指出并建议扩展该技能。 - 搭建框架。
python3 SKILL_DIR/scripts/scaffold.py skill LIB <name> --kind format|voice|audit --format "<PDF>"。这会 写入 SKILL.md 模板、agents/openai.yaml、预检脚本、平台测试脚本以及快照配置文件LIB/tools/snapshot/<name>.json;对于格式技能,还会写入LIB/shared-context/<name>/context/format-spec.md和format-map.json。 - 在编写代码之前确定格式的内部决策:对于
structural-system.md中范围标注为“构建时由其他人决定”的每个决策,为此格式推荐一个答案,获取所有者的决策,然后记录下来。 - 编写格式规范和 map(带 BOOK、RATIFIED 和 PROPOSED 标签的文字描述;带角色名称的数字,从不使用十六进制)。
- 编写构建器和 QA 脚本,遵循
references/format-skills.md:模型规划并编写 JSON 规范, 脚本负责构建,脚本负责对完成文件进行检查;构建时读取令牌,记录偏差, 从不拒绝。语音和审计技能则遵循references/voice-and-audit.md。 - 填写 SKILL.md:描述(触发器、它不会做什么,1,024 个字符以内)、步骤、带有“查看-规范-表”的输入处理、规范参考、“警告-绝不-拒绝”部分,以及每个平台的一条交付说明。
- 快照和验证。
python3 LIB/tools/snapshot/snapshot.py LIB/tools/snapshot/<name>.json,然后--check,接着python3 LIB/skills/<name>/scripts/verify_context.py。将字体、样式表和图稿添加到配置中的bundled_assets, 以便预检脚本能验证它们。 - 测试(
references/qa-and-testing.md):平台测试、在两种主题下进行固定结构构建、针对每个 QA 检查项的篡改测试、 令牌交换测试。然后使用一个现实的提示词进行试点循环,每次修复后重新运行相同的提示词。 - 应要求打包(
references/packaging.md):python3 LIB/tools/package/package_skill.py LIB/skills/<name> <name> <一个干净的临时文件夹>/<name>.zip --date YYYY-MM-DD。 解压到另一个干净的文件夹中,并在将 zip 文件放入LIB/finalized-skills/之前从那里运行测试。 - 记录日志。 上述每一步都应该在发生时记录到
LIB/DEV-LOG.md中。
C. 审查
读取技能(或库)并与模式进行比较。按以下顺序报告,每个条目均包含文件和行号:
- 结构:一个技能只做一件事,无运行时调用其他技能,存在
agents/openai.yaml,无单平台路径。 - 上下文:包含清单和摘要的捆绑快照,返回警告而非停止的预检,品牌时期。
- 构建器:构建时读取令牌(或硬编码值)、JSON 规范、偏差而非拒绝。
- QA:与发布检查清单关联的对完成文件的检查,篡改测试,如果技能包含重新样式化模式则需测试。
- 工作流:带默认值的输入,带声明和证据的计划,批准后再构建,以警告先行的交付。
- 打包:严格的前置元数据、描述长度和触发器、发布记录。
按影响顺序推荐修复。除非被要求,否则不要更改任何内容。
适用于所有模式的规则
- 绝不编造品牌价值。 任何颜色、字体、尺寸、规则、声明、图形或客户都不得来自常识。 空白项应被记录并由所有者决定,或者该元素被省略。
- 品牌手册是记录规则;所有者的设计文件填补其空白;每个偏离都是“内部决策”,需记录 其范围、所偏离的手册原文、状态以及决策者。
- 警告,绝不拒绝,在您构建的技能内部:修复并报告,交付带有标记的失败文件, 仅当物理上不可能时才停止。没有语音文件的语音技能就是那种不可能。
- 建议,然后询问,针对每个属于所有者的选择。只有在其做出决定后才开始构建。
- 测量,而非猜测:对比度、文本宽度、行数、渲染效果。
- 在真实的渲染器中查看输出之后才能说完成。
交付
- 在 Claude 上:总结已创建或更改的内容及其路径,并从输出文件夹分享任何已打包的 zip 文件。
- 在 ChatGPT 上:总结已创建或更改的内容及其路径,并提供任何已打包 zip 文件的下载链接。
然后列出仍然待办的事项、每个等待所有者的空白项,以及每个 PROPOSED 决策。
参考
| 文件 | 阅读目的 |
|---|---|
references/architecture.md | 技能类型、工作空间、技能文件夹、快照优先上下文、平台无关性 |
references/brand-foundations.md | 将品牌手册转化为数据:文件、颜色和字体架构、内部决策、状态标签 |
references/format-skills.md | 格式技能内部工作流程、警告-绝不-拒绝、规范、构建器、QA 检查、各格式注意事项 |
references/voice-and-audit.md | 语音技能和审计技能 |
references/qa-and-testing.md | 测试、渲染、试点、交互规则的调试 |
references/packaging.md | 严格的前置元数据、描述、发布步骤、上传失败处理 |
references/process.md | 决策、活记录、工作顺序、安全工作、Office 工具链的经验教训 |