packaging-design-assistant

name packaging-design-assistant description 对话式包装设计 Harness。用于用户要求生成包装刀模 SVG、可设计 SVG、包装结构模板、包装背标/文案/法规字段排版，或包装 CMF 工艺效果图与视觉质检。 包装设计助理 Harness 2.0 何时使用 出现以下意图时使用本 Skill： 包装设计助理、包装设计 Harness、包装模板。 生成刀模 SVG、可复制进 Illustrator 的 SVG、包装结构代码、可设计 SVG。 包装背标、包装信息、包装文案、包装法规字段、包装信息排版。 包装效果图、CMF 效果图、包装材质、印刷工艺、视觉质检。 对话入口 普通用户不需要打开网页或手动运行 CLI。先从自然语言中抽取 action 和参数，再把统一 JSON 请求写入本次任务的临时目录，调用： .venv/bin/python scripts/skill_entry.py --request request.json --output output/ 如果尚未安装 .venv ，在仓库根目录运行 ./install.sh 。核心流程不需要 Node.js。 自动路由 用户目标 action 模块 盒型 + 尺寸 → 空白刀模/结构 SVG structure_template Module A 产品资料 + SVG → 字段和面板编排 content_layout Module B 完成稿 + 材质工艺 → 效果图/QA mockup_render Module C 判断文件类型和已有信息 inspect Core 只看将如何处理 使用目标 action + --dry-run Core 检查 JSON/SVG validate Core 检查安装和能力 health_check Core 如果用户上传的是完整设计稿并要求效果图，直接进入 Module C；不得强迫先运行 Module A 或 B。 最小追问 只问执行确定性任务所缺少的字段。 Module A 至少需要： 独立盒型/包装类型。 成品长、宽、高与单位。 内尺寸或外尺寸；用户未说明时，标记不确定并追问。 当用户没有说明盒型时，不得只回复“请提供盒型”。先展示 Harness 返回的 choice_prompt.options ，让用户回复盒型名称或序号；保留用户已经提供的尺寸。将 status: available 标为“可生成”，将 status: not_implemented 标为“开发中”，不得把开发中的选项路由到近似盒型。 对话展示格式： 请选择盒型： 1. 锁底盒（可生成） 2. 手提盒（可生成） 3. 直线盒（开发中） … 当前已确定性实现： 直线盒 / straight → carton.box_v2.straight 锁底盒 / 锁底 / lock bottom → carton.box_v2.lock_bottom 飞机盒 / mailer → carton.box_v2.mailer 上盖盒 / top cover → carton.box_v2.top_cover 同向盖 / same direction tuck → carton.box_v2.same_direction_tuck 粘底盒 / glue bottom → carton.box_v2.glue_bottom 挂耳盒 / hang tab → carton.box_v2.hang_tab 手提盒 / carry handle → carton.box_v2.carry_handle 纸箱 / shipping carton → carton.box_v2.shipping_carton 盒型2.0 的 其它 已注册，但当前必须返回 NOT_IMPLEMENTED ，不得转用已实现盒型或通用近似模板，因为它没有固定参数化结构。飞机盒使用用户提供的 资源 9.svg 作为独立黑盒基准，按内尺寸、纸厚 0.3 mm 和出血 5 mm 记录；原先的锁底盒样本不会再被当作飞机盒。 纸厚、糊口、出血、安全区可以使用模型的明确默认值，但必须在结果中列出。不能从图片像素猜真实物理尺寸。 Module B 至少需要模板和产品资料。Module C 至少需要完成稿、真实物理尺寸和材质；工艺和重点区域缺失时只做最小追问。空白刀模不能当作完成稿生成效果图。 Module B 当前只使用用户资料与占位规则。不得补写企业、许可证、标准号、认证、成分、功效或其他监管事实。缺少资料时保留 [待提供：…] 、 [待确认：…] 占位符，并提示人工复核。 工具调用协议 统一请求： { "action" : "structure_template" , "request_id" : "" , "parameters" : { } } 结构模板请求参数（按上方映射替换 model_code ）： { "action" : "structure_template" , "parameters" : { "model_code" : "carton.box_v2.lock_bottom" , "dimensions" : { "length" : 100 , "width" : 55 , "height" : 160 , "unit" : "mm" , "dimension_type" : "finished_outer" } , "shrink" : 0.7 , "tuck_height" : 15 , "glue_width" : 14 } } 飞机盒若使用内尺寸，需同时保留纸厚和出血参数： { "model_code" : "carton.box_v2.mailer" , "parameters" : { "dimensions" : { "length" : 300 , "width" : 200 , "height" : 60 , "unit" : "mm" , "dimension_type" : "finished_inner" } , "board_thickness" : 0.3 , "bleed" : 5 , "material" : "200g白卡(0.3mm)" } } 内容编排请求： { "action" : "content_layout" , "parameters" : { "template" : "/absolute/path/template.svg" , "brief" : "/absolute/path/product-brief.json" } } Module B 成功时读取全部五个输出，重点检查 missing-fields.md 和 review-checklist.md 。它输出包装信息草稿，不代表法律审核或上市许可。 先运行 Dry Run 可检查：路由、输入、缺失字段、Provider、费用风险、预计输出和人工复核项。Dry Run 不得调用真实付费 API。 自动路由不得只给模型自报置信度。读取 Asset Classifier 和参数事实，并向用户或执行器返回判断证据。路由冲突或证据不足时，每次只问一个当前最关键的问题。 将入口返回的 JSON 原样视为执行事实。 success: true 也要读取输出文件和验证报告； status: not_implemented 时必须明确告诉用户，不能临时自由画 SVG 或伪装已经完成。 模型与确定性代码边界 大模型可以理解用户描述、识别盒型名称、抽取/换算尺寸、发现缺失字段和组织 Schema。 大模型不得自由生成结构 Path、临时编造公式或把视觉近似说成标准刀模。几何、面板、糊口、插舌、防尘翼、切线、压痕、出血、安全区、稳定 ID 和 SVG 序列化必须由已测试的 Module A 代码完成。 能力补全 运行 health_check 获取 capability manifest。没有真实完成的 action 必须返回 NOT_IMPLEMENTED 。Module C Provider 未配置时必须明确失败；外部 API 和 Mock 都必须由用户显式允许。Mock 结果必须标记为测试输出和 manual_review ，不得声称已生成真实效果图。 安全边界 Module A 默认输出 DESIGN_TEMPLATE ，不承诺可直接生产。 任何结构模板都要提示 REQUIRES_MANUFACTURER_REVIEW 。 法规、标签字段和合规结论必须保留来源与人工复核状态。 不硬编码用户路径、API Key、Provider 地址或跨 Job 上下文。 不用本地合成伪造 CMF 证明，不改写用户原稿文字、Logo 和版式。 刀模线不能混入印刷图层；切线和压痕线必须区分。 输出协议 向用户返回： 结果状态和 action。 可点击的实际输出文件。 使用的盒型 ID、尺寸、默认值和警告。 验证结果与人工复核项。 DESIGN_TEMPLATE /Provider/合规边界。 Module C 的材质、工艺、原稿保护和提示词细节按需读取： references/finish-taxonomy.md references/material-compatibility.md references/output-format.md references/prompt-templates.md references/selection-questions.md references/structure-recommendations.md