# Xdjz Xiaohongshu Shop Diagnosis

> 诊断小红书店铺定位、商品与内容等方面的问题，分析原因，并提供可落地的优化建议。

- Skill: `ahang1598/xdjz-xiaohongshu-shop-diagnosis` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx get-skill add ahang1598/xdjz-xiaohongshu-shop-diagnosis`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ahang1598/xdjz-xiaohongshu-shop-diagnosis/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ahang1598 (https://skillmd.com/u/ahang1598)
- Updated: 2026-11-18
- Page: https://skillmd.com/skills/ahang1598/xdjz-xiaohongshu-shop-diagnosis

---


# 小红书店铺诊断

## 任务约定

面向商家老板，帮助其发现问题、确定优化方向并看到执行后的样子。默认中文，唯一必填输入为**店铺号或店铺名称，二者任选其一**。公司名称、店铺链接、截图、品牌素材均为可选辅助信息；用户只给公司名称时先尝试解析关联店铺，不增加必填项。

收到明确诊断请求后直接执行到可下载PDF，不先让用户确认框架、填写问卷或选择模板。用户要求“先讨论/先不要更新”时只完成所要求的讨论。仅身份歧义、登录验证或确实必要的缺失信息阻断时询问；不得为省事让用户手工补齐可自动取得的资料。

本Skill编排当前环境已提供的能力，不包含平台私有API，也不保证任意环境都有已登录浏览器或可访问全部公开页面。

## 执行顺序

### 1. 确认对象与可用能力

读 [采集与证据](references/collection.md)。优先使用适用连接器；需平台内搜索、检查已登录页面、截图或商品详情时，遵循环境提供的浏览器能力与使用规范。公开信息查询先按环境要求使用搜索，不能把搜索失败当成绕过工具规则的理由。

平台站内常被 IP 风控拦截（小红书错误 300012 等）。**执行本步前先读 collection.md 的「风控拦截与提速」**：浏览器最多试 2 次，被拦即改走服务端抓取（WebFetch）并按其缓存与变参规则取数；外部搜索定位身份最多 2 轮，取不到就一次向用户要主页/笔记链接。不要反复重试同一通道。

用店铺号或名称识别唯一店铺，核对账号号、主体/认证、主营品类、主页与商品归属。区分博主账号、店铺、品牌和经营公司；它们的指标不能直接混用。出现多个合理同名候选且无法证实关联时，展示最少量区分信息，只问一次目标是哪家。不要默认第一条搜索结果正确。

已登录则复用；登录扫码仅按平台真实安全流程，不能自制登录二维码。遇验证或访问阻断，按工具规范停止该路径，保留已得到的证据，简明说明限制。

### 2. 能自动则自动地采集

本版仅使用通过店铺名称/店铺号能够定位并合法访问的公开前台信息，包括平台内需正常登录才能查看的公开内容。自动采集 → 自动关联、分类、比较 → 对关键原因定向补证据。不读取商家后台、私信或订单等私有数据，不要求用户上传经营数据，不将已有登录或授权视为扩大本次数据范围的理由。不发消息、不下单、不修改店铺、不发布样例。

建立店铺档案、证据台账与素材台账。优先查看真实商品详情、关联笔记、评论和外部消费者体验；根据问题选取可比商品。围绕可行动问题定向抽样，记录窗口、样本、去重规则与抓取时间；证据足够后停止无目标扩搜。

输出**公开信息经营优化诊断版**：以证据支持的机会、风险线索和低成本试验为主，不声称已经量化经营损失或识别真实经营瓶颈。缺失曝光、点击、订单、利润、退款率时不填估算值。本版不执行授权流程，也不依赖后台数据即可完成本报告；`references/metrics.md`仅保留为未来用户明确要求经营数据诊断时的口径参考，不属于本版工作流。

### 3. 先分析，再编排页面

读 [公开信息分析方法](references/public-analysis.md)。以**经营目标 → 定位问题线索 → 比较候选原因 → 选择动作 → 验证效果**为分析主线。用户未说明目标时，先根据公开证据筛选本轮可改善的方向，不默认其订单下降或利润不足，也不增加必填问卷。

按八类经营任务初筛机会，不必八类都深入或出页。不要因页面与评论容易采集就只推荐改详情；检查客群、场景、商品供给、获客表达、选择理由、价值说明、交付预期与再次购买理由。利润、资金、库存、人效缺乏公开依据时明确暂不能诊断，不编造对应问题。

每个候选发现保留事实、来源、适用范围、可能影响、候选原因、支持与反证、缺口、优先级理由。**公开页面的缺口可以确认，缺口造成转化低不能直接确认**。同一现象比较合理的不同原因，不用“客户觉得贵”直接推导降价，不用互动少直接推导封面差。

本轮选择1–3项证据较充分、潜在影响较大、投入较小且容易验证的动作。每项形成任务卡：经营目标、发现与证据、原因及判断强度、改哪里/改成什么、直接交付物、责任角色/依赖、验证方法及继续/调整/停止条件。区分可直接审核的设计与需要小范围验证的经营动作，不保证收益。

从实际可见的购买路径与顾客反馈重建本店顾客旅程，不默认套用“购买前/等待收货/售后”三段。可覆盖发现、比较选款、确认下单、等待配送、开箱使用、售后与再次购买，并按品类与证据调整或侧重。各环节对应顾客问题、可能影响、真实证据和处理重点；区分已有优势、优先改善与待核查信号。流程重建不等于行为追踪，缺失的环节不虚构问题。

### 4. 按金字塔原理制作可读报告

读 [报告与视觉规范](references/report-design.md)。先写一个有证据支持的核心判断，再选至多三个支撑论点；**每页只表达一个观点**，页面标题本身就是结论。避免在摘要、诊断、行动表反复抄写同一段话。使用老板易懂的具体语言，保留专业判断与证据边界，删去解释报告结构的旁白；详细写法见报告规范。

首页以“关键发现 → 影响 → 建议”呈现，区分值得保留与需要改善的发现，关键建议通常两项、最多三项。第二页用实际顾客旅程图给老板全局概览，标出证据支持的问题环节与重点；内容围绕经营目标组织，避免成为页面检查清单。专题默认将真实案例、问题说明和优化后的效果放在同一页；不能直接优化时给出具体建议，必要时附已核验的优秀案例链接。每页仍只论证一个观点，确需拆页时才拆，不重复论证。

至少为首要可执行建议制作一个**针对该店具体商品/场景的成品效果示例**，不能只给字段清单或把问题推回“问客服”。详见报告规范中的事实不足处理。适度引用真实店铺图片、详情/笔记截图并标注来源；示意图与原始证据明确区分，不能伪造买家截图、官方界面或改善前后经营数据。

尾部顺序为：行动计划 → 一页分类数据与来源说明；报告止于来源页，不追加授权、品牌介绍或额外推广页。

### 5. 生成、检查与交付PDF

**优先复用 `scripts/report_template.py`（数据与布局分离的模板）**：把报告内容写成数据 JSON（结构见 `scripts/report_data_example.json`），运行 `python report_template.py <data.json> <out.pdf>` 生成。复跑或改数据时只改 JSON，不改布局代码；确需新增版式时在模板里加页面类型，修一处对所有报告生效。该模板依赖 `scripts/pdf_components.py`（中文排版、页眉页脚、卡片与箭头组件），字体在数据 JSON 中传入真实字体文件路径。

**目检闭环按“一轮找齐、批量修、复查改动页”执行，不要全量两轮**：
1. 第一次渲染后**逐页一次性检查完**（字体清晰、无乱码、无溢出、无孤字标题；截图可读；证据/假设标记不被遮盖；没有为了填版面的无用图表），把所有问题列成清单；
2. 一次批量修复全部问题，重新生成；
3. 第二轮**只复查被改动影响的页面**，不重读未变页面；纯数据更新（布局未动）可只抽查版式最容易溢出的 1–2 页。

如环境要求持久保存，将报告存入用户可访问的文件系统；已有报告改版保留对应文件身份。最终给出 `店铺名_经营诊断报告_日期.pdf` 的可下载链接，简述主要发现与重要限制，不把整篇报告再贴进聊天。默认只交付PDF，用户要求时再给可编辑版本或单独设计图。

## 必须守住的判断边界

- 未核验身份，不出冒充该店的正式诊断；无法访问目标时不拿同名店、行业常识代替实证。
- 粉丝/互动不等于成交；标题价格不等于成交价；少量差评不等于高退货率；网页入口缺失不等于店铺路径缺失。
- 只有店铺名也能启动，但不能承诺无需登录或身份澄清就必然访问全部公开页面。
- 数据缺口集中放附录；影响关键结论的限制紧随结论，不以大量重复免责声明淹没正文。
- 使用具体商品样例，不固化本次云觅鲜花的账号、图片、价格、结论或登录状态。

