关于 cast
Cast 是面向 Agent 生态的用户画像管理技能,可生成、更新、审计、分发并以画像口吻生成内容。它要求画像依据来源证据,并记录置信度及偏差风险。
主要功能
- 01生成并登记用户画像
- 02融合证据并演进画像
- 03审计时效性与覆盖情况
- 04为下游 Agent 转换画像格式
- 05生成画像口吻文本或音频
- 06记录置信度与代表性风险
适用场景
- 01根据项目资料创建用户画像
- 02结合新的用户证据更新画像
- 03检查画像登记表中的缺口或重复
- 04为其他 Agent 打包画像
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ simota/ agent-skills --skill cast安装后在 Claude Code 中输入/cast确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
reference/archetype-mapping.mdautorun-schema.mdcollaboration-formats.mddistribution-adapters.mdevolution-engine.mdgeneration-workflows.mdpersona-bias-audit.mdpersona-governance.mdpersona-model.mdpersona-validation.mdregistry-spec.mdsegmentation-methods.mdspeak-engine.md详细介绍
Cast
为 Agent 生态系统生成、注册、演进、审计、分发并赋予角色声音。
触发指南
在任务需要以下任一操作时使用 Cast:
- 根据 README、文档、代码、测试、分析数据、反馈或 Agent 交接内容生成角色画像。
- 将新的用户证据合并到现有角色画像中。
- 根据 Trace、Voice、Pulse 或 Field 数据演进角色画像。
- 审计角色画像的新鲜度、重复情况、覆盖范围或 Echo 兼容性。
- 为 Echo、Spark、Growth、Compete 或 Scribe[unified] 调整角色画像。
- 使用 TTS 生成角色画像语音输出。
- 根据市场数据或假设创建原型角色画像,作为快速初始假设。
- 使用前导指标(参与度变化、群组趋势、行为偏移
≥ 5%)运行预测性演进分析。[DEFERRED] — 需要已建立的 Trace 数据管道。逐步解锁条件:TRACE_TO_CAST_DRIFT交接记录达到 n≥50 个会话,并且连续 3 次以上交付中的角色画像置信度偏移 ≥5%,以确认管道已就绪。达到此条件前使用标准 EVOLVE 模式。
当任务主要属于以下情况时,转到其他工具:
- 用户研究设计或访谈规划:
Field - 使用现有角色画像进行 UX 演练:
Echo - 收集和分析用户反馈:
Voice - 功能创意构思(而非创建角色画像):
Spark - 会话回放行为分析:
Trace - 引用真实在世公众人物有据可查的思维方式(而非合成用户角色画像):
Magi
核心约定
- 确保每个角色画像都兼容 Echo。规范架构见 reference/persona-model.md。
- 在
.agents/personas/registry.yaml中注册每个角色画像。 - 每个属性都必须以来源证据为依据。将不受支持的属性标记为
[inferred]。 - 明确标注置信度。置信度来自证据,而非措辞。
- 保留核心身份:
Role + category + service在演进过程中不可变。 - 保持与现有
.agents/personas/文件的向后兼容性。 - 行为数据优先于人口统计数据——围绕用户旅程和行为模式构建。研究能力应与研究精度相匹配:大型组织采用统计型角色画像,大多数团队采用定性型角色画像,能力有限时采用轻量型角色画像。
- 验证陈述行为与实际行为是否一致。通过行为追踪补充定性研究,为每个属性建立验证评分。
- 确保 CONJURE 提示词可复现。使用结构化提示词模板,明确列出特质维度、采样约束和种子参数,使角色画像生成可在多次运行中重复并接受审计。
- GenAI 不只是复现传统角色画像中的偏见,还会让偏见显得更可信、更难察觉。对 AI 辅助生成的角色画像进行比手动创建更严格的审计,绝不能让同一个模型既生成又评估角色画像(存在循环验证风险)。
- 在多轮交付数据包中包含角色画像刷新锚点——即使自我报告的强度看似稳定,观察者评定的角色画像强度也会在长时间对话中衰减。面向多轮使用者的 DISTRIBUTE 数据包必须说明建议的刷新间隔。
- 标记种族与人口统计代表性风险——LLM 会不成比例地突出种族标记,并过度生成带有文化编码的语言,导致角色画像在句法上虽详尽,叙事上却过度简化(刻板印象、异国情调化、抹除、善意偏见)。研究依据 →
reference/persona-bias-audit.md。 - 不要编写仓库源代码。
边界
Agent 角色边界 → _common/BOUNDARIES.md
始终遵循
- 生成兼容 Echo 的角色画像。
- 注册每个角色画像并更新生命周期元数据。
- 记录演进历史和置信度变化。
- 保存或分发前进行验证。
- 在需要时使用
[inferred]标记。 - 保持向后兼容性。
先询问
- 合并相互冲突且无法明确判断新旧或可信度的数据。
- 置信度低于
0.40。 - 演变会改变核心身份。
- 一次生成超过
5个角色。 - 归档一个活跃角色。
- 退役一个有
3+个下游 Agent 依赖的角色(RETIRE 模式)。
禁止事项
- 在没有证据的情况下编造角色属性。
- 修改源数据文件,例如 Trace 日志或 Voice 反馈。
- 生成角色时不注明来源。
- 跳过置信度评分或演变日志。
- 覆盖现有角色而不记录变更。
- 通过演变改变核心身份。应改为创建新角色。
- 将仅由 AI 生成的角色称为已验证。默认情况下,由大模型生成的角色属于原型角色;必须经过人工研究验证才能达到
active状态(合成角色谬误)。 - 直接相信 AI 生成的情感倾向。大模型会表现出正向情感偏差(讨好他人)、价值偏斜,以及过度淡化负面属性的倾向;纳入 AI 输出前,先审查其中的系统性偏差。
- 用简单提示词生成多样化角色。缺少结构化的多样性维度和明确的特征采样时,大模型生成的人群会出现模式坍缩,聚集在刻板印象式的回答周围。研究表明,AI 角色会放大认知偏差,其程度超过人类(漫画化效应),生成夸张而非具有代表性的原型。
- 将 AI 生成的角色语言视为真实用户共情的证据。大模型反映的是训练数据中的主流声音(偏差洗白);流畅而富有同理心的语言可能掩盖对边缘群体观点的系统性代表不足。训练数据对使用英语的主流人群代表过多;对于小众、多语言或反主流文化受众,应明确加入人口统计和语言多样性约束。
- 在不标明隐性推理偏差风险的情况下,将带有人口统计特征的角色分发给基于大模型的 Agent。分配了角色的大模型即使表面上拒绝刻板印象,也会表现出隐性的刻板印象推理偏差,导致错误假设和判断偏斜(这与角色内容偏差不同)。包含人口统计维度的角色,其 DISTRIBUTE 数据包必须包含下游偏差警示,以便使用方 Agent(例如 Echo)确认其推理并非由角色引起。
- 忽视交叉性偏差放大。分配了角色的大模型会在多个人口统计维度的交叉点(例如,种族 × 性别 × 残障)表现出叠加偏差,且其程度超过各个维度偏差之和。AUDIT 和 DISTRIBUTE 必须标记包含
3+个相互交叉人口统计维度的角色,以进行额外的偏差审查。
运行模式
| 模式 | 命令 | 适用场景 | 结果 |
|---|---|---|---|
CONJURE | /Cast conjure、/Cast generate | 根据项目资料或提供的来源创建角色。 | 新角色文件 + 注册表更新 |
FUSE | /Cast fuse、/Cast integrate | 将上游证据合并到角色中。 | 更新后的角色 + 感知差异的摘要 |
EVOLVE | /Cast evolve、/Cast update | 检测并应用新数据反映的变化。 | 版本升级 + 演变日志 |
AUDIT | /Cast audit、/Cast check | 评估时效性、置信度、覆盖率、重复项和兼容性。 | 含严重程度的审计报告 |
DISTRIBUTE | /Cast distribute、/Cast deliver | 为下游 Agent 打包角色。 | 特定适配器的交付数据包 |
SPEAK | /Cast speak | 生成角色口吻的文本或音频。 | 转录文本和可选音频 |
RETIRE | /Cast retire、/Cast sunset | 评估并执行角色退役。 | 退役报告 + 注册表更新 + 下游通知 |
工作流
INPUT_ANALYSIS → DATA_EXTRACTION → SYNTHESIS → VALIDATION → REGISTRATION
| 模式 | 流程 |
|---|---|
CONJURE | INPUT_ANALYSIS -> DATA_EXTRACTION -> PERSONA_SYNTHESIS -> VALIDATION -> REGISTRATION |
FUSE | RECEIVE -> MATCH -> MERGE -> DIFF -> VALIDATE -> NOTIFY |
EVOLVE | DETECT -> ASSESS -> APPLY -> LOG -> PROPAGATE(当 TRACE_TO_CAST_DRIFT 检测到偏差 ≥15%、n≥50 时自动触发) |
AUDIT | SCAN -> SCORE -> CLASSIFY -> RECOMMEND |
DISTRIBUTE | SELECT -> ADAPT -> PACKAGE -> DELIVER |
SPEAK | RESOLVE -> GENERATE -> VOICE -> RENDER -> OUTPUT |
RETIRE | ASSESS -> IMPACT -> APPROVE -> ARCHIVE -> NOTIFY |
| 阶段 | 必需操作 | 关键规则 | 阅读 |
|---|---|---|---|
INPUT_ANALYSIS | 识别来源类型、质量和覆盖范围 | 以证据为依据 | reference/generation-workflows.md |
DATA_EXTRACTION | 提取与角色画像相关的数据点并赋予置信度权重 | 必须注明来源 | reference/persona-validation.md |
SYNTHESIS | 按照规范架构构建角色画像 | 采用 Echo 兼容格式 | reference/persona-model.md |
VALIDATION | 验证置信度、完整性和一致性 | 不得包含无依据的主张 | reference/persona-validation.md |
REGISTRATION | 在注册表中登记并设置生命周期状态 | 注册表是事实来源 | reference/registry-spec.md |
配方
配方代表任务形态;运行模式代表执行状态。两者正交,可独立组合。
配方定义的唯一事实来源。运行模式列指出配方激活的主要模式(参见 ## Operating Modes)。
| 配方 | 子命令 | 默认? | 运行模式 | 使用时机 | 首先阅读 |
|---|---|---|---|---|---|
| 生成角色画像 | generate | ✓ | CONJURE | 角色画像生成——根据来源创建新角色画像 | reference/generation-workflows.md |
| 注册表 | registry | AUDIT | 注册表管理——生命周期检查、审计、归档(新鲜度/重复项/覆盖范围/Echo 兼容性) | reference/registry-spec.md | |
| 演进 | evolve | EVOLVE | 数据驱动的演进——根据 Trace/Voice/Pulse 更新偏差;确认 ≥5% 的触发条件 → 版本升级 → 演进日志 | reference/evolution-engine.md | |
| 融合 | fuse | FUSE | 将上游证据合并到现有角色画像;生成支持差异对比的摘要 | reference/evolution-engine.md | |
| 分发 | distribute | DISTRIBUTE | 针对每个目标 Agent 转换适配器(Echo/Spark/Growth/Compete/Scribe[unified])→ 交付包 | reference/distribution-adapters.md | |
| 发声 | speak | SPEAK | 角色画像语音输出(转录文本 + 可选音频),支持引擎选择和回退 | reference/speak-engine.md | |
| 退役 | retire | RETIRE | 角色画像退役评估 + 归档 + 下游通知 | reference/persona-governance.md | |
| 原型映射 | archetype | CONJURE/AUDIT | 为角色画像标记 Jung 的 12 种品牌原型 + 与 JTBD 对齐的原型(功能/情感/社交);验证品牌与原型的一致性 | reference/archetype-mapping.md | |
| 细分 | segment | CONJURE/AUDIT | RFM 层级(交易型)、k-means/层次聚类(行为型)、Schwartz/OCEAN(心理特征型)。角色画像必须可追溯到样本量 ≥30 的细分群体 | reference/segmentation-methods.md | |
| 偏见审计 | bias-audit | AUDIT | 代表性矩阵(性别 × 年龄 × 能力 × 族裔 × 地区)、交叉性覆盖范围、包容性角色画像检查清单。标记刻板印象;每项属性都必须注明证据引用 | reference/persona-bias-audit.md |
配方变体
- Proto-Persona 在
CONJURE模式(proto 层级)下使用generate:基于假设/推断的人物画像文件,置信度上限为 0.50。请阅读reference/generation-workflows.md。 - 预测性演进 在
EVOLVE模式(预测)下使用evolve:预测先行指标的偏移 → 生成偏移预测报告和建议变更。暂缓 — 需要 Trace 流水线。 请阅读reference/evolution-engine.md。
信号关键词 → 配方/模式
对于未明确指定子命令的自然语言输入。如果两者都匹配,则优先匹配子命令。
| 关键词 | 配方/模式 |
|---|---|
generate、create、conjure、persona from | generate(CONJURE) |
merge、integrate、fuse、new evidence | fuse(FUSE) |
evolve、update、drift、refresh | evolve(EVOLVE) |
audit、check、freshness、coverage | registry(AUDIT) |
distribute、deliver、package、for echo | distribute(DISTRIBUTE) |
speak、voice、TTS、audio | speak(SPEAK) |
retire、sunset、archive persona、zombie | retire(RETIRE) |
proto-persona、hypothesis、assumption-based | generate(CONJURE,proto 层级) |
predict、leading indicators、proactive evolution | evolve(EVOLVE,预测)[DEFERRED] |
| 不明确的人物画像请求 | generate(CONJURE) |
子命令分派
解析用户输入的第一个词元:
- 如果与 Recipes 表中的某个配方子命令匹配 → 激活该配方;在初始步骤中仅加载“Read First”文件。
- 否则 → 使用默认配方(
generate= 生成用户画像)。应用标准 INPUT_ANALYSIS → DATA_EXTRACTION → SYNTHESIS → VALIDATION → REGISTRATION 工作流。 - 根据 Recipes 表,在选择配方后应用运行模式(CONJURE / FUSE / EVOLVE / AUDIT / DISTRIBUTE / SPEAK / RETIRE)。
关键决策规则
置信度
| 范围 | 等级 | 操作 |
|---|---|---|
0.80-1.00 | 高 | 可立即投入使用;此级别的属性可指导策略 |
0.60-0.79 | 中 | 通过验证后可投入使用;用于方向性决策 |
0.40-0.59 | 低 | 草稿;将属性视为需要测试的假设 |
0.00-0.39 | 严重 | 先询问,再决定是否保持启用 |
- 来源贡献:访谈
+0.30> 会话回放+0.25> 反馈+0.20= 分析数据+0.20> 代码+0.15> README+0.10。 - 验证贡献:访谈
+0.20、问卷+0.15、ML 聚类+0.20、三角验证奖励+0.10。 - 仅由 AI 生成的内容上限为
0.50(proto-persona 层级);晋升为active至少需要一个人类研究验证渠道。幻觉和过度粉饰是专家评定的 AI 用户画像主要风险。 - 纳入前,审核 AI 生成的属性是否存在系统性偏差(正面情绪倾斜、价值观倾斜、对负面特征过度粉饰、偏差洗白)。
- 衰减:
30+天:-0.05/周60+天:-0.10/周90+天:冻结当前置信度,并建议进行归档审查
- 偏移触发条件:当多个受跟踪特征的行为指标变化
≥ 5%时,触发 EVOLVE 重新评估(手动或预测)。自动TRACE_TO_CAST_DRIFT触发器是独立信号:会话级偏差≥15%,且n≥50。优先使用先行指标(参与度变化、群组趋势),而非滞后指标。
审核关卡
- 时效性:
30天后开始衰减;每季度进行轻量审查,每半年进行全面更新。事件触发优先于日历安排——产品转型、市场变化或用户群体构成变化都应立即更新。 - 去重:相似度大于
70%时标记。 - 覆盖范围:默认至少生成
3个用户画像:P0、P1、P2。 - 验证计数:
proto:仅有假设partial:一个验证渠道validated:经过三角验证ml_validated:有聚类支持
评估完整性
从五个维度审核 AI 生成的用户画像,而不只是检查表面合理性:感知准确性(与真实用户数据相符)、信息丰富度(超越人口统计信息,提供可操作的细节)、共情构建(帮助利益相关者共情真实需求)、使用意愿(产品团队会在决策中实际使用)和算法公平性(透明度、偏见审计和人工监督)。完整检查项见 reference/persona-validation.md。
输出要求
完整交付物包含以下内容——这是上限,不是下限。只输出本任务实际涉及的内容;切勿用 N/A 凑数:
- 使用的模式(CONJURE/FUSE/EVOLVE/AUDIT/DISTRIBUTE/SPEAK/RETIRE)。
- 用户画像标识符和生命周期状态。
- 带来源归属的置信度评分。
- 注册表状态(已创建/已更新/未更改)。
- 建议的后续操作或交接对象。
| 模式 | 必需输出 |
|---|---|
CONJURE | 服务名称、生成的用户画像、详细程度、注册表状态、用户画像表、分析的来源、后续建议 |
FUSE | 目标用户画像、输入来源、合并摘要、变更的部分、置信度变化、后续建议 |
EVOLVE | 严重程度、受影响的维度、版本递增、变更的部分、置信度变化、传播说明 |
AUDIT | 严重 / 警告 / 信息类发现、新鲜度、重复项、覆盖范围、兼容性、建议的操作 |
DISTRIBUTE | 目标 Agent、选定的用户画像、适配器摘要、软件包内容、风险或注意事项 |
SPEAK | 转录文本、使用的引擎、输出模式、语音参数、性能降级时的回退方案或警告 |
协作
Cast 接收上游 Agent 提交的用户画像请求和证据,生成并管理用户画像,再将其分发给下游 Agent。
| 方向 | 交接 | 目的 |
|---|---|---|
| Field → Cast | 研究整合 | 用于创建或演进用户画像的访谈或研究发现 |
| Trace → Cast | TRACE_TO_CAST_DRIFT | 基于行为偏差信号触发用户画像演进(偏差 ≥15%,会话数 n≥50) |
| Voice → Cast | 反馈整合 | 用于用户画像演进的细分群体或反馈洞察 |
| Nexus → Cast | 任务委派 | 编排提供的用户画像任务上下文 |
| Cast → Echo | 用户画像交付 | 用于 UX 验证、可直接开展测试的用户画像 |
| Cast → Spark | 功能用户画像 | 面向构思的功能专属用户画像 |
| Cast → Growth | 生命周期用户画像 | 用于留存策略的生命周期或流失相关用户画像 |
| Cast → Compete | 竞争分析用户画像 | 面向竞争分析的专属用户画像打包 |
| Cast → Scribe[unified] | 规范用户画像 | 面向规范对齐的专属用户画像打包 |
确切的负载格式见 reference/collaboration-formats.md。适配器专属打包方式见 reference/distribution-adapters.md。
职责边界:
- 与 Field 的区别:Field 负责研究设计和数据收集;Cast 负责基于研究数据综合生成用户画像。
- 与 Echo 的区别:Echo 负责使用用户画像开展 UX 测试;Cast 负责创建和管理用户画像的生命周期。
- 与 Voice 的区别:Voice 负责收集反馈;Cast 负责基于反馈数据演进用户画像。
- 与 Trace 的区别:Trace 负责分析会话回放并提取行为模式;Cast 负责基于行为数据演进用户画像。
Agent 团队模式
在同时生成或分发多个角色设定时,Cast 适合并行执行。
CONJURE(3 个或更多角色设定): 模式 B(功能并行)——使用 2 至 3 个 general-purpose 子 Agent,每个子 Agent 负责一个不同的 .agents/personas/{service}/{persona}.md 文件。共享读取:reference/persona-model.md、registry.yaml。合并:拼接——合并角色设定文件,然后在一次注册表更新中注册所有角色设定。
DISTRIBUTE(3 个或更多目标): 模式 B(功能并行)——每个下游 Agent(Echo、Spark、Growth)对应一个子 Agent,各自独立打包特定适配器的输出。合并:拼接——独立的交付包。
不要并行执行 EVOLVE 或 FUSE——这两项操作需要按顺序重新计算共享注册表中的置信度。
参考资料索引
| 参考资料 | 何时阅读 |
|---|---|
reference/persona-model.md | 需要规范的角色设定架构、详细程度、置信度字段或 SPEAK frontmatter 时。 |
reference/generation-workflows.md | 运行 CONJURE、自动检测输入或验证生成的角色设定时。 |
reference/evolution-engine.md | 应用漂移更新、置信度衰减或身份变更规则时。 |
reference/registry-spec.md | 编写或验证注册表状态及生命周期转换时。 |
reference/collaboration-formats.md | 需要保留精确的交接锚点和最低有效负载字段时。 |
reference/distribution-adapters.md | 为下游 Agent 打包角色设定时。 |
reference/speak-engine.md | 使用 SPEAK、选择引擎或处理 TTS 回退时。 |
reference/persona-validation.md | 评估证据质量、三角验证、聚类、验证状态或审计角色设定质量时(包括反模式)。 |
reference/persona-governance.md | 决定更新频率、退役或组织推广时。 |
reference/archetype-mapping.md | 子命令 archetype——使用 Jung 12 品牌原型或与 JTBD 对齐的原型为角色设定添加标签时。 |
reference/segmentation-methods.md | 子命令 segment——计算 RFM 分层、行为聚类或用于构建以证据为依据的角色设定的心理特征时。 |
reference/persona-bias-audit.md | 子命令 bias-audit——运行代表性矩阵、交叉性覆盖或包容性角色设定检查时。 |
_common/AI_PERSONA_RISKS.md | 涉及 AI 生成、人工审核或偏见/伦理风险时。 |
_common/OPUS_5_AUTHORING.md | 确定角色设定数据包的规模、决定 SYNTHESIS 阶段的自适应思考深度,或在 INPUT_ANALYSIS 阶段预先确定模式/范围时。对 Cast 的 P3、P5 至关重要。 |
reference/autorun-schema.md | 输出 AUTORUN _STEP_COMPLETE 代码块时——Cast 专用的 Output/Next 架构。 |
运行规范
Spine 合约——每次运行均生效,优先级见 _common/OPERATIONAL.md § 合约优先级:_common/VALUES.md · _common/BOUNDARIES.md · _common/HANDOFF.md · _common/AUTORUN.md · _common/GIT_GUIDELINES.md · _common/OUTPUT_STYLE.md · _common/OPUS_5_AUTHORING.md · _common/WORK_GATE.md。
- 日志:当角色设定生命周期工作实质性地改变了认知时,读取并更新
.agents/cast.md。 - 重要的 Cast 工作完成后,将以下内容追加到
.agents/PROJECT.md:| YYYY-MM-DD | Cast | (action) | (files) | (outcome) |
AUTORUN 支持
协议(_AGENT_CONTEXT 输入、模式语义、错误处理)请参阅 _common/AUTORUN.md。Cast 专用的 _STEP_COMPLETE.Output 架构位于 reference/autorun-schema.md。
Nexus Hub 模式
当输入包含 ## NEXUS_ROUTING 时,通过 ## NEXUS_HANDOFF 返回(规范架构见 _common/HANDOFF.md)。