recipe-persona

recipe-persona 是一个用于创建或更新用户画像（Persona）的技能，隶属于 shinpr/claude-code-discover 项目。

用途

该技能用于创建或更新用户画像文件，内容涵盖人口统计、情境、JTBD（待完成的任务）、痛点与收益，以及行为模式。它会在可用时整合对现有代码库的分析，以支撑画像的构建。

主要能力

• 画像创建与更新：支持从零开始创建画像，或基于新证据更新已有画像。
• 代码库分析集成：当现有代码能够揭示用户行为时，通过 Agent 工具（subagent_type: "discover:codebase-analyzer"）委派 codebase-analyzer 进行代码分析，识别用户角色与权限、面向用户的功能与工作流、与用户相关的数据模型，以及分析/追踪事件（如存在）。
• 研究资料收集：从现有代码、用户研究（访谈记录或摘要、调查结果、支持工单模式、使用分析、市场研究）以及 VPC 分析中收集资料。
• VPC 映射：从价值主张画布映射客户概况，包括客户任务（功能性、社交性、情感性）、痛点（挫折、障碍、风险）和收益（必需的、预期的、期望的、意外的）。
• 画像起草：使用 design-perspective 技能中 references/persona-template.md 的模板创建画像文件，涵盖人口统计、情境、JTBD、痛点与收益、行为模式以及验证状态。

使用方式

执行协议要求：

1. 当现有代码揭示用户行为时，将代码分析委派给 codebase-analyzer。
2. 遵循所定义的画像流程。
3. 在每个 [STOP — BLOCKING] 标记处停止——展示发现结果，且在用户明确确认前不得继续。

工作流概览：

• 输入（新画像请求 / 画像更新 / 发现触发）
• 1. 情境评估 → 判断是新建还是更新、是否存在现有代码
• 1. 研究资料收集 → 用户数据、访谈、分析数据、代码分析
• 1. 画像起草 → 使用 persona-template.md [停止：用户确认画像]
• 输出：docs/product/personas/persona-[name].md

执行决策流中的情境评估依据输入 $ARGUMENTS 判断：

• 不存在任何画像：从零开始创建——收集用户研究或假设。
• 画像已存在且有新数据：用新证据更新现有画像。
• 存在现有代码库：调用 codebase-analyzer 获取真实用户行为洞察。
• 访谈后 / 调查后：用新的原始研究进行更新。

画像起草阶段会使用模板文件生成画像，包含以下部分：

• 人口统计：角色、经验、技术熟练度、行业
• 情境：环境、频率、时间压力、相邻工具
• JTBD：主要任务、次要任务、社交/情感任务
• 痛点与收益：从研究中映射，并标注严重程度/优先级
• 行为模式：决策方式、采纳倾向、信息来源
• 验证状态：基于研究质量——明确标记假设

[STOP — BLOCKING] 将画像草案呈现给用户以确认，内容包括：完整画像草案、证据来源与置信度、需要验证的假设、与现有机会点（如有）的关联。在用户明确确认之前，不得写入画像文件。

用户批准后：

• 将画像写入 docs/product/personas/persona-[name].md
• 更新任何引用此画像的机会文件
• 若画像情境发生变化，更新旅程图

子代理使用

• codebase-analyzer：当存在带有面向用户功能的现有代码库时使用，目的是对代码中实际用户行为模式进行客观分析（上下文分离带来的好处）。

适用范围

包含：画像创建、画像更新、与 VPC 和代码分析的集成。

不包含：旅程映射、用户故事编写。

完成标准

• 已评估情境（创建还是更新）
• 已收集研究资料（代码分析、用户数据、市场研究，如可用）
• 已起草包含所有模板部分的画像
• 已清晰标记验证状态（基于证据还是假设）
• 用户已确认画像
• 文件已写入 docs/product/personas/