Skip to content

幽灵字段 Customer Since 的最后 6 处:ai-copilot 两页把「成为客户的日期」写进 Copilot 会读的客户画像(三语) #840

Description

@yinlianghui

来源:#824(PR 见下)实施过程中的越界发现,不由该 PR 的改动导致,该 PR 未修改本文件面。基线 origin/main = a501812。

#805 / PR #823 修了 revenue/contracts.mdx,#824 修了 revenue/index.mdx 与 sales/accounts.mdx。grep -rn "customer-since|成为客户的日期|成為客戶的日期" content/ 显示同一条幽灵声明还剩最后 6 处,全在 content/docs/ai-copilot/ 下,而且换了一种更难被搜到的拼法(英文页写 customer-since 带连字符、zh 页写「成为客户的日期」),所以前三轮的 Customer Since 关键字搜索都没扫到它们。

事实

crm_account 上没有 customer_since,也没有任何其它名字的字段记录「何时成为客户」——grep -rn "customer_since" src/ 零命中,src/objects/account.object.ts 的字段表里也没有对应项。合同激活(src/objects/contract.hook.ts:104-119)只在合同上盖 signed_date、把 account.type 改成 customer,不写任何日期到客户上。

两个 Copilot 技能的 instructions 里也没有提到这个数据点:

  • src/skills/customer-360.skill.ts 的第 2 步只列了 crm_contact / crm_case / crm_opportunity,账户本身走 describe_object + get_record,读回来的是真实存在的字段;
  • src/skills/case-triage.skill.ts 第 2 步的权重是「customer tier and contract value」,没有成为客户的时长。

具体位置(6 个文件)

文件:行 原文
content/docs/ai-copilot/sales-copilot.mdx:110 - **Relationship snapshot** — account tier, customer-since date, account owner.
content/docs/ai-copilot/sales-copilot.zh-Hans.mdx:104 - **关系快照**——客户层级、成为客户的日期、客户负责人。
content/docs/ai-copilot/sales-copilot.zh-Hant.mdx:104 - **關係快照**——客戶層級、成為客戶的日期、客戶負責人。
content/docs/ai-copilot/service-copilot.mdx:38 - The **customer's profile** (account tier, customer-since, contract).
content/docs/ai-copilot/service-copilot.zh-Hans.mdx:34 - **客户的画像**(客户层级、成为客户的日期、合同)。
content/docs/ai-copilot/service-copilot.zh-Hant.mdx:34 - **客戶的畫像**(客戶層級、成為客戶的日期、合約)。

两处都是三项并列,另外两项(客户层级 tier、客户负责人 owner_id / 合同)都是真实字段,中间夹的这一项是空的——与 #824 里 sales/accounts.mdx 那条同型:并排的邻居都成立,读者没有理由怀疑其中一条不存在。

影响

读者(和照着文档写 prompt 的人)会以为 Customer 360° / 案例分诊能拿到「这家客户跟了我们多久」。实际 Copilot 调 describe_object 拿回来的字段表里根本没有这一项,要么它据实略过、要么它拿别的日期(比如 last_activity_date)去凑。

修法建议

以 src/objects/account.object.ts + 两个 *.skill.ts 为事实来源改这 6 个文件:删掉这一项,或按 #823 / #824 已定的口径改写为「客户上不记录成为客户的日期,要看这段关系有多久只能读合同的签署日期 / 开始日期」。不为散文加钉子测试。

⛔ 不要改 src/** —— 要不要在 crm_account 上加 customer_since 是产品决定,不该由文档倒推;若确定要做,另开实现单。

Refs #824 #805 #823

Activity

  1. added
    bugSomething isn't working
    documentationImprovements or additions to documentation
    pm:queueReady for the PM dispatch loop
    pm:dispatchedDispatched to a dev agent by /pm-dispatch
    and removed
    pm:queueReady for the PM dispatch loop
    on Aug 5, 2026
  2. self-assigned this
    on Aug 5, 2026
  3. yinlianghui commented on Aug 5, 2026

    @yinlianghui
    CollaboratorAuthor

    🔒 认领(修复线 PM 派单):session_01VHrPAGEgFDoHjphqYG4BMa,分支 claude/issue-840-copilot-customer-since,worktree hotcrm-issue-840。文件面:ai-copilot/sales-copilot.mdx ×3(Customer 360° 关系快照)、ai-copilot/service-copilot.mdx ×3(案例分诊客户画像)、changeset。裁定:按 #824/PR #841 已定口径处理这最后 6 处(en 带连字符 customer-since、zh 意译「成为客户的日期」——两种拼法都清);两个技能的 instructions(customer-360.skill.ts、case-triage.skill.ts)里没有这个数据点,文档句子改成技能真实读取的字段(以 skill 源码为唯一事实来源,skill 真读什么写什么);⛔ 不动 src/**(要不要给技能加这个数据点是产品决策)。⚠️ sales-copilot zh 页刚被 #842 改过动词面,基线取最新 main。


    Generated by Claude Code

  4. yinlianghui commented on Aug 5, 2026

    @yinlianghui
    CollaboratorAuthor

    [PM 验收] PR #848 ACCEPT — 已转 ready 并挂 auto-merge(session_01VHrPAGEgFDoHjphqYG4BMa)

    复核结论:

    越界发现处置:#847(同两页其余 bullet 的能力漂移,case_triage 工具面够不着宣称的检索/产出)证据硬、边界去重已做(#808/#732/#612 各留边界说明),已挂 pm:queue。因与本 PR 同文件族,将在 #848 落地后排后续轮次派发。


    Generated by Claude Code

  5. added and removed on Sep 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

bugSomething isn't workingdocumentationImprovements or additions to documentationpm:dispatchedDispatched to a dev agent by /pm-dispatchpriority:p2Medium: important, M3

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions