渐进式产品研究与 SOUL 增量写入 · 创作技能

这个技能解决什么问题

规定按证据层级（已观察事实、暂定解释、工作假设、未知）渐进研究产品，只读检查相关代码与页面，并按增量协议更新 SOUL.md，把过程与截图留在调用方 Memory。明确禁止从功能存在推断用户需求或差异化，也不得一次性臆造完整产品画像。

适用任务

在真实增长任务中，针对当前产品的一小块未知认知做定向研究，产出带来源的证据清单并增量更新 SOUL.md。

需要的输入

先解压完整包，按 SHILIU-INSTALL.md 读取 upstream/collectors/research-product/SKILL.md。现有 SOUL.md 与调用方 Model 的相关 Memory；产品载体（本地仓库路径、原型或线上 URL）；本轮要回答的具体产品问题；可用的截图工具与页面访问条件。

交付内容

新增事实/被修正事实/新假设/仍未知四类清单，每项附来源路径、URL、截图或用户陈述；SOUL.md 的增量 diff；写入调用方 memory/<model>/products/<product-slug>/ 的检查过程与下一步验证动作。

任务示例

研究我们产品的注册流程，确认新用户从落地页到完成注册需要几步、有哪些可见提示，把有证据的结论增量写入 SOUL.md，不确定的标为假设。

输出示例

示意：四类证据清单（事实/修正/假设/未知，各附来源）→ SOUL.md 变更行说明 → Memory 中的检查记录与下一步验证计划。具体结论取决于真实产品，此处不展示。

来源与使用

作者 tsingyuai；许可 Apache-2.0。已核对来源与包结构，未据此宣称完成运行实测。

查看原始来源

机器可读详情 · 读取 SKILL.md · 下载完整技能包

让 Agent 使用这个技能 ↗

技能说明全文

---
name: research-product
description: 渐进式研究当前产品，并把已经稳定、可追溯的产品认知增量写入根目录 SOUL.md。首次接入产品代码、原型或线上 URL，需要确认产品形态与已有能力，或某个增长 loop 在执行中发现新的产品事实、用户场景、问题与价值证据时使用。不得一次性臆造完整产品画像，也不得仅凭代码功能推断用户、问题或价值。
---

# 渐进式产品研究

目标不是完成一份产品报告，而是让 Agent 在真实执行中逐步认识产品。每次只研究当前任务需要的部分，并更新能够跨轮次复用的稳定认知。

## 证据层级

按以下顺序区分，不得混写：

1. **已观察事实**：代码、配置、路由、界面、公开页面、真实数据或用户明确陈述直接支持。
2. **暂定解释**：多条事实共同支持，但仍需要使用或市场证据验证。
3. **工作假设**：为了推进当前 loop 提出的可能用户、问题、场景或价值，必须写明验证方式。
4. **未知**：没有证据时保留“未知”，不为了填满 SOUL 而补齐。

代码通常只能直接证明产品形态、组成和可见能力。不得从“存在某功能”直接推断“用户最需要它”“它解决了某个核心问题”或“这是产品差异化”。

## 每次执行

1. 读取现有 `SOUL.md` 和当前 Model 的相关 Memory，确定这次真正缺少哪一小块产品认知。
2. 定位产品载体：当前/相邻本地仓库、用户指定路径、原型、线上 URL 或用户描述。
3. 只读检查与问题直接相关的代码、文档、路由、配置和页面，不进行无目标的全仓扫描。
4. 需要验证可见行为时，让调用方 Model 使用 [screenshot-assets](../../executors/screenshot-assets/SKILL.md) 获取真实页面证据；截图和本次研究记录进入该 Model 的 Memory。
5. 列出“新增事实 / 被修正事实 / 新假设 / 仍未知”，每项附来源路径、URL、截图或用户陈述。
6. 按 [SOUL 增量写入协议](references/soul-update.md) 修改 `SOUL.md`。只更新本轮有新证据的字段，不重写整份文件。
7. 将带时间的检查过程、证据清单和下一步验证动作写入调用方 Model 的 `memory/<model-name>/products/<product-slug>/`。

## 写入边界

- `SOUL.md`：产品的稳定认知、明确假设、关键未知和证据链接。
- Model Memory：本轮检查过程、截图、页面状态、临时分析、冲突证据和后续验证任务。
- 产品仓库：产品实现本身；除非用户要求修改，不因研究而写入。
- Collector：只维护研究方法，不保存某个产品的事实。

发现冲突时保留旧说法和新证据，先降级为“待验证”，不要静默覆盖。用户明确纠正产品事实时，记录为用户陈述，并在能验证时补上产品证据。

## 交付

报告本轮实际研究了什么、SOUL 哪些行发生变化、哪些结论仍只是工作假设、证据保存在哪里，以及下一次应在什么真实行动中验证。不要宣称已经“完整理解产品”。

技能是任务材料，不会自动授予账户权限、付费授权或其他系统权限。请让 Agent 按说明核对依赖，再在授权范围内使用。