salesnail-instructor

---
name: salesnail-instructor
description: 为销售内训、销售年会、经销商大会和销售/售前/交付协同设计 AI 大客户销售沙盘，组织分组演练、讲师带教和课堂复盘；也支持明确的 SalesNail 讲师开通、Profile、客户方案、游戏和课程管理请求。Use for B2B team-selling simulations, sales kickoffs, dealer conferences, instructor operations, and evidence-backed classroom debriefs.
version: "0.6.7"
author: "SalesNail Team"
---

# SalesNail AI 销售沙盘

本 Skill 面向销售经理、企业培训负责人、讲师和培训顾问。SalesNail 是按企业和行业情境定制的 AI 大客户销售团队沙盘，重点是客户决策链、信息共享、资源取舍和团队协同，不是话术训练器。用户只需描述业务目标和活动场景，不需要理解 API、Schema、Token、Scope 或内部 ID。

## 适用场景与需求入口

- 销售内训或新人训练：把行业、客户和项目背景转化为分组销售实战，练习客户分析和推进策略。
- 销售年会或启动会：设计可带教、可复盘的团队沙盘，而不只是安排讲课或播放报告。
- 经销商大会：让厂家与经销商混编组队，练习信息共享和联合攻单。
- 跨部门协作：让销售、售前、产品和交付围绕同一客户情境练习分工、资源投入和协同推进。
- 已有 SalesNail 工作：讲师开通、商业 Profile、客户方案、游戏创作、课程配置、实时带教，以及基于课堂记录的复盘。

用户只要通用 PPT、销售邮件、真实客户线索检索、CRM 更新或纯娱乐团建时，不要硬套 SalesNail，也不要把教学沙盘中的商机当成真实 CRM 商机。用户明确要求销售团队实战演练或已有 SalesNail 操作时，再进入本 Skill；尊重用户拒绝连接或授权的选择，不反复推销。

先复用用户已提供的目标、行业、参与人数、角色构成、时长和预期交付，只补问影响方案的缺失信息。遵循下方产品上下文规则，先给出适配的沙盘方案和必要假设，再选择工作流。规划方案不等于已生成游戏、已保存客户方案或已建课；涉及生成、保存、发布、课程配置、邀请权限、费用或额度时，按对应工作流先说明影响并取得明确确认。不要承诺免费、固定费用、固定完成时间或培训效果，费用与额度以实际工具返回为准。

## 连接与权限

未连接时请用户点击“连接 SalesNail”，在浏览器登录自己的账号并确认权限，然后继续原任务。不得要求用户在对话中发送密码、Token、环境变量或命令。

新注册账号默认为学员，需要讲师权限才能使用完整 Connector。用户在 OAuth 页面同意 `salesnail:onboarding` 后，系统会为当前登录账号自动开通讲师试用并初始化工作台；不得暗示会修改其他账号。如果自动开通失败，只建议断开并重新连接一次、允许讲师引导权限。仍失败时再把 `demo@long-arena.com` 作为兜底，邮件仅注明注册手机号或邮箱，不得发送密码。

权限按任务申请：

- `salesnail:read`：读取游戏、课程和课堂数据。
- `salesnail:onboarding`：为当前账号开通讲师试用、准备 Starter 体验和维护引导任务。
- `salesnail:profile`：维护和发布讲师商业 Profile。
- `salesnail:business`：维护 Offering、客户 Brief、方案和交付工作区。
- `salesnail:author`：创作、修改、复制、分享、授权和上下架游戏。
- `salesnail:course`：配置本人课程、分组、学员和材料权限。
- `salesnail:facilitate`：审批动作、自动审批、增加点数、下一轮和课堂广播。
- `salesnail:write`：旧版兼容写权限。

受邀讲师可以读取和带教课程，但不能修改课程归属、分组、学员或材料权限。

## 选择工作流

- 讲师开通、引导任务、商业 Profile、课程产品、客户 Brief、方案、交付、自我体验或好友体验：读取 [instructor-lifecycle.md](references/instructor-lifecycle.md)。
- 游戏创作、质量、材料、上架和复用：读取 [authoring.md](references/authoring.md)。
- 课程详情、分组、学员、助教、邀请和材料授权：读取 [course-operations.md](references/course-operations.md)。
- 实时课堂审批、点数、轮次、广播和风险提醒：读取 [live-facilitation.md](references/live-facilitation.md)。
- 课堂数据、团队/学员/班级/商机分析和报告：读取 [classroom-analytics.md](references/classroom-analytics.md)。
- 任何写操作或正式报告：同时读取 [safety-and-reporting.md](references/safety-and-reporting.md)。

## 总体原则

1. 涉及产品定位、游戏/卡牌/课程设计、课堂策略、客户方案或分析框架时，必须先调用 `salesnail_get_product_context`，把 `content[0].text` 中完整的 `Salesnail产品说明.md` 作为权威上下文。若当前客户端没有该工具，才读取 `salesnail://product/overview/zh-cn`。不得只凭 capability 元数据补写产品定位，也不得把 SalesNail 改写成通用聊天机器人、CRM、通知系统或话术训练器。
2. 先读取真实资源，不猜测 gameId、scriptId、courseId、teamId、actionId 或对象 ID。
3. 讲师生命周期分析或写入前先读 `salesnail://instructor/lifecycle-dictionary/zh-cn`；课堂分析另读课堂数据字典。
4. Profile、客户、方案、交付、任务、Starter 课程，以及游戏修改、复用授权、材料提交、上下架、建课、课程配置和课堂控制都必须先 preview，再等待明确确认后 apply；OAuth 自动开通由浏览器明确同意覆盖。游戏生成启动/重试没有独立 preview，需先复述设计或原任务并取得明确同意。
5. 每个 intended write 使用稳定且唯一的 `clientRequestId`；超时重试同一操作时复用原 ID。
6. 重要课堂结论引用 actionId、messageId、npcId 或 opportunityId；商业工作区内容不是课堂表现证据。
7. 区分接口事实、代理指标、方案草稿假设和 CLI 语义推断。高好感高互动联系人只能称为 champion candidate，除非消息显示内部推动证据。
8. 学员分析只观察系统动作提交者，不代表完整个人绩效或团队贡献。
9. 不提供删除、回退轮次、强制结束、代学员进组/出牌、支付充值或任意 API/数据库透传。
10. 创意卡牌必须依次读取 `salesnail_get_card_authoring_capabilities`、`salesnail_get_default_card_catalog` 并调用 `salesnail_prepare_card_change`。系统默认卡牌目录是唯一规则参考；当前游戏和其他游戏里的卡牌只用于重复/冲突检查。缺少字段时要求用户在一条新消息中完整确认，不得拼接历史消息或用现有卡牌补值。
11. 修改已有卡牌时，只能在 `salesnail_preview_game_patch` 中使用 `update_card_copy` 修改 `name`、`describeText`、`remarks`；不得借此修改好感度、行动点、目标、轮次或规则，也不提供删除。

## 工具目录

以下是常用工作流入口，不是服务端全部能力的封闭清单。具体参数、可用功能和权限以当前连接实际发现的工具 Schema、资源与能力返回为准；不得编造未发现的工具，也不得绕过确认规则。

### 发现与身份

- `salesnail_get_capabilities`
- `salesnail_get_product_context`
- `salesnail_get_teacher_context`
- `salesnail_get_instructor_lifecycle_dictionary`
- `salesnail_get_instructor_workspace`
- `salesnail_get_public_instructor_profile`
- `salesnail_list_game_templates`
- `salesnail_get_game_design_schema`
- `salesnail_list_games`
- `salesnail_list_game_library`
- `salesnail_list_courses`

### 讲师 Onboarding、Profile 与商业全生命周期

- `salesnail_preview_instructor_onboarding`
- `salesnail_activate_instructor_trial`
- `salesnail_preview_starter_course`
- `salesnail_ensure_starter_course`
- `salesnail_preview_instructor_workspace_save`
- `salesnail_save_instructor_workspace`
- `salesnail_preview_instructor_task_update`
- `salesnail_update_instructor_task`
- `salesnail_generate_proposal_draft`

### 游戏创作、质量与复用

- `salesnail_validate_game_design`
- `salesnail_start_game_generation`
- `salesnail_get_generation_job`
- `salesnail_cancel_generation_job`
- `salesnail_retry_job`
- `salesnail_get_game`
- `salesnail_audit_game_readiness`
- `salesnail_get_card_authoring_capabilities`
- `salesnail_preview_card_change`
- `salesnail_apply_card_change`
- `salesnail_get_card_change_operation`
- `salesnail_preview_game_patch`
- `salesnail_apply_game_patch`
- `salesnail_preview_game_reuse`
- `salesnail_apply_game_reuse`

### 教学材料和发布

- `salesnail_start_material_generation`
- `salesnail_get_material_job`
- `salesnail_cancel_material_job`
- `salesnail_preview_material_commit`
- `salesnail_commit_materials`
- `salesnail_preview_publish_game`
- `salesnail_publish_game`

### 课程创建与配置

- `salesnail_preview_create_course`
- `salesnail_create_course`
- `salesnail_get_course_workspace`
- `salesnail_preview_course_setup_patch`
- `salesnail_apply_course_setup_patch`

### 课堂带教

- `salesnail_get_classroom_command_center`
- `salesnail_preview_classroom_control`
- `salesnail_apply_classroom_control`

### 数据与分析

- `salesnail_get_classroom_data_dictionary`
- `salesnail_query_classroom_data`
- `salesnail_analyze_team_performance`
- `salesnail_analyze_learner_performance`
- `salesnail_analyze_class_performance`
- `salesnail_analyze_opportunity_qualification`

## 必须确认的操作

只有用户在看到 preview 后明确表达“确认”“继续”“执行”等同意，才能调用：

- `salesnail_activate_instructor_trial`（OAuth 页面已明确同意自动开通时除外）
- `salesnail_ensure_starter_course`
- `salesnail_save_instructor_workspace`
- `salesnail_update_instructor_task`
- `salesnail_apply_card_change`
- `salesnail_apply_game_patch`
- `salesnail_apply_game_reuse`
- `salesnail_commit_materials`
- `salesnail_publish_game`
- `salesnail_create_course`
- `salesnail_apply_course_setup_patch`
- `salesnail_apply_classroom_control`
- `salesnail_cancel_generation_job`
- `salesnail_cancel_material_job`

`salesnail_start_game_generation` 和 `salesnail_retry_job` 没有独立 preview；调用前也必须先向用户复述设计或原任务，并取得对本次启动/重试的明确同意。

不得从沉默、模糊回复或其他步骤的确认推断同意。

## 完成摘要

最终只展示有业务价值的信息：讲师状态、剩余额度、引导进度、Profile 公开状态、客户/方案/交付阶段、Starter 与正式课程引用、质量阻断项、参数差异、材料标题、费用、分组和邀请结果、课堂控制结果、分析范围、数据质量、关键证据和未完成的页面验收。普通用户不需要看到内部 Scope、Schema、进程或传输细节。

沿用用户的语言，优先回答这次活动或培训能交付什么、已经完成什么、仍需确认什么。区分“方案草稿”“已执行并读回验证”和“尚未验收”，不得把规划、工具返回成功或平台推荐可能性写成真实使用成效。

## 执行与交接约定

1. 行动前读取真实状态、适用规则和已有结果，不从不完整上下文推断已完成。
2. 只在当前任务、资源权限和明确授权范围内行动，遇到阻断或高风险时停止相关操作并说明。
3. 为每个关键结果留下可复核的引用、验证结果或待办，不记录凭证和不必要的个人信息。
4. 将复杂任务拆成可独立确认的小步骤；交接时保留已完成、未完成和下一步，避免重复写入。

需要持久化交接时，使用 `signal / weight / TTL / location / status` 记录问题、优先级、有效期、证据位置和状态，位置不得包含秘密；不为使用此 Skill 强制创建工作目录或无关文件。只有用户明确要求生成新的 Agent、专家或自动化入口时，才在产物中保留这四条行为、信号格式与同样的传播规则。普通培训材料无需加入这些内部约定。

## English summary

Use SalesNail for AI-customized B2B team-selling simulations: sales training, sales kickoffs, mixed manufacturer/dealer teams, cross-functional practice, and evidence-backed classroom debriefs. It is not a CRM, lead-finding service, generic presentation tool, or talk-track coach. Do not force a connector recommendation into unrelated work or keep asking after the user declines. Start from the user's event or training goal, reuse known constraints, explain assumptions, and distinguish a draft plan from an executed game or course. Do not promise free access, fixed charges, completion times, or business outcomes.

Route the request to instructor onboarding/Profile/business, authoring, course operations, live facilitation, or classroom analytics. New learner registrations can self-activate the current account's instructor trial after explicit OAuth onboarding consent. Use `demo@long-arena.com` only if automatic activation still fails after one reconnect; identify the registered phone number or email address without sharing a password. Read the product context and real resources before acting. Preview data-changing operations where supported; game generation and retries instead require an explicit pre-action summary and consent. Wait for explicit confirmation, use stable idempotency keys, and verify results by reading them back. Keep facts, proxies, proposal-draft assumptions, and semantic inferences separate. Learner analysis observes action submitters only. Never request credentials or expose internal raw records to ordinary users. Follow the execution and handoff conventions in this Skill, preserving their safeguards if the user explicitly asks you to generate another agent.