Lohaslee/dsh-super-pm

dsh-super-pm

dsh-super-pm 是一个面向 DeepSeek Harness（DSH） 的标准插件，用于打包和分发 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 的关系是：

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

插件负责：

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

当前版本不注册自定义 GUI，也不自动执行外部研究。插件注册 15 个 super_pm_* 工具，覆盖决策记忆、项目状态与验证、交付与追溯、PRD 与分享（见下文「工具」）；它们只读写项目内的 .super-pm/ 文件，不发起模型回合也不抓取外部资料。保存动作必须由用户明确授权，产品推理由 Skill 负责，插件负责项目级记忆和可复现的安装、分发和激活。

在 DSH 中安装

从 GitHub 安装

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

固定到已发布版本（推荐用于复核）：

dsh plugin --profile web add github:Lohaslee/dsh-super-pm#v0.8.3

从本地 checkout 安装

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

从 npm 安装

npm 包尚未发布（npm view dsh-super-pm 目前返回 404），发布后才可使用：

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

修改服务端 profile 组合后，需要重启 dsh web。dsh plugin add 已把本包登记进 profile 的 dsh.profile.bundles，挂载点随 profile 走：升级 DSH 不需要改动安装目录里的任何文件。运行时只依赖 base bundle 提供的 tools 与 systemPrompt 两个服务。不要把 /super-pm 当成直接命令：DSH Slash Command 不会发送模型回合。请直接输入产品请求，例如 使用 super-pm，帮我诊断这个产品的留存问题，或直接描述产品决策、0 到 1 想法、功能定义或产品诊断问题。

安装后验证挂载

本包只用官方 bundle 接缝挂载，不依赖任何 dsh-base 改动：

• package.json 的 dsh.bundle.patch 指向包内 cordis.patch.yml；
• dsh plugin add 只把 dsh-super-pm 登记进 profile 的 dsh.profile.bundles；
• 启动时，profile 组合树把包内 patch 的两行都插入：
  • super-pm-tools（name: dsh-super-pm）：注册 15 个 super_pm_* 运行时工具；
  • super-pm-skill-filesystem（name: "@deepseek-ai/dsh-skill-filesystem"，providerName: super-pm-filesystem）：挂载随包的 ./skills。

dsh-base 的 patch 中没有任何 super-pm 条目。可直接验证：

dsh --profile web --dump-config | grep -A7 '^# == dsh-super-pm'

输出应包含以下两行，缺一不可：

# == dsh-super-pm
- id: super-pm-tools
  name: dsh-super-pm
- id: super-pm-skill-filesystem
  name: '@deepseek-ai/dsh-skill-filesystem'

这与 dsh-better-sidebar、dsh-spend、@etony668/dsh-task-board 等可用第三方 bundle 使用同一挂载方式（bundle 自带 patch，自引用包名）。

工具

插件共注册 15 个 super_pm_* 工具，按用途分四组。

决策记忆（4）

项目状态与验证（3）：super_pm_update_state、super_pm_recovery_summary、super_pm_record_validation

交付与追溯（3）：super_pm_prepare_handoff、super_pm_traceability_report、super_pm_product_pulse

PRD 与分享（5）：super_pm_generate_prd、super_pm_save_prd、super_pm_validate_prd、super_pm_share_decision、super_pm_discover_easter_egg

所有工具都要求传入明确的绝对项目根目录。插件不会根据当前 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。

开发与验证

npm install
npm run check
npm run pack:check

npm run check 会检查：

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

验证上游 Skill 来源资料：

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

发布到 GitHub

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

git add .
git commit -m "chore: prepare v0.8.3 release"
git push origin main

创建稳定版本 tag：

git tag v0.8.3
git push origin v0.8.3

建议发布前执行：

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 的版本，并用 dsh --profile <name> --dump-config 确认 super-pm-tools 与 super-pm-skill-filesystem 两行都在组合树中。

项目结构

.
├── 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 与上游仓库 Lohaslee/super-pm。