发现自 #808(四个知识库写实)的实施过程。#808 / PR #892 只改了 content/docs/ai-copilot/skills.mdx 每张技能表里的**「知识库」那一行**(裁定面内),外加摘要表 Case Triage 一格里的「matching KB articles」小句(同属虚构知识库说法)——同表其余各行的漂移不在该单 scope 内,故单独立单。实测 origin/main @ 0d3f321。
一、skills.mdx 各技能表的「读取 / 写入 / 输出」行
src/skills/*.skill.ts 是唯一事实来源。逐条对照:
| 页面所在 |
页面的说法 |
源码实况 |
| 🚦 工单分流 · 写入 |
「若用户接受,更新 priority、category、queue」 |
case-triage.skill.ts:49 的 tools 只有 ['describe_object', 'get_record'],没有任何写工具;ADR-0011 曝光默认关闭,escalate_case / close_case 都没有 ai 块,所以运行时根本没有可调用的写路径。而且 crm_case 上既没有 category 字段也没有 queue 字段(工单类型的真实字段是 case_type),这两个名字在对象里查无此物。 |
| 🚦 工单分流 · 输出 |
「建议优先级、分类、团队、Top 3 知识库文章、致谢草稿」 |
instructions 只产出优先级 + 一条理由 + 升级/关闭指引,并把客户回复交给 email_drafting。分类、团队、文章、草稿四项都不产出。 |
| 🚦 工单分流 · 读取 |
「工单主题/描述、联系人与客户上下文、既往工单、产品」 |
无检索工具,拉不出「既往工单」;crm_case 无任何 product 字段或指向 crm_product 的 lookup(#860 已就 service-copilot 页确认过同一事实)。 |
| 🎯 线索资格判定 · 写入 |
「若用户接受,更新 rating 与 status」 |
技能不直接写字段,它调用 action_convert_lead / action_schedule_followup(lead-qualification.skill.ts:34-47)。写路径与副作用是那两个 action 的,不是这两个字段。 |
| 🔭 Customer 360° · 读取 |
「客户、联系人、商机、合同、工单、近期活动、营销活动成员」 |
instructions 只枚举 crm_contact / crm_case / crm_opportunity / crm_knowledge_article。合同、活动、营销活动成员都没被要求读——#847 / PR #861 已就 service-copilot 页把这条写实(「它够得着 crm_contract 但没被要求读」),本页没跟。 |
| 「技能如何协同」段 |
「工单分流可以调用 Customer 360 检查客户是否高价值」「邮件撰写可以调用 Customer 360」「这种组合是自动的」 |
instructions 里唯一真实的移交是 case_triage 第 6 步把客户回复交给 email_drafting。调用 Customer 360 的两条都没有出处。 |
这一族缺陷此前已在 sales-copilot / service-copilot 两页被 #840 / #847 / #860 逐轮写实(PR #848 / #861 / #865),skills.mdx 是同一批说法里没被覆盖到的那一页——而它恰好是被另外两页当作「完整技能规格」引用的那一页。
二、content/docs/whats-new.mdx:99(三语)技能数写成 5
- **Five built-in skills**: lead qualification, email drafting, revenue forecasting, customer 360°, case triage.
src/skills/index.ts 的 allSkills 注册 6 个:上列五个 + LiveDataSkill。skills.mdx:21 自己写的就是「HotCRM ships with six core skills」,两页对不上。Live Data 不是内部实现细节——它有独立的技能文档段落,还是 Wow #1(实时结构)背后的那个技能。
zh 同位:whats-new.zh-Hans.mdx:81「五项内置技能」、whats-new.zh-Hant.mdx:81「五項內建技能」。
边界
发现自 #808(四个知识库写实)的实施过程。#808 / PR #892 只改了
content/docs/ai-copilot/skills.mdx每张技能表里的**「知识库」那一行**(裁定面内),外加摘要表 Case Triage 一格里的「matching KB articles」小句(同属虚构知识库说法)——同表其余各行的漂移不在该单 scope 内,故单独立单。实测 origin/main @ 0d3f321。一、
skills.mdx各技能表的「读取 / 写入 / 输出」行src/skills/*.skill.ts是唯一事实来源。逐条对照:priority、category、queue」case-triage.skill.ts:49的tools只有['describe_object', 'get_record'],没有任何写工具;ADR-0011 曝光默认关闭,escalate_case/close_case都没有ai块,所以运行时根本没有可调用的写路径。而且crm_case上既没有category字段也没有queue字段(工单类型的真实字段是case_type),这两个名字在对象里查无此物。email_drafting。分类、团队、文章、草稿四项都不产出。crm_case无任何 product 字段或指向crm_product的 lookup(#860 已就 service-copilot 页确认过同一事实)。rating与status」action_convert_lead/action_schedule_followup(lead-qualification.skill.ts:34-47)。写路径与副作用是那两个 action 的,不是这两个字段。crm_contact/crm_case/crm_opportunity/crm_knowledge_article。合同、活动、营销活动成员都没被要求读——#847 / PR #861 已就 service-copilot 页把这条写实(「它够得着crm_contract但没被要求读」),本页没跟。case_triage第 6 步把客户回复交给email_drafting。调用 Customer 360 的两条都没有出处。这一族缺陷此前已在 sales-copilot / service-copilot 两页被 #840 / #847 / #860 逐轮写实(PR #848 / #861 / #865),
skills.mdx是同一批说法里没被覆盖到的那一页——而它恰好是被另外两页当作「完整技能规格」引用的那一页。二、
content/docs/whats-new.mdx:99(三语)技能数写成 5src/skills/index.ts的allSkills注册 6 个:上列五个 +LiveDataSkill。skills.mdx:21自己写的就是「HotCRM ships with six core skills」,两页对不上。Live Data 不是内部实现细节——它有独立的技能文档段落,还是 Wow #1(实时结构)背后的那个技能。zh 同位:
whats-new.zh-Hans.mdx:81「五项内置技能」、whats-new.zh-Hant.mdx:81「五項內建技能」。边界
revenue_forecastingwrites nothing #732:那单是forecasting.mdx说revenue_forecasting写预测记录(另一页、另一技能,且挂着 needs-user-decision)。