persona-docs

Persona Docs 是一款专注于产品用户研究的文档生成技能，旨在帮助产品团队在项目启动初期建立清晰的目标用户定义。通过结构化的模板和指导流程，该技能引导用户完成从目标用户画像定义、痛点分析到用户旅程映射的完整文档创建过程，确保产品决策始终围绕真实用户需求展开。

核心用法上，该技能通过分析现有代码库或产品描述，结合交互式提问（如"谁是主要用户"、"解决什么痛点"等），生成包含六大核心组件的标准化文档：目标用户画像、需求痛点、发现路径、入职流程、用户旅程图以及功能接触点。用户可通过 OpenClaw/Moltbot 等平台的 npx 命令安装使用，支持单文件或多文件模式存储于 docs/PERSONA.md 或 docs/personas/ 目录。

显著优点在于其强制性的以用户为中心的设计思维。该技能强调"在产品编码前先定义用户"，通过具体的质量标准和"NEVER Do"清单（如禁止仅描述人口统计特征、禁止创建超过3个初始画像等）避免常见陷阱。文档结构注重可操作性，要求描述足够具体以使团队成员形成一致理解，同时保持迭代灵活性，建议每季度回顾更新。

潜在局限性包括其 T3 来源属性（个人开发者社区项目）带来的权威性相对不足，以及作为文档模板工具无法替代真实的用户访谈和数据验证。此外，技能依赖用户自行提供准确的产品背景信息，若输入偏差可能导致生成的用户画像脱离实际。对于复杂的多角色产品，需要手动处理角色冲突和优先级排序，自动化程度有限。

该技能特别适合产品经理、UX 研究员、初创公司创始人和新加入团队的成员使用。对于处于项目启动阶段缺乏明确方向的产品团队，或需要统一团队对目标用户认知的场景尤为 valuable。也适用于规划重大功能前的需求验证，以及新成员快速理解产品定位的入职培训。

使用风险方面，主要需注意该技能为纯文档工具，生成的用户画像仅为假设性框架，必须结合实际用户反馈验证。长期不更新会导致文档失效甚至产生误导。此外，虽然安装命令涉及 npx 和 shell 操作，但均为用户手动执行示例，无自动执行风险。建议在使用前审查模板内容，确保符合实际产品定位。