pm-clarify SKILL.md skillA

pm-clarify 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-clarify@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/01-demand-insight/pm-clarify/SKILL.md
Versions recorded: 5
Latest version: git:20260924.3ac45f5, committed Sep 24, 2026
First version recorded: Jul 2, 2026
Size: 8,819 bytes
Repository stars: 86
License: MIT

Use when: 有初步需求清单需要细化细节、需明确需求场景和边界条件、需求描述模糊需要结构化 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
# 检查是否有需求调研报告
if [ ! -f "docs/01-需求调研/需求调研报告.md" ]; then
  echo "⚠️  未找到需求调研报告"
  echo ""
  echo "建议先执行 /pm-demand 完成需求调研"
  echo ""
  echo "您可以选择："
  echo "A) 执行 /pm-demand 先完成需求调研（推荐）"
  echo "B) 手动输入需求列表（快速模式）"
fi
```

---

## 写入时边界

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

---

## 跨 Agent 交互规则

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

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

---

## 执行流程

### 步骤 1: 读取前置数据

**如果有需求调研报告**：

使用 Read 工具读取 `docs/01-需求调研/需求调研报告.md`

提取：
- 产品名称
- 目标用户
- 核心痛点
- 初步需求清单

**如果有创意方案库**：

使用 Read 工具读取 `docs/01-需求调研/创意方案库.md`

提取：
- 核心创意方案

**如果没有前置文档**：

进入快速模式，使用 AskUserQuestion 收集需求列表：

> 📝 快速模式 - 请列出核心需求：
>
> 请逐个输入需求，每个需求一行：
> 例如：
> - 快速下单
> - 订单追踪
> - 会员体系
>
> 输入"完成"结束

---

### 步骤 2: 逐个细化需求

**关键原则**：
- 一次只细化一个需求
- 明确使用场景
- 明确边界条件
- 明确验收标准

---

对每个需求，AI 询问以下问题：

**问题 1: 使用场景**

> 需求"{需求名称}"的使用场景是什么？
>
> A) 用户首次使用时
> B) 用户日常使用时
> C) 用户遇到特定问题时
> D) 用户完成特定任务后
> E) 其他（请手动输入）
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add konglong87/superpm/pm-clarify@sha256:185ffc4258b77bb7

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_q6h4lx355dshme4l.svg)](https://markdownregistry.com/a/art_q6h4lx355dshme4l)

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

Versions

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

version	committed	commit	size	audit
git:20260924.3ac45f5 latest	2026-09-24	3ac45f5	8,819 B	A	view · diff
git:20260924.26fb3bb	2026-09-24	26fb3bb	8,507 B	A	view · diff
git:20260730.fea8df7	2026-07-30	fea8df7	8,587 B	A	view · diff
git:20260730.1745f93	2026-07-30	1745f93	8,912 B	A	view · diff
git:20260702.72f7781	2026-07-02	72f7781	8,779 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 (8819 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_q6h4lx355dshme4l
GET https://markdownregistry.com/api/v1/resolve?ref=konglong87/superpm/pm-clarify
GET https://markdownregistry.com/api/v1/blob/185ffc4258b77bb7251e9356c4e062dad254968c6390ec2ef8f877941d2f79a9

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.