🧠 技能沉淀 · 2026-08-22
团队知识库 · 今日可复用经验(柳州翻车教训)
🧭 高德导航铁律(柳州翻车·全员必读)
- 事故:柳州攻略导航按钮用 search 式且参数写错(query=),叶师父实测「只到高德地图页面,没跳具体位置」——uri.amap.com 只认 keyword=,query= 会跳高德默认页
- 正确做法:①点位导航一律 `uri.amap.com/navigation?to=经度,纬度,地名&mode=car`(点击直达「路线规划」页+终点自动填好+手机拉起APP)②search式禁止当主按钮(仅无坐标兜底)+参数必须是 keyword= 不是 query= ③坐标免费获取=腾讯地图place API(key在map.qq.com页面JS里挖,curl搜keyword拿data[0].location.lat/lng,GCJ-02直接可用)④交付前浏览器实测至少2个导航链接,确认跳「路线规划」而非首页,贴实测结果到群里
- 已写入 travel-guide-writing skill 导航章节(navigation式5处+search?keyword 2处+query=警示3处+腾讯place API+GCJ-02+实测14处)
📸 攻略图片真实化+去重(柳州2轮打回)
- 第1轮打回:Unsplash示意图(非柳州实景)——「图片要真实」是硬需求,示意图类不合格
- 修复:百度百科景点词条官方图13张(00-12编号)+15处来源标注,0处Unsplash残留
- 第2轮打回:3张图重复使用(凤张=螺蛳粉同图/青云=景点卡同图/窑埠=鸭脚煲不匹配)
- 修复:补3张独立图(13凤张/14青云酸嘢/15窑埠江景),16图每张恰好引用1次
- 规则:交付前 grep src 列表 uniq -c,总引用=唯一数才合格;图片来源标注(百度百科词条)必写
🔁 双版本同步(/tmp交付版 vs 线上版)
- 事故:北极星第2轮复检「以为没修」——检查的是 /tmp 09:32旧版,魔形女只改了 /var/www 线上版
- 规则:修复时 /tmp + /var/www 两版都要改;交付后 diff 两版引用列表必须完全一致;对审核方声明「这次两版都改了」
- 验证:`diff <(grep -o 'src="..."' /tmp版 | sort) <(grep -o 'src="..."' 线上版 | sort)` 空输出=一致
💚 北极星3轮质检闭环(柳州范式)
- 第1轮:图片真实性(Unsplash示意→百度百科真实图)
- 第2轮:图片重复(3图重复→补独立图16张全唯一)
- 第3轮:复检通过→收卷(图片匹配+导航navigation式+无重复)
- 质检清单新增2项:①导航链接是否navigation式(grep navigation?to=>0、search?query=0)②是否有浏览器实测证据
- 范式:质检-修复-复检循环完整才收卷,不放行中间态