AI 技能AI 插件【免费下载链接】baoyu-skills项目地址https://gitcode.com/gh_mirrors/ba/baoyu-skills点击查看免费下载本篇技术指南围绕 baoyu-skills 项目中 baoyu-infographic 技能的首次配置流程first-time setup展开讲解当项目中没有 EXTEND.md 偏好文件时Agent 如何通过一次交互式提问完成布局、风格、宽高比、语言与保存位置五类偏好的收集与落盘。读完本文你将掌握 EXTEND.md 的完整 YAML 字段语义、两级保存位置项目级与用户级的优先级规则、偏好如何影响后续 Step 3 推荐与 Step 4 默认值以及如何在日后通过直接编辑或重新触发设置来修改偏好。一、为什么需要首次设置偏好的作用边界baoyu-infographic 是一个信息图生成技能其核心设计是「布局layout× 风格style」两个维度自由组合配合宽高比、输出语言、图像后端等参数完成从内容分析到成品图片的全流程完整工作流见 SKILL.md 的## Workflow一节共 7 个步骤。当技能运行且未找到任何 EXTEND.md时就会进入本篇文章的主题——首次设置流程。它的目的是在生成任何信息图之前先通过交互式提问把用户的偏好固化下来。需要特别强调的是偏好的作用边界来自 first-time-setup.md 的## Overview一节已保存的偏好只影响 Step 3 的推荐结果和 Step 4 的默认值偏好永远不会绕过 Step 4 的确认环节。也就是说偏好扮演的是「推荐输入recommendation inputs」而非「执行授权」的角色。即使 EXTEND.md 中明确写了preferred_layout: dense-modules最终生成前仍须经过 Step 4 的组合/宽高比/语言/后端确认详见 SKILL.md 的## Confirmation Policy一节。除非用户在当次请求中明确说了--no-confirm、「直接生成」、「不用确认」、「按默认出图」等等价表述否则确认是硬性门禁hard gate。⛔ 阻塞性操作首次设置必须在任何其他工作流步骤之前完成。在设置完成前Agent 禁止询问源内容或主题source content or topic询问布局、风格或宽高比开始 Step 1.2 内容分析。在设置期间只能询问本流程中的问题保存 EXTEND.md 后再继续进入 Step 1.2。二、设置流程总览首次设置遵循一条线性流水线流程示意图来自 first-time-setup.md 的## Setup FlowNo EXTEND.md found │ ▼ ┌─────────────────────┐ │ AskUserQuestion │ │ (all questions) │ └─────────────────────┘ │ ▼ ┌─────────────────────┐ │ Create EXTEND.md │ └─────────────────────┘ │ ▼ Continue to Step 1.2三个环节检测到无 EXTEND.md → 通过AskUserQuestion一次性提出所有问题 → 创建 EXTEND.md → 继续 Step 1.2 内容分析。在 SKILL.md 的 Step 1.1Load Preferences中这个检测逻辑被描述为按优先级顺序查找 EXTEND.md找到则读取解析并显示一行摘要未找到则按本流程发起提问。三、五个提问的完整定义首次设置使用单次AskUserQuestion调用、包含多个问题的形式运行时通常会自动附加一个 Other 选项。问题文案使用用户输入的语言不应当一律默认使用英文。Question 1Preferred Layout默认布局header: Layout question: Default layout preference? options: - label: Auto-select (Recommended) description: Pick layout per content in Step 3 - label: bento-grid description: Multiple topics, overview (general default) - label: linear-progression description: Timelines, processes, tutorials - label: dense-modules description: High-density modules,>--- version: 1 preferred_layout: [selected layout or null] preferred_style: [selected style or null] preferred_aspect: [landscape|portrait|square|null] language: [selected language or null] preferred_image_backend: auto custom_styles: [] ---模板中两个字段是内置默认、不由首次设置询问的preferred_image_backend: auto图像后端偏好被直接烘焙为autocustom_styles: []自定义风格列表初始为空。preferred_image_backend: auto的语义在 SKILL.md 的## Image Generation Tools一节中定义当运行时存在原生图像工具如 Codex 的imagegen、Hermes 的image_generate时优先使用否则回退到已安装的后端如baoyu-image-gen仅当存在多个非原生后端且无原生工具时才向用户询问一次。后端解析的完整优先级链当前请求显式指定 已保存偏好 自动选择 询问用户在 codex-imagegen.md 中有配套的调用契约说明。字段的完整类型定义可参见 preferences-schema.md 的## Field Reference表FieldTypeDefaultDescriptionversionint1Schema versionpreferred_layoutstring|nullnullPre-selected layout — surfaces as the top recommendation in Step 3preferred_stylestring|nullnullPre-selected style — surfaces as the top recommendation in Step 3preferred_aspectstring|nullnullDefault aspect for Step 4 (named preset or W:H string)languagestring|nullnullOutput language (null auto-detect from source content)preferred_image_backendstringautoauto prefer runtime-native tool, fall back to the only installed backend, ask if multiple non-native are presentask always confirm on every runbackend-id pin this backend when available, fall back toautowhen it isntcustom_stylesarray[]Additional styles available alongside the 21 built-ins其中custom_styles字段允许用户扩展超出内置风格库的自定义风格每个条目由三个必填字段构成见 schema 的## Custom Style FieldsFieldRequiredDescriptionnameYesUnique style identifier (kebab-case)descriptionYesOne-line description shown in Step 3 recommendationsprompt_fragmentYesStyle traits appended into the Step 5 prompt bodyprompt_fragment是自定义风格注入到 Step 5 提示词正文中的「风格特征片段」例如在完整配置示例中一个名为my-brand的自定义风格这样定义custom_styles: - name: my-brand description: Brand-aligned warm pastel infographic prompt_fragment: Use brand pastel palette (#F2C7B6, #B6D7E8, #C8E0B4); rounded rectangles; warm hand-drawn outlines; ample whitespace.七、偏好的生效链路从 EXTEND.md 到提示词理解「偏好如何起作用」需要串联技能工作流的多个环节均定义在 SKILL.md 中Step 1.1 加载按优先级读取 EXTEND.md解析后显示一行摘要Step 3 推荐preferred_layout与preferred_style会作为 Step 3 的**首要推荐top recommendation**浮出若用户输入命中 Keyword Shortcuts如「高密度信息大图」→dense-modules 四组推荐风格、默认 portrait则跳过基于内容的布局推断Step 4 确认preferred_aspect与language作为该步的默认值出现但组合/宽高比/语言/后端四项仍需用户确认除非显式--no-confirmStep 5 提示词生成最终确认的 layout/style/aspect/language 被填入 base-prompt.md 模板的{{LAYOUT}}、{{STYLE}}、{{ASPECT_RATIO}}、{{LANGUAGE}}占位符布局与风格的详细指南{{LAYOUT_GUIDELINES}}、{{STYLE_GUIDELINES}}分别来自 layouts/ 与 styles/ 下的定义文件如 dense-modules.md 定义 6–7 个类型化信息模块、坐标标记与信息密度规则。可见首次设置的产物 EXTEND.md 实际是一条贯穿整个生成管线的「默认值配置链」它不改变生成逻辑只改变推荐起点与确认默认项。八、日后修改偏好的三种方式首次设置结束后偏好并非一成不变。SKILL.md 的## Changing Preferences一节给出了三种修改途径针对第一个匹配到的 EXTEND.md 生效直接编辑文件打开 EXTEND.md 修改字段完整 schema 见 preferences-schema.md重新交互式配置删除 EXTEND.md或向 Agent 说「reconfigure baoyu-infographic preferences」/「重新配置」下一次运行便会重新触发首次设置流程常见单行修改preferred_image_backend: auto— 默认值运行时原生工具优先回退到唯一已安装后端仅当存在多个非原生后端时才询问preferred_image_backend: codex-imagegen— 固定使用 Codex 内置图像工具preferred_image_backend: baoyu-image-gen— 固定使用 baoyu-image-gen 技能preferred_image_backend: ask— 每次运行都确认后端preferred_layout: dense-modules、preferred_style: morandi-journal、preferred_aspect: portrait、language: zh— 分别调整 Step 3 推荐与 Step 4 默认值同样遵循 Confirmation Policy永不绕过 Step 4。九、两个完整的 EXTEND.md 配置示例minimal 示例只设置核心三项省略preferred_image_backend缺省视为auto--- version: 1 preferred_layout: bento-grid preferred_style: craft-handmade language: zh ---full 示例面向「高密度中文产品指南」场景锁定 dense-modules morandi-journal portrait zh并钉住codex-imagegen后端、附带一个自定义品牌风格--- version: 1 preferred_layout: dense-modules preferred_style: morandi-journal preferred_aspect: portrait language: zh preferred_image_backend: codex-imagegen custom_styles: - name: my-brand description: Brand-aligned warm pastel infographic prompt_fragment: Use brand pastel palette (#F2C7B6, #B6D7E8, #C8E0B4); rounded rectangles; warm hand-drawn outlines; ample whitespace. ---十、易混淆点速查偏好不是指令EXTEND.md 的所有字段都只是默认值与推荐输入Step 4 确认是硬性门禁auto是后端默认值首次设置从不询问后端preferred_image_backend被直接写入auto只有显式改为ask才会每次询问XDG 路径只读不写XDG 级路径在读取时被识别但首次设置不提供将其作为保存目标设置期间禁止发散首次设置完成前不得询问内容主题、布局或风格也不得提前开始 Step 1.2 分析读取优先级项目级.baoyu-skills/baoyu-infographic/EXTEND.md优先于 XDG 路径XGD 路径优先于用户主目录路径第一个命中的文件生效。相关文档索引首次设置流程本文核心文档偏好 schema 完整字段定义技能主文档工作流、确认策略与图像后端规则提示词基座模板内容分析框架结构化内容模板codex-imagegen 调用契约赞分享AI 技能AI 插件【免费下载链接】baoyu-skills项目地址https://gitcode.com/gh_mirrors/ba/baoyu-skills点击查看免费下载相关推荐wgpu-py 云端部署指南Headless GPU 服务器与 Lavapipe 软件渲染实践wgpu py 云端部署指南Headless GPU 服务器与 Lavapipe 软件渲染实践 wgpu py 是将 WebGPU 图形 API 引入 PytAI 技能AI 插件CANN/ge设置布尔列表属性aclopSetAttrListBoola nameZH CN_TOPIC_0000001312721741 /a 产品支持情况a nameseAI 技能AI 插件如何通过 URLpayload 参数让 code-server 打开指定文件的特定行列如何通过 URLpayload 参数让 code server 打开指定文件的特定行列 假设你已有一台可访问的 code server 实例安装与暴露方AI 技能AI 插件上一篇Composer包移动开发跨平台移动应用支持终极指南下一篇FlowMVI终极指南如何在3行代码内实现Kotlin多平台架构创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考