dsh-super-pm

Readme

# dsh-super-pm

`dsh-super-pm` 是一个面向 **DeepSeek Harness（DSH）** 的标准插件，用于打包和分发 [Super PM](https://github.com/Lohaslee/super-pm) 产品思考 Skill。

它不是一个独立的产品管理系统，也不是简单的提示词集合，而是把 Super PM 的产品分析方法、七套产品视角、双语参考资料和工作流，以 DSH 可安装的插件形式提供给模型使用。

## Super PM 是什么

这个需求是真的吗？用户为什么要放弃现在的做法？如果只能做好一件事，应该是什么？又有哪些东西看起来很诱人，但这次坚决不能做？

AI 可以很快列出功能、写出 PRD，却不一定能陪你把产品真正想明白。有时文档越完整，一个没有被验证的假设反而越像事实。

Super PM 的目标，是陪你分析需求、拆开事实与假设、讨论取舍，把一个模糊想法逐步收敛成可以验证、可以交付的产品方向。

它最初面向独立开发者验证 0 到 1 的产品想法，也适用于已有产品诊断。软件、AI、硬件、服务、内容、平台、企业产品和线下体验，都可以使用这套方法进行讨论。

## 核心能力

- **负向边界优先**：先明确这次绝不能发生、明确不做和不可接受的成本，再讨论功能和方案。
- **区分事实与假设**：分开记录用户原话、事实、推断、建议和待验证假设，不用肯定语气掩盖未知。
- **动态组织产品视角**：只使用能够改变当前判断的产品维度和视角，不机械地让所有角色轮流发言。
- **支持 Lead PM**：可以指定一个产品视角负责整体方向，其他视角负责挑战、补充和识别风险。
- **适配不同产品类型**：根据问题选择需求与价值、产品系统、使用与交付、触点与形态、体验与信任等相关维度。
- **优先验证高风险假设**：先给出最低成本的验证方案，再决定是否进行外部研究、竞品检查或原型验证。
- **支持决策沉淀**：在获得明确授权后，将重要产品决定保存到项目的 `.super-pm/decisions.md`。
- **按需输出产物**：可以生成决策简报、产品报告或面向 AI coding agent 和交付团队的 PRD。
- **知道何时退出**：纯工程实现、翻译、一般事实问答以及需要专业权威的法律和财务结论，不会被强行套用产品视角。

## 七个产品视角

七套产品经验以化名呈现。它们是判断问题的方法，不是真人模拟，也不会为了凑人数轮流发言。

| 产品视角 | 主要关注 |
| --- | --- |
| 乔帮主 | 聚焦、取舍、完整体验、产品品质与叙事 |
| 龙哥 | 人性、克制、自然交互、注意力与社交压力 |
| 梁老师 | 用户状态、情绪驱动力、真需求、系统能力与机会判断 |
| 俞老师 | 用户价值、替换成本、交易结构、优先级与假设验证 |
| 师母 | 本质思考、一手用户洞察、突破机制、内容与推荐产品 |
| 想哥 | 产品定义、核心体验、商业闭环、组织与规模化 |
| 军哥 | 时机、专注执行、性价比、口碑、用户参与与复盘 |

其中“师母”是本 Skill 使用的一套产品视角化名，并非对具体人物的模拟或代言。

## 这是一个 DSH 插件

本项目与上游 `super-pm` Skill 的关系是：

```text
上游 super-pm Skill
        ↓ 随包分发
 dsh-super-pm DSH 插件
        ↓ 安装到 DeepSeek Harness
 DSH 发现 super-pm Skill 并按产品请求加载
```

插件负责：

- 提供标准的 DSH `package.json` 元数据
- 通过 `cordis.patch.yml` 接入 DSH profile
- 挂载插件自带的 `skills/super-pm/` 目录
- 保留中英文参考资料、验证脚本和触发评测
- 让 Skill 可以从 GitHub、npm 或本地 checkout 安装

当前版本不注册自定义 GUI，也不自动执行外部研究。插件额外提供四个轻量的产品决策工具：读取、保存、查看历史和校验 `.super-pm/decisions.md`。保存动作必须由用户明确授权，产品推理由 Skill 负责，插件负责项目级记忆和可复现的安装、分发和激活。

## 在 DSH 中安装

### 从 GitHub 安装

```bash
dsh plugin --profile web add github:Lohaslee/dsh-super-pm
```

### 从本地 checkout 安装

```bash
dsh plugin --profile web add /absolute/path/to/dsh-super-pm
```

### 从 npm 安装

```bash
dsh plugin --profile web add dsh-super-pm
```

修改服务端 profile 组合后，需要重启 `dsh web`。不要把 `/super-pm` 当成直接命令：DSH Slash Command 不会发送模型回合。请直接输入产品请求，例如 `使用 super-pm，帮我诊断这个产品的留存问题`，或直接描述产品决策、0 到 1 想法、功能定义或产品诊断问题。

### 决策工具

| 工具 | 作用 |
| --- | --- |
| `super_pm_read_decisions` | 读取指定项目的当前产品决策 |
| `super_pm_save_decision` | 保存用户明确确认过的产品决策 |
| `super_pm_decision_history` | 查看某个决定及其替代历史 |
| `super_pm_validate_decisions` | 检查决策文件的结构和替代关系 |

所有工具都要求传入明确的绝对项目根目录。插件不会根据当前 `cwd` 猜测项目，也不会跨项目读取 `.super-pm/decisions.md`。保存工具只在用户明确要求保存或修改时执行；方向改变时必须填写变更原因，旧决定会保留并标记为已替代。

## 包含内容

- `skills/super-pm/SKILL.md`：面向模型的完整工作流和行为规则
- `skills/super-pm/references/`：中英文产品视角、路由、验证、决策记忆和 PRD 模板
- `skills/super-pm/scripts/`：上游 Skill 的来源校验脚本
- `skills/super-pm/evals/`：触发行为评测样例
- `lib/decisions-core.mjs`：无 IO 的决策解析、去重、替代链和校验核心
- `lib/decisions-store.mjs`：项目隔离、原子写入的决策文件存储层
- `lib/project-state-core.mjs`：产品状态、验证记录和恢复摘要核心
- `lib/project-state-store.mjs`：状态与验证记录的原子存储层
- `lib/tools.mjs`：八个 DSH 产品决策和交付工具
- `examples/`：在 DSH 中完成产品决策闭环的示例
- `cordis.patch.yml`：挂载 Skill Provider 和产品决策工具
- `lib/index.js`：DSH 插件入口和资源信息
- `scripts/validate.mjs`：插件结构与 Skill frontmatter 校验脚本

## 当前版本

当前版本为 `0.8.0`，新增项目级产品决策记忆、验证记录、恢复摘要、状态管理、Task Board 交付追踪和可分享体验：

- `super_pm_read_decisions`
- `super_pm_save_decision`
- `super_pm_decision_history`
- `super_pm_validate_decisions`
- `super_pm_prepare_handoff`：把确认决策转换为 `board_sync` 任务草稿，不直接修改 Task Board
- `super_pm_recovery_summary`：读取产品状态、当前决策和最近验证，恢复会话上下文
- `super_pm_record_validation`：记录验证假设、方法、阈值、结果和决策变化
- `super_pm_update_state`：更新产品阶段、目标、负责人、开放假设和下一步
- `super_pm_traceability_report`：汇总决策、验证记录和 Task Board 任务的关联关系
- `super_pm_generate_prd`：根据确认上下文生成 PRD 预览，不写文件
- `super_pm_save_prd`：用户确认后保存 PRD
- `super_pm_validate_prd`：校验 PRD 完整性和成熟度
- `super_pm_share_decision`：生成默认脱敏的可分享决定卡
- `super_pm_product_pulse`：返回轻量的方向、证据、边界和行动状态
- `super_pm_discover_easter_egg`：主动发现低干扰彩蛋

分享和趣味功能是 v0.8 的可选体验：用户可以主动生成脱敏的决定卡、查看产品 Pulse，或用模糊表达寻找彩蛋。用户问“有没有什么特别的”时不会直接揭底；真正的彩蛋会在合适的产品里程碑附近偶尔出现，并用不同产品视角的自然引子带出一句短评。它们不自动外发、不联网、不修改项目状态。所有项目工具都要求显式传入绝对项目根目录。只有用户明确要求保存或修改时，插件才会写入 `.super-pm/`。验证记录必须包含观察结果、解释和下一步；PRD 必须先生成预览并校验，用户确认后才保存；Task Board 交付也必须先展示草稿并获得用户确认，再调用 DSH 原生 `board_sync`。

## 开发与验证

```bash
npm install
npm run check
npm run pack:check
```

`npm run check` 会检查：

- JavaScript 插件入口
- package.json 和 DSH bundle 元数据
- Skill frontmatter
- bundle patch 配置
- 随包 Skill 资源布局

验证上游 Skill 来源资料：

```bash
python3 skills/super-pm/scripts/validate_sources.py
```

## 发布到 GitHub

已有 GitHub 仓库时，提交和推送更新：

```bash
git add .
git commit -m "chore: prepare v0.1.0 release"
git push origin main
```

创建稳定版本 tag：

```bash
git tag v0.1.0
git push origin v0.1.0
```

建议发布前执行：

```bash
npm run check
npm run pack:check
python3 skills/super-pm/scripts/validate_sources.py
```

发布新版本时，请同步更新：

- `package.json` 中的 `version`
- `CHANGELOG.md`
- GitHub tag

发布后，建议在干净的 DSH profile 中安装带 tag 的版本，并确认 `/super-pm` 出现在技能目录中。

## 项目结构

```text
.
├── CHANGELOG.md
├── LICENSE
├── README.md
├── README.zh.md
├── .github/
│   └── workflows/ci.yml
├── cordis.patch.yml
├── lib/
│   └── index.js
├── package.json
├── examples/
│   └── 01-dsh-decision-loop.md
├── scripts/
│   ├── test-decisions.mjs
│   └── validate.mjs
└── skills/
    └── super-pm/
        ├── SKILL.md
        ├── agents/
        ├── evals/
        ├── references/
        └── scripts/
```

## 许可证

本插件采用 MIT License。随包的 Super PM Skill 保留上游仓库的许可证和署名背景，详见 [LICENSE](LICENSE) 与上游仓库 [Lohaslee/super-pm](https://github.com/Lohaslee/super-pm)。