pm-docs SKILL.md skillA

pm-docs from konglong87/superpm is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned

mdr add konglong87/superpm/pm-docs@git:20260924.3ac45f5

Pins git:20260924.3ac45f5 in mdr.lock. Pin the fingerprint instead.

Audit grade: A, 17 of 17 checks passed
Kind: SKILL.md skill
Repository: konglong87/superpm
Path: skills/02-solution-design/pm-docs/SKILL.md
Versions recorded: 5
Latest version: git:20260924.3ac45f5, committed Sep 24, 2026
First version recorded: Jul 30, 2026
Size: 12,375 bytes
Repository stars: 86
License: MIT

Use when: 需要输出PRD/BRD/MRD产品文档、方案文档、商业计划文档、需要文档模板 Do NOT auto-select when: 用户用自然语言说"写需求文档""写PRD""帮我设计需求"等新产品请求 → 这些必须先路由到 start-super-pm Direct slash-command use is allowed: 用户显式输入 /pm-docs 时可直接进入，但必须通过本 skill 的前置门禁 Do NOT use when: 文档已完备无需生成、仅需口头讨论无需书面输出.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

## Preamble (run first)

```bash
# 检查前置文档
echo "📊 正在检查前置文档..."

if [ -f "docs/01-需求调研/MVP方案.md" ]; then
  echo "✅ MVP方案 - 已找到"
else
  echo "⏳ MVP方案 - 未找到"
fi

if [ -f "docs/01-需求调研/需求调研报告.md" ]; then
  echo "✅ 需求调研报告 - 已找到"
else
  echo "⏳ 需求调研报告 - 未找到"
fi

if [ -f "docs/01-需求调研/市场调研报告.md" ]; then
  echo "✅ 市场调研报告 - 已找到"
else
  echo "⏳ 市场调研报告 - 未找到"
fi
```

---

## 写入时边界

只讨论时不写文件，启动检查不创建目录。用户要求保存产物时，先确认当前产品、精确输出路径及已有文件的覆盖/追加选择；确认后**仅在实际 Write 前**创建该输出文件的父目录。完整安装可参见 `skills/_shared/artifact-policy.md`，单独安装本 skill 也按本段执行。

---

## 前置门禁

无论从哪个入口进入，都必须执行前置文档检查：

1. 检查 `docs/01-需求调研/` 中是否有 **MVP方案**（黄金路径的必要前置）
2. 如果有 MVP方案 → 读取文档，判断是否与当前用户描述的产品相关
   - 相关 → 前置已满足，继续执行
   - 不相关 → 停止，建议先完成前置流程
3. 如果没有 MVP方案 → 停止，建议先执行 `/pm-brainstorm` → `/pm-demand` → `/pm-mvp`

不得在门禁不满足时生成文档。

---

## 跨 Agent 交互规则

当流程要求与用户交互时：

1. 如果当前环境支持 AskUserQuestion，使用 AskUserQuestion（最佳体验）。
2. 如果当前环境不支持 AskUserQuestion，必须用普通聊天消息提出同样问题。
3. 一次只问一个问题。
4. 提问后必须停止当前回合，等待用户回答（STOP and WAIT）。
5. 不得在用户回答前生成文档、写入 docs。
6. 已有 docs 文件不能替代本轮用户回答。

---

产出要求：关键功能引用已确认的需求或 MVP 条目；标记证据、假设和待决策问题，并为功能写出可验证的验收标准。不要凭空补齐未经确认的用户或数据。

## 执行流程

### 步骤 1: 确定文档类型（主 agent - 用户交互）

使用 AskUserQuestion 询问：

> 您希望生成哪些文档？
>
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add konglong87/superpm/pm-docs@sha256:f634fc76b88e7bda

The line at the top of this page pins the label git:20260924.3ac45f5, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

[![mdr](https://markdownregistry.com/badge/art_5m6ejfxsg752xo2x.svg)](https://markdownregistry.com/a/art_5m6ejfxsg752xo2x)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Jul 30, 2026 and Sep 24, 2026, about one every 14 days.

version	committed	commit	size	audit
git:20260924.3ac45f5 latest	2026-09-24	3ac45f5	12,375 B	A	view · diff
git:20260924.26fb3bb	2026-09-24	26fb3bb	12,063 B	A	view · diff
git:20260924.7250d3a	2026-09-24	7250d3a	12,143 B	A	view · diff
git:20260730.fea8df7	2026-07-30	fea8df7	11,935 B	A	view · diff
git:20260730.1745f93	2026-07-30	1745f93	12,260 B	A	view

Audit of the latest version

A 17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.

pass: Frontmatter block present
pass: Frontmatter declares a name
pass: Frontmatter declares a description
pass: Size between 200 bytes and 200 KB (12375 bytes)
pass: No zero-width or bidi control characters
pass: No instruction hidden inside an HTML comment
pass: No link to an exfiltration or paste host
pass: No credential-shaped string
pass: No instruction to send local credentials anywhere
pass: No text hidden with inline styles
pass: No prompt-injection phrasing
pass: No curl or wget piped into a shell
pass: No recursive delete of root, home or parent
pass: No instruction to read or print local credentials
pass: No base64 blob over 200 characters
pass: No link to a raw IP address
pass: No script tag

Source

GitHub

konglong87/superpm · 86 stars · license MIT · pushed 2026-10-26 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_5m6ejfxsg752xo2x
GET https://markdownregistry.com/api/v1/resolve?ref=konglong87/superpm/pm-docs
GET https://markdownregistry.com/api/v1/blob/f634fc76b88e7bdabf1d23db3140e7bd7a667ae2cb4ff4cc6271b88c3b407df7

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.