diff --git a/.changeset/docs-align-retired-agents.md b/.changeset/docs-align-retired-agents.md
new file mode 100644
index 00000000..3ab619d3
--- /dev/null
+++ b/.changeset/docs-align-retired-agents.md
@@ -0,0 +1,34 @@
+---
+'hotcrm': patch
+---
+
+Docs alignment: correct the metadata counts in the README, rewrite the AI copilot
+pages as skill docs, and disclaim the archived Salesforce comparison.
+
+The README advertised "2 AI agents (sales-copilot, service-copilot), 20 flows,
+5 sharing rules" three paragraphs above a repository-layout block that correctly
+called the AI surface skills-only with 23 flows. The real numbers, taken from
+`objectstack.config.ts`, are **0 app-owned agents, 6 AI skills, 23 flows and 9
+sharing rules**; both README passages now say that, and the `8 datasets` count was
+added so the two lists agree.
+
+The published `ai-copilot/sales-copilot` and `ai-copilot/service-copilot` pages (en,
+zh-Hans, zh-Hant) still described two AI personas that were retired in #512 — "it
+lives in the right-side chat panel and as inline buttons" for capabilities that ship
+today as six skills on the platform `ask` assistant. They are rewritten as skill docs
+at their existing URLs, with the activation rules taken from each skill's real
+`triggerConditions` and the write paths named as the actual HotCRM actions
+(`convert_lead`, `schedule_followup`, `escalate_case`, `close_case`) the skills call.
+The AI Copilot index, the Skills page, the glossary's "Agent (AI)" entry, the
+customization guide (which told developers to edit a long-deleted
+`src/agents/sales-copilot.agent.ts`) and every inbound link label were updated to
+match.
+
+`docs/archive/2026-02/SALESFORCE_FEATURE_COMPARISON.md` now opens with a
+retired-architecture banner. It describes a ~148-object, 13-package product and marks
+`sla_policy`, `queue`, `email_to_case` and `pricebook` as implemented — none exist —
+so its "~95% Salesforce parity" headline was actively misleading anyone evaluating the
+repo. Finally `docs/ARCHITECTURE.md` was corrected: the diagram no longer draws the
+deleted `src/agents` or the never-created `src/cubes`, the manifest table reads
+`2.2.2` instead of `1.0.5`, and `requires` no longer lists the `ai` capability that
+was removed in 2.2.0.
diff --git a/README.md b/README.md
index 0799d67f..ae2d1ae6 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,7 @@
 # HotCRM
 
 > **The reference app for AI-written enterprise software.** A complete CRM —
-> 15 objects, 20 flows, 4 dashboards, 2 AI copilots, 4 languages — is roughly
+> 15 objects, 23 flows, 4 dashboards, 6 AI skills, 4 languages — is roughly
 > **170k tokens** of typed [ObjectStack](https://github.com/objectstack-ai/objectstack)
 > metadata (~18,000 lines): the entire enterprise CRM fits in a single agent
 > context window, so an AI can hold it whole, reason about it, and refactor it.
@@ -57,7 +57,7 @@ HotCRM is a complete, opinionated CRM built as the **first official application*
 | `crm_product` | | | |
 | `crm_forecast` | | | |
 
-Plus **2 AI agents** (sales-copilot, service-copilot), **4 dashboards**, **20 flows**, **13 actions**, **6 AI skills**, **4 language bundles** (en, zh-CN, es-ES, ja-JP), **6 permission profiles**, **12 positions**, and **5 sharing rules**.
+Plus **6 AI skills** (a skills-only surface — HotCRM defines no agents of its own; the skills attach to the platform `ask` assistant), **4 dashboards**, **23 flows**, **13 actions**, **8 datasets**, **4 language bundles** (en, zh-CN, es-ES, ja-JP), **6 permission profiles**, **12 positions**, and **9 sharing rules**.
 
 > **Business reader?** The ObjectStack docs tour every one of these capabilities in plain business language — [What Can It Do?](https://objectstack.ai/docs/capabilities) — with HotCRM as the running example on every page.
 
diff --git a/content/docs/ai-copilot/index.mdx b/content/docs/ai-copilot/index.mdx
index f8fe92f2..a4d161df 100644
--- a/content/docs/ai-copilot/index.mdx
+++ b/content/docs/ai-copilot/index.mdx
@@ -5,47 +5,58 @@ description: The AI assistant embedded throughout HotCRM — what it can do, whe
 
 # AI Copilot
 
-HotCRM is **AI-native** — the assistant is built in, not bolted on. Two specialised copilots ship out of the box:
+HotCRM is **AI-native** — the assistant is built in, not bolted on. But the assistant
+itself is not something HotCRM ships: it is the **platform assistant** (`ask`) that
+every ObjectStack environment already provides. What HotCRM contributes is **six
+skills** that teach that assistant your CRM.
 
-- The **Sales Copilot** helps reps qualify leads, draft emails, forecast revenue, and get a 360° view of accounts.
-- The **Service Copilot** helps agents triage cases, see the full customer history, and draft customer responses.
+> **No app-owned agents.** HotCRM used to define two agents of its own — a "Sales
+> Copilot" and a "Service Copilot". They were retired, and their capability moved into
+> skills that attach to the platform assistant. Everything on this page still works;
+> only the wiring changed.
 
-Both run on top of your CRM data — they read from the same objects you see in the UI, and they know your products, knowledge bases, and process rules.
+The six skills read from the same objects you see in the UI, and they know your
+products, knowledge bases, and process rules.
 
 ## Where you'll find it
 
-- 🪄 **Copilot panel** — a chat panel that opens from the right edge of every page.
-- ⚡ **Inline actions** — buttons like *"Qualify this lead"*, *"Draft reply"*, *"Summarize case"* on record detail pages.
-- 📋 **Suggestions** — automatic insights in dashboards (*"3 deals are at risk this week"*).
+- 🪄 **Assistant panel** — the chat panel the platform opens from the right edge of every page.
+- 🎯 **Context activation** — skills declare the record they belong to, so opening a lead and asking *"is this worth a call?"* runs Lead Qualification without you naming it.
+- 📈 **Dashboard questions** — the forecasting skill also activates on dashboards, so you can ask *"what's at risk this week?"* where the numbers already are.
 
 ## How it works (in plain terms)
 
-The Copilot has three ingredients:
+The assistant has three ingredients:
 
 1. **Skills** — bite-sized abilities like *Draft an email*, *Qualify this lead*, *Triage this case*. See [Skills](/docs/ai-copilot/skills).
 2. **Knowledge bases** — searchable libraries of product info, sales playbooks, support articles, and competitive intel. See [Knowledge Bases](/docs/ai-copilot/knowledge-bases).
-3. **Your live CRM data** — the Copilot reads from the same accounts, contacts, opportunities, and cases you do, respecting the same sharing rules.
+3. **Your live CRM data** — the assistant reads from the same accounts, contacts, opportunities, and cases you do, respecting the same sharing rules.
 
-When you ask a question, the Copilot picks the right skill, pulls relevant knowledge, and combines it with your CRM data to produce a grounded answer — with citations back to the source records and articles.
+When you ask a question, the assistant picks the right skill, pulls relevant
+knowledge, and combines it with your CRM data to produce a grounded answer — with
+citations back to the source records and articles.
 
 ## What it won't do
 
 - ❌ See records you can't see — it respects sharing and field-level security.
 - ❌ Take actions without your confirmation — drafted emails and updates are previewed first.
 - ❌ Fabricate data — every claim is traceable to a record or knowledge source.
+- ❌ Reach for tools of its own — skills declare no bespoke tools, so every write goes through a real HotCRM action with the same permission checks as the button.
 
-## Two flavours
+## Two groupings of skills
 
-| Copilot | Audience | Built-in skills |
-| --- | --- | --- |
-| [**Sales Copilot**](/docs/ai-copilot/sales-copilot) | Sales reps, sales managers | Lead qualification, email drafting, revenue forecasting, 360° customer view |
-| [**Service Copilot**](/docs/ai-copilot/service-copilot) | Service agents, support managers | Case triage, 360° customer view, email drafting |
+The six skills are documented in two role-shaped groups. This is a documentation
+convenience, not a runtime boundary — one assistant runs all six, and it will use a
+"sales" skill on a service question whenever that is the right answer.
 
-Both copilots can call each other's skills when relevant — for example, the Service Copilot can use the Sales Copilot's *Customer 360°* skill to show what the customer has bought.
+| Group | Audience | Skills |
+| --- | --- | --- |
+| [**Sales Skills**](/docs/ai-copilot/sales-copilot) | Sales reps, sales managers | Live Data, Lead Qualification, Email Drafting, Revenue Forecasting, Customer 360° |
+| [**Service Skills**](/docs/ai-copilot/service-copilot) | Service agents, support managers | Live Data, Case Triage, Customer 360°, Email Drafting |
 
 ## Start here
 
-- [Sales Copilot](/docs/ai-copilot/sales-copilot) — what reps and managers can do.
-- [Service Copilot](/docs/ai-copilot/service-copilot) — what agents can do.
+- [Sales Skills](/docs/ai-copilot/sales-copilot) — what reps and managers can do.
+- [Service Skills](/docs/ai-copilot/service-copilot) — what agents can do.
 - [Skills](/docs/ai-copilot/skills) — the full skill library.
-- [Knowledge Bases](/docs/ai-copilot/knowledge-bases) — the RAG indexes the Copilot reads from.
+- [Knowledge Bases](/docs/ai-copilot/knowledge-bases) — the RAG indexes the assistant reads from.
diff --git a/content/docs/ai-copilot/index.zh-Hans.mdx b/content/docs/ai-copilot/index.zh-Hans.mdx
index 4292d12f..cf65f5f3 100644
--- a/content/docs/ai-copilot/index.zh-Hans.mdx
+++ b/content/docs/ai-copilot/index.zh-Hans.mdx
@@ -5,47 +5,53 @@ description: 嵌入 HotCRM 各处的 AI 助手——它能做什么、在哪里
 
 # AI Copilot
 
-HotCRM 是 **AI 原生**的——助手是内置的，而非外挂的。开箱即用地提供两个专门的 Copilot：
+HotCRM 是 **AI 原生**的——助手是内置的，而非外挂的。但助手本身并非由 HotCRM 提供：它
+是每个 ObjectStack 环境已经自带的 **平台助手**（`ask`）。HotCRM 贡献的是 **六项技
+能**，让这个助手学会你的 CRM。
 
-- **销售 Copilot** 帮助销售代表判定线索资格、撰写邮件、预测收入，并获得客户的 360° 全景视图。
-- **服务 Copilot** 帮助客服坐席分流工单、查看完整的客户历史，并撰写客户回复。
+> **没有应用自有的智能体。** HotCRM 曾定义过两个自己的智能体——"销售 Copilot"和"服务
+> Copilot"。它们已被退役，其能力迁移到了附着于平台助手的技能中。本页描述的一切依然有
+> 效；变的只是接线方式。
 
-两者都运行在你的 CRM 数据之上——它们从你在 UI 中看到的同一批对象读取数据，并且了解你的产品、知识库和流程规则。
+这六项技能从你在 UI 中看到的同一批对象读取数据，并且了解你的产品、知识库和流程规则。
 
 ## 你会在哪里找到它
 
-- 🪄 **Copilot 面板**——一个从每个页面右侧边缘打开的聊天面板。
-- ⚡ **内联操作**——记录详情页上的按钮，如*"判定此线索资格"*、*"撰写回复"*、*"总结工单"*。
-- 📋 **建议**——仪表盘中的自动洞察（*"本周有 3 笔交易存在风险"*）。
+- 🪄 **助手面板**——平台从每个页面右侧边缘打开的聊天面板。
+- 🎯 **上下文激活**——技能声明了自己所属的记录，因此打开一条线索并问 *"这条值得打个电话吗？"*，无需点名就会运行线索资格判定。
+- 📈 **在仪表盘上提问**——收入预测技能也会在仪表盘上激活，你可以就地问 *"本周有什么风险？"*。
 
 ## 它如何运作（通俗地说）
 
-Copilot 有三大要素：
+助手有三大要素：
 
 1. **技能**——细分到点的能力，如*撰写邮件*、*判定此线索资格*、*分流此工单*。参见 [技能](/zh-Hans/docs/ai-copilot/skills)。
 2. **知识库**——可搜索的产品信息、销售剧本、支持文章和竞争情报库。参见 [知识库](/zh-Hans/docs/ai-copilot/knowledge-bases)。
-3. **你的实时 CRM 数据**——Copilot 从你看到的同一批客户、联系人、商机和工单读取数据，并遵循相同的共享规则。
+3. **你的实时 CRM 数据**——助手从你看到的同一批客户、联系人、商机和工单读取数据，并遵循相同的共享规则。
 
-当你提出问题时，Copilot 会选择合适的技能、拉取相关知识，并将其与你的 CRM 数据结合，生成有依据的答案——并附带回溯到源记录和文章的引用。
+当你提出问题时，助手会选择合适的技能、拉取相关知识，并将其与你的 CRM 数据结合，生成有
+依据的答案——并附带回溯到源记录和文章的引用。
 
 ## 它不会做什么
 
 - ❌ 查看你看不到的记录——它遵循共享和字段级安全。
 - ❌ 未经你确认就执行操作——撰写好的邮件和更新会先预览。
 - ❌ 编造数据——每一条声明都可追溯到一条记录或一个知识来源。
+- ❌ 使用自带的专属工具——技能不声明任何专属工具，每一次写入都经由真实的 HotCRM 操作完成，权限校验与点击按钮时完全一致。
 
-## 两种形态
+## 技能的两种分组
 
-| Copilot | 受众 | 内置技能 |
-| --- | --- | --- |
-| [**销售 Copilot**](/zh-Hans/docs/ai-copilot/sales-copilot) | 销售代表、销售经理 | 线索资格判定、邮件撰写、收入预测、360° 客户视图 |
-| [**服务 Copilot**](/zh-Hans/docs/ai-copilot/service-copilot) | 服务坐席、支持经理 | 工单分流、360° 客户视图、邮件撰写 |
+六项技能按角色分成两组来编写文档。这只是文档上的便利，而非运行时边界——同一个助手运行
+全部六项技能，只要"销售"技能是正确答案，它也会用它来回答服务问题。
 
-两个 Copilot 在相关时可以互相调用对方的技能——例如，服务 Copilot 可以使用销售 Copilot 的 *Customer 360°* 技能来展示客户购买过什么。
+| 分组 | 受众 | 技能 |
+| --- | --- | --- |
+| [**销售技能**](/zh-Hans/docs/ai-copilot/sales-copilot) | 销售代表、销售经理 | 实时数据、线索资格判定、邮件撰写、收入预测、Customer 360° |
+| [**服务技能**](/zh-Hans/docs/ai-copilot/service-copilot) | 服务坐席、支持经理 | 实时数据、工单分流、Customer 360°、邮件撰写 |
 
 ## 从这里开始
 
-- [销售 Copilot](/zh-Hans/docs/ai-copilot/sales-copilot)——销售代表和经理能做什么。
-- [服务 Copilot](/zh-Hans/docs/ai-copilot/service-copilot)——坐席能做什么。
+- [销售技能](/zh-Hans/docs/ai-copilot/sales-copilot)——销售代表和经理能做什么。
+- [服务技能](/zh-Hans/docs/ai-copilot/service-copilot)——坐席能做什么。
 - [技能](/zh-Hans/docs/ai-copilot/skills)——完整的技能库。
-- [知识库](/zh-Hans/docs/ai-copilot/knowledge-bases)——Copilot 读取的 RAG 索引。
+- [知识库](/zh-Hans/docs/ai-copilot/knowledge-bases)——助手读取的 RAG 索引。
diff --git a/content/docs/ai-copilot/index.zh-Hant.mdx b/content/docs/ai-copilot/index.zh-Hant.mdx
index 117f62cf..805173cd 100644
--- a/content/docs/ai-copilot/index.zh-Hant.mdx
+++ b/content/docs/ai-copilot/index.zh-Hant.mdx
@@ -5,47 +5,53 @@ description: 嵌入 HotCRM 各處的 AI 助手——它能做什麼、在哪裡
 
 # AI Copilot
 
-HotCRM 是 **AI 原生**的——助手是內建的，而非外掛的。開箱即用地提供兩個專門的 Copilot：
+HotCRM 是 **AI 原生**的——助手是內建的，而非外掛的。但助手本身並非由 HotCRM 提供：它
+是每個 ObjectStack 環境已經自帶的 **平台助手**（`ask`）。HotCRM 貢獻的是 **六項技
+能**，讓這個助手學會你的 CRM。
 
-- **銷售 Copilot** 幫助銷售代表判定潛在客戶資格、撰寫郵件、預測收入，並獲得客戶的 360° 全景視圖。
-- **服務 Copilot** 幫助客服坐席分流工單、查看完整的客戶歷史，並撰寫客戶回覆。
+> **沒有應用自有的智能體。** HotCRM 曾定義過兩個自己的智能體——「銷售 Copilot」和「服
+> 務 Copilot」。它們已被退役，其能力遷移到了附著於平台助手的技能中。本頁描述的一切依
+> 然有效；變的只是接線方式。
 
-兩者都執行在你的 CRM 資料之上——它們從你在 UI 中看到的同一批物件讀取資料，並且了解你的產品、知識庫和流程規則。
+這六項技能從你在 UI 中看到的同一批物件讀取資料，並且了解你的產品、知識庫和流程規則。
 
 ## 你會在哪裡找到它
 
-- 🪄 **Copilot 面板**——一個從每個頁面右側邊緣開啟的聊天面板。
-- ⚡ **內聯操作**——記錄詳情頁上的按鈕，如*「判定此潛在客戶資格」*、*「撰寫回覆」*、*「總結工單」*。
-- 📋 **建議**——儀表板中的自動洞察（*「本週有 3 筆交易存在風險」*）。
+- 🪄 **助手面板**——平台從每個頁面右側邊緣開啟的聊天面板。
+- 🎯 **情境啟用**——技能宣告了自己所屬的記錄，因此打開一筆潛在客戶並問 *「這筆值得打個電話嗎？」*，無需點名就會執行潛在客戶資格判定。
+- 📈 **在儀表板上提問**——收入預測技能也會在儀表板上啟用，你可以就地問 *「本週有什麼風險？」*。
 
 ## 它如何運作（通俗地說）
 
-Copilot 有三大要素：
+助手有三大要素：
 
 1. **技能**——細分到點的能力，如*撰寫郵件*、*判定此潛在客戶資格*、*分流此工單*。參見 [技能](/zh-Hant/docs/ai-copilot/skills)。
 2. **知識庫**——可搜尋的產品資訊、銷售劇本、支援文章和競爭情報庫。參見 [知識庫](/zh-Hant/docs/ai-copilot/knowledge-bases)。
-3. **你的即時 CRM 資料**——Copilot 從你看到的同一批客戶、聯絡人、商機和工單讀取資料，並遵循相同的共享規則。
+3. **你的即時 CRM 資料**——助手從你看到的同一批客戶、聯絡人、商機和工單讀取資料，並遵循相同的共享規則。
 
-當你提出問題時，Copilot 會選擇合適的技能、拉取相關知識，並將其與你的 CRM 資料結合，生成有依據的答案——並附帶回溯到來源記錄和文章的引用。
+當你提出問題時，助手會選擇合適的技能、拉取相關知識，並將其與你的 CRM 資料結合，生成有
+依據的答案——並附帶回溯到來源記錄和文章的引用。
 
 ## 它不會做什麼
 
 - ❌ 查看你看不到的記錄——它遵循共享和欄位級安全。
 - ❌ 未經你確認就執行操作——撰寫好的郵件和更新會先預覽。
 - ❌ 編造資料——每一條聲明都可追溯到一條記錄或一個知識來源。
+- ❌ 使用自帶的專屬工具——技能不宣告任何專屬工具，每一次寫入都經由真實的 HotCRM 操作完成，權限校驗與點擊按鈕時完全一致。
 
-## 兩種形態
+## 技能的兩種分組
 
-| Copilot | 受眾 | 內建技能 |
-| --- | --- | --- |
-| [**銷售 Copilot**](/zh-Hant/docs/ai-copilot/sales-copilot) | 銷售代表、銷售經理 | 潛在客戶資格判定、郵件撰寫、收入預測、360° 客戶視圖 |
-| [**服務 Copilot**](/zh-Hant/docs/ai-copilot/service-copilot) | 服務坐席、支援經理 | 工單分流、360° 客戶視圖、郵件撰寫 |
+六項技能按角色分成兩組來編寫文件。這只是文件上的便利，而非執行時邊界——同一個助手執行
+全部六項技能，只要「銷售」技能是正確答案，它也會用它來回答服務問題。
 
-兩個 Copilot 在相關時可以互相呼叫對方的技能——例如，服務 Copilot 可以使用銷售 Copilot 的 *Customer 360°* 技能來展示客戶購買過什麼。
+| 分組 | 受眾 | 技能 |
+| --- | --- | --- |
+| [**銷售技能**](/zh-Hant/docs/ai-copilot/sales-copilot) | 銷售代表、銷售經理 | 即時資料、潛在客戶資格判定、郵件撰寫、收入預測、Customer 360° |
+| [**服務技能**](/zh-Hant/docs/ai-copilot/service-copilot) | 服務坐席、支援經理 | 即時資料、工單分流、Customer 360°、郵件撰寫 |
 
 ## 從這裡開始
 
-- [銷售 Copilot](/zh-Hant/docs/ai-copilot/sales-copilot)——銷售代表和經理能做什麼。
-- [服務 Copilot](/zh-Hant/docs/ai-copilot/service-copilot)——坐席能做什麼。
+- [銷售技能](/zh-Hant/docs/ai-copilot/sales-copilot)——銷售代表和經理能做什麼。
+- [服務技能](/zh-Hant/docs/ai-copilot/service-copilot)——坐席能做什麼。
 - [技能](/zh-Hant/docs/ai-copilot/skills)——完整的技能庫。
-- [知識庫](/zh-Hant/docs/ai-copilot/knowledge-bases)——Copilot 讀取的 RAG 索引。
+- [知識庫](/zh-Hant/docs/ai-copilot/knowledge-bases)——助手讀取的 RAG 索引。
diff --git a/content/docs/ai-copilot/knowledge-bases.mdx b/content/docs/ai-copilot/knowledge-bases.mdx
index 63d41049..e6c363b4 100644
--- a/content/docs/ai-copilot/knowledge-bases.mdx
+++ b/content/docs/ai-copilot/knowledge-bases.mdx
@@ -13,9 +13,9 @@ This is the layer that makes the Copilot's answers **grounded** — every fact,
 
 | Knowledge base | Used by | What's in it |
 | --- | --- | --- |
-| 📘 **Sales Knowledge** | Sales Copilot | Playbooks, objection handling, qualification frameworks, win/loss notes |
+| 📘 **Sales Knowledge** | Sales skills | Playbooks, objection handling, qualification frameworks, win/loss notes |
 | 📗 **Product Information** | Sales + Service | Product datasheets, feature specs, release notes, FAQs |
-| 🎧 **Support Knowledge** | Service Copilot | KB articles, troubleshooting guides, runbooks |
+| 🎧 **Support Knowledge** | Service skills | KB articles, troubleshooting guides, runbooks |
 | ⚔️ **Competitive Intel** | Sales | Competitor profiles, battle cards, win/loss analyses |
 
 ## How they work (in plain terms)
@@ -49,7 +49,7 @@ The sales rep's playbook, in searchable form.
 
 ## 📗 Product Information
 
-Everything about what you sell. Read by both sales and service copilots.
+Everything about what you sell. Read by both the sales and the service skills.
 
 **Typical contents**:
 
diff --git a/content/docs/ai-copilot/knowledge-bases.zh-Hans.mdx b/content/docs/ai-copilot/knowledge-bases.zh-Hans.mdx
index fc773f40..c821bea0 100644
--- a/content/docs/ai-copilot/knowledge-bases.zh-Hans.mdx
+++ b/content/docs/ai-copilot/knowledge-bases.zh-Hans.mdx
@@ -13,9 +13,9 @@ description: 为 AI Copilot 提供依据的四个可搜索知识库——销售
 
 | 知识库 | 使用者 | 内含什么 |
 | --- | --- | --- |
-| 📘 **销售知识** | 销售 Copilot | 剧本、异议处理、资格判定框架、赢单/失单笔记 |
+| 📘 **销售知识** | 销售技能 | 剧本、异议处理、资格判定框架、赢单/失单笔记 |
 | 📗 **产品信息** | 销售 + 服务 | 产品数据表、功能规格、发布说明、常见问题 |
-| 🎧 **支持知识** | 服务 Copilot | 知识库文章、故障排查指南、操作手册 |
+| 🎧 **支持知识** | 服务技能 | 知识库文章、故障排查指南、操作手册 |
 | ⚔️ **竞争情报** | 销售 | 竞争对手画像、对战卡、赢单/失单分析 |
 
 ## 它们如何运作（通俗地说）
@@ -49,7 +49,7 @@ description: 为 AI Copilot 提供依据的四个可搜索知识库——销售
 
 ## 📗 产品信息
 
-关于你所销售内容的一切。由销售和服务两个 Copilot 读取。
+关于你所销售内容的一切。由销售和服务两组技能读取。
 
 **典型内容**：
 
diff --git a/content/docs/ai-copilot/knowledge-bases.zh-Hant.mdx b/content/docs/ai-copilot/knowledge-bases.zh-Hant.mdx
index 064139bf..93487d30 100644
--- a/content/docs/ai-copilot/knowledge-bases.zh-Hant.mdx
+++ b/content/docs/ai-copilot/knowledge-bases.zh-Hant.mdx
@@ -13,9 +13,9 @@ description: 為 AI Copilot 提供依據的四個可搜尋知識庫——銷售
 
 | 知識庫 | 使用者 | 內含什麼 |
 | --- | --- | --- |
-| 📘 **銷售知識** | 銷售 Copilot | 劇本、異議處理、資格判定框架、贏單/失單筆記 |
+| 📘 **銷售知識** | 銷售技能 | 劇本、異議處理、資格判定框架、贏單/失單筆記 |
 | 📗 **產品資訊** | 銷售 + 服務 | 產品資料表、功能規格、發布說明、常見問題 |
-| 🎧 **支援知識** | 服務 Copilot | 知識庫文章、故障排查指南、操作手冊 |
+| 🎧 **支援知識** | 服務技能 | 知識庫文章、故障排查指南、操作手冊 |
 | ⚔️ **競爭情報** | 銷售 | 競爭對手畫像、對戰卡、贏單/失單分析 |
 
 ## 它們如何運作（通俗地說）
@@ -49,7 +49,7 @@ description: 為 AI Copilot 提供依據的四個可搜尋知識庫——銷售
 
 ## 📗 產品資訊
 
-關於你所銷售內容的一切。由銷售和服務兩個 Copilot 讀取。
+關於你所銷售內容的一切。由銷售和服務兩組技能讀取。
 
 **典型內容**：
 
diff --git a/content/docs/ai-copilot/sales-copilot.mdx b/content/docs/ai-copilot/sales-copilot.mdx
index 9ca9ffda..a82d85fb 100644
--- a/content/docs/ai-copilot/sales-copilot.mdx
+++ b/content/docs/ai-copilot/sales-copilot.mdx
@@ -1,11 +1,20 @@
 ---
-title: Sales Copilot
-description: The AI sales assistant — qualify leads, draft emails, forecast revenue, and get a 360° customer view.
+title: Sales Skills
+description: The sales-side AI skills — qualify leads, draft emails, forecast revenue, and get a 360° customer view.
 ---
 
-# Sales Copilot
+# Sales Skills
 
-The Sales Copilot is your AI partner for the sales process. It lives in the right-side chat panel and as inline buttons on lead, contact, account, and opportunity pages.
+HotCRM does not ship an assistant of its own. It ships **skills** — packaged AI
+abilities that attach to the **platform assistant** (`ask`) that every ObjectStack
+environment already provides. When you open the assistant panel inside HotCRM, the
+sales skills below are what it knows how to do.
+
+> **Where the personas went.** Earlier versions of this page described a "Sales
+> Copilot" agent. HotCRM no longer defines its own agents: the same capability now
+> lives in five skills registered through `src/skills/`, and the platform assistant
+> selects among them. Nothing was lost — the wiring moved from an app-owned agent to
+> the platform one.
 
 ## Who it's for
 
@@ -13,36 +22,56 @@ The Sales Copilot is your AI partner for the sales process. It lives in the righ
 - **Sales managers** — pipeline and forecast intelligence.
 - **Sales operations** — bulk insights and what-if analysis.
 
-## What it can do
+## How a skill gets picked
+
+You do not choose a skill from a menu. Each skill declares the record context it
+belongs to, and the assistant activates it when that context matches:
+
+| Skill | Activates on |
+| --- | --- |
+| 🎯 Lead Qualification | a `crm_lead` record |
+| 📈 Revenue Forecasting | a `crm_opportunity` record or a dashboard |
+| 🔄 Live Data, ✍️ Email Drafting, 🔭 Customer 360° | any context — always available |
+
+So opening a lead and typing *"is this one worth a call?"* runs Lead Qualification
+without you naming it.
 
-The Sales Copilot ships with five core skills. They can be invoked by chatting (*"Qualify this lead"*) or by clicking inline buttons.
+## The sales skills
 
 ### 1. 🔄 Live Data — the foundation
 
-Before it qualifies a lead, drafts an email, or forecasts a number, the Sales Copilot grounds itself in **live data**. Every turn, it calls `describe_object` and `query_records` against the live metadata + record store — not a cached snapshot. That's why adding a field at 10:00:00 lets the Copilot answer a question about it at 10:00:05 with zero retraining.
+Before it qualifies a lead, drafts an email, or forecasts a number, the assistant
+grounds itself in **live data**. Every turn, it calls `describe_object` and
+`query_records` against the live metadata + record store — not a cached snapshot.
+That's why adding a field at 10:00:00 lets the assistant answer a question about it
+at 10:00:05 with zero retraining.
 
-See [Live Schema (Wow #1)](/docs/ai-copilot/live-schema) for the 30-second demo. Everything below composes on top of this skill.
+See [Live Schema (Wow #1)](/docs/ai-copilot/live-schema) for the 30-second demo.
+Everything below composes on top of this skill.
 
 ### 2. 🎯 Lead Qualification
 
-Ask the Copilot to qualify a lead and it scores them on the BANT framework:
+Ask the assistant to qualify a lead and it scores them 0–100 on the BANT framework:
 
 - **Budget** — is there budget for what you sell?
 - **Authority** — is this person the decision maker?
 - **Need** — is there a clear, articulated need?
 - **Timeline** — is there urgency?
 
-The Copilot pulls signals from the lead record, any campaign engagement history, related accounts (if matched), and recent emails. It returns:
+It reads the lead record and its related activity history, then returns:
 
-- A **score** (Hot 🔥 / Warm 🌡️ / Cold ❄️).
-- A **rationale** citing the signals.
-- A **recommended next action** ("schedule discovery call", "nurture", "disqualify").
+- A **score** (0–100) with one line of justification per BANT dimension.
+- The **field or activity** each judgement was drawn from.
+- The single **recommended next step**, with the lead ID cited.
 
-Click **Accept** to update the lead's status and rating automatically.
+If the score is 70 or above and you agree, the skill calls the real **Convert Lead**
+action. Otherwise it calls **Schedule Follow-up** with the date it recommends.
+Conversion is never performed without your explicit confirmation.
 
 ### 3. ✍️ Email Drafting
 
-Highlight any record (lead, contact, opportunity) and ask the Copilot to draft an email. It produces a context-aware draft using:
+On any record (lead, contact, opportunity), ask for an email draft. It produces a
+context-aware draft using:
 
 - The contact's name, role, and account.
 - The opportunity stage and amount (if relevant).
@@ -50,7 +79,7 @@ Highlight any record (lead, contact, opportunity) and ask the Copilot to draft a
 - The relevant product datasheet from the Product Information knowledge base.
 - The sales playbook from the Sales Knowledge knowledge base.
 
-Common email templates the Copilot handles well:
+Common email shapes it handles well:
 
 - **Introduction** — first outreach after a lead is captured.
 - **Discovery follow-up** — after a discovery call.
@@ -59,11 +88,11 @@ Common email templates the Copilot handles well:
 - **Renewal reminder** — to a contract holder ahead of expiration.
 - **Win celebration** — to the customer after closed-won.
 
-You always **preview and edit** before sending. The Copilot never sends on its own.
+You always **preview and edit** before sending. The skill never sends on its own.
 
 ### 4. 📈 Revenue Forecasting
 
-Ask *"What's my forecast for this quarter?"* and the Copilot returns:
+Ask *"What's my forecast for this quarter?"* and you get:
 
 - **Closed** — committed revenue (closed-won this period).
 - **Commit** — opportunities >80% probability in the period.
@@ -71,11 +100,12 @@ Ask *"What's my forecast for this quarter?"* and the Copilot returns:
 - **Pipeline** — everything else.
 - **Risk callouts** — deals slipping, stale opportunities, missing close dates.
 
-Forecasts respect role hierarchy — a rep sees their own number, a manager sees their team's, a director sees the rollup.
+Forecasts respect your position and sharing rules — a rep sees their own number, a
+manager sees their team's, a director sees the rollup.
 
 ### 5. 🔭 Customer 360°
 
-On any account or contact, ask *"Give me a 360° view"* and the Copilot summarizes:
+On any account or contact, ask *"Give me a 360° view"* and you get:
 
 - **Relationship snapshot** — account tier, customer-since date, account owner.
 - **Active deals** — open opportunities with stage and amount.
@@ -84,24 +114,27 @@ On any account or contact, ask *"Give me a 360° view"* and the Copilot summariz
 - **Contracts** — active and upcoming renewals.
 - **Marketing engagement** — recent campaigns the customer engaged with.
 
-Perfect for prep before a meeting — "give me Customer 360 on Acme" and you walk in informed.
+Perfect for prep before a meeting — "give me Customer 360 on Acme" and you walk in
+informed.
 
 ## Tips for reps
 
-- ✅ Use *Qualify this lead* the moment a new lead lands — it saves 15 minutes per lead.
-- ✅ For email drafts, give the Copilot the **goal** in one sentence: *"Push for a meeting next week"* — better than a generic *"draft a follow-up"*.
+- ✅ Ask to qualify the moment a new lead lands — it saves 15 minutes per lead.
+- ✅ For email drafts, give the **goal** in one sentence: *"Push for a meeting next week"* — better than a generic *"draft a follow-up"*.
 - ✅ Ask *"What's at risk in my pipeline?"* every Monday morning.
 
 ## Tips for managers
 
 - ✅ Use *Customer 360* before every customer-facing meeting your team has.
 - ✅ Run *Revenue forecast* mid-week to spot slipping deals before the EOQ scramble.
-- ✅ Ask *"Which reps need coaching?"* — the Copilot flags reps with stale pipelines or unusually long stage times.
+- ✅ Ask *"Which reps need coaching?"* — the forecasting skill flags reps with stale pipelines or unusually long stage times.
 
 ## Limits
 
-- The Copilot **respects sharing** — it can only reference records you can see.
-- It **won't auto-send** emails, **won't auto-update** records, and **won't bulk-change** data without explicit confirmation.
-- For sensitive customers, the Copilot **redacts** flagged fields (configurable by admins).
+- Skills **respect sharing** — they can only reference records you can see.
+- They **won't auto-send** emails, **won't auto-update** records, and **won't bulk-change** data without explicit confirmation.
+- Skills declare no bespoke tools: every write goes through a real HotCRM action, so the same permission checks apply as when you click the button yourself.
 
-See [Skills](/docs/ai-copilot/skills) for the full skill specification and [Knowledge Bases](/docs/ai-copilot/knowledge-bases) for how to keep the Copilot's answers fresh and accurate.
+See [Skills](/docs/ai-copilot/skills) for the full skill specification and
+[Knowledge Bases](/docs/ai-copilot/knowledge-bases) for how to keep the answers fresh
+and accurate.
diff --git a/content/docs/ai-copilot/sales-copilot.zh-Hans.mdx b/content/docs/ai-copilot/sales-copilot.zh-Hans.mdx
index 736f1f75..fe37ead9 100644
--- a/content/docs/ai-copilot/sales-copilot.zh-Hans.mdx
+++ b/content/docs/ai-copilot/sales-copilot.zh-Hans.mdx
@@ -1,11 +1,18 @@
 ---
-title: 销售 Copilot
-description: AI 销售助手——判定线索资格、撰写邮件、预测收入，并获得 360° 客户视图。
+title: 销售技能
+description: 销售侧的 AI 技能——判定线索资格、撰写邮件、预测收入，并获得 360° 客户视图。
 ---
 
-# 销售 Copilot
+# 销售技能
 
-销售 Copilot 是你在销售流程中的 AI 伙伴。它存在于右侧聊天面板，并以内联按钮形式出现在线索、联系人、客户和商机页面上。
+HotCRM 本身不提供助手。它提供的是 **技能**——打包好的 AI 能力，附着在每个
+ObjectStack 环境已经自带的 **平台助手**（`ask`）之上。当你在 HotCRM 中打开助手面板
+时，下面这些销售技能就是它会做的事。
+
+> **人格设定去哪了。** 本页的早期版本描述过一个"销售 Copilot"智能体。HotCRM 不再定
+> 义自己的智能体：同样的能力现在存在于通过 `src/skills/` 注册的五项技能中，由平台助
+> 手在其中做选择。没有任何能力丢失——只是接线方式从应用自有的智能体挪到了平台的那一
+> 个。
 
 ## 它面向谁
 
@@ -13,36 +20,53 @@ description: AI 销售助手——判定线索资格、撰写邮件、预测收
 - **销售经理**——管道和预测情报。
 - **销售运营**——批量洞察和假设分析。
 
-## 它能做什么
+## 技能是怎样被选中的
+
+你不需要从菜单里挑选技能。每项技能都声明了自己所属的记录上下文，助手在上下文匹配时
+自动激活它：
+
+| 技能 | 激活于 |
+| --- | --- |
+| 🎯 线索资格判定 | `crm_lead` 记录 |
+| 📈 收入预测 | `crm_opportunity` 记录或仪表盘 |
+| 🔄 实时数据、✍️ 邮件撰写、🔭 Customer 360° | 任意上下文——始终可用 |
+
+所以打开一条线索并输入 *"这条值得打个电话吗？"*，无需点名就会运行线索资格判定。
 
-销售 Copilot 内置五项核心技能。它们可以通过聊天（*"判定此线索资格"*）或点击内联按钮来调用。
+## 销售技能清单
 
 ### 1. 🔄 实时数据——基础
 
-在判定线索资格、撰写邮件或预测数字之前，销售 Copilot 会将自身建立在 **实时数据** 之上。每一轮，它都针对实时元数据 + 记录存储调用 `describe_object` 和 `query_records`——而非缓存的快照。这就是为什么在 10:00:00 添加一个字段，Copilot 能在 10:00:05 回答关于它的问题，且零重新训练。
+在判定线索资格、撰写邮件或预测数字之前，助手会将自身建立在 **实时数据** 之上。每一
+轮，它都针对实时元数据 + 记录存储调用 `describe_object` 和 `query_records`——而非缓存
+的快照。这就是为什么在 10:00:00 添加一个字段，助手能在 10:00:05 回答关于它的问题，且
+零重新训练。
 
-参见 [实时模式（Wow #1）](/zh-Hans/docs/ai-copilot/live-schema) 中的 30 秒演示。下面的一切都构建在此技能之上。
+参见 [实时模式（Wow #1）](/zh-Hans/docs/ai-copilot/live-schema) 中的 30 秒演示。下面
+的一切都构建在此技能之上。
 
 ### 2. 🎯 线索资格判定
 
-让 Copilot 判定一个线索的资格，它会按 BANT 框架为其评分：
+让助手判定一条线索的资格，它会按 BANT 框架给出 0–100 的评分：
 
 - **Budget（预算）**——是否有购买你所售产品的预算？
 - **Authority（权限）**——此人是决策者吗？
 - **Need（需求）**——是否有清晰、明确表达的需求？
 - **Timeline（时间线）**——是否有紧迫性？
 
-Copilot 从线索记录、任何活动参与历史、相关客户（如已匹配）和近期邮件中提取信号。它返回：
+它读取线索记录及其相关活动历史，然后返回：
 
-- 一个 **评分**（热门 🔥 / 温热 🌡️ / 冷淡 ❄️）。
-- 一份引用信号的 **理由**。
-- 一个 **建议的下一步操作**（"安排探询通话"、"培育"、"取消资格"）。
+- 一个 **评分**（0–100），每个 BANT 维度附一行理由。
+- 每项判断所依据的 **字段或活动**。
+- 单一的 **建议下一步**，并引用线索 ID。
 
-点击 **接受** 即可自动更新线索的状态和评级。
+若评分达到 70 及以上且你同意，技能会调用真实的 **转换线索** 操作；否则它会调用 **安排
+跟进** 并给出建议的日期。未经你明确确认，绝不执行转换。
 
 ### 3. ✍️ 邮件撰写
 
-高亮任意记录（线索、联系人、商机），让 Copilot 撰写一封邮件。它会使用以下内容生成一份感知上下文的草稿：
+在任意记录（线索、联系人、商机）上请求邮件草稿。它会使用以下内容生成一份感知上下文的
+草稿：
 
 - 联系人的姓名、角色和所属客户。
 - 商机阶段和金额（如相关）。
@@ -50,7 +74,7 @@ Copilot 从线索记录、任何活动参与历史、相关客户（如已匹配
 - 来自产品信息知识库的相关产品数据表。
 - 来自销售知识知识库的销售剧本。
 
-Copilot 能很好地处理的常见邮件模板：
+它能很好处理的常见邮件形态：
 
 - **介绍**——线索捕获后的首次触达。
 - **探询跟进**——探询通话之后。
@@ -59,11 +83,11 @@ Copilot 能很好地处理的常见邮件模板：
 - **续约提醒**——在到期前发给合同持有人。
 - **赢单庆祝**——在赢单成交后发给客户。
 
-你始终在发送前 **预览和编辑**。Copilot 从不擅自发送。
+你始终在发送前 **预览和编辑**。技能从不擅自发送。
 
 ### 4. 📈 收入预测
 
-问 *"我这个季度的预测是多少？"*，Copilot 会返回：
+问 *"我这个季度的预测是多少？"*，你会得到：
 
 - **Closed（已成交）**——已承诺收入（本期赢单成交）。
 - **Commit（承诺）**——本期内概率 >80% 的商机。
@@ -71,11 +95,11 @@ Copilot 能很好地处理的常见邮件模板：
 - **Pipeline（管道）**——其余一切。
 - **风险提示**——滑落的交易、陈旧的商机、缺失的成交日期。
 
-预测遵循角色层级——销售代表看到自己的数字，经理看到团队的，总监看到汇总。
+预测遵循你的岗位与共享规则——销售代表看到自己的数字，经理看到团队的，总监看到汇总。
 
 ### 5. 🔭 Customer 360°
 
-在任意客户或联系人上，问 *"给我一个 360° 视图"*，Copilot 会总结：
+在任意客户或联系人上，问 *"给我一个 360° 视图"*，你会得到：
 
 - **关系快照**——客户层级、成为客户的日期、客户负责人。
 - **进行中的交易**——带阶段和金额的开放商机。
@@ -88,20 +112,21 @@ Copilot 能很好地处理的常见邮件模板：
 
 ## 给销售代表的提示
 
-- ✅ 新线索一落地就使用 *判定此线索资格*——每个线索节省 15 分钟。
-- ✅ 撰写邮件时，用一句话给 Copilot 一个 **目标**：*"推动下周开个会"*——比泛泛的 *"撰写一封跟进邮件"* 更好。
+- ✅ 新线索一落地就请求资格判定——每个线索节省 15 分钟。
+- ✅ 撰写邮件时，用一句话说明 **目标**：*"推动下周开个会"*——比泛泛的 *"撰写一封跟进邮件"* 更好。
 - ✅ 每周一早上问 *"我的管道里有什么风险？"*。
 
 ## 给经理的提示
 
 - ✅ 在团队的每次面向客户的会议前使用 *Customer 360*。
 - ✅ 在周中运行 *收入预测*，在季末冲刺前发现滑落的交易。
-- ✅ 问 *"哪些销售代表需要辅导？"*——Copilot 会标记管道陈旧或阶段停留异常长的销售代表。
+- ✅ 问 *"哪些销售代表需要辅导？"*——收入预测技能会标记管道陈旧或阶段停留异常长的销售代表。
 
 ## 限制
 
-- Copilot **遵循共享**——它只能引用你能看到的记录。
-- 它 **不会自动发送** 邮件、**不会自动更新** 记录，也 **不会批量更改** 数据，除非有明确确认。
-- 对于敏感客户，Copilot 会 **遮蔽** 标记的字段（可由管理员配置）。
+- 技能 **遵循共享**——它们只能引用你能看到的记录。
+- 它们 **不会自动发送** 邮件、**不会自动更新** 记录，也 **不会批量更改** 数据，除非有明确确认。
+- 技能不声明任何专属工具：每一次写入都经由真实的 HotCRM 操作完成，因此与你亲手点击按钮时的权限校验完全一致。
 
-参见 [技能](/zh-Hans/docs/ai-copilot/skills) 了解完整的技能规格，参见 [知识库](/zh-Hans/docs/ai-copilot/knowledge-bases) 了解如何保持 Copilot 答案的新鲜和准确。
+参见 [技能](/zh-Hans/docs/ai-copilot/skills) 了解完整的技能规格，参见
+[知识库](/zh-Hans/docs/ai-copilot/knowledge-bases) 了解如何保持答案的新鲜和准确。
diff --git a/content/docs/ai-copilot/sales-copilot.zh-Hant.mdx b/content/docs/ai-copilot/sales-copilot.zh-Hant.mdx
index 7adebcfe..9a9e73c9 100644
--- a/content/docs/ai-copilot/sales-copilot.zh-Hant.mdx
+++ b/content/docs/ai-copilot/sales-copilot.zh-Hant.mdx
@@ -1,48 +1,72 @@
 ---
-title: 銷售 Copilot
-description: AI 銷售助手——判定潛在客戶資格、撰寫郵件、預測收入，並獲得 360° 客戶視圖。
+title: 銷售技能
+description: 銷售側的 AI 技能——判定潛在客戶資格、撰寫郵件、預測收入，並獲得 360° 客戶視圖。
 ---
 
-# 銷售 Copilot
+# 銷售技能
 
-銷售 Copilot 是你在銷售流程中的 AI 夥伴。它存在於右側聊天面板，並以內聯按鈕形式出現在潛在客戶、聯絡人、客戶和商機頁面上。
+HotCRM 本身不提供助手。它提供的是 **技能**——打包好的 AI 能力，附著在每個
+ObjectStack 環境已經自帶的 **平台助手**（`ask`）之上。當你在 HotCRM 中打開助手面板
+時，下面這些銷售技能就是它會做的事。
+
+> **人格設定去哪了。** 本頁的早期版本描述過一個「銷售 Copilot」智能體。HotCRM 不再定
+> 義自己的智能體：同樣的能力現在存在於透過 `src/skills/` 註冊的五項技能中，由平台助手
+> 在其中做選擇。沒有任何能力遺失——只是接線方式從應用自有的智能體挪到了平台的那一個。
 
 ## 它面向誰
 
 - **銷售代表**——處理潛在客戶和交易的日常夥伴。
 - **銷售經理**——管道和預測情報。
-- **銷售維運**——批量洞察和假設分析。
+- **銷售營運**——批次洞察和假設分析。
+
+## 技能是怎樣被選中的
+
+你不需要從選單裡挑選技能。每項技能都宣告了自己所屬的記錄情境，助手在情境匹配時自動啟
+用它：
+
+| 技能 | 啟用於 |
+| --- | --- |
+| 🎯 潛在客戶資格判定 | `crm_lead` 記錄 |
+| 📈 收入預測 | `crm_opportunity` 記錄或儀表板 |
+| 🔄 即時資料、✍️ 郵件撰寫、🔭 Customer 360° | 任意情境——始終可用 |
 
-## 它能做什麼
+所以打開一筆潛在客戶並輸入 *「這筆值得打個電話嗎？」*，無需點名就會執行潛在客戶資格判
+定。
 
-銷售 Copilot 內建五項核心技能。它們可以透過聊天（*「判定此潛在客戶資格」*）或點擊內聯按鈕來呼叫。
+## 銷售技能清單
 
 ### 1. 🔄 即時資料——基礎
 
-在判定潛在客戶資格、撰寫郵件或預測數字之前，銷售 Copilot 會將自身建立在 **即時資料** 之上。每一輪，它都針對即時元資料 + 記錄儲存呼叫 `describe_object` 和 `query_records`——而非快取的快照。這就是為什麼在 10:00:00 新增一個欄位，Copilot 能在 10:00:05 回答關於它的問題，且零重新訓練。
+在判定潛在客戶資格、撰寫郵件或預測數字之前，助手會將自身建立在 **即時資料** 之上。每
+一輪，它都針對即時中繼資料 + 記錄儲存呼叫 `describe_object` 和 `query_records`——而非快
+取的快照。這就是為什麼在 10:00:00 新增一個欄位，助手能在 10:00:05 回答關於它的問題，
+且零重新訓練。
 
-參見 [即時結構（Wow #1）](/zh-Hant/docs/ai-copilot/live-schema) 中的 30 秒示範。下面的一切都構建在此技能之上。
+參見 [即時模式（Wow #1）](/zh-Hant/docs/ai-copilot/live-schema) 中的 30 秒示範。下面的
+一切都構建在此技能之上。
 
 ### 2. 🎯 潛在客戶資格判定
 
-讓 Copilot 判定一個潛在客戶的資格，它會按 BANT 框架為其評分：
+讓助手判定一筆潛在客戶的資格，它會按 BANT 框架給出 0–100 的評分：
 
 - **Budget（預算）**——是否有購買你所售產品的預算？
 - **Authority（權限）**——此人是決策者嗎？
 - **Need（需求）**——是否有清晰、明確表達的需求？
 - **Timeline（時間線）**——是否有緊迫性？
 
-Copilot 從潛在客戶記錄、任何活動參與歷史、相關客戶（如已匹配）和近期郵件中提取信號。它返回：
+它讀取潛在客戶記錄及其相關活動歷史，然後回傳：
 
-- 一個 **評分**（熱門 🔥 / 溫熱 🌡️ / 冷淡 ❄️）。
-- 一份引用信號的 **理由**。
-- 一個 **建議的下一步操作**（「安排探詢通話」、「培育」、「取消資格」）。
+- 一個 **評分**（0–100），每個 BANT 維度附一行理由。
+- 每項判斷所依據的 **欄位或活動**。
+- 單一的 **建議下一步**，並引用潛在客戶 ID。
 
-點擊 **接受** 即可自動更新潛在客戶的狀態和評級。
+若評分達到 70 及以上且你同意，技能會呼叫真實的 **轉換潛在客戶** 操作；否則它會呼叫
+**安排跟進** 並給出建議的日期。未經你明確確認，絕不執行轉換。
 
 ### 3. ✍️ 郵件撰寫
 
-高亮任意記錄（潛在客戶、聯絡人、商機），讓 Copilot 撰寫一封郵件。它會使用以下內容生成一份感知上下文的草稿：
+在任意記錄（潛在客戶、聯絡人、商機）上請求郵件草稿。它會使用以下內容產生一份感知情境
+的草稿：
 
 - 聯絡人的姓名、角色和所屬客戶。
 - 商機階段和金額（如相關）。
@@ -50,7 +74,7 @@ Copilot 從潛在客戶記錄、任何活動參與歷史、相關客戶（如已
 - 來自產品資訊知識庫的相關產品資料表。
 - 來自銷售知識知識庫的銷售劇本。
 
-Copilot 能很好地處理的常見郵件範本：
+它能很好處理的常見郵件形態：
 
 - **介紹**——潛在客戶捕獲後的首次觸達。
 - **探詢跟進**——探詢通話之後。
@@ -59,11 +83,11 @@ Copilot 能很好地處理的常見郵件範本：
 - **續約提醒**——在到期前發給合約持有人。
 - **贏單慶祝**——在贏單成交後發給客戶。
 
-你始終在發送前 **預覽和編輯**。Copilot 從不擅自發送。
+你始終在發送前 **預覽和編輯**。技能從不擅自發送。
 
 ### 4. 📈 收入預測
 
-問 *「我這個季度的預測是多少？」*，Copilot 會返回：
+問 *「我這一季的預測是多少？」*，你會得到：
 
 - **Closed（已成交）**——已承諾收入（本期贏單成交）。
 - **Commit（承諾）**——本期內機率 >80% 的商機。
@@ -71,16 +95,16 @@ Copilot 能很好地處理的常見郵件範本：
 - **Pipeline（管道）**——其餘一切。
 - **風險提示**——滑落的交易、陳舊的商機、缺失的成交日期。
 
-預測遵循角色層級——銷售代表看到自己的數字，經理看到團隊的，總監看到彙總。
+預測遵循你的職位與共享規則——銷售代表看到自己的數字，經理看到團隊的，總監看到彙總。
 
 ### 5. 🔭 Customer 360°
 
-在任意客戶或聯絡人上，問 *「給我一個 360° 視圖」*，Copilot 會總結：
+在任意客戶或聯絡人上，問 *「給我一個 360° 視圖」*，你會得到：
 
 - **關係快照**——客戶層級、成為客戶的日期、客戶負責人。
 - **進行中的交易**——帶階段和金額的開放商機。
 - **近期活動**——最近一次通話、會議、郵件。
-- **未結工單**——任何服務工單，及其優先級和存續時長。
+- **未結工單**——任何服務工單，及其優先順序和存續時長。
 - **合約**——有效及即將到來的續約。
 - **行銷參與**——客戶近期參與的活動。
 
@@ -88,20 +112,21 @@ Copilot 能很好地處理的常見郵件範本：
 
 ## 給銷售代表的提示
 
-- ✅ 新潛在客戶一落地就使用 *判定此潛在客戶資格*——每個潛在客戶節省 15 分鐘。
-- ✅ 撰寫郵件時，用一句話給 Copilot 一個 **目標**：*「推動下週開個會」*——比泛泛的 *「撰寫一封跟進郵件」* 更好。
+- ✅ 新潛在客戶一落地就請求資格判定——每筆節省 15 分鐘。
+- ✅ 撰寫郵件時，用一句話說明 **目標**：*「推動下週開個會」*——比泛泛的 *「撰寫一封跟進郵件」* 更好。
 - ✅ 每週一早上問 *「我的管道裡有什麼風險？」*。
 
 ## 給經理的提示
 
 - ✅ 在團隊的每次面向客戶的會議前使用 *Customer 360*。
 - ✅ 在週中執行 *收入預測*，在季末衝刺前發現滑落的交易。
-- ✅ 問 *「哪些銷售代表需要輔導？」*——Copilot 會標記管道陳舊或階段停留異常長的銷售代表。
+- ✅ 問 *「哪些銷售代表需要輔導？」*——收入預測技能會標記管道陳舊或階段停留異常長的銷售代表。
 
 ## 限制
 
-- Copilot **遵循共享**——它只能引用你能看到的記錄。
-- 它 **不會自動發送** 郵件、**不會自動更新** 記錄，也 **不會批量更改** 資料，除非有明確確認。
-- 對於敏感客戶，Copilot 會 **遮蔽** 標記的欄位（可由管理員配置）。
+- 技能 **遵循共享**——它們只能引用你能看到的記錄。
+- 它們 **不會自動發送** 郵件、**不會自動更新** 記錄，也 **不會批次更改** 資料，除非有明確確認。
+- 技能不宣告任何專屬工具：每一次寫入都經由真實的 HotCRM 操作完成，因此與你親手點擊按鈕時的權限校驗完全一致。
 
-參見 [技能](/zh-Hant/docs/ai-copilot/skills) 了解完整的技能規格，參見 [知識庫](/zh-Hant/docs/ai-copilot/knowledge-bases) 了解如何保持 Copilot 答案的新鮮和準確。
+參見 [技能](/zh-Hant/docs/ai-copilot/skills) 了解完整的技能規格，參見
+[知識庫](/zh-Hant/docs/ai-copilot/knowledge-bases) 了解如何保持答案的新鮮和準確。
diff --git a/content/docs/ai-copilot/service-copilot.mdx b/content/docs/ai-copilot/service-copilot.mdx
index 6bfeee05..77c367e6 100644
--- a/content/docs/ai-copilot/service-copilot.mdx
+++ b/content/docs/ai-copilot/service-copilot.mdx
@@ -1,11 +1,20 @@
 ---
-title: Service Copilot
-description: The AI service-agent assistant — triage cases, see full customer history, draft replies.
+title: Service Skills
+description: The service-side AI skills — triage cases, see full customer history, draft replies.
 ---
 
-# Service Copilot
+# Service Skills
 
-The Service Copilot is your AI partner for resolving customer issues fast. It lives in the right-side chat panel and as inline actions on case detail pages.
+HotCRM does not ship an assistant of its own. It ships **skills** — packaged AI
+abilities that attach to the **platform assistant** (`ask`) that every ObjectStack
+environment already provides. When a service agent opens the assistant panel on a
+case, the skills below are what it knows how to do.
+
+> **Where the personas went.** Earlier versions of this page described a "Service
+> Copilot" agent. HotCRM no longer defines its own agents: the same capability now
+> lives in skills registered through `src/skills/`, and the platform assistant selects
+> among them. Nothing was lost — the wiring moved from an app-owned agent to the
+> platform one.
 
 ## Who it's for
 
@@ -13,11 +22,17 @@ The Service Copilot is your AI partner for resolving customer issues fast. It li
 - **Support managers** — case routing and SLA compliance.
 - **Knowledge managers** — flagging gaps in the support knowledge base.
 
-## What it can do
+## How a skill gets picked
+
+Case Triage declares `crm_case` as its record context, so it activates the moment an
+agent asks a question while viewing a case. Customer 360°, Email Drafting, and Live
+Data carry no context restriction and are available everywhere.
+
+## The service skills
 
 ### 1. 🚦 Case Triage
 
-When a new case lands, the Copilot can triage it in one click. It analyses:
+Ask the assistant to triage a case and it analyses:
 
 - The **subject** and **description**.
 - The **customer's profile** (account tier, customer-since, contract).
@@ -29,15 +44,17 @@ It returns:
 
 - **Suggested priority** (Low / Medium / High / Critical) with a rationale tied to the [SLA matrix](/docs/service/sla-and-escalation).
 - **Suggested category** (Bug, Question, Feature Request, Billing).
-- **Suggested team / queue** based on the product or topic.
-- **Top 3 matching KB articles** with confidence scores.
+- **Top matching KB articles**.
 - A **draft first reply** that acknowledges the issue and links to the KB articles.
+- A pointer to the right next action — **Escalate Case** or **Close Case**.
 
-Agents can accept, edit, or reject each suggestion individually.
+Agents accept, edit, or reject each suggestion individually. The skill never changes
+the case on its own: it hands off to the same `escalate_case` / `close_case` actions
+an agent would click.
 
 ### 2. 🔭 Customer 360°
 
-On any case, ask *"Give me the customer's history"* and the Copilot surfaces:
+On any case, ask *"Give me the customer's history"* and you get:
 
 - **All prior cases** (open and closed) for the same contact and account.
 - **Contract status** — what they've bought, when it expires, what tier of support they're entitled to.
@@ -45,11 +62,13 @@ On any case, ask *"Give me the customer's history"* and the Copilot surfaces:
 - **Last touchpoints** — recent emails, calls, meetings.
 - **Account health signals** — escalations, churn risk flags, satisfaction scores.
 
-This is the difference between *"I see this is your first case"* and *"I see this is the 3rd time you've hit this issue this quarter — let me escalate."*
+This is the difference between *"I see this is your first case"* and *"I see this is
+the 3rd time you've hit this issue this quarter — let me escalate."*
 
 ### 3. ✍️ Email / Reply Drafting
 
-The Copilot drafts customer replies tuned for service tone:
+The same Email Drafting skill the sales side uses will draft customer replies tuned
+for service tone:
 
 - **Acknowledgment** — *"We've received your case and are investigating."*
 - **Asking for more info** — bug reproduction steps, screenshots, logs.
@@ -57,47 +76,37 @@ The Copilot drafts customer replies tuned for service tone:
 - **Resolution** — explaining what was done.
 - **Closure** — confirming everything's resolved.
 
-All drafts cite the Support Knowledge articles they pulled from, so agents can verify the source. The Copilot never sends — agents preview and edit first.
-
-## Inline actions on case pages
-
-| Button | What it does |
-| --- | --- |
-| **🚦 Triage** | Runs the triage skill and pre-fills priority, category, queue. |
-| **📚 Find articles** | Searches Support Knowledge for matching KB articles. |
-| **✍️ Draft reply** | Drafts a customer-facing reply based on case state. |
-| **🔭 Customer 360** | Opens the customer history side-panel. |
-| **🔁 Suggest similar** | Finds similar resolved cases. |
-
-## What the Copilot does for you in the background
+All drafts cite the Support Knowledge articles they pulled from, so agents can verify
+the source. Nothing is sent automatically — agents preview and edit first.
 
-Even without you asking, the Service Copilot is busy:
+### 4. 🔄 Live Data
 
-- **Auto-suggests articles** as the agent types into the case description.
-- **Flags repeat issues** — "this contact has filed 4 similar cases".
-- **Warns on SLA risk** — "this case will breach SLA in 47 minutes".
-- **Highlights sentiment** — angry-customer detection in the email thread.
+Every service skill composes on Live Data: the assistant re-reads the case object's
+schema before answering, so a field an admin added this morning is usable this
+afternoon. See [Live Schema (Wow #1)](/docs/ai-copilot/live-schema).
 
 ## Tips for agents
 
-- ✅ **Triage every new case** — it's a 5-second click and saves you sorting/routing time.
+- ✅ **Triage every new case** — it's one question and saves you sorting/routing time.
 - ✅ Use **Customer 360** before any phone call — knowing the contract tier shapes the conversation.
-- ✅ **Trust but verify** the KB suggestions — if the Copilot's confidence is below 70%, double-check.
+- ✅ **Trust but verify** the KB suggestions — check the cited article before you send.
 
 ## Tips for managers
 
-- ✅ Track **Copilot acceptance rate** — if your agents reject most triage suggestions, your KB needs work.
-- ✅ Use **Suggest similar** during deflection meetings — patterns of repeated cases reveal product issues.
+- ✅ Track how often triage suggestions are accepted — if your agents reject most of them, your KB needs work.
+- ✅ Look for patterns of repeated cases during deflection meetings — they reveal product issues.
 
 ## Tips for knowledge managers
 
-- ✅ When the Copilot can't find a matching article for a case, it logs the **gap** — review these weekly to identify new articles to write.
-- ✅ Articles that the Copilot cites frequently are your **highest-value content** — keep them updated.
+- ✅ When the assistant can't find a matching article for a case, that's a knowledge gap — review these to identify new articles to write.
+- ✅ Articles cited frequently are your **highest-value content** — keep them updated.
 
 ## Limits
 
-- The Copilot respects [sharing rules](/docs/administration/sharing-and-security) — it only sees what the agent can see.
-- It **won't close cases** or **mark them resolved** without explicit agent action.
-- For VIP/escalated customers, the Copilot **routes to humans first** rather than auto-suggesting deflection.
+- Skills respect [sharing rules](/docs/administration/sharing-and-security) — they only see what the agent can see.
+- They **won't close cases** or **mark them resolved** without explicit agent action.
+- Skills declare no bespoke tools: every state change goes through a real HotCRM action, so the same permission checks apply as when an agent clicks the button.
 
-See [Skills](/docs/ai-copilot/skills) for the full skill spec and [Knowledge Bases](/docs/ai-copilot/knowledge-bases) for the Support Knowledge index that powers replies.
+See [Skills](/docs/ai-copilot/skills) for the full skill spec and
+[Knowledge Bases](/docs/ai-copilot/knowledge-bases) for the Support Knowledge index
+that powers replies.
diff --git a/content/docs/ai-copilot/service-copilot.zh-Hans.mdx b/content/docs/ai-copilot/service-copilot.zh-Hans.mdx
index 342dad8c..cad77c7e 100644
--- a/content/docs/ai-copilot/service-copilot.zh-Hans.mdx
+++ b/content/docs/ai-copilot/service-copilot.zh-Hans.mdx
@@ -1,11 +1,17 @@
 ---
-title: 服务 Copilot
-description: AI 服务坐席助手——分流工单、查看完整客户历史、撰写回复。
+title: 服务技能
+description: 服务侧的 AI 技能——分流工单、查看完整客户历史、撰写回复。
 ---
 
-# 服务 Copilot
+# 服务技能
 
-服务 Copilot 是你快速解决客户问题的 AI 伙伴。它存在于右侧聊天面板，并以内联操作形式出现在工单详情页上。
+HotCRM 本身不提供助手。它提供的是 **技能**——打包好的 AI 能力，附着在每个
+ObjectStack 环境已经自带的 **平台助手**（`ask`）之上。当服务坐席在工单上打开助手面板
+时，下面这些技能就是它会做的事。
+
+> **人格设定去哪了。** 本页的早期版本描述过一个"服务 Copilot"智能体。HotCRM 不再定义
+> 自己的智能体：同样的能力现在存在于通过 `src/skills/` 注册的技能中，由平台助手在其中
+> 做选择。没有任何能力丢失——只是接线方式从应用自有的智能体挪到了平台的那一个。
 
 ## 它面向谁
 
@@ -13,11 +19,16 @@ description: AI 服务坐席助手——分流工单、查看完整客户历史
 - **支持经理**——工单路由和 SLA 合规。
 - **知识管理员**——标记支持知识库中的空缺。
 
-## 它能做什么
+## 技能是怎样被选中的
+
+工单分流声明了 `crm_case` 作为记录上下文，因此坐席在查看工单时提问，它就会激活。
+Customer 360°、邮件撰写和实时数据没有上下文限制，处处可用。
+
+## 服务技能清单
 
 ### 1. 🚦 工单分流
 
-当一个新工单落地时，Copilot 可一键将其分流。它会分析：
+请助手分流一个工单，它会分析：
 
 - **主题** 和 **描述**。
 - **客户的画像**（客户层级、成为客户的日期、合同）。
@@ -29,15 +40,16 @@ description: AI 服务坐席助手——分流工单、查看完整客户历史
 
 - **建议的优先级**（低 / 中 / 高 / 紧急），并附带与 [SLA 矩阵](/zh-Hans/docs/service/sla-and-escalation) 关联的理由。
 - **建议的分类**（缺陷、问题咨询、功能请求、账单）。
-- 基于产品或主题的 **建议团队 / 队列**。
-- 带置信度评分的 **最匹配的前 3 篇知识库文章**。
+- **最匹配的知识库文章**。
 - 一份 **首次回复草稿**，确认问题并链接到知识库文章。
+- 指向正确下一步操作的指引——**升级工单** 或 **关闭工单**。
 
-坐席可以逐条接受、编辑或拒绝每条建议。
+坐席可以逐条接受、编辑或拒绝每条建议。技能自身绝不修改工单：它把动作交给坐席本来就会
+点击的 `escalate_case` / `close_case` 操作。
 
 ### 2. 🔭 Customer 360°
 
-在任意工单上，问 *"给我客户的历史"*，Copilot 会呈现：
+在任意工单上，问 *"给我客户的历史"*，你会得到：
 
 - **所有过往工单**（未结和已结）——针对同一联系人和客户。
 - **合同状态**——他们购买了什么、何时到期、有权享受何种层级的支持。
@@ -45,11 +57,12 @@ description: AI 服务坐席助手——分流工单、查看完整客户历史
 - **最近的接触点**——近期邮件、通话、会议。
 - **客户健康信号**——升级、流失风险标记、满意度评分。
 
-这就是 *"我看到这是您第一个工单"* 与 *"我看到这是您本季度第 3 次遇到这个问题——让我来升级处理"* 之间的差别。
+这就是 *"我看到这是您第一个工单"* 与 *"我看到这是您本季度第 3 次遇到这个问题——让我
+来升级处理"* 之间的差别。
 
 ### 3. ✍️ 邮件 / 回复撰写
 
-Copilot 撰写针对服务语气调优的客户回复：
+销售侧使用的同一项邮件撰写技能，也会撰写针对服务语气调优的客户回复：
 
 - **确认收悉**——*"我们已收到您的工单，正在调查。"*
 - **索取更多信息**——缺陷重现步骤、截图、日志。
@@ -57,47 +70,36 @@ Copilot 撰写针对服务语气调优的客户回复：
 - **解决**——说明已完成的处理。
 - **关闭**——确认一切已解决。
 
-所有草稿都会引用其所提取的支持知识文章，以便坐席核实来源。Copilot 从不发送——坐席先预览和编辑。
-
-## 工单页面上的内联操作
-
-| 按钮 | 它的作用 |
-| --- | --- |
-| **🚦 分流** | 运行分流技能并预填优先级、分类、队列。 |
-| **📚 查找文章** | 在支持知识中搜索匹配的知识库文章。 |
-| **✍️ 撰写回复** | 基于工单状态撰写面向客户的回复。 |
-| **🔭 Customer 360** | 打开客户历史侧边面板。 |
-| **🔁 推荐相似** | 查找相似的已解决工单。 |
-
-## Copilot 在后台为你做什么
+所有草稿都会引用其所提取的支持知识文章，以便坐席核实来源。不会自动发送任何内容——坐席
+先预览和编辑。
 
-即使你没有提出请求，服务 Copilot 也在忙碌：
+### 4. 🔄 实时数据
 
-- **自动推荐文章**——当坐席输入工单描述时。
-- **标记重复问题**——"此联系人已提交 4 个相似工单"。
-- **SLA 风险预警**——"此工单将在 47 分钟内违反 SLA"。
-- **高亮情绪**——邮件线程中的愤怒客户检测。
+每项服务技能都构建在实时数据之上：助手在回答之前会重新读取工单对象的模式，因此管理员
+今早新增的字段今天下午就能用上。参见
+[实时模式（Wow #1）](/zh-Hans/docs/ai-copilot/live-schema)。
 
 ## 给坐席的提示
 
-- ✅ **为每个新工单分流**——只需 5 秒的点击，节省你的排序/路由时间。
+- ✅ **为每个新工单分流**——只需问一句，节省你的排序/路由时间。
 - ✅ 在任何电话通话前使用 **Customer 360**——了解合同层级会影响对话方式。
-- ✅ **信任但要核实** 知识库建议——如果 Copilot 的置信度低于 70%，请再次确认。
+- ✅ **信任但要核实** 知识库建议——发送前先查看被引用的文章。
 
 ## 给经理的提示
 
-- ✅ 跟踪 **Copilot 接受率**——如果你的坐席拒绝了大多数分流建议，说明你的知识库需要完善。
-- ✅ 在化解会议中使用 **推荐相似**——重复工单的模式揭示了产品问题。
+- ✅ 跟踪分流建议的接受率——如果你的坐席拒绝了大多数建议，说明你的知识库需要完善。
+- ✅ 在化解会议中留意重复工单的模式——它们揭示了产品问题。
 
 ## 给知识管理员的提示
 
-- ✅ 当 Copilot 找不到与工单匹配的文章时，它会记录这个 **空缺**——每周审查这些记录，以确定要撰写的新文章。
-- ✅ Copilot 频繁引用的文章是你 **价值最高的内容**——保持它们更新。
+- ✅ 当助手找不到与工单匹配的文章时，那就是一处知识空缺——审查这些情况，以确定要撰写的新文章。
+- ✅ 被频繁引用的文章是你 **价值最高的内容**——保持它们更新。
 
 ## 限制
 
-- Copilot 遵循 [共享规则](/zh-Hans/docs/administration/sharing-and-security)——它只能看到坐席能看到的内容。
-- 它 **不会关闭工单**，也 **不会将其标记为已解决**，除非坐席明确操作。
-- 对于 VIP/已升级的客户，Copilot 会 **优先路由给人工**，而非自动推荐化解。
+- 技能遵循 [共享规则](/zh-Hans/docs/administration/sharing-and-security)——它们只能看到坐席能看到的内容。
+- 它们 **不会关闭工单**，也 **不会将其标记为已解决**，除非坐席明确操作。
+- 技能不声明任何专属工具：每一次状态变更都经由真实的 HotCRM 操作完成，因此与坐席亲手点击按钮时的权限校验完全一致。
 
-参见 [技能](/zh-Hans/docs/ai-copilot/skills) 了解完整的技能规格，参见 [知识库](/zh-Hans/docs/ai-copilot/knowledge-bases) 了解为回复提供动力的支持知识索引。
+参见 [技能](/zh-Hans/docs/ai-copilot/skills) 了解完整的技能规格，参见
+[知识库](/zh-Hans/docs/ai-copilot/knowledge-bases) 了解为回复提供动力的支持知识索引。
diff --git a/content/docs/ai-copilot/service-copilot.zh-Hant.mdx b/content/docs/ai-copilot/service-copilot.zh-Hant.mdx
index 2105f60b..958d0d5d 100644
--- a/content/docs/ai-copilot/service-copilot.zh-Hant.mdx
+++ b/content/docs/ai-copilot/service-copilot.zh-Hant.mdx
@@ -1,11 +1,17 @@
 ---
-title: 服務 Copilot
-description: AI 服務坐席助手——分流工單、查看完整客戶歷史、撰寫回覆。
+title: 服務技能
+description: 服務側的 AI 技能——分流工單、查看完整客戶歷史、撰寫回覆。
 ---
 
-# 服務 Copilot
+# 服務技能
 
-服務 Copilot 是你快速解決客戶問題的 AI 夥伴。它存在於右側聊天面板，並以內聯操作形式出現在工單詳情頁上。
+HotCRM 本身不提供助手。它提供的是 **技能**——打包好的 AI 能力，附著在每個
+ObjectStack 環境已經自帶的 **平台助手**（`ask`）之上。當服務坐席在工單上打開助手面板
+時，下面這些技能就是它會做的事。
+
+> **人格設定去哪了。** 本頁的早期版本描述過一個「服務 Copilot」智能體。HotCRM 不再定
+> 義自己的智能體：同樣的能力現在存在於透過 `src/skills/` 註冊的技能中，由平台助手在其
+> 中做選擇。沒有任何能力遺失——只是接線方式從應用自有的智能體挪到了平台的那一個。
 
 ## 它面向誰
 
@@ -13,11 +19,16 @@ description: AI 服務坐席助手——分流工單、查看完整客戶歷史
 - **支援經理**——工單路由和 SLA 合規。
 - **知識管理員**——標記支援知識庫中的空缺。
 
-## 它能做什麼
+## 技能是怎樣被選中的
+
+工單分流宣告了 `crm_case` 作為記錄情境，因此坐席在檢視工單時提問，它就會啟用。
+Customer 360°、郵件撰寫和即時資料沒有情境限制，處處可用。
+
+## 服務技能清單
 
 ### 1. 🚦 工單分流
 
-當一個新工單落地時，Copilot 可一鍵將其分流。它會分析：
+請助手分流一個工單，它會分析：
 
 - **主題** 和 **描述**。
 - **客戶的畫像**（客戶層級、成為客戶的日期、合約）。
@@ -25,31 +36,33 @@ description: AI 服務坐席助手——分流工單、查看完整客戶歷史
 - 工單中引用的 **產品**。
 - **支援知識** 知識庫中的匹配文章。
 
-它返回：
+它回傳：
 
-- **建議的優先級**（低 / 中 / 高 / 緊急），並附帶與 [SLA 矩陣](/zh-Hant/docs/service/sla-and-escalation) 關聯的理由。
+- **建議的優先順序**（低 / 中 / 高 / 緊急），並附帶與 [SLA 矩陣](/zh-Hant/docs/service/sla-and-escalation) 關聯的理由。
 - **建議的分類**（缺陷、問題諮詢、功能請求、帳單）。
-- 基於產品或主題的 **建議團隊 / 佇列**。
-- 帶置信度評分的 **最匹配的前 3 篇知識庫文章**。
+- **最匹配的知識庫文章**。
 - 一份 **首次回覆草稿**，確認問題並連結到知識庫文章。
+- 指向正確下一步操作的指引——**升級工單** 或 **關閉工單**。
 
-坐席可以逐條接受、編輯或拒絕每條建議。
+坐席可以逐條接受、編輯或拒絕每條建議。技能自身絕不修改工單：它把動作交給坐席本來就會
+點擊的 `escalate_case` / `close_case` 操作。
 
 ### 2. 🔭 Customer 360°
 
-在任意工單上，問 *「給我客戶的歷史」*，Copilot 會呈現：
+在任意工單上，問 *「給我客戶的歷史」*，你會得到：
 
 - **所有過往工單**（未結和已結）——針對同一聯絡人和客戶。
 - **合約狀態**——他們購買了什麼、何時到期、有權享受何種層級的支援。
 - **進行中的商機**——以便坐席知道是否正在與一位正處於採購中的客戶交談。
 - **最近的接觸點**——近期郵件、通話、會議。
-- **客戶健康信號**——升級、流失風險標記、滿意度評分。
+- **客戶健康訊號**——升級、流失風險標記、滿意度評分。
 
-這就是 *「我看到這是您第一個工單」* 與 *「我看到這是您本季度第 3 次遇到這個問題——讓我來升級處理」* 之間的差別。
+這就是 *「我看到這是您第一個工單」* 與 *「我看到這是您本季第 3 次遇到這個問題——讓我
+來升級處理」* 之間的差別。
 
 ### 3. ✍️ 郵件 / 回覆撰寫
 
-Copilot 撰寫針對服務語氣調優的客戶回覆：
+銷售側使用的同一項郵件撰寫技能，也會撰寫針對服務語氣調優的客戶回覆：
 
 - **確認收悉**——*「我們已收到您的工單，正在調查。」*
 - **索取更多資訊**——缺陷重現步驟、截圖、日誌。
@@ -57,47 +70,36 @@ Copilot 撰寫針對服務語氣調優的客戶回覆：
 - **解決**——說明已完成的處理。
 - **關閉**——確認一切已解決。
 
-所有草稿都會引用其所提取的支援知識文章，以便坐席核實來源。Copilot 從不發送——坐席先預覽和編輯。
-
-## 工單頁面上的內聯操作
-
-| 按鈕 | 它的作用 |
-| --- | --- |
-| **🚦 分流** | 執行分流技能並預填優先級、分類、佇列。 |
-| **📚 查找文章** | 在支援知識中搜尋匹配的知識庫文章。 |
-| **✍️ 撰寫回覆** | 基於工單狀態撰寫面向客戶的回覆。 |
-| **🔭 Customer 360** | 開啟客戶歷史側邊面板。 |
-| **🔁 推薦相似** | 查找相似的已解決工單。 |
-
-## Copilot 在後台為你做什麼
+所有草稿都會引用其所提取的支援知識文章，以便坐席核實來源。不會自動發送任何內容——坐席
+先預覽和編輯。
 
-即使你沒有提出請求，服務 Copilot 也在忙碌：
+### 4. 🔄 即時資料
 
-- **自動推薦文章**——當坐席輸入工單描述時。
-- **標記重複問題**——「此聯絡人已提交 4 個相似工單」。
-- **SLA 風險預警**——「此工單將在 47 分鐘內違反 SLA」。
-- **高亮情緒**——郵件線程中的憤怒客戶偵測。
+每項服務技能都構建在即時資料之上：助手在回答之前會重新讀取工單物件的模式，因此管理員
+今早新增的欄位今天下午就能用上。參見
+[即時模式（Wow #1）](/zh-Hant/docs/ai-copilot/live-schema)。
 
 ## 給坐席的提示
 
-- ✅ **為每個新工單分流**——只需 5 秒的點擊，節省你的排序/路由時間。
+- ✅ **為每個新工單分流**——只需問一句，節省你的排序/路由時間。
 - ✅ 在任何電話通話前使用 **Customer 360**——了解合約層級會影響對話方式。
-- ✅ **信任但要核實** 知識庫建議——如果 Copilot 的置信度低於 70%，請再次確認。
+- ✅ **信任但要核實** 知識庫建議——發送前先查看被引用的文章。
 
 ## 給經理的提示
 
-- ✅ 追蹤 **Copilot 接受率**——如果你的坐席拒絕了大多數分流建議，說明你的知識庫需要完善。
-- ✅ 在化解會議中使用 **推薦相似**——重複工單的模式揭示了產品問題。
+- ✅ 追蹤分流建議的接受率——如果你的坐席拒絕了大多數建議，說明你的知識庫需要完善。
+- ✅ 在化解會議中留意重複工單的模式——它們揭示了產品問題。
 
 ## 給知識管理員的提示
 
-- ✅ 當 Copilot 找不到與工單匹配的文章時，它會記錄這個 **空缺**——每週審查這些記錄，以確定要撰寫的新文章。
-- ✅ Copilot 頻繁引用的文章是你 **價值最高的內容**——保持它們更新。
+- ✅ 當助手找不到與工單匹配的文章時，那就是一處知識空缺——審查這些情況，以確定要撰寫的新文章。
+- ✅ 被頻繁引用的文章是你 **價值最高的內容**——保持它們更新。
 
 ## 限制
 
-- Copilot 遵循 [共享規則](/zh-Hant/docs/administration/sharing-and-security)——它只能看到坐席能看到的內容。
-- 它 **不會關閉工單**，也 **不會將其標記為已解決**，除非坐席明確操作。
-- 對於 VIP/已升級的客戶，Copilot 會 **優先路由給人工**，而非自動推薦化解。
+- 技能遵循 [共享規則](/zh-Hant/docs/administration/sharing-and-security)——它們只能看到坐席能看到的內容。
+- 它們 **不會關閉工單**，也 **不會將其標記為已解決**，除非坐席明確操作。
+- 技能不宣告任何專屬工具：每一次狀態變更都經由真實的 HotCRM 操作完成，因此與坐席親手點擊按鈕時的權限校驗完全一致。
 
-參見 [技能](/zh-Hant/docs/ai-copilot/skills) 了解完整的技能規格，參見 [知識庫](/zh-Hant/docs/ai-copilot/knowledge-bases) 了解為回覆提供動力的支援知識索引。
+參見 [技能](/zh-Hant/docs/ai-copilot/skills) 了解完整的技能規格，參見
+[知識庫](/zh-Hant/docs/ai-copilot/knowledge-bases) 了解為回覆提供動力的支援知識索引。
diff --git a/content/docs/ai-copilot/skills.mdx b/content/docs/ai-copilot/skills.mdx
index 05f540e3..65f68c24 100644
--- a/content/docs/ai-copilot/skills.mdx
+++ b/content/docs/ai-copilot/skills.mdx
@@ -1,15 +1,15 @@
 ---
 title: Skills
-description: The full library of AI Copilot skills — what each one does, where it appears, and what data it uses.
+description: The full library of HotCRM AI skills — what each one does, where it appears, and what data it uses.
 ---
 
 # Skills
 
-A **skill** is a bite-sized AI ability the Copilot can perform — like *"qualify this lead"* or *"draft a customer reply"*. Skills are the building blocks of both the [Sales Copilot](/docs/ai-copilot/sales-copilot) and the [Service Copilot](/docs/ai-copilot/service-copilot).
+A **skill** is a bite-sized AI ability the platform assistant can perform — like *"qualify this lead"* or *"draft a customer reply"*. Skills are all HotCRM contributes to the assistant; they are documented in two groups, [Sales Skills](/docs/ai-copilot/sales-copilot) and [Service Skills](/docs/ai-copilot/service-copilot).
 
 ## Why skills, not "one big AI"
 
-Breaking the Copilot into skills makes it:
+Packaging the capability as skills rather than one prompt makes it:
 
 - **Predictable** — each skill has a defined input, output, and behavior.
 - **Auditable** — admins can see what each skill reads from and writes to.
@@ -39,7 +39,7 @@ HotCRM ships with six core skills:
 | **Writes** | Nothing — read-only |
 | **Knowledge base** | None — purely metadata + records |
 
-This is the skill behind **[Wow #1 — Live Schema](/docs/ai-copilot/live-schema)**: add a field in the admin console, and the Copilot uses it on the very next turn. Every other Sales / Service skill composes on top of Live Data, so the same live-schema property applies transitively — Lead Qualification can score a lead on a custom field added 10 seconds ago.
+This is the skill behind **[Wow #1 — Live Schema](/docs/ai-copilot/live-schema)**: add a field in the admin console, and the assistant uses it on the very next turn. Every other Sales / Service skill composes on top of Live Data, so the same live-schema property applies transitively — Lead Qualification can score a lead on a custom field added 10 seconds ago.
 
 ### 🎯 Lead Qualification
 
@@ -95,10 +95,10 @@ This is the skill behind **[Wow #1 — Live Schema](/docs/ai-copilot/live-schema
 
 Skills can call other skills. For example:
 
-- The Service Copilot's *Case Triage* skill can invoke *Customer 360* to check if the customer is high-value before assigning priority.
-- The Sales Copilot's *Email Drafting* skill can invoke *Customer 360* to ground the email in real account context.
+- The *Case Triage* skill can invoke *Customer 360* to check if the customer is high-value before assigning priority.
+- The *Email Drafting* skill can invoke *Customer 360* to ground the email in real account context.
 
-This composition is automatic — you ask one question, the Copilot wires up whatever skills it needs.
+This composition is automatic — you ask one question, the assistant wires up whatever skills it needs.
 
 ## What every skill respects
 
diff --git a/content/docs/ai-copilot/skills.zh-Hans.mdx b/content/docs/ai-copilot/skills.zh-Hans.mdx
index 2a54e290..e1ffea9d 100644
--- a/content/docs/ai-copilot/skills.zh-Hans.mdx
+++ b/content/docs/ai-copilot/skills.zh-Hans.mdx
@@ -1,15 +1,15 @@
 ---
 title: 技能
-description: AI Copilot 技能的完整库——每项技能做什么、出现在哪里，以及使用哪些数据。
+description: HotCRM AI 技能的完整库——每项技能做什么、出现在哪里，以及使用哪些数据。
 ---
 
 # 技能
 
-**技能**是 Copilot 可以执行的细分到点的 AI 能力——比如 *"判定此线索资格"* 或 *"撰写客户回复"*。技能是 [销售 Copilot](/zh-Hans/docs/ai-copilot/sales-copilot) 和 [服务 Copilot](/zh-Hans/docs/ai-copilot/service-copilot) 两者的构建模块。
+**技能**是平台助手可以执行的细分到点的 AI 能力——比如 *"判定此线索资格"* 或 *"撰写客户回复"*。技能是 HotCRM 对助手的全部贡献；它们按两组编写文档：[销售技能](/zh-Hans/docs/ai-copilot/sales-copilot) 和 [服务技能](/zh-Hans/docs/ai-copilot/service-copilot)。
 
 ## 为什么用技能，而非"一个大 AI"
 
-将 Copilot 拆分为技能使它：
+把能力打包为技能（而不是一段大提示词）使它：
 
 - **可预测**——每项技能都有明确定义的输入、输出和行为。
 - **可审计**——管理员可以看到每项技能从哪里读取、向哪里写入。
@@ -39,7 +39,7 @@ HotCRM 内置六项核心技能：
 | **写入** | 无——只读 |
 | **知识库** | 无——纯粹是元数据 + 记录 |
 
-这是 **[Wow #1 — 实时模式](/zh-Hans/docs/ai-copilot/live-schema)** 背后的技能：在管理控制台中添加一个字段，Copilot 在下一轮就会使用它。其他每项销售 / 服务技能都构建在实时数据之上，因此同样的实时模式特性会传递地适用——线索资格判定可以根据 10 秒前添加的自定义字段为线索评分。
+这是 **[Wow #1 — 实时模式](/zh-Hans/docs/ai-copilot/live-schema)** 背后的技能：在管理控制台中添加一个字段，助手在下一轮就会使用它。其他每项销售 / 服务技能都构建在实时数据之上，因此同样的实时模式特性会传递地适用——线索资格判定可以根据 10 秒前添加的自定义字段为线索评分。
 
 ### 🎯 线索资格判定
 
@@ -95,10 +95,10 @@ HotCRM 内置六项核心技能：
 
 技能可以调用其他技能。例如：
 
-- 服务 Copilot 的 *工单分流* 技能可以调用 *Customer 360* 来检查客户在分配优先级前是否为高价值客户。
-- 销售 Copilot 的 *邮件撰写* 技能可以调用 *Customer 360* 将邮件建立在真实的客户上下文之上。
+- *工单分流* 技能可以调用 *Customer 360* 来检查客户在分配优先级前是否为高价值客户。
+- *邮件撰写* 技能可以调用 *Customer 360* 将邮件建立在真实的客户上下文之上。
 
-这种组合是自动的——你问一个问题，Copilot 会接好它所需的任何技能。
+这种组合是自动的——你问一个问题，助手会接好它所需的任何技能。
 
 ## 每项技能都遵循什么
 
diff --git a/content/docs/ai-copilot/skills.zh-Hant.mdx b/content/docs/ai-copilot/skills.zh-Hant.mdx
index 5f1462ac..b32ae52b 100644
--- a/content/docs/ai-copilot/skills.zh-Hant.mdx
+++ b/content/docs/ai-copilot/skills.zh-Hant.mdx
@@ -1,15 +1,15 @@
 ---
 title: 技能
-description: AI Copilot 技能的完整庫——每項技能做什麼、出現在哪裡，以及使用哪些資料。
+description: HotCRM AI 技能的完整庫——每項技能做什麼、出現在哪裡，以及使用哪些資料。
 ---
 
 # 技能
 
-**技能**是 Copilot 可以執行的細分到點的 AI 能力——比如 *「判定此潛在客戶資格」* 或 *「撰寫客戶回覆」*。技能是 [銷售 Copilot](/zh-Hant/docs/ai-copilot/sales-copilot) 和 [服務 Copilot](/zh-Hant/docs/ai-copilot/service-copilot) 兩者的構建模塊。
+**技能**是平台助手可以執行的細分到點的 AI 能力——比如 *「判定此潛在客戶資格」* 或 *「撰寫客戶回覆」*。技能是 HotCRM 對助手的全部貢獻；它們按兩組編寫文件：[銷售技能](/zh-Hant/docs/ai-copilot/sales-copilot) 和 [服務技能](/zh-Hant/docs/ai-copilot/service-copilot)。
 
 ## 為什麼用技能，而非「一個大 AI」
 
-將 Copilot 拆分為技能使它：
+把能力打包為技能（而不是一段大提示詞）使它：
 
 - **可預測**——每項技能都有明確定義的輸入、輸出和行為。
 - **可稽核**——管理員可以看到每項技能從哪裡讀取、向哪裡寫入。
@@ -39,7 +39,7 @@ HotCRM 內建六項核心技能：
 | **寫入** | 無——唯讀 |
 | **知識庫** | 無——純粹是元資料 + 記錄 |
 
-這是 **[Wow #1 — 即時結構](/zh-Hant/docs/ai-copilot/live-schema)** 背後的技能：在管理主控台中新增一個欄位，Copilot 在下一輪就會使用它。其他每項銷售 / 服務技能都構建在即時資料之上，因此同樣的即時結構特性會傳遞地適用——潛在客戶資格判定可以根據 10 秒前新增的自訂欄位為潛在客戶評分。
+這是 **[Wow #1 — 即時結構](/zh-Hant/docs/ai-copilot/live-schema)** 背後的技能：在管理主控台中新增一個欄位，助手在下一輪就會使用它。其他每項銷售 / 服務技能都構建在即時資料之上，因此同樣的即時結構特性會傳遞地適用——潛在客戶資格判定可以根據 10 秒前新增的自訂欄位為潛在客戶評分。
 
 ### 🎯 潛在客戶資格判定
 
@@ -95,10 +95,10 @@ HotCRM 內建六項核心技能：
 
 技能可以呼叫其他技能。例如：
 
-- 服務 Copilot 的 *工單分流* 技能可以呼叫 *Customer 360* 來檢查客戶在分配優先級前是否為高價值客戶。
-- 銷售 Copilot 的 *郵件撰寫* 技能可以呼叫 *Customer 360* 將郵件建立在真實的客戶上下文之上。
+- *工單分流* 技能可以呼叫 *Customer 360* 來檢查客戶在分配優先級前是否為高價值客戶。
+- *郵件撰寫* 技能可以呼叫 *Customer 360* 將郵件建立在真實的客戶上下文之上。
 
-這種組合是自動的——你問一個問題，Copilot 會接好它所需的任何技能。
+這種組合是自動的——你問一個問題，助手會接好它所需的任何技能。
 
 ## 每項技能都遵循什麼
 
diff --git a/content/docs/analytics/index.mdx b/content/docs/analytics/index.mdx
index af51b49c..1d155c88 100644
--- a/content/docs/analytics/index.mdx
+++ b/content/docs/analytics/index.mdx
@@ -55,7 +55,7 @@ The AI Copilot can read directly from cubes — ask questions like:
 - *"Why did East close 3 fewer deals than West last quarter?"*
 - *"Show me which products correlate with longer sales cycles."*
 
-See the [Sales Copilot](/docs/ai-copilot/sales-copilot) for more.
+See [Sales Skills](/docs/ai-copilot/sales-copilot) for more.
 
 ## Start here
 
diff --git a/content/docs/analytics/index.zh-Hans.mdx b/content/docs/analytics/index.zh-Hans.mdx
index cb9d25aa..673cdc00 100644
--- a/content/docs/analytics/index.zh-Hans.mdx
+++ b/content/docs/analytics/index.zh-Hans.mdx
@@ -55,7 +55,7 @@ AI Copilot 可以直接从多维数据集读取数据——可以提出如下问
 - *"为什么上季度东区比西区少成交了 3 笔交易？"*
 - *"告诉我哪些产品与更长的销售周期相关。"*
 
-更多内容请参阅 [Sales Copilot](/zh-Hans/docs/ai-copilot/sales-copilot)。
+更多内容请参阅 [销售技能](/zh-Hans/docs/ai-copilot/sales-copilot)。
 
 ## 从这里开始
 
diff --git a/content/docs/analytics/index.zh-Hant.mdx b/content/docs/analytics/index.zh-Hant.mdx
index 1138b6ba..adb82df9 100644
--- a/content/docs/analytics/index.zh-Hant.mdx
+++ b/content/docs/analytics/index.zh-Hant.mdx
@@ -55,7 +55,7 @@ AI Copilot 可以直接從多維資料集讀取資料——可以提出如下問
 - *"為什麼上一季東區比西區少成交了 3 筆交易？"*
 - *"告訴我哪些產品與更長的銷售週期相關。"*
 
-更多內容請參閱 [Sales Copilot](/zh-Hant/docs/ai-copilot/sales-copilot)。
+更多內容請參閱 [銷售技能](/zh-Hant/docs/ai-copilot/sales-copilot)。
 
 ## 從這裡開始
 
diff --git a/content/docs/customization/ai-skills.mdx b/content/docs/customization/ai-skills.mdx
index 34265944..9a7e64c7 100644
--- a/content/docs/customization/ai-skills.mdx
+++ b/content/docs/customization/ai-skills.mdx
@@ -1,11 +1,15 @@
 ---
 title: AI Skills
-description: Add Copilot skills and wire them into HotCRM agents.
+description: Add AI skills and register them with the HotCRM stack.
 ---
 
 # AI Skills
 
-AI skills live in `src/skills/` and are registered from `src/skills/index.ts`. Agents live in `src/agents/`.
+AI skills live in `src/skills/` and are registered from `src/skills/index.ts`.
+
+HotCRM defines **no agents of its own** — there is no `src/agents/` directory. Skills
+attach to the platform assistant (`ask`), which every ObjectStack environment already
+provides. Registering a skill in `allSkills` is the whole wiring step.
 
 ## Add a skill
 
@@ -24,27 +28,27 @@ account and contract records, summarize risk, and draft a concise
 });
 ```
 
-Export it:
+## Register it
+
+Export the skill and add it to `allSkills` — that array is what
+`objectstack.config.ts` passes to `defineStack({ skills })`:
 
 ```ts
 // src/skills/index.ts
 export { RenewalPitchSkill } from './renewal_pitch.skill.js';
-```
 
-## Attach it to an agent
+import { RenewalPitchSkill } from './renewal_pitch.skill.js';
 
-```ts
-// src/agents/sales-copilot.agent.ts
-skills: [
-  'live_data',
-  'lead_qualification',
-  'email_drafting',
-  'revenue_forecasting',
-  'customer_360',
-  'renewal_pitch',
-],
+export const allSkills: Skill[] = [
+  // …existing skills
+  RenewalPitchSkill,
+];
 ```
 
+To make the skill activate on a particular record instead of everywhere, declare a
+`triggerConditions` entry on it — for example
+`{ field: 'objectName', operator: 'eq', value: 'crm_contract' }`.
+
 ## Verify
 
 ```bash
diff --git a/content/docs/customization/ai-skills.zh-Hans.mdx b/content/docs/customization/ai-skills.zh-Hans.mdx
index 7fa4b5ae..28a7a274 100644
--- a/content/docs/customization/ai-skills.zh-Hans.mdx
+++ b/content/docs/customization/ai-skills.zh-Hans.mdx
@@ -1,11 +1,15 @@
 ---
 title: AI Skills
-description: 新增 Copilot skills，并接入 HotCRM agents。
+description: 新增 AI skills，并注册到 HotCRM stack。
 ---
 
 # AI Skills
 
-AI skills 位于 `src/skills/`，并从 `src/skills/index.ts` 注册。Agents 位于 `src/agents/`。
+AI skills 位于 `src/skills/`，并从 `src/skills/index.ts` 注册。
+
+HotCRM **不定义任何自己的 agent** —— 不存在 `src/agents/` 目录。Skills 附着在每个
+ObjectStack 环境已自带的平台助手（`ask`）之上。把 skill 注册进 `allSkills` 就是全部
+的接线工作。
 
 ## 新增 skill
 
@@ -24,27 +28,26 @@ account and contract records, summarize risk, and draft a concise
 });
 ```
 
-导出：
+## 注册
+
+导出该 skill 并把它加入 `allSkills` —— 这个数组正是 `objectstack.config.ts` 传给
+`defineStack({ skills })` 的内容：
 
 ```ts
 // src/skills/index.ts
 export { RenewalPitchSkill } from './renewal_pitch.skill.js';
-```
 
-## 接入 agent
+import { RenewalPitchSkill } from './renewal_pitch.skill.js';
 
-```ts
-// src/agents/sales-copilot.agent.ts
-skills: [
-  'live_data',
-  'lead_qualification',
-  'email_drafting',
-  'revenue_forecasting',
-  'customer_360',
-  'renewal_pitch',
-],
+export const allSkills: Skill[] = [
+  // …已有的 skills
+  RenewalPitchSkill,
+];
 ```
 
+若希望该 skill 只在特定记录上激活（而非处处可用），在它上面声明 `triggerConditions`
+即可，例如 `{ field: 'objectName', operator: 'eq', value: 'crm_contract' }`。
+
 ## 验证
 
 ```bash
diff --git a/content/docs/customization/ai-skills.zh-Hant.mdx b/content/docs/customization/ai-skills.zh-Hant.mdx
index 6eb89392..0e62bc9d 100644
--- a/content/docs/customization/ai-skills.zh-Hant.mdx
+++ b/content/docs/customization/ai-skills.zh-Hant.mdx
@@ -1,11 +1,15 @@
 ---
 title: AI Skills
-description: 新增 Copilot skills，並接入 HotCRM agents。
+description: 新增 AI skills，並註冊到 HotCRM stack。
 ---
 
 # AI Skills
 
-AI skills 位於 `src/skills/`，並從 `src/skills/index.ts` 註冊。Agents 位於 `src/agents/`。
+AI skills 位於 `src/skills/`，並從 `src/skills/index.ts` 註冊。
+
+HotCRM **不定義任何自己的 agent** —— 不存在 `src/agents/` 目錄。Skills 附著在每個
+ObjectStack 環境已自帶的平台助手（`ask`）之上。把 skill 註冊進 `allSkills` 就是全部
+的接線工作。
 
 ## 新增 skill
 
@@ -24,27 +28,26 @@ account and contract records, summarize risk, and draft a concise
 });
 ```
 
-匯出：
+## 註冊
+
+匯出該 skill 並把它加入 `allSkills` —— 這個陣列正是 `objectstack.config.ts` 傳給
+`defineStack({ skills })` 的內容：
 
 ```ts
 // src/skills/index.ts
 export { RenewalPitchSkill } from './renewal_pitch.skill.js';
-```
 
-## 接入 agent
+import { RenewalPitchSkill } from './renewal_pitch.skill.js';
 
-```ts
-// src/agents/sales-copilot.agent.ts
-skills: [
-  'live_data',
-  'lead_qualification',
-  'email_drafting',
-  'revenue_forecasting',
-  'customer_360',
-  'renewal_pitch',
-],
+export const allSkills: Skill[] = [
+  // …既有的 skills
+  RenewalPitchSkill,
+];
 ```
 
+若希望該 skill 只在特定記錄上啟用（而非處處可用），在它上面宣告 `triggerConditions`
+即可，例如 `{ field: 'objectName', operator: 'eq', value: 'crm_contract' }`。
+
 ## 驗證
 
 ```bash
diff --git a/content/docs/getting-started/quick-tour.mdx b/content/docs/getting-started/quick-tour.mdx
index 84526786..a174d21d 100644
--- a/content/docs/getting-started/quick-tour.mdx
+++ b/content/docs/getting-started/quick-tour.mdx
@@ -48,7 +48,7 @@ A **lead** is someone who's expressed interest but hasn't been qualified yet.
 1. Click **Sales → Leads → New**.
 2. Fill in **Name**, **Company**, **Email**.
 3. Save. The lead is automatically assigned to you.
-4. Click **🎯 Qualify** on the lead detail page — the [Sales Copilot](/docs/ai-copilot/sales-copilot) will score them as Hot / Warm / Cold and suggest the next action.
+4. Ask the assistant to *"qualify this lead"* on the lead detail page — the [Lead Qualification skill](/docs/ai-copilot/sales-copilot) scores them 0–100 on BANT and suggests the next action.
 5. When ready, click **Convert** to turn the lead into an Account + Contact + Opportunity in one step.
 
 ➜ Learn more: [Leads](/docs/sales/leads)
@@ -72,7 +72,7 @@ A **case** is a customer issue.
 
 1. Cases arrive via email, web form, phone, chat, or portal.
 2. New cases land in a queue — agents pick them up.
-3. Click **🚦 Triage** on a new case — the [Service Copilot](/docs/ai-copilot/service-copilot) suggests priority, category, and the top 3 matching knowledge-base articles.
+3. Ask the assistant to *"triage this case"* on a new case — the [Case Triage skill](/docs/ai-copilot/service-copilot) suggests priority, category, and matching knowledge-base articles.
 4. The SLA clock starts — see the time-to-respond / time-to-resolve countdown on the case page.
 5. Reply to the customer; close the case when resolved.
 
diff --git a/content/docs/getting-started/quick-tour.zh-Hans.mdx b/content/docs/getting-started/quick-tour.zh-Hans.mdx
index 31fbc766..25c67e29 100644
--- a/content/docs/getting-started/quick-tour.zh-Hans.mdx
+++ b/content/docs/getting-started/quick-tour.zh-Hans.mdx
@@ -48,7 +48,7 @@ description: HotCRM 的 5 分钟演练 —— 主页、你的第一条线索、
 1. 点击 **Sales → Leads → New**。
 2. 填写 **Name**、**Company**、**Email**。
 3. 保存。线索会自动分配给你。
-4. 在线索详情页上点击 **🎯 Qualify** —— [Sales Copilot](/zh-Hans/docs/ai-copilot/sales-copilot) 会将其评分为 Hot / Warm / Cold 并建议下一步操作。
+4. 在线索详情页上请助手 *"判定此线索资格"* —— [线索资格判定技能](/zh-Hans/docs/ai-copilot/sales-copilot) 会按 BANT 给出 0–100 的评分并建议下一步操作。
 5. 准备就绪后，点击 **Convert** 一步将线索转化为 Account + Contact + Opportunity。
 
 ➜ 了解更多：[线索](/zh-Hans/docs/sales/leads)
@@ -72,7 +72,7 @@ description: HotCRM 的 5 分钟演练 —— 主页、你的第一条线索、
 
 1. 案例通过邮件、Web 表单、电话、聊天或门户到达。
 2. 新案例进入队列 —— 坐席接手。
-3. 在新案例上点击 **🚦 Triage** —— [Service Copilot](/zh-Hans/docs/ai-copilot/service-copilot) 会建议优先级、类别以及最匹配的前 3 篇知识库文章。
+3. 在新工单上请助手 *"分流此工单"* —— [工单分流技能](/zh-Hans/docs/ai-copilot/service-copilot) 会建议优先级、分类以及匹配的知识库文章。
 4. SLA 计时器开始 —— 在案例页面查看响应时间 / 解决时间倒计时。
 5. 回复客户；解决后关闭案例。
 
diff --git a/content/docs/getting-started/quick-tour.zh-Hant.mdx b/content/docs/getting-started/quick-tour.zh-Hant.mdx
index 4b460189..26948620 100644
--- a/content/docs/getting-started/quick-tour.zh-Hant.mdx
+++ b/content/docs/getting-started/quick-tour.zh-Hant.mdx
@@ -48,7 +48,7 @@ description: HotCRM 的 5 分鐘演練 —— 主頁、你的第一條線索、
 1. 點擊 **Sales → Leads → New**。
 2. 填寫 **Name**、**Company**、**Email**。
 3. 儲存。線索會自動指派給你。
-4. 在線索詳情頁上點擊 **🎯 Qualify** —— [Sales Copilot](/zh-Hant/docs/ai-copilot/sales-copilot) 會將其評分為 Hot / Warm / Cold 並建議下一步操作。
+4. 在潛在客戶詳情頁上請助手 *「判定此潛在客戶資格」* —— [潛在客戶資格判定技能](/zh-Hant/docs/ai-copilot/sales-copilot) 會按 BANT 給出 0–100 的評分並建議下一步操作。
 5. 準備就緒後，點擊 **Convert** 一步將線索轉換為 Account + Contact + Opportunity。
 
 ➜ 了解更多：[線索](/zh-Hant/docs/sales/leads)
@@ -72,7 +72,7 @@ description: HotCRM 的 5 分鐘演練 —— 主頁、你的第一條線索、
 
 1. 案例透過郵件、Web 表單、電話、聊天或入口網站到達。
 2. 新案例進入佇列 —— 專員接手。
-3. 在新案例上點擊 **🚦 Triage** —— [Service Copilot](/zh-Hant/docs/ai-copilot/service-copilot) 會建議優先順序、類別以及最匹配的前 3 篇知識庫文章。
+3. 在新工單上請助手 *「分流此工單」* —— [工單分流技能](/zh-Hant/docs/ai-copilot/service-copilot) 會建議優先順序、分類以及匹配的知識庫文章。
 4. SLA 計時器開始 —— 在案例頁面查看回應時間 / 解決時間倒數計時。
 5. 回覆客戶；解決後關閉案例。
 
diff --git a/content/docs/guides/email-and-calendar.mdx b/content/docs/guides/email-and-calendar.mdx
index 90b2aab1..a6a58e20 100644
--- a/content/docs/guides/email-and-calendar.mdx
+++ b/content/docs/guides/email-and-calendar.mdx
@@ -51,7 +51,7 @@ Tracking events are stored on the email activity, the contact, and the originati
 
 ## AI-drafted emails
 
-On any record, click **✍️ Draft Email** to have the [Sales Copilot](/docs/ai-copilot/sales-copilot) or [Service Copilot](/docs/ai-copilot/service-copilot) draft a contextual email:
+On any record, ask the assistant to draft an email — the Email Drafting skill is shared by the [sales](/docs/ai-copilot/sales-copilot) and [service](/docs/ai-copilot/service-copilot) skill sets:
 
 1. Pick a goal (*"discovery follow-up"*, *"renewal pitch"*, *"resolution"*).
 2. Review the draft — edit, replace, regenerate.
diff --git a/content/docs/guides/email-and-calendar.zh-Hans.mdx b/content/docs/guides/email-and-calendar.zh-Hans.mdx
index 16c7bf99..6801836f 100644
--- a/content/docs/guides/email-and-calendar.zh-Hans.mdx
+++ b/content/docs/guides/email-and-calendar.zh-Hans.mdx
@@ -51,7 +51,7 @@ HotCRM 集成了 **Gmail**（Google Workspace）和 **Outlook**（Microsoft 365
 
 ## AI 起草的邮件
 
-在任何记录上，点击 **✍️ 起草邮件**，让 [销售 Copilot](/zh-Hans/docs/ai-copilot/sales-copilot) 或 [服务 Copilot](/zh-Hans/docs/ai-copilot/service-copilot) 起草一封上下文相关的邮件：
+在任何记录上，请助手起草邮件——邮件撰写技能由 [销售技能](/zh-Hans/docs/ai-copilot/sales-copilot) 和 [服务技能](/zh-Hans/docs/ai-copilot/service-copilot) 共用：
 
 1. 选择一个目标（*"发现阶段跟进"*、*"续约推介"*、*"问题解决"*）。
 2. 审阅草稿 —— 编辑、替换、重新生成。
diff --git a/content/docs/guides/email-and-calendar.zh-Hant.mdx b/content/docs/guides/email-and-calendar.zh-Hant.mdx
index 01fc4d37..ba07aa70 100644
--- a/content/docs/guides/email-and-calendar.zh-Hant.mdx
+++ b/content/docs/guides/email-and-calendar.zh-Hant.mdx
@@ -51,7 +51,7 @@ HotCRM 整合了 **Gmail**（Google Workspace）和 **Outlook**（Microsoft 365
 
 ## AI 起草的郵件
 
-在任何記錄上，點擊 **✍️ 起草郵件**，讓 [銷售 Copilot](/zh-Hant/docs/ai-copilot/sales-copilot) 或 [服務 Copilot](/zh-Hant/docs/ai-copilot/service-copilot) 起草一封情境相關的郵件：
+在任何記錄上，請助手起草郵件——郵件撰寫技能由 [銷售技能](/zh-Hant/docs/ai-copilot/sales-copilot) 和 [服務技能](/zh-Hant/docs/ai-copilot/service-copilot) 共用：
 
 1. 選擇一個目標（*「發現階段跟進」*、*「續約推介」*、*「問題解決」*）。
 2. 審閱草稿 —— 編輯、替換、重新生成。
diff --git a/content/docs/reference/glossary.mdx b/content/docs/reference/glossary.mdx
index 0f26cf4e..6355d99c 100644
--- a/content/docs/reference/glossary.mdx
+++ b/content/docs/reference/glossary.mdx
@@ -15,7 +15,7 @@ description: CRM and platform terms — alphabetised so you can stop bluffing in
 
 **Activity** — A task, event, call, or email logged against a record.
 
-**Agent (AI)** — A composite AI assistant that bundles skills + knowledge bases. The Sales Copilot and Service Copilot are agents.
+**Agent (AI)** — A composite AI assistant that bundles skills + knowledge bases. HotCRM defines no agents of its own: its six skills attach to the platform `ask` agent that every ObjectStack environment provides.
 
 **ARPU** *(Average Revenue Per User)* — Total revenue ÷ active users.
 
diff --git a/content/docs/reference/glossary.zh-Hans.mdx b/content/docs/reference/glossary.zh-Hans.mdx
index 36b60b36..b2df65e1 100644
--- a/content/docs/reference/glossary.zh-Hans.mdx
+++ b/content/docs/reference/glossary.zh-Hans.mdx
@@ -15,7 +15,7 @@ description: CRM 与平台术语 —— 按字母排序，让你在会议中不
 
 **Activity（活动）** —— 针对某条记录记录的任务、事件、通话或邮件。
 
-**Agent (AI)（AI 代理）** —— 捆绑技能 + 知识库的复合型 AI 助手。Sales Copilot 和 Service Copilot 都是代理。
+**Agent (AI)（AI 代理）** —— 捆绑技能 + 知识库的复合型 AI 助手。HotCRM 不定义任何自己的代理：它的六项技能附着在每个 ObjectStack 环境自带的平台 `ask` 代理之上。
 
 **ARPU** *(Average Revenue Per User，每用户平均收入)* —— 总收入 ÷ 活跃用户数。
 
diff --git a/content/docs/reference/glossary.zh-Hant.mdx b/content/docs/reference/glossary.zh-Hant.mdx
index cbc805b2..7343325e 100644
--- a/content/docs/reference/glossary.zh-Hant.mdx
+++ b/content/docs/reference/glossary.zh-Hant.mdx
@@ -15,7 +15,7 @@ description: CRM 與平台術語 —— 按字母排序，讓你在會議中不
 
 **Activity（活動）** —— 針對某筆記錄記錄的任務、事件、通話或郵件。
 
-**Agent (AI)（AI 代理）** —— 捆綁技能 + 知識庫的複合型 AI 助手。Sales Copilot 和 Service Copilot 都是代理。
+**Agent (AI)（AI 代理）** —— 捆綁技能 + 知識庫的複合型 AI 助手。HotCRM 不定義任何自己的代理：它的六項技能附著在每個 ObjectStack 環境自帶的平台 `ask` 代理之上。
 
 **ARPU** *(Average Revenue Per User，每使用者平均收入)* —— 總收入 ÷ 活躍使用者數。
 
diff --git a/content/docs/sales/index.mdx b/content/docs/sales/index.mdx
index 9404a53d..b45ce81d 100644
--- a/content/docs/sales/index.mdx
+++ b/content/docs/sales/index.mdx
@@ -42,9 +42,9 @@ You don't need to do these manually — HotCRM handles them in the background:
 - **Quote expiration** — quotes that pass their expiration date are auto-marked as expired every night.
 - **Discount approval** — opportunities over $500K are automatically routed to your sales manager and director for approval.
 
-## The Sales Copilot
+## Sales AI skills
 
-The [Sales Copilot](/docs/ai-copilot/sales-copilot) is built in. When you open a lead, account or opportunity, it can:
+The [sales skills](/docs/ai-copilot/sales-copilot) are built into the platform assistant. When you open a lead, account or opportunity, it can:
 
 - **Qualify a lead** using the BANT method (Budget, Authority, Need, Timeline) and give you a score.
 - **Draft outbound emails** personalised for the contact and grounded in the product catalog.
diff --git a/content/docs/sales/index.zh-Hans.mdx b/content/docs/sales/index.zh-Hans.mdx
index 969f7579..12c15c75 100644
--- a/content/docs/sales/index.zh-Hans.mdx
+++ b/content/docs/sales/index.zh-Hans.mdx
@@ -44,7 +44,7 @@ Lead  ──►  Account + Contact  ──►  Opportunity  ──►  Quote  
 
 ## Sales Copilot
 
-[Sales Copilot](/zh-Hans/docs/ai-copilot/sales-copilot) 是内置的。当你打开一条线索、客户或商机时，它可以：
+[销售技能](/zh-Hans/docs/ai-copilot/sales-copilot) 已内置于平台助手。当你打开一条线索、客户或商机时，它可以：
 
 - 使用 BANT 方法（预算、决策权、需求、时间线）**审核线索资格**并给出评分。
 - **起草外呼邮件**，针对联系人进行个性化，并以产品目录为依据。
diff --git a/content/docs/sales/index.zh-Hant.mdx b/content/docs/sales/index.zh-Hant.mdx
index d811151d..284ee763 100644
--- a/content/docs/sales/index.zh-Hant.mdx
+++ b/content/docs/sales/index.zh-Hant.mdx
@@ -44,7 +44,7 @@ Lead  ──►  Account + Contact  ──►  Opportunity  ──►  Quote  
 
 ## Sales Copilot
 
-[Sales Copilot](/zh-Hant/docs/ai-copilot/sales-copilot) 是內建的。當你打開一筆潛在客戶、客戶或商機時，它可以：
+[銷售技能](/zh-Hant/docs/ai-copilot/sales-copilot) 已內建於平台助手。當你打開一筆潛在客戶、客戶或商機時，它可以：
 
 - 使用 BANT 方法（預算、決策權、需求、時間線）**審核潛在客戶資格**並給出評分。
 - **起草外撥郵件**，針對聯絡人進行個人化，並以產品目錄為依據。
diff --git a/content/docs/service/cases.mdx b/content/docs/service/cases.mdx
index 1ca62392..83e759d7 100644
--- a/content/docs/service/cases.mdx
+++ b/content/docs/service/cases.mdx
@@ -148,9 +148,9 @@ You don't have to configure any of this — every CRM object ships with `trackHi
 
 > Tip — if you only want to see the discussion, use the filter dropdown at the top of the Activity tab; you can also subscribe to the case from there so any future post pings you in the bell.
 
-## How the AI Copilot helps
+## How the AI assistant helps
 
-The [Service Copilot](/docs/ai-copilot/service-copilot) auto-activates on any case. Ask:
+The [service skills](/docs/ai-copilot/service-copilot) auto-activate on any case. Ask:
 
 - *"Triage this case"* — Case Triage skill recommends a priority based on subject and description.
 - *"Suggest a resolution"* — searches the [Support Knowledge Base](/docs/service/knowledge-base) and drafts a customer reply.
diff --git a/content/docs/service/cases.zh-Hans.mdx b/content/docs/service/cases.zh-Hans.mdx
index c9ba730e..537b3e4c 100644
--- a/content/docs/service/cases.zh-Hans.mdx
+++ b/content/docs/service/cases.zh-Hans.mdx
@@ -150,7 +150,7 @@ Activity 标签页是工单上发生过什么的唯一可信来源。它将四
 
 ## AI Copilot 如何提供帮助
 
-[Service Copilot](/zh-Hans/docs/ai-copilot/service-copilot) 会在任何工单上自动激活。你可以问：
+[服务技能](/zh-Hans/docs/ai-copilot/service-copilot) 会在任何工单上自动激活。你可以问：
 
 - *"分流这个工单"*——工单分流技能根据主题和描述推荐优先级。
 - *"建议一个解决方案"*——搜索[支持知识库](/zh-Hans/docs/service/knowledge-base)并起草客户回复。
diff --git a/content/docs/service/cases.zh-Hant.mdx b/content/docs/service/cases.zh-Hant.mdx
index 93195803..917d591b 100644
--- a/content/docs/service/cases.zh-Hant.mdx
+++ b/content/docs/service/cases.zh-Hant.mdx
@@ -150,7 +150,7 @@ Activity 標籤頁是工單上發生過什麼的唯一可信來源。它將四
 
 ## AI Copilot 如何提供幫助
 
-[Service Copilot](/zh-Hant/docs/ai-copilot/service-copilot) 會在任何工單上自動啟動。你可以問：
+[服務技能](/zh-Hant/docs/ai-copilot/service-copilot) 會在任何工單上自動啟動。你可以問：
 
 - *"分流這個工單"*——工單分流技能根據主題和描述推薦優先順序。
 - *"建議一個解決方案"*——搜尋[支援知識庫](/zh-Hant/docs/service/knowledge-base)並起草客戶回覆。
diff --git a/content/docs/service/index.mdx b/content/docs/service/index.mdx
index d12015de..8f5a8ca7 100644
--- a/content/docs/service/index.mdx
+++ b/content/docs/service/index.mdx
@@ -40,9 +40,9 @@ New ──► In Progress ──► Waiting on Customer ──► Resolved ─
 - **Flag SLA breaches** with a red banner once the SLA target passes.
 - **Block bad closes** — you can't mark a case Closed without a resolution written.
 
-## The Service Copilot
+## Service AI skills
 
-The [Service Copilot](/docs/ai-copilot/service-copilot) is built into every case. Ask it:
+The [service skills](/docs/ai-copilot/service-copilot) are built into every case. Ask the assistant:
 
 - *"Triage this case"* — assigns a priority based on subject, description and customer tier.
 - *"Suggest a resolution"* — searches the support knowledge base and drafts a customer reply.
diff --git a/content/docs/service/index.zh-Hans.mdx b/content/docs/service/index.zh-Hans.mdx
index 9a361eae..693e1bac 100644
--- a/content/docs/service/index.zh-Hans.mdx
+++ b/content/docs/service/index.zh-Hans.mdx
@@ -42,7 +42,7 @@ New ──► In Progress ──► Waiting on Customer ──► Resolved ─
 
 ## Service Copilot
 
-[Service Copilot](/zh-Hans/docs/ai-copilot/service-copilot) 内置于每个工单中。你可以问它：
+[服务技能](/zh-Hans/docs/ai-copilot/service-copilot) 内置于每个工单中。你可以问助手：
 
 - *"分流这个工单"*——根据主题、描述和客户等级分配优先级。
 - *"建议一个解决方案"*——搜索支持知识库并起草客户回复。
diff --git a/content/docs/service/index.zh-Hant.mdx b/content/docs/service/index.zh-Hant.mdx
index 553e3318..aef27c6d 100644
--- a/content/docs/service/index.zh-Hant.mdx
+++ b/content/docs/service/index.zh-Hant.mdx
@@ -42,7 +42,7 @@ New ──► In Progress ──► Waiting on Customer ──► Resolved ─
 
 ## Service Copilot
 
-[Service Copilot](/zh-Hant/docs/ai-copilot/service-copilot) 內建於每個工單中。你可以問它：
+[服務技能](/zh-Hant/docs/ai-copilot/service-copilot) 內建於每個工單中。你可以問助手：
 
 - *"分流這個工單"*——根據主題、描述和客戶等級分配優先順序。
 - *"建議一個解決方案"*——搜尋支援知識庫並起草客戶回覆。
diff --git a/content/docs/whats-new.zh-Hans.mdx b/content/docs/whats-new.zh-Hans.mdx
index 85c39ef8..1f3dcf1c 100644
--- a/content/docs/whats-new.zh-Hans.mdx
+++ b/content/docs/whats-new.zh-Hans.mdx
@@ -11,7 +11,7 @@ description: 近期发布、新能力，以及即将推出的内容。
 
 ### ✨ 惊艳点 #1 —— 实时模式，实时 AI
 
-在管理控制台中添加一个字段。十秒后，向 Sales Copilot 询问与它相关的问题。它已经知道了。无需重新训练、无需重启、无需重新部署 —— 平台在每个智能体回合都会重新读取元数据，而 Copilot 的 `describe_object` 工具一保存就会返回你的新字段。
+在管理控制台中添加一个字段。十秒后，向助手询问与它相关的问题。它已经知道了。无需重新训练、无需重启、无需重新部署 —— 平台在每个智能体回合都会重新读取元数据，而 Copilot 的 `describe_object` 工具一保存就会返回你的新字段。
 
 用我们随附的脚本在 30 秒内试一试：
 
diff --git a/content/docs/whats-new.zh-Hant.mdx b/content/docs/whats-new.zh-Hant.mdx
index 0ba61f5b..50b5760c 100644
--- a/content/docs/whats-new.zh-Hant.mdx
+++ b/content/docs/whats-new.zh-Hant.mdx
@@ -11,7 +11,7 @@ description: 近期發行、新能力，以及即將推出的內容。
 
 ### ✨ 驚艷點 #1 —— 即時結構描述，即時 AI
 
-在管理主控台中新增一個欄位。十秒後，向 Sales Copilot 詢問與它相關的問題。它已經知道了。無需重新訓練、無需重新啟動、無需重新部署 —— 平台在每個智慧代理回合都會重新讀取中繼資料，而 Copilot 的 `describe_object` 工具一儲存就會傳回你的新欄位。
+在管理主控台中新增一個欄位。十秒後，向助手詢問與它相關的問題。它已經知道了。無需重新訓練、無需重新啟動、無需重新部署 —— 平台在每個智慧代理回合都會重新讀取中繼資料，而 Copilot 的 `describe_object` 工具一儲存就會傳回你的新欄位。
 
 用我們隨附的指令稿在 30 秒內試一試：
 
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index d278596f..49b9b05c 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -12,10 +12,9 @@ flowchart TD
   Stack --> Objects["src/objects"]
   Stack --> Actions["src/actions"]
   Stack --> Flows["src/flows"]
-  Stack --> Agents["src/agents"]
   Stack --> Skills["src/skills"]
   Stack --> UI["src/apps, src/views, src/pages"]
-  Stack --> Analytics["src/dashboards, src/reports, src/cubes"]
+  Stack --> Analytics["src/datasets, src/dashboards, src/reports"]
   Stack --> Security["src/profiles, src/sharing"]
   Stack --> Data["src/data"]
   Stack --> Runtime["@objectstack/runtime"]
@@ -31,11 +30,19 @@ The stack manifest defines:
 | --- | --- |
 | id | `app.objectstack.hotcrm` |
 | namespace | `crm` |
-| version | `1.0.5` |
+| version | `2.2.2` |
 | type | `app` |
 | name | `HotCRM` |
+| engines.protocol | `^17.0.0-rc.1` |
 
-Runtime capabilities are declared in `requires`: `ai`, `automation`, `triggers`, `analytics`, `auth`, `ui`, `approvals`, and `sharing`.
+Runtime capabilities are declared in `requires`: `automation`, `triggers`, `analytics`, `auth`, `ui`, `approvals`, and `sharing`.
+
+`ai` is deliberately **not** in that list. ObjectStack 11.3.0 (ADR-0025 S2) moved the
+AI runtime out of the open edition, and under ObjectStack 16 `requires: ['ai']` is
+fail-fast — declaring it would hard-abort `objectstack start`/`dev` for this
+open-edition app. The AI metadata is unaffected: the skills still validate, build into
+the artifact, and run wherever a runtime provides the `ai` tier. See the comment in
+[`objectstack.config.ts`](../objectstack.config.ts) for the full rationale.
 
 ## Metadata Areas
 
@@ -48,7 +55,7 @@ Runtime capabilities are declared in `requires`: `ai`, `automation`, `triggers`,
 | AI skills | `src/skills/*.skill.ts` | `skills` |
 | Apps, views, pages | `src/apps/`, `src/views/`, `src/pages/` | `apps`, `views`, `pages` |
 | Analytics | `src/datasets/`, `src/dashboards/`, `src/reports/` | `datasets`, `dashboards`, `reports` |
-| Security | `src/profiles/`, `src/sharing/` | `permissions`, `sharingRules`, `roles` |
+| Security | `src/profiles/`, `src/sharing/` | `permissions`, `sharingRules`, `positions` |
 | i18n | `src/translations/` | `translations`, `i18n` |
 | Demo data | `src/data/` | `data` |
 
@@ -149,11 +156,15 @@ answering record questions, because admins can change metadata over time.
 
 Security is assembled from:
 
-- permission profiles in `src/profiles/`
-- sharing rules in `src/sharing/`
-- role hierarchy in `src/sharing/role-hierarchy.ts`
+- 6 permission profiles in `src/profiles/`
+- 9 sharing rules in `src/sharing/*.sharing.ts`
+- 12 positions in `src/sharing/positions.ts`
 
-The stack maps `RoleHierarchy.roles` into the ObjectStack `roles` field and registers sharing rules for accounts, opportunities, cases, and territory-style visibility.
+The stack registers sharing rules for accounts, opportunities, cases, campaigns, and
+territory-style visibility, and passes `CrmPositions` to `defineStack({ positions })`.
+Per ADR-0090 D3 positions are flat capability-distribution groups — the v1 role
+hierarchy's parent links are gone, because hierarchy belongs to the business-unit tree,
+which this app does not model.
 
 ## Verification
 
diff --git a/docs/archive/2026-02/SALESFORCE_FEATURE_COMPARISON.md b/docs/archive/2026-02/SALESFORCE_FEATURE_COMPARISON.md
index b8340df6..05ddb03f 100644
--- a/docs/archive/2026-02/SALESFORCE_FEATURE_COMPARISON.md
+++ b/docs/archive/2026-02/SALESFORCE_FEATURE_COMPARISON.md
@@ -2,6 +2,27 @@
 <!-- Archived 2026-02 snapshot — references planning docs that have since been
      removed. Frozen for history; not link-checked. -->
 
+# ⚠️ RETIRED ARCHITECTURE — DO NOT USE THIS DOCUMENT TO EVALUATE HotCRM
+
+> **This document describes a pre-2.x HotCRM that no longer exists.** It was written
+> against a multi-package (`packages/*`) architecture of ~148 business objects, and it
+> marks features as "✅ Implemented" — `sla_policy`, `queue`, `email_to_case`,
+> `pricebook`, four industry verticals, ten connectors, a community portal — **none of
+> which exist in the current tree**. Its headline claim of *~95% Salesforce feature
+> parity* is therefore not a statement about the shipping product.
+>
+> **What HotCRM actually is today:** a single ObjectStack marketplace app built from a
+> flat `src/{type}/` tree — **15 business objects**, 23 flows, 13 actions, 6 AI skills,
+> 4 dashboards, 8 datasets, 6 permission profiles, 12 positions, 9 sharing rules, and
+> 4 locale bundles. See the [README](../../../README.md) for the current product and
+> [docs/ARCHITECTURE.md](../../ARCHITECTURE.md) for the current architecture.
+>
+> This file is kept **only as a historical record** of the direction the project took
+> in February 2026 and later abandoned. Nothing below it is maintained, verified, or
+> a commitment.
+
+---
+
 # HotCRM vs Salesforce: Deep Feature Comparison
 
 > **Version**: 3.0