图形学图像处理跨平台【免费下载链接】SkiaSharpSkiaSharp is a cross-platform 2D graphics API for .NET platforms based on Googles Skia Graphics Library. It provides a comprehensive 2D API that can be used across mobile, server and desktop models to render images.项目地址https://gitcode.com/gh_mirrors/sk/SkiaSharp点击查看免费下载本文是 SkiaSharp 仓库中issue-triage技能的实操守则解读。它以 .agents/skills/issue-triage/references/anti-patterns.md 为骨架系统梳理 AI 在分流triageIssue 时必须避开的 9 类反模式并结合技能入口 SKILL.md、triage-schema.json、validate-triage.py 与 issue-pipeline.md 等仓库证据逐条展开。读完本文你将掌握什么是 triage 的只读红线、9 类典型反模式的具体表现与正确做法以及如何借助 schema 与验证脚本守住输出质量底线让每个 Issue 的首次分流都经得起下游 repro复现与 fix修复环节的检验。反模式全景一张表看清 9 条铁律anti-patterns.md用「❌ NEVER」语气列出 9 条分流禁令其共性指向同一个目标triage 阶段只做只读分析、只产出可验证的证据绝不越权改写源码、绝不臆断结论。先看总览#反模式一句话含义正确做法0只读红线CRITICALtriage 期间不得创建/编辑任何源码文件、不得构建运行需要复现时标记needs-investigation交给issue-repro1Pre-baked delegation把分类结论写进子代理提示词子代理只调查并返回证据由你基于证据分类2Age-based closure因 Issue 太旧而关闭旧 Issue 无修复仍是未解决的 bug/需求保持打开3Platform-deprecated ≠ stale把 Xamarin.Forms 问题当做过时先检查 MAUI 中是否仍存在相同代码/缺口4Assertion without citation写「代码做了 X」却没有{file, lines}每条结论必须给出codeInvestigation的 file/lines 引证5Batch shortcuts批量处理时偷懒复用结论每个 Issue 独立完整调查可并行调查、不可并行下结论6.NET Forward Compatibility断言「不支持 .NET X」或建议降级.NET 前向兼容net8.0库可在net10.0应用运行平台专属 TFM 除外7No repo artifacts在仓库工作树创建总结/计划文件工作文件放会话工作区~/.copilot/session-state/8Fabrication编造代码调查结论、文件路径或行号找不到就说找不到绝不虚构9Skipping validation跳过validate-triage.py必须运行脚本看到 ✅ 才能持久化输出其中第 0 条是整个分流体系的「地基」其余 9 条本质上都是从不同角度守卫它的边界。红线优先Triage 是只读分析动了源码就是失败anti-patterns.md开篇即声明「If you edit a source file during triage, you have FAILED.」这是整个技能体系的最高优先级规则与 SKILL.md 中反复出现的「Triage is READ-ONLY. Do NOT edit any source files (.cs, .cpp, .csproj, .json)」完全一致。被明令禁止的包括创建、编辑或运行.cs、.csproj、.cpp、.h、.json源码、.slnx、.targets、.props等任何工程与源码文件执行构建与测试dotnet build、dotnet test、dotnet cake以及运行任何 reporter 提供的代码。这条红线与流水线里其他技能的分工互为镜像issue-repro的反模式清单同样规定「Reproduction ONLY creates new test projects in/tmp/skiasharp/repro/{timestamp}/. NEVER editbinding/,externals/,samples/,source/,tests/,utils/」——参见 .agents/skills/issue-repro/references/anti-patterns.md。也就是说triage、repro、fix 三个阶段各司其职triage 读代码下分类repro 建临时项目做复现fix 才真正修改产品源码。正确做法是如果在分流阶段确实需要复现就在output.actionability.suggestedAction中标记为needs-investigation并停止把复现工作交给issue-repro技能。这个交接动作在 issue-pipeline.md 中被定义为三步流水线的第 1 步Triage → Repro → Fix数据通过 JSON 文件在docs-data-cache分支上接力传递。反模式 1预烘焙委托Pre-baked delegation表现在派发给子代理sub-agent的提示词里预先写死你想要的分类结论例如「请去确认这是 type/bug 并查找证据」。问题子代理会顺着提示词「找证据圆结论」调查变成走过场证据链被污染。正确做法子代理的职责边界是调查并返回证据分类决策永远由你主代理基于返回的证据作出。这与 SKILL.md 的 Phase 2 要求一脉相承——「Grep, read files, trace call chains. Never create files, compile, or execute」——证据收集与结论判定必须分离否则流水线下游拿到的codeInvestigation就是不可信的。反模式 2按年龄关闭Age-based closure表现看到 Issue 是很久以前提的、长期无人回复就直接建议关闭。问题Issue 的「旧」不代表「无效」。一个没有代码修复的旧 Issue意味着问题或需求仍然存在。正确做法判断一个 Issue 是否过时依据不是时间而是当前代码状态。SKILL.md 的 Phase 2 明确要求对 bug 检查「does the issue still exist?该代码路径是否仍然存在」对 feature request 检查「has it been implemented since filing?自提出以来是否已实现」。只有证据表明问题已被修复、或需求已被实现才可能走向close-as-fixed否则应保持打开。suggestedAction枚举中的keep-open有效 Issue 但暂无行动正是为此准备的——见 schema-cheatsheet.md 的「Choosing suggestedAction by issue type」。反模式 3平台弃用 ≠ 过时Platform-deprecated ≠ stale表现把 Xamarin.Forms 相关的 Issue 一律当作「已过时」而建议关闭。问题Xamarin.Forms 停更不代表问题消失。SkiaSharp 的视图层有大量跨平台实现MAUI、Uno、GTK 等同一个 bug 或 API 缺口极可能在 MAUI 里原样存在。正确做法先检查同一代码/缺口在 MAUI或对应活跃平台中是否仍然存在再决定处置。这与 labels.md 中的平台标签体系呼应——area/SkiaSharp.Views.Maui、area/SkiaSharp.Views.Uno等都是独立于area/SkiaSharp.Views.Forms的有效区域标签。另外注意 labels.md 的一个关键区分API 契约跨平台存在但某个平台处理器缺失应归类为type/bugAPI 契约被破坏只有当没有任何平台实现时才用type/enhancement。盲目按「平台过时」关闭恰恰会漏掉这种契约层面的真 bug。反模式 4无引证的断言Assertion without citation表现在analysis.codeInvestigation之外凭空写「the code does X」却拿不出{file, lines}条目。问题没有 file:line 的断言无法被下游repro、fix验证等于空口白话。正确做法每个结论都必须挂靠codeInvestigation条目其结构为{file, finding, relevance}可选lines行号——这是 triage-schema.json 的硬性定义。规则不仅写在文档里还写进了验证脚本validate-triage.py 会强制检查——type/bug 必须有至少一条 codeInvestigation 条目close-类动作至少两条*否则脚本报错退出。这正是「No file:line no claim」的机器化落地。反模式 5批量捷径Batch shortcuts表现同时处理多个 Issue 时为节省时间把第一个的分析结论套用到后面相似的 Issue 上。问题Issue 相似不等于相同尤其是平台、版本、复现步骤不同的情况。正确做法每个 Issue 获得完整独立的调查。SKILL.md 给出了明确的平衡点并行调查parallel investigation没问题并行下结论parallel conclusions绝不允许。调查阶段可以并行 grep、读文件、trace 调用链但分类和suggestedAction必须逐个独立得出。同时 Phase 2 要求搜索相关 Issue 与 PRgh search issues/gh pr list目的正是区分「重复」与「相关」——批量捷径最容易把相关误判成重复污染去重决策。反模式 6.NET 前向兼容性.NET Forward Compatibility表现看到 Issue 报告在net10.0应用中出现问题就下结论「库不支持 .NET 10」或建议「降级到 .NET 8」作为变通方案。问题两个都是错误结论。.NET 在设计上前向兼容——NuGet 的 TFM fallback 机制允许一个net8.0的库在net10.0的应用中正常引用运行。版本号低于应用目标框架不等于不兼容。正确做法断言「不支持 .NET X」之前先确认库的目标框架TFM与依赖链变通方案应当是修复问题本身而不是劝用户降级框架。唯一的例外是平台专属 TFM例如net8.0-ios这类需要平台专属 native assets 的 TFM——因为 iOS/Android 等平台的 native 库绑定在具体 TFM 上。这条规则与 .agents/skills/issue-repro/references/anti-patterns.md 中的「Assuming TFM incompatibility」互为印证repro 阶段同样禁止在未检查 nupkg 前臆断 TFM 不兼容。反模式 7仓库无产物No repo artifacts表现在仓库工作树里创建TRIAGE_SUMMARY.md、PLAN.md之类的总结、计划或报告文件。问题这些临时产物会污染仓库、混入提交历史且不属于任何流水线环节的交付物。正确做法所有工作文件一律放在会话工作区~/.copilot/session-state/。triage 的正式交付物只有三件且全部由脚本生成到output/ai-triage/{number}/下triage.json— 经 schema 验证的结构化 JSONtriage.md— 由 triage-report.md.jinja2 模板渲染的 Markdown 报告triage.html— 基于 viewer.html 的交互式查看页。生成流程见 persist-triage.py先跑验证脚本验证通过才复制 JSON 并触发渲染。这条「产物归位」的纪律在issue-repro的反模式 #21 中同样存在属于整个 AI 工作流体系的通用约束。反模式 8编造Fabrication表现没读文件却写「the code shows X」编造文件路径或行号或为了「显得有结论」而虚构调查结果。问题这是对流水线信任链的彻底破坏。下游 repro 会拿着你编造的行号去读代码fix 会基于虚构的「根因」写修复——错误会逐级放大。正确做法找不到代码就明说找不到。SKILL.md 对此的表述是如果搜索不到对应的类型/方法/行为如实记录必要时在analysis.nextQuestions中列出待调查问题让 repro 环节去确认。编造行为同时在issue-repro反模式 #22 中被明令禁止——repro 阶段不得用 echo 模拟命令输出、不得仅凭静态代码分析就声称「reproduced」。真实性是三个环节共同的底线。反模式 9跳过验证Skipping validation表现写完 JSON 后「心里过一遍」觉得没问题就跳过validate-triage.py直接持久化。问题人工自查不是验证。schema 约束additionalProperties: false、必填字段、枚举合法性和业务规则bug 必须有 codeInvestigation、绝对路径必须脱敏只有脚本才能系统性把关。正确做法严格走 SKILL.md 定义的 Phase 5 关卡python3 .agents/skills/issue-triage/scripts/validate-triage.py /tmp/{number}.json退出码语义明确Exit 0 ✅ 有效可进入 Phase 6 持久化Exit 1 ❌ 按输出修正错误后重跑最多重试 3 次Exit 2 致命错误文件不存在、schema 缺失、参数错误停止并报告。脚本除了做 JSON Schema 校验triage-schema.json还带额外的业务检查validate-triage.pybug 无 codeInvestigation 报错、needs-investigation无suggestedReproPlatform给出警告、codeInvestigation中出现/Users/、/home/、C:\Users\等绝对路径直接报错。而persist-triage.py会在持久化前再次调用验证脚本验证失败拒绝写入——双重保险确保未经 ✅ 的输出永远不会进入output/ai-triage/。反模式之外三类更隐蔽的坑主文档的 9 条之外SKILL.md和同体系的issue-repro反模式还暴露了三类与 triage 直接相关的补充红线值得一并记住1. Triage 期间禁用store_memorySKILL.md 反模式 #1。Triage 产出的是 JSON 工件不是记忆。把未经核实的「事实」写入持久记忆会污染所有后续会话。只有经过验证的结论才允许沉淀。2. 建议代码必须经过三方验证workaround-validation。如果resolution.proposals[]或add-comment的评论里包含代码片段必须先经过三个并行验证代理的检查API 正确性 / 行为正确性 / 平台安全性详见 workaround-validation.md。任一代理判定 fail就要修复或删除代码、降低置信度、设置validated: no——绝不允许把未经检查的代码发给 reporter。3. 评论风险等级动态计算。add-comment的风险不是固定值而是由内容和置信度共同决定见 schema-cheatsheet.md纯事实陈述且置信度 ≥ 0.85 为 low包含变通方案建议为 medium任何「关闭 / 驳回 / by-design」表述一律 high——因为告诉 reporter「你的 Issue 无效」永远需要人工复核。落地指南一次合规的 Triage 该怎么做把 9 条反模式倒过来就是一份可执行的合规清单与 SKILL.md 的六阶段流程对齐Setup一次性安装依赖、确认gh可用并已认证Investigate只读读 Issue 全文 → 对涉及的 SK* 类型/方法 grep 源码并读相关文件 → 搜索相关 Issue 与 PR重复、先前修复、被回滚的改动都要记录→ 所有发现写入analysis.codeInvestigation带 file:lines 引证Analyze读 schema-cheatsheet.md 和 labels.md 校准枚举 → 按 research-by-type.md 做类型专属研究 → 生成 JSON 到/tmp/{number}.json禁止用$TMPDIR之类的变量替代字面路径Workarounds按 workaround-search.md 的 9 级优先级已有 triage → 已关闭 Issue → 已知模式 → 源码 → 文档 → 教程 → 示例 → 更广搜索 → 网络给 reporter 找「现在就能用」的变通方案含代码则走三方验证Validate运行validate-triage.py看到 ✅ 才能继续Persist Present运行persist-triage.py展示triage.json / triage.md / triage.html三件产物并根据suggestedAction提示下游走向needs-investigation→issue-reprorepro 确认 →issue-fix对应关系见 issue-pipeline.md。最后可以对照 evals.json 中的评测用例自检例如「triage #3420」要求 Android 16KB 页大小 bug 归类为type/bugarea/libSkiaSharp.nativeos/Android、suggestedReproPlatform为 linuxAndroid 问题统一用 Linux runner——这些判定背后每一处都有源码调查与标签规范支撑正是 9 条反模式被逐一遵守后的自然结果。小结anti-patterns.md的价值不在于罗列「不能做什么」而在于它把 AI 分流最容易犯的 9 类错误系统化、可测试化了只读红线管住越权引证要求管住空谈验证脚本管住输出质量前向兼容管住版本误判仓库归位管住环境污染。对于任何要在 SkiaSharp 仓库乃至同类大型开源项目上运行 AI 三阶段 Issue 流水线的团队把这份反模式清单与validate-triage.py一起固化进工作流是让 triage 结果真正「可被下游信任」的最低成本方案。赞分享图形学图像处理跨平台【免费下载链接】SkiaSharpSkiaSharp is a cross-platform 2D graphics API for .NET platforms based on Googles Skia Graphics Library. It provides a comprehensive 2D API that can be used across mobile, server and desktop models to render images.项目地址https://gitcode.com/gh_mirrors/sk/SkiaSharp点击查看免费下载相关推荐SkiaSharp Issue Triage仓库内置的智能 Issue 分流技能全解析SkiaSharp Issue Triage仓库内置的智能 Issue 分流技能全解析 SkiaSharp 是基于 Google Skia 图形库的跨平台 2图形学图像处理跨平台LangChain Go 实战手册15 分钟跑通你的第一个 LLM 应用LangChain Go 实战手册15 分钟跑通你的第一个 LLM 应用 想象一下这个场景老板甩来一堆产品手册 PDF说给官网做个能回答这些文档问题的机图形学图像处理跨平台SkiaSharp Issue 智能分诊输出格式指南基于 triage-examples.md 校准 Bug、Question 与 Duplicate 三类 JSON 示例SkiaSharp Issue 智能分诊输出格式指南基于 triage examples.md 校准 Bug、Question 与 Duplicate 三类图形学图像处理跨平台上一篇终极指南Zelda64Recomp从源码编译到完整部署的完整流程下一篇Preline UI数据表格(HSDataTable)终极指南10个实用技巧轻松提升数据管理效率创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考