用途:本技能面向 maplibre-agent-skills 仓库,指导如何把一次真实的 MapLibre 排错会话转化为技能提案。最有价值的输入是智能体先给出错误答案、再查证并跑通代码的过程,因为“最初的错误答案”一旦上下文结束就无法复原,它也是技能是否值得存在的证据。贡献流程本身见 AGENTS.md 与 CONTRIBUTING.md,本技能只讲会话结束前的采集。
适用时机:某次 MapLibre 任务需要查阅文档、源码、CHANGELOG 或 issue;第一版答案错误,或对 Mapbox GL JS 成立而对 MapLibre 不成立;发现文档未明说的版本边界、坑点或失败模式;或有人要求把会话沉淀为技能。
采集四要素(趁会话未关,先记入草稿):一、错误的第一版答案原文,这是唯一无法事后重建的基线假设;二、实际打开的一手来源 URL(样式规范、GL JS 文档、PR/issue、CHANGELOG),不要凭记忆补链接;三、用一两句写成规则的正确结论;四、版本与最小复现(GL JS 与 Native 有差异)。
去项目化:逐行自问“换到别人的项目里是否仍成立”。删掉项目名、文件路径、内部架构与业务逻辑;保留版本边界(“X 之前坏、之后好”才是判断);保留错误答案之所以看似合理的原因(常是 Mapbox GL JS 习惯或过时训练数据);匿名化,不上传私有内容。
规模判断:一次会话的失败通常只够一个测试加一节内容,优先给已有技能加小节,其次加技能间指针,最后才新建技能。
评测:先写评测再写正文,提示词用会话最初的问题并去掉项目信息;评分标准编码正确结论,措辞要能评判陌生人的回答;用错误答案编造的 API 名做 not-icontains 触发线,真实名称做 icontains。机制与基线运行见 evals/README.md。
交接:明确说明哪些结论已对一手来源验证、哪些没有;无法运行评测(无 API 密钥或不在仓库克隆中)要如实说明,PR 交由人工提交。仅含错误答案、来源与复现的失败报告本身就是完整贡献。
禁止:粘贴完整对话记录;引用未打开的来源;报告未运行的评测结果或编造密钥;把项目特例当 MapLibre 判断;因答案“显然缺失”而跳过基线检查。
相关技能:maplibre-mapbox-migration。参考:AGENTS.md、CONTRIBUTING.md、evals/README.md、Agent Skills 规范。本技能为快照,若与一手来源冲突,以来源为准,并报告分歧及所用 MapLibre 版本。