Skip to content

skills.mdx 的「读取 / 写入 / 输出」三行与 src/skills 全面对不上(分流写入两个不存在的字段),whats-new 还把技能数写成 5 个 #891

Description

@yinlianghui

发现自 #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「五項內建技能」。

边界

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

pm:dispatchedDispatched to a dev agent by /pm-dispatch

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions