/ys 主入口
> 判断问题域，消解式路由，不给清单轰炸。
1. 定位
/ys 是 ysskill 技能包的统一入口。它只负责一件事：听懂用户原话，把模糊的经营焦虑消解成一句真问题，然后路由到 1 个主技能，并视情况联动最多 1 个辅助技能。
本技能不输出具体诊断结论，不做十项清单式建议，不做跨象限同时治疗。
2. 触发词
- 中文：「帮我看看」「帮我诊断一下」「你看看我这家店」「/ys」
- 斜杠：
/ys - 场景：用户描述店铺现状、流量焦虑、转化低、选品犹豫、内容没方向、执行力差等任何经营问题；或需要对日 / 周 / 月 / 大促做阶段性复盘
知识库检索（执行前必读）
诊断 / 路由前必须读取 knowledge/atoms.jsonl（原子库，每行一条原子，核心字段 knowledge）与 knowledge/knowledge-packs/ys-ys.md（本技能对应路由表、核心概念与案例模板），按主题检索相关原子作为推理依据；命中后输出引用原子 ID（格式：依据 0000001）。本 SKILL.md 只给方法与步骤，案例与经验以知识库为准；无相关原子时明确标注「无原子支撑」，不得凭感觉下判断。
3. 核心公理
- 诊断先于方案（SRS 4.1）：先消解问题，再给解法；不消解就给方案 = 自嗨。
- 小商家的病 90% 是「诊断错 + 不执行」（SRS 4.1）：诊断与执行力技能必须能联动。
- 一次只解决一个真瓶颈（SRS 4.1）：抓主要矛盾，不列十项清单。
- 数据 > 感觉 > 理论（SRS 4.1）：真实数据优先，感觉其次，理论兜底。当前版本理论为主，需逐步替换为数据。
- 路由即诊断（SRS 5
/ys）：把用户从「不知道问什么」引导到「问对的问题」。
4. 诊断漏斗
- 采集：听取症状，索要关键数据；缺数据时先给「缺数据清单」，不猜。
- 消解：用一句话重述真问题，把「没流量」消解成「开场 30 秒流失」或「投流 ROI 低于 1」。
- 分层：把问题归入产品 / 流量 / 转化 / 复购 / 执行五大层。
- 定主：选出 1 个当前最应解决的真瓶颈。
- 路由：给出 1 个主技能 + 最多 1 个联动技能。
5. 输出模板
【用户原话】（引用用户输入中最关键的 1–2 句）
【真问题】（一句话消解后的核心问题）
【根因分层】产品 / 流量 / 转化 / 复购 / 执行 中归入哪一层
【路由建议】
- 主技能：<技能名>（理由不超过 20 字）
- 联动技能：<技能名 或 无>（理由不超过 20 字）
【一句话结论】（30 字以内）
【引导语】（邀请用户进入下一步，例如：「请把近 30 天数据贴给我，我让 /ys-diagnosis 跑一遍。」）
6. 反例库
- 清单轰炸：用户说「没流量」，AI 同时给投流、内容、直播、选品、客服 5 条建议。错在一次解决多个瓶颈，违反「一次只解决一个真瓶颈」公理。
- 不消解就路由：用户说「转化低」，AI 直接推荐
/ys-copy。错在没有先区分是「流量不精准」还是「信任感不够」，应先由/ys-diagnosis拆象限。 - 忽视执行联动：用户方向明确但总说「做不动」，AI 仍继续给策略建议。错在应联动
/ys-action或/ys-unblock拆解卡点。 - 越过 save/restore：跨对话时不建议用户先
/ys-save。错在多轮诊断会丢失上下文，应主动提示存档。 - 把复盘当诊断：用户说「帮我复盘这周」，AI 直接输出四象限诊断报告。错在复盘是「回看预期 vs 实际」，不是「找新问题」，应走
/ys-review；复盘中发现的新问题再转给/ys-diagnosis。
7. 联动
7.1 16 个对外子技能路由条件表
路由确定主技能后，先按需读取该技能对应的子技能文档（下表「子技能文档」列，与本文件同级存放），再按其 8 段结构执行；一次只加载当前需要的 1 份文档，不要预加载全部。
| 技能 | 路由条件（用户表达或问题域） | 子技能文档（按需读取） | 典型联动 |
|---|---|---|---|
/ys |
默认入口；任何未明确归属的经营问题 | 本文件即该技能 | 指向下方任一主技能 |
/ys-strategy |
问「卖什么」「这个类目能不能做」「商业模式怎么设计」 | ys-strategy.md |
/ys-selection（选品落地） |
/ys-diagnosis |
问「整体有没有问题」「问题在哪」「先看哪个象限」 | ys-diagnosis.md |
/ys-save（诊断后存档） |
/ys-review |
阶段性回看：复盘、日结、周复盘、月报、大促后复盘、这波活动值不值 | ys-review.md |
/ys-diagnosis（复盘发现新问题） |
/ys-live |
流量/直播间相关：场观低、停留短、转化差、话术没方向 | ys-live.md |
/ys-content 或 /ys-copy |
/ys-selection |
选品/品线相关：不知道卖什么、想上新、利润薄 | ys-selection.md |
/ys-strategy 或 /ys-diagnosis |
/ys-content |
内容/脚本/短视频相关：选题、脚本结构、标题、拍摄方向 | ys-content.md |
/ys-copy（钩子与文案） |
/ys-copy |
转化/文案相关：带货文案、AI 味、钩子、话术 | ys-copy.md |
/ys-content 或 /ys-live |
/ys-benchmark |
想找对标账号、拆可模仿点 | ys-benchmark.md |
/ys-benchmark-idea（先筛选对象） |
/ys-benchmark-idea |
不知道学谁、对标账号太多 | ys-benchmark-idea.md |
/ys-benchmark（再拆解） |
/ys-competitor |
竞品相关：分析某店怎么做、竞品有什么我没有、竞品对比 | ys-competitor.md |
/ys-diagnosis（判断是否值得补） |
/ys-service |
售后/客诉/差评相关 | ys-service.md |
/ys-diagnosis（看服务象限） |
/ys-action |
方向对但做不动、需要拆到明天可启动 | ys-action.md |
/ys-unblock（若心理卡点明显） |
/ys-unblock |
知道但做不到、怕失败/怕评价/怕成功 | ys-unblock.md |
/ys-action（最小行动） |
/ys-save |
任何诊断结束、用户说「记下来」「存档」 | ys-save.md |
无 |
/ys-restore |
用户说「上次」「接着」「继续」 | ys-restore.md |
无 |
/ys-index-obsidian |
原子库相关：同步到 Obsidian、生成笔记、重建 MOC、素材回流 | ys-index-obsidian.md |
/ys-save（存档本轮结论） |
7.2 路由后固定动作
- 路由到诊断类技能（
/ys-diagnosis、/ys-live、/ys-selection等）时，若用户提供了数据，进入量化诊断；若无数据，输出框架建议 + 缺数据清单。 - 路由到执行类技能（
/ys-action、/ys-unblock）时，先确认方向已明确，否则回退到/ys-diagnosis。 - 路由到复盘类技能（
/ys-review）时，先确认对比周期与口径；缺上期或计划值时，先输出复盘框架并索要基线。 - 路由到工具类技能（
/ys-competitor、/ys-index-obsidian）时，先确认配套依赖已安装（requests / beautifulsoup4 / openai / pyyaml）：/ys-competitor走包根目录的内置模块mod_competitor.py，/ys-index-obsidian走scripts/下的同步脚本。 - 任何一轮有意义诊断结束后，建议用户
/ys-save存档。 - 跨对话触发词出现时，优先
/ys-restore。
8. 数据要求
本技能为路由入口，自身不需要经营数据。
但应在采集阶段询问或记录以下信息，供下游技能使用：
- 经营平台（抖音 / 视频号 / 小红书 / 其他）
- 主营类目 / 客单价区间
- 团队规模（1 人 / 1–3 人 / 3–10 人）
- 是否有近 30 天店铺数据（访客、转化率、客单价、复购率、退货率）
- 是否有投流数据（月投流费、月成交数、毛利率、自然流量占比）
无数据时不中断：先按用户描述做定性路由，并提示「接入数据后可升级为量化诊断」。
9. 高步频内置模块（mod_*）
以下四个模块不是独立子技能，而是内置在包根目录的常驻工具：它们与全部子技能共享同一个
knowledge/atoms.jsonl 与 knowledge/candidates.jsonl，也共用同一套 DeepSeek 抽取流水线
（base_url=https://api.deepseek.com，model 取 deepseek_model，api_key 取环境变量 DEEPSEEK_API_KEY
或 atom_admin/config.json）与同一套去重脱敏逻辑（复用 scripts/sync_atoms_to_md.py）。
| 模块文件 | 调用频率 | 功能 | 触发示例 |
|---|---|---|---|
mod_competitor.py |
每周 | 竞品采集（SerpApi 或手动粘贴）→ 解析直播间/商品/评论与高频词 → 抽原子 → 与自身按 topics 做 diff（竞品有我有 / 竞品有我缺 / 我有竞品无） | 「分析这个竞品」「竞品有什么我没有」「扒一下对手的商品结构」 |
mod_review.py |
每周 | 差评聚类（7 类规则 + 模型兜底）→ 匹配服务类原子给根因与修复建议 → 客服话术 + 服务分修复 7 天 SOP → 高频根因生成 anti-pattern 候选 | 「帮我分析这批差评」「差评怎么回」「服务分怎么救」 |
mod_rule_watch.py |
每月 | 巡检 type=rule 原子：>90 天标过期、平台来源 >60 天标待复核；可选联网找新规则，同 topics 下旧规则标 expired、新规则进候选 |
「规则是不是过期了」「平台规则更新了吗」 |
mod_data_connector.py |
每周 | 数据对接（API / CSV / 手动）→ 汇总 17 项核心指标 → 生成 diagnosis_input.json 与可直接粘贴的诊断输入 |
「拉一下店铺数据」「把数据喂给诊断」「生成诊断输入」 |
9.1 共用红线（四个模块都写死在代码里）
- 候选只追加
candidates.jsonl，绝不直写主库（唯一例外是mod_rule_watch把旧规则status标expired，且改前必备份）； verified生成时强制false，只有回验模块能改成true；source为空一律拦截，不生成候选；- 竞品数据不存精确 GMV，一律区间化；差评不存用户真实 ID / 手机 / 微信号；
- 规则过期只改
status为expired，不删旧原子、不改写内容； - 写候选前必须与
atoms + candidates做 md5 精确去重 + Jaccard > 0.85 近似去重。
9.2 CLI 入口
python mod_competitor.py --shop "某家居店" --mode direct --text-file competitor.txt
python mod_competitor.py --shop "某家居店" --compare-only
python mod_review.py --input reviews.csv
python mod_review.py --input "物流太慢了" --single
python mod_rule_watch.py --check
python mod_rule_watch.py --check --auto-search --mark-expired
python mod_data_connector.py --platform douyin --days 7
python mod_data_connector.py --csv shop_data.csv --feed-diagnosis
python mod_data_connector.py --manual
桌面端（atom_admin/）的「高步频工具」菜单可直接调用这四个模块，输出显示在日志面板。
9.3 原子 schema 新增可选字段
| 字段 | 说明 |
|---|---|
harvest_source |
采集来源标记：competitor / review / rule_watch / 空（人工录入） |
related_product |
关联商品名（差评、竞品场景可用） |
版本：v2.0 ｜ 作者：黄继华 ｜ 验证状态：主入口无量化阈值，纯路由逻辑
