前言¶
写技术方案的人多半遇过这种情况:方案本身没问题,但给不同的人讲效果完全不同。跟工程师讲,对方关心实现路径;跟管理层讲,对方关心投入产出;给新人讲,对方连术语都没听过。靠人工改稿,一份方案能改出三四版,改到最后连信息点都对不齐。
下面介绍的 Skill「说人话/说行话/说官话」就是为这件事准备的:输入一份方案,输出三个面向不同角色的版本,并且保证每个版本信息量一致。
这是什么¶
一句话定位:把同一个方案按执行者、决策者、新人三类角色视角分别改写,同时生成三个独立版本。
- 名称:说人话/说行话/说官话
- 坐标:@user_fa14b5bc/tri-lingual-mode
- 版本:1.0.0
- 来源:community(社区发布,非官方团队出品)
- 发布者:user_fa14b5bc
- 分类:content-creation
- 标签:requires_api_key=false,即不需要额外 API Key
- 官方地址:https://api.skillhub.cn/user_fa14b5bc/tri-lingual-mode
- SkillHub 页面:https://www.skillhub.cn/skills/user_fa14b5bc/tri-lingual-mode
截至抓取时,SkillHub 页面显示评分 100000、下载 640、安装 0。安装数为 0,意味着这是刚上架不久的社区 Skill,没有经过大量实际使用验证,这一点在采用前要有预期。
它解决的问题不是「翻译」,而是「同一份内容、多种受众语境的表达转换」。和把文档丢给通用对话模型让它「改得通俗一点」相比,差别在于它固定了三种角色视角,并且要求三个版本信息对齐。
核心功能¶
只列已从资料中核实到的能力:
1、三语翻译引擎按角色生成独立版本。内置三种视角:执行者(关心怎么做)、决策者(关心值不值)、新人(关心是什么)。一次调用产出三个版本,而不是在一段文本里同时说三种话。
2、按角色匹配类比。每个版本会选用该角色熟悉的类比来解释同一个概念,例如面向决策者的版本用成本和收益打比方,面向新人的版本用日常场景打比方。
3、交叉检测。翻译完成后会做一次校验,确保核心信息没有在改写过程中遗漏。这是三个版本之间的一致性约束,也是它比普通改写更可靠的地方。
4、每个版本附带三个追问问题。生成的每个版本末尾会列出「对方听完最可能追问的 3 个问题」,用途是提前准备答辩,而不是等对方问了再补。
5、支持自定义角色画像。内置的是三类默认角色,但可以传任意角色画像,例如投资人、客户、跨部门同事,生成对应的专用版本。
使用方式¶
已抓取资料里没有给出安装命令或配置项,因此这里不写未经验证的命令。SkillHub 页面标注 requires_api_key=false,说明使用时不需要额外申请密钥,具体安装方式以官方页面说明为准。
这类 Skill 基于通用 SKILL.md 格式,接入方式和其它同格式 Skill 一致:把 SKILL.md 放到 Agent 能读取的 skill 目录下,在对话中按 Skill 名称触发即可。不同编辑器的目录路径不同,本文不逐一展开,避免给出核实不到的路径。
调用前需要准备的输入:
1、方案正文,或者要点提纲。
2、本次要生成的角色。用内置三类默认角色,或者给一个自定义画像。
3、触发指令,直接说明需要按哪些角色生成版本。
典型用法¶
以下是按官方资料描述的用法写的示例 prompt,用于说明输入怎么写,不是真实输出记录。
给三类默认角色生成版本:
把下面这份灰度发布方案,按执行者、决策者、新人三个角色分别改写成三个独立版本,要求信息点一致,每个版本末尾列出对方最可能追问的 3 个问题。
【方案正文】
……
自定义角色:
用下面这个角色画像改写方案,输出一个版本,末尾附 3 个该角色最可能追问的问题。
角色画像:预算负责人,关注成本是否可控、有没有隐性支出,不熟悉技术细节。
【方案正文】
……
拿到结果后建议做的两件事:
1、先比对三个版本覆盖的要点是否一致。交叉检测是 Skill 内部的步骤,人工快速扫一遍能确认没有漏掉关键限制条件。
2、用追问问题做预演。三个追问问题可以直接当成答辩清单,逐条准备答复。
适用场景与注意¶
适合的场景:
1、跨角色汇报准备。需要同时面对技术和业务方,一份稿子不够用。
2、给不同层级讲同一件事。向上汇报和向下同步,措辞和重点完全不同。
3、跨部门沟通。对方不了解你的上下文,需要把背景补进去。
4、新人 onboarding 时的技术方案讲解。
需要注意的限制:
1、它是表达转换工具,不改变方案内容。方案本身有逻辑漏洞,改写之后依然有。
2、角色画像需要自己描述清楚。默认三类角色覆盖了常见情况,但面向特定人群(例如法务、采购)时,画像写得越具体,类比匹配越准。
3、交叉检测能减少信息遗漏,但不能替代人工核对。涉及数字、指标、期限的内容,生成后要自己再对一遍。
4、来源是 community,发布者是个人账号,安装数为 0,采用前建议先拿一份真实方案试跑,确认输出风格符合自己的汇报习惯。
5、改写后的文本如果要对外发送,建议自己再过一遍,确认没有在简化过程中丢掉必要的前提条件或风险说明。
结尾¶
这个 Skill 的价值在于把「同一件事讲给不同的人听」这件事变成一次可复用的调用,省掉反复改稿的时间,同时用交叉检测兜住信息一致性。适合需要频繁做跨角色沟通、并且已经有一定方案沉淀的团队和个人。
官方地址:https://api.skillhub.cn/user_fa14b5bc/tri-lingual-mode
SkillHub 页面:https://www.skillhub.cn/skills/user_fa14b5bc/tri-lingual-mode