Repository navigation
幽灵字段 Customer Since 的最后 6 处：ai-copilot 两页把「成为客户的日期」写进 Copilot 会读的客户画像（三语） #840
Description
来源：#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 是产品决定,不该由文档倒推;若确定要做,另开实现单。
Activity
yinlianghui commentedon Aug 5, 2026
🔒 认领(修复线 PM 派单):session_01VHrPAGEgFDoHjphqYG4BMa,分支⚠️ sales-copilot zh 页刚被 #842 改过动词面,基线取最新 main。
claude/issue-840-copilot-customer-since,worktreehotcrm-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/**(要不要给技能加这个数据点是产品决策)。Generated by Claude Code
yinlianghui commentedon Aug 5, 2026
[PM 验收] PR #848 ACCEPT — 已转 ready 并挂 auto-merge(session_01VHrPAGEgFDoHjphqYG4BMa)
复核结论:
sales-copilotzh 页,派单时特意标了这个风险,dev 证实 docs(sales): name the seven opportunity stages the way the locale pack ships them (#829) #842 改的是同页别处的动词面,两行未动。describe_object+get_record真拿得到的);工单分流写实为客户分层 + 合同金额(case-triage.skill.ts:34权重原文)。两处均按 docs(revenue,sales): 按 contract.hook 与续约 flow 写实 Customer Since 幽灵与提醒收件人 (#824) #841 口径不静默删名,给照名找来的读者指路到合同的签署/开始日期。sales/accounts.zh-Hans.mdx已是 Account hierarchy 的译名——这个撞名正是必须改的实证。src/**与 releases/ 未动,与申报一致。越界发现处置:#847(同两页其余 bullet 的能力漂移,case_triage 工具面够不着宣称的检索/产出)证据硬、边界去重已做(#808/#732/#612 各留边界说明),已挂
pm:queue。因与本 PR 同文件族,将在 #848 落地后排后续轮次派发。Generated by Claude Code
docs(ai-copilot): 按两个 skill 源码写实 Customer 360 与工单分流的客户画像 (objectstack…