Skip to content

Instantly share code, notes, and snippets.

@esz135888
Created May 23, 2026 18:54
Show Gist options
  • Select an option

  • Save esz135888/30d747b3db1f551c018fb5be62c9f995 to your computer and use it in GitHub Desktop.

Select an option

Save esz135888/30d747b3db1f551c018fb5be62c9f995 to your computer and use it in GitHub Desktop.
PLS job 0fe47b0d customer visit script adoption evidence ledger

Acceptance Tests

Gate 0:Artifact

  • script-adoption-evidence-ledger.html 可打開。
  • 必交檔案齊全:production-brief.mddata-model.mdacceptance-tests.mddecision-record.mdartifact-url-or-pr.md
  • learning-memory.json 可 parse。
  • artifacts_json 包含 primary_artifact、market_context、production_readiness、e2e_verification、people_sync、learning_memory。

Gate 1:D1 Adoption Review

通過條件:

  • 墨宇產品負責人於 2026-05-25 18:00 前回覆 accept/revise/evidence_gap。
  • 若 accept,仍需 2 筆 visit_evidence_events 才能關閉 overdue。
  • 若 revise,必須指出腳本段落與修正理由。
  • 若 evidence_gap,必須指出缺客戶痛點或案例授權。

Gate 2:D7 Visit Evidence

測試事件:

{
  "visit_type": "mock",
  "pain_moment": "客戶問到導入後維護責任時開始質疑",
  "objection_type": "risk",
  "evidence_requested": "同產業導入前後對照",
  "next_step": "補14天試行驗收設計",
  "next_step_owner": "45a2dfa3-9174-4f64-b333-33dfd9eafc87",
  "next_step_due": "2026-05-27"
}

通過條件:

  • 至少 2 筆 event。
  • 每筆 event 有 pain_moment、evidence_requested、next_step、owner、due、source_ref。
  • events 可產生至少 1 個 proposal_modules draft。

Gate 3:D14 Proposal Module

通過條件:

  • 至少 3 個 proposal_modules。
  • 每個 module 有 objection_type 與 evidence_event_ids。
  • external module 只引用 approved case。
  • blocked module 有 risk_note 與 owner。

Gate 4:D30 Dashboard

通過條件:

  • adoption_snapshots 每週產生。
  • 指標包含 adoption_review_on_time、visit_event_completeness、proposal_module_count、case_scope_risk、next_step_close_rate。

e2e_verification

本輪可驗證:

  • 本地檔案已建立。
  • learning memory JSON 可 parse。
  • required keywords 可搜尋:market_context、production_readiness、e2e_verification、people_sync、learning_memory。
  • Gist URL 建立後以 curl -I -Lgh gist view --files 驗證。

Data Model / API / Sync / Permission Spec

Tables

script_adoption_reviews

欄位 型別 說明
id uuid review id
project_id uuid project id
script_version_id uuid 腳本版本
reviewer_member_id uuid 墨宇產品負責人
status enum accept, revise, evidence_gap, no_response
review_note text 採用或退修原因
due_at timestamptz 2026-05-25 18:00
created_at timestamptz 建立時間

visit_evidence_events

欄位 型別 說明
id uuid event id
script_version_id uuid 腳本版本
visit_type enum mock, real
customer_segment text 客戶類型
stakeholder_role text 對方角色
pain_moment text 客戶開始質疑/感受不到優勢的時機
objection_type enum proof, value, risk, price, timing, stakeholder
evidence_requested text 客戶想看的證據
next_step text 下一步
next_step_owner uuid 負責人
next_step_due date 到期
source_ref text CRM/PLS/Drive/meeting note
audit_actor uuid 記錄者
audit_at timestamptz 記錄時間

case_scope_checks

欄位 型別 說明
id uuid check id
case_name text GOMAJI / 南山 / 旅行社 / 學生作品
publish_scope enum internal_only, external_anonymous, external_named
consent_status enum unknown, pending, approved, expired, rejected
approved_by uuid 授權人
expires_at date 到期
risk_note text 風險

proposal_modules

欄位 型別 說明
id uuid module id
objection_type enum 異議類型
title text 模組標題
body text 提案片段
evidence_event_ids uuid[] 來源拜訪事件
case_scope_check_ids uuid[] 來源案例權限
audience_scope enum internal, external
status enum draft, approved, blocked

API / Sync

Adoption review

POST /api/pls/projects/{project_id}/script-adoption-review

{
  "script_version_id": "uuid",
  "reviewer_member_id": "45a2dfa3-9174-4f64-b333-33dfd9eafc87",
  "status": "accept",
  "review_note": "可進 mock visit,但需兩筆使用證據才能關閉 overdue"
}

Visit event

POST /api/pls/projects/{project_id}/visit-evidence-events

Rules:

  • pain_momentevidence_requestednext_step 必填。
  • next_step 必須有 owner/due。
  • external proposal 只能用 publish_scope != internal_onlyconsent_status=approved 的 case。

權限與稽核

角色 可讀 可寫 不可做
墨宇產品負責人 全部採用與腳本 adoption_review、script approval 覆蓋客成原始 event
墨宇客戶成功窗口 腳本、自己拜訪 event visit_evidence_events 發布外部案例
墨宇 CEO 決策窗口 adoption dashboard review note 改原始拜訪紀錄
PLS worker 必要摘要與 source_ref progress/upload/complete/派工建議 假裝 LINE/CRM 已同步

所有 event 需保留 source_refaudit_actoraudit_at。客戶名稱可匿名化;外部案例需通過 case_scope_checks

失敗回滾

  • 若 status=revise:不得關閉 overdue,派產品負責人段落修正。
  • 若 status=evidence_gap:派客成補痛點或案例 owner 補授權。
  • 若 D7 少於 2 筆 events:維持 overdue,轉成 visit evidence gap。
  • 若 case scope 未通過:proposal module status=blocked

Decision Record:客戶拜訪腳本採用證據帳本

背景

PLS 多輪偵測「產出第一版客戶拜訪腳本」仍 overdue。前輪已產出腳本、mock visit、closure gate;若本輪再重寫腳本,會增加文件但不會關閉根因。根因是缺 adoption evidence。

選項

選項 說明 優點 風險
A. 再寫新版腳本 產出更多話術。 快速。 無法證明被產品接受或客成使用。
B. 只做提醒訊息 催 owner 回覆。 成本低。 沒有資料模型與 E2E 驗收。
C. 建採用證據帳本 adoption_review + visit events + case scope + proposal module。 可判斷是否關閉 overdue,能自動派下一輪缺口。 需要產品與客成實際回寫。

推薦

採用 C。

理由:

  • 成熟 sales playbook/CRM 做法重視 playbook 進 CRM、保存問答、建立 follow-up task 與 adoption 指標。
  • 目前缺口是採用與證據,不是文字不足。
  • C 可以把 overdue action 轉為可測閉環:accept + 2 events + case safe。

採用狀態

建議狀態:pending_adoption_evidence

owner:墨宇產品負責人

evidence owner:墨宇客戶成功窗口

due:2026-05-25 18:00 adoption review;D7 前 2 筆 visit evidence。

落地路徑

  1. 產品負責人回覆 accept/revise/evidence_gap。
  2. 客成補 2 筆 mock/真實拜訪事件。
  3. PLS 驗證欄位完整與 case scope。
  4. 若通過,關閉 overdue 並派 D14 proposal module。
  5. 若未通過,依缺口派產品修正、客成補痛點或案例授權任務。

退修回饋格式

若不採納,必須回饋:

  • 哪個腳本段落不能用。
  • 缺哪種客戶痛點。
  • 哪個案例不能引用。
  • owner/due/驗收是否需調整。

沒有上述回饋,不應再重寫腳本,應維持採用證據缺口。

{
"job_id": "0fe47b0d-0ac0-4e60-888d-7907132ae20a",
"project_id": "b3138a2e-6641-4cc1-859d-8b1d0abf2d3b",
"ai_native_project_id": "de53d513-ec69-423b-9de2-7969241d2895",
"learned_at": "2026-05-24T02:58:00+08:00",
"signal": {
"type": "action_overdue",
"summary": "產出第一版客戶拜訪腳本仍 overdue",
"root_cause_hypothesis": "缺 adoption_review 與 visit_evidence_events,不是缺更多腳本文字。"
},
"recommended_next_check": [
"script_adoption_reviews 是否有 accept/revise/evidence_gap",
"visit_evidence_events 是否至少 2 筆且完整",
"case_scope_checks 是否允許外部提案使用",
"proposal_modules 是否已由高頻異議生成",
"overdue action 是否可按 close rule 關閉"
],
"do_not_repeat": [
"不要再單純重寫客戶拜訪腳本",
"不要在沒有產品 accept 的情況下關閉 overdue",
"不要在少於 2 筆 visit evidence 時宣稱採用",
"不要把未授權案例放進外部 proposal module"
],
"next_worker_rules": {
"if_accept_and_two_events_exist": "close_overdue_and_dispatch_D14_proposal_modules",
"if_revise": "dispatch_product_owner_section_revision",
"if_evidence_gap": "dispatch_customer_success_pain_inventory_or_case_authorization",
"if_no_response_by_due": "escalate_to_ceo_decision_window",
"if_case_scope_blocked": "block_external_module_and_dispatch_case_permission"
},
"market_context": {
"checked_date": "2026-05-24",
"pattern": "Sales playbook adoption requires CRM-saved conversation fields, follow-up tasks, next-best actions, and adoption metrics."
},
"production_readiness": {
"primary_artifact": "script-adoption-evidence-ledger.html",
"e2e_verification": "Validate JSON, required keywords, uploaded files, durable Gist URL.",
"required_artifacts": [
"production-brief.md",
"data-model.md",
"acceptance-tests.md",
"decision-record.md",
"artifact-url-or-pr.md"
]
}
}

客戶拜訪腳本 Adoption Evidence Ledger Production Brief

場景

「產出第一版客戶拜訪腳本」已多輪被 PLS 偵測為 overdue。前輪已補足腳本、mock visit 與 closure gate;本輪的正確推進不是再寫腳本,而是補採用證據帳本,讓 PLS 能判斷此 action 是否真的可關閉:產品是否接受、客成是否使用、是否有 2 筆拜訪證據、案例權限是否安全、是否能轉成提案模組。

30 天路徑

節點 成果 驗收
D1 產品負責人回覆 accept/revise/evidence_gap,客成跑 1 次 mock visit。 adoption_review 有狀態,visit event 有 pain/evidence/next_step。
D7 累積 2 筆 mock 或真實拜訪使用證據。 2 筆 events 完整率 100%,每筆有 owner/due。
D14 將高頻異議轉為提案模組,連案例授權內外版規則。 至少 3 個 proposal_modules 可用,publish_scope 無越界。
D30 客戶策略簡報與提案產線 adoption dashboard。 script adoption、proposal conversion、case risk 每週可追。

Purpose-to-Purpose E2E

原始目的:讓客戶在拜訪中感受到墨宇的差異化優勢。

產出物:採用證據帳本、adoption_review、visit_evidence_events、case_scope_check、proposal_modules。

人採用:墨宇產品負責人定稿;墨宇客戶成功窗口用腳本與欄位做拜訪;CEO 決策窗口看採用與提案轉換,而不是再看一份文字稿。

指標改善:腳本採用率、拜訪紀錄完整率、提案模組生成數、客戶下一步同意率、案例授權風險下降。

market_context

2026-05-24 快速檢查成熟做法:

  • HubSpot playbooks 強調 playbook 應放在 CRM record 內使用,並可在對話後保存問答結果到 timeline。
  • HubSpot playbook/follow-up 實務強調 playbook 要搭配 CRM custom fields、follow-up tasks 與自動化流程。
  • Gartner sales enablement 方向強調 end-to-end buying journey data、內容與工具、商業團隊能力提升,以及 next-best action。
  • 近期 CRM adoption 討論指出,問題常不是缺話術,而是 sales team 沒有把 call note、next task 與 follow-up 寫回系統。

本輪採用:腳本採用不是靠口頭說已完成,而是靠 adoption_review + visit_evidence_events + next_step tasks + case_scope_check。

Solution Stack

  • 脈絡框架:script version → adoption review → visit event → case scope → proposal module → adoption dashboard。
  • 作業流程:產品 accept/revise/evidence_gap → 客成 mock/real visit → PLS 驗證 2 筆證據 → 生成提案模組或派缺口。
  • 資料/DB 模型:script_adoption_reviewsvisit_evidence_eventscase_scope_checksproposal_modulesadoption_snapshots
  • 可操作工具:script-adoption-evidence-ledger.html、資料模型、驗收測試、LINE 草稿。
  • 驗收指標:adoption_review on-time、event completeness、case scope safe、proposal module conversion。
  • 下一輪升級:若 accept + 2 events,關閉 overdue 並派 D14 proposal module;若 revise/evidence_gap,派對應 owner。

production_readiness

  • Primary artifact:script-adoption-evidence-ledger.html
  • Data model:data-model.md 定義 schema/API/權限/稽核。
  • E2E acceptance:acceptance-tests.md 定義 D1/D7/D14/D30 gate。
  • Decision record:decision-record.md 記錄為何本輪不再重寫腳本。
  • Learning memory:learning-memory.json 指示下一輪 PLS 優先檢查採用證據,而不是生成新腳本。

people_sync

LINE 草稿:

墨宇產品負責人、客成窗口,PLS 已把「第一版客戶拜訪腳本」改成採用證據帳本。請在 2026-05-25 18:00 前回覆 accept/revise/evidence_gap;客成 D7 前補 2 筆 mock/真實拜訪紀錄,每筆必填 pain_moment、evidence_requested、next_step、owner、due。關閉條件:產品 accept + 2 筆使用證據 + 案例權限不越界。

learning_memory

本輪推翻的假設:overdue 不代表還缺腳本,而是缺採用 evidence。下一輪若仍看到同一 action overdue,先查 adoption_review 與 visit_evidence_events;若缺 review,追產品;若缺 events,追客成;若 case scope 不清,追案例授權;只有在 revise 明確指出段落問題時才重寫腳本。

<!doctype html>
<html lang="zh-Hant">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>客戶拜訪腳本 Adoption Evidence Ledger</title>
<style>
:root { --ink:#14212f; --muted:#617080; --line:#d8e0e8; --bg:#f7fafc; --panel:#fff; --green:#0f766e; --blue:#1d4ed8; --amber:#9a5b00; --red:#b42318; }
* { box-sizing: border-box; }
body { margin:0; font-family:ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif; color:var(--ink); background:var(--bg); line-height:1.5; }
header { background:#121826; color:white; padding:30px clamp(18px,4vw,50px); }
h1,h2,h3 { margin:0; line-height:1.2; }
h1 { font-size:clamp(28px,5vw,48px); max-width:1080px; }
h2 { font-size:22px; margin-bottom:12px; }
h3 { font-size:16px; margin-bottom:7px; }
header p { max-width:1050px; color:#d9e2ef; margin:10px 0 0; }
main { padding:24px clamp(16px,4vw,50px) 46px; }
.grid { display:grid; grid-template-columns:repeat(12,1fr); gap:14px; margin-bottom:22px; }
.card { background:var(--panel); border:1px solid var(--line); border-radius:8px; padding:16px; box-shadow:0 1px 2px rgba(16,24,40,.04); }
.span-3 { grid-column:span 3; } .span-4 { grid-column:span 4; } .span-6 { grid-column:span 6; } .span-8 { grid-column:span 8; } .span-12 { grid-column:span 12; }
.metric { font-size:31px; font-weight:760; margin:5px 0 2px; }
.muted { color:var(--muted); }
.tag { display:inline-flex; align-items:center; min-height:24px; padding:2px 8px; border-radius:999px; border:1px solid currentColor; font-size:12px; font-weight:720; margin:2px 4px 2px 0; }
.green { color:var(--green); } .blue { color:var(--blue); } .amber { color:var(--amber); } .red { color:var(--red); }
table { width:100%; border-collapse:collapse; }
th,td { text-align:left; padding:10px 8px; border-bottom:1px solid var(--line); vertical-align:top; }
th { font-size:12px; color:var(--muted); text-transform:uppercase; letter-spacing:0; }
ul,ol { margin:8px 0 0 18px; padding:0; } li { margin:5px 0; }
.code { font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace; font-size:13px; background:#eef3f7; border-radius:6px; padding:2px 5px; }
.line-draft { white-space:pre-wrap; background:#eff6ff; border:1px solid #bfd7ff; border-radius:8px; padding:14px; }
@media (max-width:960px){ .span-3,.span-4,.span-6,.span-8{grid-column:span 12;} }
</style>
</head>
<body>
<header>
<h1>客戶拜訪腳本 Adoption Evidence Ledger</h1>
<p>把「產出第一版客戶拜訪腳本」從反覆 overdue 轉成採用證據帳本:腳本是否真的被產品接受、客成使用、客戶回覆、提案轉換,全部用同一組欄位回寫 PLS。</p>
</header>
<main>
<section class="grid">
<div class="card span-3"><h3>Closure Readiness</h3><div class="metric amber">2/5</div><p class="muted">有腳本與 gate;缺 owner acceptance 與 2 筆使用證據。</p></div>
<div class="card span-3"><h3>Owner / Due</h3><div class="metric">產品</div><p class="muted">墨宇產品負責人,2026-05-25 18:00。</p></div>
<div class="card span-3"><h3>Evidence Target</h3><div class="metric blue">2 筆</div><p class="muted">mock 或真實拜訪皆可,但必須有 pain/evidence/next_step。</p></div>
<div class="card span-3"><h3>Close Rule</h3><div class="metric green">明確</div><p class="muted">accept + 2 events + case scope safe 才能關閉 overdue。</p></div>
</section>
<section class="grid">
<div class="card span-8">
<h2>D1 / D7 / D14 / D30 採用路徑</h2>
<table>
<thead><tr><th>節點</th><th>產出</th><th>驗收</th></tr></thead>
<tbody>
<tr><td>D1</td><td>產品負責人回覆 accept/revise/evidence_gap;客成用腳本跑 1 次 mock。</td><td>adoption_review 有狀態,mock event 有 pain/evidence/next_step。</td></tr>
<tr><td>D7</td><td>累積 2 筆拜訪使用證據,整理客戶感受不到優勢的前三場景。</td><td>2 筆 events 完整率 100%,每筆有 owner/due。</td></tr>
<tr><td>D14</td><td>將高頻異議轉成提案模組,接案例授權內外版規則。</td><td>至少 3 個 proposal_modules 可用,publish_scope 無越界。</td></tr>
<tr><td>D30</td><td>形成客戶策略簡報與提案產線採用 dashboard。</td><td>script adoption、proposal conversion、case risk 每週可追。</td></tr>
</tbody>
</table>
</div>
<div class="card span-4">
<h2>Purpose-to-Purpose E2E</h2>
<ol>
<li>原始目的:客戶能感受到墨宇優勢。</li>
<li>產出物:腳本、採用 review、拜訪 events、提案模組。</li>
<li>人採用:產品定稿,客成使用,CEO 看指標。</li>
<li>指標改善:採用率、提案轉換、回覆率、證據風險下降。</li>
</ol>
</div>
</section>
<section class="grid">
<div class="card span-6">
<h2>Evidence Ledger</h2>
<table>
<thead><tr><th>證據</th><th>必填欄位</th><th>關閉判斷</th></tr></thead>
<tbody>
<tr><td>adoption_review</td><td>reviewer、status、note、due</td><td><span class="tag amber">缺</span> 無 accept 不得 close</td></tr>
<tr><td>visit_evidence_event</td><td>pain_moment、objection_type、evidence_requested、next_step</td><td><span class="tag amber">缺</span> 少於 2 筆不得 close</td></tr>
<tr><td>case_scope_check</td><td>case_name、publish_scope、consent_status</td><td><span class="tag green">可定義</span> 未授權只能內部/匿名</td></tr>
<tr><td>proposal_module</td><td>objection_type、body、evidence_asset_ids、audience_scope</td><td><span class="tag blue">下一輪</span> D14 生成</td></tr>
</tbody>
</table>
</div>
<div class="card span-6">
<h2>people_sync</h2>
<div class="line-draft">LINE 草稿:
墨宇產品負責人、客成窗口,PLS 已把「第一版客戶拜訪腳本」改成採用證據帳本。請在 2026-05-25 18:00 前回覆 accept/revise/evidence_gap;客成 D7 前補 2 筆 mock/真實拜訪紀錄,每筆必填 pain_moment、evidence_requested、next_step、owner、due。
關閉條件:產品 accept + 2 筆使用證據 + 案例權限不越界。缺任一項,PLS 不關閉 overdue,而是派下一輪缺口任務。</div>
</div>
</section>
</main>
</body>
</html>

Sources

Checked on 2026-05-24.

market_context

Applied Interpretation

本輪將市場成熟做法轉成 PLS 可執行工具箱:adoption review、visit evidence、case scope、proposal module、adoption snapshot。這使「第一版客戶拜訪腳本」能被採用證據關閉,而不是在文件層反覆生成。

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