text-to-cad 中的 SendCutSend 预审报告模板：用证据驱动的方式编写制造就绪度报告

text-to-cad 中的 SendCutSend 预审报告模板用证据驱动的方式编写制造就绪度报告【免费下载链接】text-to-cadA library of agent skills for CAD, CAE and CAM项目地址: https://gitcode.com/GitHub_Trending/tex/text-to-cad在 text-to-cad 这个面向 CAD/CAE/CAM 的 Agent 技能库中sendcutsend技能负责在用户上传 DXF/STEP 文件到 SendCutSend 之前基于官方订购指南、目录 JSON 与工程规格 JSON 生成保守、有证据支撑的“预检preflight”报告。本文以 report-template.md 这份报告模板为主体完整拆解报告五节结构Context / Sources Checked / Geometry Facts / Findings / Verdict的字段要求与判定纪律并结合 SKILL.md 与 official-sources.md 说明每一节背后的取数来源、引用规范与源码级依据帮助读者掌握一套可复现、可审计的“文件事实 × 官方规则”对比式预审报告写法。一、模板的定位什么时候必须用它report-template.md 开篇即给出触发条件当用户要求 review、validation、preflight 或 manufacturing readiness 报告时使用该结构。在 SKILL.md 的 Reporting 一节中这条引用关系被明确写入技能正文“Usereferences/report-template.mdwhen a structured report would help.”转换后的仓库内路径为 skills/sendcutsend/references/report-template.md并在 References 一节再次标注“Report shape:references/report-template.md”。也就是说模板不是可选的排版建议而是整个技能“报告形态”的规范来源技能负责定义查什么、怎么比模板负责定义报告长什么样、结论怎么说。该技能在 README.md 的技能表中被概括为“Checks DXF and STEP files before upload to SendCutSend”其入口提示词定义在 openai.yamlUse $sendcutsend to review this DXF or STEP file for SendCutSend upload readiness.——“upload readiness”正是模板 Verdict 一节所要回答的问题。二、逐节解剖模板结构模板全文只有 42 行但每一节都规定了不可省略的字段。以下按模板顺序完整继承其要求。2.1 Context先声明“假设的下单上下文”模板 Context 节 要求报告头部固定列出四项字段取值要求File被审查文件的pathAssumed serviceDXF laser sheet cutting或STEP CNC routing二选一Order context材料、厚度、主加工方式、表面处理、数量、二次工序Date checkedYYYY-MM-DD格式的核查日期这一节的关键语义在于“Assumed”一词SendCutSend 的可制造性规则是按 SKU材料厚度服务键控的缺少下单上下文时不能臆断。SKILL.md 的工作流第 1 步与之呼应先收集订单意图——激光钣金切割优先用 DXF、CNC 开槽/3D 建模优先用 STEP/STP并记录文件类型、目标工艺、材料/SKU、厚度、数量、服务、表面处理与五金件如果订单上下文缺失或有歧义应先呈现具体的候选 SKU/材料/厚度/服务附来源链接请用户确认后再写就绪度结论而不是直接给结论。2.2 Sources Checked文献表而非行级引用的替代品Sources Checked 节 的规则可以拆成四条硬约束以 Markdown 链接列出实际查阅过的 SendCutSend 官方 URL只收录真正用到的来源记录访问日期并在可得时记录 JSON 的_meta.generated_at值Findings 表必须逐行链接具体规则来源因此本节是文献表bibliography不能替代行级引用来源清单必须与 Findings 表的 Rule source 列相互印证。官方来源的具体选择规则定义在 official-sources.md三个核心入口分别是订购指南sendcutsend-ordering-guide.md、目录 JSONsendcutsend-catalog.json与工程规格 JSONsendcutsend-specs.json均托管在 SendCutSend 官方 CDN 的specs目录下每次审查前都应直接从官方 URL 拉取把当前响应体作为材料/服务检查的证据。三者分工明确订购指南用于下单流程、文件格式规则与白话设计规则目录 JSON 用于“可下单性”事实SKU、材料名、厚度、库存状态、切割工艺、最小/最大零件尺寸、可用服务、五金件、表面处理选项工程规格 JSON 用于 SKU 键控的工程校验值公差、最小孔/桥/边距值、折弯参数、攻丝、锪孔、五金插入、压凹、表面处理约束、材料属性。SKILL.md 还强调了一条总纪律把订购指南、catalog JSON、specs JSON 视为证据源而非稳定 API——字段名、类型、覆盖范围都可能变化缺失、不可解析、N/A或互相矛盾的数据一律不得转化为 pass 或 fail。2.3 Geometry Facts只陈述“文件事实”Geometry Facts 节 要求汇总来自$cad检查如可用与针对性的build123d/ezdxf检查代码产出的事实至少覆盖文件类型、单位、范围/包围盒、实体/体数量、图层、不受支持的实体、明显的开口/重复几何以及解析限制。该节还有三个条件性扩展要求是模板中最“长”的部分本次工作流生成的文件要附 viewer 链接如果被审查的上传文件是在本工作流中生成或更新的应尽可能附上$cad-viewer的 viewer 链接。这与 SKILL.md 的“CAD Viewer Handoff”义务一致完成任何创建或修改.dxf/.step/.stp上传候选的 SendCutSend 工作后必须把显式文件路径交给$cad-viewer若技能不可用或启动失败应显式报告而非静默省略。带折弯的 2D 文件DXF必须包含导出文件中的折弯几何事实——折弯线数量与图层、每条折弯线的独立长度、每条折弯线最近的非折弯切割几何、局部法兰深度、折弯线跨距覆盖、折弯相邻切割几何、接触/支撑不足的观察以及 split/interrupted/common-axis 折弯的观察并要求拿这些事实与当前材料/厚度的服务页面对比。带折弯的 STEP/STP 文件必须包含如可测的实测板材厚度与提取出的折弯半径集合仅当订单上下文已知时才把折弯半径与所选材料/SKU 对比。这与 SKILL.md 的“Geometry Inspection”一节对应几何事实必须用项目 Python 环境中的检查代码获取STEP/STP 用build123d.import_stepDXF 用build123d.ezdxf禁止用原始文本解析或其他几何后端产出几何事实且第 3 步明确要求“检查的是确切的上传文件本身而不是源生成器、CAD 模型或生成器控制台摘要”。2.4 Findings一行一个问题每行必须可溯源Findings 节 规定表格形态与引用纪律StatusCheckEvidenceRule sourceRecommendation✅ pass / ❌ fail / ❓ need more info需求名称文件事实指向具体规则文档/表格的 Markdown 链接或Direct file inspection具体的下一步动作三条关键规则一行一个问题不得把多个问题折叠进一行Rule source 必须链接定义该需求的具体官方页面或 JSON 文件来源是 JSON 时要给出字段路径模板给出的示例是materials[skuALU-063].cutting_specs.min_hole_size这种“SKU 定位 字段路径”的写法并且优先使用精确到 SKU 的来源而不是泛化的指南文字没有任何外部规则适用时Rule source 必须写Direct file inspection直接文件检查不允许留空——这条规则在 SKILL.md 的 Reporting 一节中被再次强调。“一行一个问题”不是排版偏好而是为了防止物理成因不同的折弯问题被混同。SKILL.md 专门要求不要将折弯相邻几何坍缩为泛化的法兰失败应分别成行报告——最小法兰/接触长度错误、折弯线或压模区几何交叉、附近自由边或切口导致的折弯接触/支撑不足、未跨完整折弯区域的折弯线、split/common-axis 折线段、以及触碰或跨越折弯线的切割几何。若官方来源没有暴露精确的压模区/接触阈值就把实测文件事实标注为 direct file inspection并显式标记“受来源限制”的对比。2.5 Verdict三种且仅三种结论Verdict 节 把结论压缩为受限词表Ready to upload for this assumed context在该假设上下文下可上传Needs edits before upload上传前需要修改Insufficient context to validate上下文不足以校验并给出两条不可逾越的判定红线任何一条必需的最新官方需求检查被标记为❌ fail或❓ need more info时永远不得给出 ready 结论只有在每一条被引用的必需检查都具备充分订单上下文、来源证据、实测文件事实且通过或明确不在所选服务范围内时才能使用Ready to upload for this assumed context在 SendCutSend 显式的 UI 分类模型被有意加入之前所有实测的上传风险与可制造性问题一律按❌ fail处理不得推测平台可能有其他分类。这三条红线与 SKILL.md 的 Comparison 纪律一一对应只比较“可信的证据对”来源要求与实测文件事实都必须可用且可信缺少测量或测量有风险时为该特定几何事实编写一个小的build123d/ezdxf定向检查器在发出任何材料相关的 pass/fail 之前不得静默缩放几何或使用不确定的比例。三、支撑模板的状态词表与证据链设计模板中的三个状态符号不是随意定义的它们在 SKILL.md 中有精确语义✅ pass实测文件事实满足被引用的、当前有效的需求❌ fail实测的上传风险、可制造性问题或对当前被引用需求的直接实测违反❓ need more info缺失上下文、缺失来源证据、未测量的几何、来源冲突或工具限制。注意 pass 的语义是“满足被引用的需求”而不是“文件看起来不错”——这就是模板强调“evidence-backed”证据支撑的原因每个 ✅ 背后必须能同时指出“规则来源字段路径”和“文件实测值”两列内容。来源侧的证据链规则在 official-sources.md 中完整定义必须捕获的溯源信息Provenance来源 URL、访问日期、JSON 的_meta.schema_version、_meta.generated_at、如存在_meta.source_data_generated_at以及行级引用用的字段路径如sendcutsend-specs.json materials[skuALU-063].cutting_specs.min_hole_size。冲突处理优先级当来源事实冲突或字段缺失、不可解析、为N/A时报告不确定性并将依赖行标记为❓ need more info除非另一个更具体的被引用来源能解决冲突。事实来源的采信优先级从高到低为材料/厚度/服务特定的配置器或当前报价/上传结果工程规格 JSON 中的精确 SKU 条目目录 JSON 中的精确 SKU 条目订购指南更广泛的 SendCutSend 人类可读页面仅在前三个来源文件都不足时使用。并且要记录冲突以及最终采信了哪个来源。四、模板的输入从哪来SKILL 工作流如何为五节供数模板本身不取数它的每一节都依赖 SKILL.md 四步工作流的前置产物。理解这条供数链才能正确使用模板收集订单意图→ Context 节记录文件类型、目标工艺、材料/SKU、厚度、数量、服务、表面处理、五金件上下文缺失时先列出候选含来源记录中的photo_url图片与learn_more_url链接如可得请用户确认。拉取并规范化官方来源→ Sources Checked 节读取 official-sources.md直接获取官方来源并检查返回文档防御性地规范化来源事实——解析数值字符串、尺寸字符串、N/A、缺失字段、混合类型与缺失的服务数组显式记入备注。检查确切的上传文件→ Geometry Facts 节DXF 侧按需测量单位、边界、图层、实体类型、开口/重复几何、不受支持注释、候选孔/圆、线条统计、折弯线候选、折弯到切割距离、折弯相邻切割几何、局部法兰深度、退化零面积轮廓STEP/STP 侧按需测量可解析性、单位提示、实体/曲面信号、包围盒、壳体/体信号、有效性、板材厚度、圆柱折弯面半径及解析限制。所有检查辅助代码保持“只报事实”可以报告测量值、解析错误与限制但不得输出 pass/fail/readiness 状态SKILL.md L41。按证据质量选择来源记录→ Findings 节的 Rule source 列精确 SKU 是唯一权威的 catalog/specs 关联键只给材料和厚度时仅当候选匹配唯一且足够精确才选定材料否则列出候选请用户选择catalog JSON 管可下单性specs JSON 管工程值订购指南管流程与文件格式规则。两个典型检查项与模板字段的对应关系值得展开DXF 单位检查SKILL.md L59 要求把$INSUNITS、头部范围、实测边界与订单上下文一起检查若$INSUNITS缺失、不受支持或不是 SendCutSend 指南期望的 DXF 单位码1表示英寸、4表示毫米应报告单位/比例错误并建议在应用任何尺寸、法兰或材料相关对比之前重新导出或先确认单位——这条错误会落到 Findings 表成为❌ fail行并直接封杀 ready 结论。折弯对比2D 文件沿每条折弯线的每个跨距/采样点测量两侧最近切割/自由边局部最小法兰深度与所选 SKU 的bending_specs.min_flange_length_before_bend/bending_specs.min_flange_length_after_bend对比任何局部法兰深度低于 SKU 最小值即报告❌ fail且不得用聚合值替代含局部切口、折线中断、split 段的几何SKILL.md L60STEP 件则提取圆柱/圆环折弯面半径并分组与所选 SKU 的bending_specs.effective_bend_radius或bending_specs.bend_radius对比半径冲突即报告折弯半径不匹配错误SKILL.md L62。这两条正是模板 Geometry Facts 节中“bent 2D files”与“bent STEP/STP files”两段要求的检查端实现。此外SKILL.md 还给出了 DXF Review 与 STEP Review 两份完整检查清单单一可上传的 1:1 比例 DXF、闭合轮廓、退化/零面积轮廓、两点闭合多段线、奇数次切割端点、重复/重叠切割几何、不受支持的标注/文字/尺寸/图像/构造线/隐藏指令图层、孔/槽/web 宽度仅在两侧事实都支持对比时才检查等这些是 Findings 表“Check”列的候选条目来源模板则保证它们被组织成一行一问题的可审计结构。五、配套机制诊断图版式预检与技能安装使用除模板本体外围绕报告交付还有两个配套机制值得注意诊断图版式预检SKILL.md L70-L81当发现项用图更易理解时若具备图像生成/编辑能力应在出现❌ fail、空间上含糊的几何问题或需要前后对比说明的几何编辑时主动生成诊断图。生成前先做版式预检——选择解释修复所需的最小标注集预判标签是否会拥挤、互相重叠或超出画布若可能拥挤则改用编号标记加侧边图例、更大画布或独立细节视图把长测量值与规则文字放在图例而非密集几何上方图中必须包含实测失败距离、被引用的最小值和拟议的移动/间隙目标。生成后先检查渲染结果再交付标签重叠、被裁剪或难读时须重新生成。技能安装与调用按 README.md 的推荐路径通过 Skills CLI 安装整个技能库npx skills install earthtojake/text-to-cad安装后即可用$sendcutsend调用该技能默认提示词见 openai.yaml。该技能与其他技能存在自然的分工边界例如gcode技能明确规定“如果是平面切割而非打印件应使用$sendcutsend而不是该技能”见 skills/gcode/SKILL.mdDXF 建模则由 skills/dxf 负责——sendcutsend 只负责“上传前的证据化预审”这一环。六、模板设计的三个核心原则通读模板与其供数工作流可以提炼出该报告形态背后的三条设计原则也是把这套模板迁移到其他制造/下单预检场景时最有价值的方法论事实与判定分离检查代码只产文件事实L41 的 fact-only 约束模板只承载判定判定必须同时落在“来源字段路径 实测值”两列上任何一列缺失该行只能是❓ need more info。引用粒度到字段路径materials[skuALU-063].cutting_specs.min_hole_size这种“SKU 定位 字段路径”的引用方式让每行 Findings 都可独立复核也使“文献表不替代行级引用”成为可执行规则。保守的结论词表只有三种 Verdict且 ready 结论要求全量必需检查通过或明确在所选服务之外在平台显式分类模型出现之前一切实测风险按失败处理——这让报告的否定结论永远比肯定结论更容易被接受。对照 report-template.md 原文42 行与上文各节模板的全部字段要求、状态词表与判定红线均已完整覆盖配合 SKILL.md 的工作流与 official-sources.md 的来源优先级即可在不修改任何仓库文件的前提下完整复现一份 SendCutSend 上传就绪度预审报告。【免费下载链接】text-to-cadA library of agent skills for CAD, CAE and CAM项目地址: https://gitcode.com/GitHub_Trending/tex/text-to-cad创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考