通过目标、频率、证据和责任四问选择合适的人机协作方式
Coding
zayn-route
Try it判断任务边界、复用证据并路由合适的 WorkFn Skill
What it does
分析复杂问题,复用已有证据,判断应先使用哪个 Skill,并规划调用顺序、参数传递、停止条件和下一步动作;覆盖客户、报价、订单、售后、内部协作、市场与商业情报,以及依据参考图、视频、网页演示或实体成品进行复现前的技术机制诊断。
The skill document
ROUTE() Skill 路由与编排
1. 基本信息
Skill ID: zayn-route
Display Name: zayn-route
Chinese Name: Skill 路由与编排
Project: WorkFn
Author Prefix: zayn
Category: Skill Orchestration
Version: 0.1.5
Status: Draft for testing
2. 解决的问题
ROUTE() 用于解决以下问题:
- 用户遇到复杂问题,不知道先调用哪个 Skill
- 一个问题可能需要多个 Skill 串联
- 前一个 Skill 的结果没有被正确传给下一个 Skill
- Skill 调用顺序错误
- 信息不足时仍然继续后续分析
- 多个 Skill 重复分析同一问题
- 最终输出 Skill 不明确
- 路由过程越来越复杂,重新变成万能工具
3. 适用场景
适用于:
- 用户的问题涉及多个阶段
- 需要先理解再澄清
- 需要先判断再报价
- 需要先分析客诉再判断责任
- 需要先检查订单再启动交付
- 需要先梳理重点再汇报或决策
- 用户不确定应该调用哪个 Skill
- 需要明确 Skill 调用链和停止条件
- 需要在日报、周报、月报、年中报告、年度报告之间选择正确的汇报 Skill
- 需要在跨部门协同、内部请求、问题升级、领导决策和最终上级沟通之间选择正确路径
- 需要在企业公开调查、合作风险、舆情、匹配度、竞争、市场研究和选品之间选择正确路径
4. 不适用场景
不适用于:
- 一个明确 Skill 已足够解决的问题
- 用户已经明确指定要调用的 Skill
- 只需要执行简单翻译
- 只需要普通总结
- 需要 ROUTE() 自己完成全部业务分析
- 需要自动执行所有 Skill
- 需要创建复杂多 Agent 系统
5. 输入参数
必填参数
| 参数 | 说明 |
|---|---|
| user_problem | 用户当前遇到的问题 |
| desired_outcome | 用户最终希望得到什么 |
| available_context | 当前已有上下文和材料 |
建议参数
| 参数 | 说明 |
|---|---|
| current_stage | 当前处于理解、澄清、判断、决策、执行、沟通、跟踪或复盘阶段 |
| known_facts | 已确认事实 |
| missing_information | 已知缺失信息 |
| existing_outputs | 已经运行过的 Skill 结果 |
| constraints | 时间、权限、风险、数据和业务限制 |
| final_output_type | 最终希望得到回复、报价、汇报、方案、计划或纪要 |
| user_selected_skill | 用户已经指定的 Skill |
| available_skills | 当前项目已有 Skill 列表 |
6. 参数运行要求
正式路由前必须输出参数状态表。
参数状态只使用:
已命中
部分命中
缺失
冲突
待验证
最低运行条件:
- 用户问题基本明确
- 最终目标基本明确
- 当前已有上下文可识别
- 能判断至少一个候选 Skill
- 能识别是否需要停止补充信息
如果用户问题和最终目标都不明确,不得生成 Skill 调用链。
7. 问题类型识别
ROUTE() 必须先判断当前问题属于哪一种或哪几种类型:
- 理解
- 澄清
- 判断
- 决策
- 执行
- 沟通
- 跟踪
- 复盘
- 研究
示例:
客户原话看不懂
属于:
理解
示例:
客户需求不完整,需要确认配置
属于:
澄清
示例:
判断是否值得报价
属于:
判断
示例:
确定价格后生成报价
属于:
执行
8. 单 Skill 优先原则
ROUTE() 必须先判断:
一个 Skill 是否已经足够解决问题。
如果一个 Skill 足够,不得为了展示能力而增加调用链。
例如:
帮我检查这份报价是否完整
只使用:
QUOTE()
例如:
帮我整理会议结论和责任人
只使用:
MINUTES()
9. 多 Skill 调用原则
只有在以下情况下才使用多个 Skill:
- 当前问题包含明显的前后阶段
- 后一个 Skill 依赖前一个 Skill 的输出
- 直接调用后一个 Skill 会缺少关键参数
- 不同 Skill 之间职责明确
- 每一步都有必要性
- 调用链长度合理
第一版建议:
最多推荐 5 个 Skill。
超过 5 个时,应重新检查是否过度设计。
10. Skill 调用链设计
调用链必须说明:
- 顺序
- Skill 名称
- 作用
- 所需输入
- 产出
- 产出传给哪个 Skill
- 停止条件
统一格式:
| 顺序 | Skill | 作用 | 所需输入 | 关键输出 | 输出传给 | 停止条件 |
|---|
11. 参数传递规则
前一个 Skill 的输出传给下一个 Skill 时,必须:
- 只传必要字段
- 不原样传递整段长文本
- 保留已确认事实
- 保留待验证信息
- 保留冲突
- 不把推测升级为事实
- 标明来源 Skill
例如,INTENT_DECODE() 输出:
客户明确表达
客户核心关注点
可能意图
待确认事项
传给 CLARIFY() 时,只保留:
已确认需求
待确认事项
不可过度推断的部分
12. 停止条件
ROUTE() 必须为每个调用链设置停止条件。
常见停止条件:
- 关键参数缺失
- 产品身份无法确认
- 客户需求范围不明确
- 责任状态无法确认
- 价格、库存或交期未确认
- 订单尚未确认
- 用户目标发生变化
- 当前证据不足
- 后续 Skill 不具备最低运行条件
- 企业主体或官方账号无法确认
- 国家、司法辖区、市场、客户群或时间范围不明确
- 关键结论只有单一低质量来源
- 实时数据源不可访问且用户未提供资料
停止时必须明确说明:
- 为什么停止
- 缺什么
- 应该补什么
- 补充后从哪个 Skill 继续
13. 正式路由触发条件
只有同时满足以下条件,才生成完整 Skill 调用链:
- 用户问题明确
- 最终目标明确
- 至少一个候选 Skill 明确
- 关键输入可识别
- Skill 之间有真实依赖
- 调用链没有明显重复
- 已设置停止条件
14. 输出结构
ROUTE() 必须按以下结构输出:
A. 参数完整度结论
只使用:
可直接路由
需要补充关键参数
当前只适合单 Skill
存在冲突,暂不建议继续
B. 参数状态表
列出:
- 用户问题
- 最终目标
- 当前阶段
- 已有材料
- 已有 Skill 输出
- 限制条件
C. 问题识别
当前问题类型:
核心目标:
当前阶段:
D. 单 Skill 或多 Skill 判断
明确说明:
- 一个 Skill 是否足够
- 为什么
- 是否需要调用链
E. 推荐 Skill 链
使用统一表格。
F. 当前先执行哪一步
只给一个当前动作。
例如:
先调用 INTENT_DECODE()
G. 参数传递说明
明确哪些结果传给下一个 Skill。
H. 停止条件
列出必须停止的情况。
I. 最终输出 Skill
明确最终由哪个 Skill 生成结果。
15. 常见路由示例
示例一:客户表达不清,需要回复
INTENT_DECODE()
↓
CLARIFY()
↓
REPLY()
示例二:陌生产品询价并报价
PRODUCT_BRIEF()
↓
CLARIFY()
↓
RFQ()
↓
PRICE()
↓
QUOTE()
↓
REPLY()
示例三:客户压价
INTENT_DECODE()
↓
PRICE()
↓
NEGOTIATE()
↓
REPLY()
示例四:客户投诉并要求退款
COMPLAINT()
↓
RESPONSIBILITY()
↓
RMA()
↓
SOLUTION()
↓
REPLY()
示例五:订单确认后的交付
ORDER()
↓
ORDER_KICKOFF()
↓
DELIVERY()
↓
MEETING()
↓
MINUTES()
示例六:复杂项目汇报
KEYPOINT()
↓
REPORT()
↓
DECISION()
示例七:周期性工作汇报
如果用户已明确周期,优先直接路由到对应专项 Skill:
DAILY_REPORT() / WEEKLY_REPORT() / MONTHLY_REPORT() / MIDYEAR_REPORT() / ANNUAL_REPORT()
如果用户只说“写个汇报”,但周期、对象或目的不明确,先使用:
REPORT()
示例八:跨部门协同后对外回复
CROSS_FUNCTIONAL_COLLABORATION()
↓
REPLY()
如果只是向内部某部门提出明确问题且无承诺、推责或风险判断,可直接使用:
REQUEST()
示例九:向经理或老板沟通
如果用户需要把已整理的事实、建议或请求转化为面向直属主管、经理、部门负责人或老板的最终沟通内容,使用:
UPWARD_COMMUNICATION()
需要先比较方案并请领导拍板时:
DECISION()
↓
UPWARD_COMMUNICATION()
问题超出权限或存在重大风险时:
ESCALATE()
↓
UPWARD_COMMUNICATION()
向平级同事或职能部门提出执行请求仍使用 REQUEST();信息明确的请假、调休、工作安排和普通上级沟通可直接使用 UPWARD_COMMUNICATION()。
示例十:潜在客户公开调查与匹配
先确认公开主体和经营信号:
COMPANY_RESEARCH()
↓
BUSINESS_RISK()
↓
SOCIAL_LISTENING()
↓
COMPANY_FIT()
只有需要继续判断业务投入时,才把匹配结果传给 QUALIFY();优先级和客户策略属于后续阶段,不应一次性强行串联全部 Skill。内部询价、订单、付款和售后历史由 CUSTOMER_PROFILE() 提供,不让 COMPANY_RESEARCH() 重复处理。
示例十一:行业研究到选品
MARKET_RESEARCH()
↓
COMPETITOR_ANALYSIS()
↓
PRODUCT_SELECTION()
只有候选产品已经形成且需要判断真实项目时,再进入 OPPORTUNITY()。如果用户只要求调查某个竞争对手,可直接使用 COMPETITOR_ANALYSIS();如果只要求判断已有候选产品,可直接使用 PRODUCT_SELECTION()。
示例十二:商业情报停止条件
公司同名主体无法区分时,停在 COMPANY_RESEARCH();司法辖区不明时,不进入 BUSINESS_RISK();账户监测缺少上次检查时间时,ACCOUNT_WATCH() 只能执行基线或近期扫描,不得声称发现新增动态;市场地区、产品边界或时间范围不明时,停在 MARKET_RESEARCH() 补问;没有我方供应、资金和交付条件时,不进入正式 PRODUCT_SELECTION()。
示例十三:客户动态到对外跟进
已有明确客户主体、官方来源、我方业务背景和上次检查时间,需要判断新动态是否值得行动:
ACCOUNT_WATCH()
↓
OPPORTUNITY()
↓
FOLLOWUP()
↓
REPLY()
如果只需要扫描、分类和保存账户动态,单独使用 ACCOUNT_WATCH()。只有出现明确项目、需求、预算、时间或采购角色线索时,才进入 OPPORTUNITY();只有动作已经确定且用户要求最终表达时,才进入 REPLY()。招聘、参展、普通转发或节日内容不得直接触发完整调用链。
以上示例只是候选路径,不得无条件套用。
16. 风险检查
必须检查:
- 是否推荐过多 Skill
- 是否存在职责重复
- 是否跳过参数检查
- 是否缺少停止条件
- 是否把一个简单问题复杂化
- 是否让 ROUTE() 自己完成业务分析
- 是否把推测继续传给下游
- 是否忽略用户已指定的 Skill
- 是否忽略已有 Skill 输出
- 是否重复询问已经提供的信息
- 是否在主体未确认时继续归因
- 是否把“未找到”传成“不存在”
- 是否将官网自述或匿名评论传成已确认事实
- 是否把过期研究数据当作当前状态
17. 禁止事项
ROUTE() 不得:
- 自动执行全部 Skill
- 直接完成所有业务分析
- 为简单问题创建长调用链
- 推荐超过 5 个 Skill,除非有明确必要
- 跳过前置 Skill 的最低运行条件
- 把前一个 Skill 的全部长文本传给下一个
- 删除冲突信息
- 把待验证信息写成确定事实
- 强行使用所有现有 Skill
- 覆盖用户指定的合理路径
- 在关键信息不足时继续后续流程
- 把路由器重新做成万能工具
18. 人工判断边界
- 用户可以指定或修改路由
- 用户可以跳过某个 Skill
- 人工确认事实优先
- ROUTE() 只能建议,不得强制执行
- AI 不得修改原始材料
- AI 不得覆盖已有人工判断
- 所有自动传递内容必须可追溯到来源 Skill
19. 验收标准
一个合格的 ROUTE() 输出必须满足:
- 能识别问题类型
- 能判断一个 Skill 是否足够
- 不为了展示能力增加 Skill
- 调用顺序合理
- 参数传递清楚
- 每一步有明确作用
- 有停止条件
- 明确当前先做什么
- 明确最终输出 Skill
- 不直接代替业务 Skill
- 不把问题复杂化
- 不把待验证信息传成确定事实
20. 当前状态
Version: 0.1.5
Status: Draft for testing
21. 通用版与行业版选择
先判断用户材料是否包含行业专属证据,再选择 Skill:
- 服务器、存储、内存、SSD、GPU、网络设备、笔记本配件、PN、固件或硬件兼容问题使用
zayn-product-brief;其他实体产品、数字产品或服务使用zayn-general-product-brief。 - 涉及硬件型号、PN、配置兼容、成色、序列号、保修、锁货或二手备件时,使用
zayn-alternative、zayn-availability或zayn-condition;其他行业分别使用对应的zayn-general-*。 - 涉及硬件工程确认、固件、测试、QC、标签序列号、包装和清关时使用
zayn-order-kickoff;普通产品、服务合同或项目启动使用zayn-general-order-kickoff。 - 涉及硬件序列号、测试、安装兼容、保修、维修、换货、退运检测或供应商退换窗口时,使用原硬件售后 Skill;一般产品、服务、订阅或项目问题使用对应的
zayn-general-complaint、zayn-general-responsibility、zayn-general-rma或zayn-general-solution。 - 行业证据不足时默认使用通用版,不得仅因用户提到“产品”“库存”“退货”就触发硬件版。
22. 市场与商业情报选择
- 调查企业公开主体、业务、团队、认证和经营信号,使用
zayn-company-research;历史询价、订单、付款和售后仍使用zayn-customer-profile。 - 调查诉讼、处罚、制裁、出口管制、信用和其他合作风险信号,使用
zayn-business-risk;主体或司法辖区不明确时停止。 - 分析社媒、新闻、论坛、客户评论和员工评价,使用
zayn-social-listening;单条或匿名评论不得升级为整体结论。 - 持续检查某一已确认账户相对历史状态的公开变化、判断信号和行动价值,使用
zayn-account-watch;无上次检查时间时只做基线或近期扫描。一次性企业背景调查仍使用zayn-company-research,阶段性舆情分析仍使用zayn-social-listening。 - 已有公司、风险和业务资料,需要判断与我方能力是否匹配,使用
zayn-company-fit;是否值得继续投入由zayn-qualify判断。 - 将具体竞争对手与我方比较,使用
zayn-competitor-analysis;调查单一企业基本信息时使用zayn-company-research。 - 研究行业、地区、客户、产业链、需求、供应、监管和竞争格局,使用
zayn-market-research。 - 已有市场证据和候选产品,需要结合供应、资金、库存、利润、物流和售后能力判断进入机会,使用
zayn-product-selection。 ACCOUNT_WATCH()只把已确认项目、需求、时间窗口、来源和信息缺口传给OPPORTUNITY();不要把招聘、参展或弱信号直接传成采购需求,也不要自行生成最终回复。- 市场情报调用中必须保留主体、来源、日期、事实/推断状态和信息缺口;不得因搜索不到而输出不存在或无风险。
23. AI 任务方案诊断选择
- 用户准备创建 Skill、自动化、程序工具、模板、工作流或 AI 助手,但尚未确认实现方式时,先使用
zayn-ai-task-diagnosis。 AI_TASK_DIAGNOSIS()通过目标、变化频率、数据证据和最终责任四问,判断应采用普通对话、Skill、定时或条件自动化、程序、模板、人工、人机协作或暂时不做。- 用户已经明确指定一个现有 Skill,或请求只是一次性、低风险且可直接完成的简单任务时,不增加
AI_TASK_DIAGNOSIS()。 - 诊断结论为 WorkFn Skill 且任务涉及多个现有 Skill 时,再进入
ROUTE();目标已确认但需要拆解执行步骤时使用PLAN();方案明显过度复杂时使用FOCUS()。 - 数据来源、触发条件、责任人或验收标准不清时,停在
AI_TASK_DIAGNOSIS()补问,不得直接承诺自动化或程序开发。
24. 目标市场客户开发选择
- 判断哪些国家、地区、行业或应用场景值得测试、重点开发或暂不进入,使用
zayn-market-opportunity。宏观市场结构与趋势研究仍使用zayn-market-research。 - 把目标市场和我方能力转成“要找哪类公司”的可搜索画像,使用
zayn-target-customer-profile。整理某个已有客户的历史事实仍使用zayn-customer-profile。 - 已有目标市场、产品或服务和客户画像,需要规划人工搜索关键词、渠道和顺序,使用
zayn-search-strategy;不得将其用于自动批量抓取。 - 用户已人工提供候选公司名称、域名、链接、截图、Excel 或 CSV,需要去重、核验和筛选,使用
zayn-company-screening。单一企业深度公开调查仍使用zayn-company-research。 - 公司已被人工确认,且需要规划联系部门、岗位、查找路径与开发角度,使用
zayn-contact-strategy。最终客户消息由FOLLOWUP()、REPLY()或RELATION()生成。 - 完整业务过程可参考
MARKET_OPPORTUNITY() → TARGET_CUSTOMER_PROFILE() → SEARCH_STRATEGY() → 人工搜索 → COMPANY_SCREENING() → 人工确认 → CONTACT_STRATEGY(),但 ROUTE() 每次只推荐当前阶段真正需要的 Skill,不跨越人工搜索或人工确认节点。 - 未明确产品或服务、目标市场和我方供应能力时,不进入正式市场机会判断;没有候选公司材料时,不进入公司筛选;没有人工确认的公司和证据时,不进入联系策略。
- 不自动批量搜索、不猜测邮箱、不自动发送外联、不自动写入作战池。
25. NETWORKMAP 路由与边界
将 ROUTE() 保持为任务判断和衔接层,将 $zayn-networkmap 保持为独立的公开关系研究 Skill。不要在本 Skill 中复制其搜索方法、多语言检索词、证据等级、名单提取、去重流程或其他研究细节。
25.1 路由前判断
围绕以下五项判断任务:
- 使用场景和用户真正要做的决定
- 已有资料和可复用证据
- 执行前必须完成的判断
- 执行边界和停止条件
- 最小可用输出
优先检查用户提供或已连接的成交、订单、付款、发货、售后、询价、报价、有效沟通、客户记录、人工备注、Obsidian 和 Excel。不得删除原始数据、覆盖人工判断、强行分类,或把疑似信息写成确定事实;新增内容单独输出。
25.2 调用条件
在以下任务中调用 $zayn-networkmap:
- 根据行业查核心展会及近期参展公司
- 根据行业查主要协会、组织及公开会员公司
- 根据公司查近期参加的展会、会议、峰会、赞助或演讲活动
- 根据活动查公开记录中的参展商、赞助商、演讲公司或其他参与公司
- 用公开证据建立行业、展会、协会、活动与公司的关系
范围明确的直接关系研究可直接调用 $zayn-networkmap。完整销售开发、市场研究或客户筛选任务,先由 ROUTE() 确认业务目标与范围,再调用该 Skill;返回后再判断是否进入客户筛选、客户补全、开发策略或停止。
同场公司、协会会员和参展公司只作为发现线索。没有独立的产品匹配、真实业务证据、意向或近期动作时,不得将其判定为潜在客户或自动写入作战池。
25.3 公司跨行业消歧
公司可能涉及多个明显不同的行业时,依次依据本地真实业务记录与人工备注、公司官网业务及产品页面、公司官方新闻和活动记录、其他可信公开资料判断。不得仅凭公司名称、搜索摘要或模型常识确定行业。
如果行业选择会明显改变展会、协会、活动或同场公司结果,在展开名单研究前停止,并提供二至四个选项。每个选项说明行业名称、关联依据、包含范围和排除的相邻业务;推荐一个选项并说明理由,但由用户最终确认。确认前不得调用 $zayn-networkmap 展开名单研究。
仅当用户已指定行业、产品或业务范围足以限定行业,或本地真实业务记录能明确证明范围且不存在明显歧义时,才可直接继续;结果开头仍须声明采用的行业和产品边界。不得用“综合科技”等宽泛标签绕过确认,不得默认采用公司最知名业务,也不得自动纳入相邻产业。
25.4 传递输入
尽可能向 $zayn-networkmap 传递:研究模式;已确认的行业和产品边界;国家或目标区域;公司名称、官网、别名和本地语言名称;时间范围;本地已有资料和真实业务记录;期望输出数量与名单完整度要求。
用户未指定时采用以下默认值:
- 公司近期活动覆盖过去 24 个月
- 周期性展会覆盖最近两个已完成或已正式公布的届次
- 第一轮研究 5 至 10 个高价值展会或协会
- 证据不足的公司或关系留空或标记未确认
- 不为追求名单完整而无限扩大查询
调用前确认公司主体可唯一识别、行业范围已确认、地区和时间窗口足够明确。下游 Skill 无法接收已确认范围或所需输入缺失时,停止并说明缺口;不得形成 ROUTE() 与 $zayn-networkmap 的循环调用。
25.5 返回后的衔接
保留来源、日期、事实与推断状态、范围限制和信息缺口。把 NETWORKMAP() 返回的公开关系作为研究证据,不直接升级为销售结论。只把下一步所需字段传给客户筛选、客户补全或开发策略 Skill;若没有足够的业务行动依据,明确停止。
Related skills
面向硬件、设备、备件和二手产品售后,依据订单、序列号、测试、兼容性、运输安装、合同和保修边界判断当前责任状态,避免证据不足时过早认责;一般产品、服务或项目责任判断使用 zayn-general-responsibility。
面向硬件、设备、备件和二手产品,在问题与责任达到可决策程度后比较远程排查、维修、换货、补发、退款、折扣和延长保修等方案的库存、技术、物流、成本和客户影响;通用售后或服务补救使用 zayn-general-solution。
为已筛选公司规划联系部门、岗位、查找路径与开发角度
面向服务器、存储、内存、硬盘、SSD、GPU、网络设备和笔记本配件等 IT 硬件,基于型号、PN、标签、截图、Datasheet 和已有资料整理用途、关键规格、版本差异、兼容与采购关注点;当用户需要通用产品或服务速览时改用 zayn-general-product-brief。
面向硬件、设备、备件和二手产品投诉,整理订单、型号、序列号、标签、图片视频、测试、兼容性、运输、保修和供应商证据,并判断补证、排查、责任判断或退换路径;一般产品或服务投诉使用 zayn-general-complaint。