pm-user-story SKILL.md skillA

pm-user-story 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-user-story@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-user-story/SKILL.md
Versions recorded: 5
Latest version: git:20260924.3ac45f5, committed Sep 24, 2026
First version recorded: Jul 2, 2026
Size: 9,707 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
# 检查方案设计目录

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

if [ -f "docs/02-方案设计/PRD产品需求文档.md" ]; then
  echo "✅ PRD文档 - 已找到"
else
  echo "⏳ PRD文档 - 未找到"
fi

if [ -f "docs/02-方案设计/功能细节拆解.md" ]; then
  echo "✅ 功能细节拆解 - 已找到"
else
  echo "⏳ 功能细节拆解 - 未找到"
fi
```

---

## 写入时边界

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

---

## 跨 Agent 交互规则

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

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

---

## 执行流程

### 步骤 1: 选择用户故事范围

使用 AskUserQuestion 询问：

> 您需要编写哪方面的用户故事？
>
> A) 全部功能用户故事（基于PRD功能列表）
> B) 单个模块的用户故事（请指定模块）
> C) 单个功能的用户故事（请指定功能）
> D) Epic级用户故事（高层次需求）
> E) 其他（请手动输入）
>
> 💡 提示：
> - Sprint规划 → 推荐单个模块的用户故事
> - 产品规划 → 推荐Epic级用户故事
> - 开发准备 → 推荐全部功能用户故事

记录到变量 `STORY_SCOPE`

---

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

根据范围读取相应文档：

**必需文档**：
- PRD产品需求文档（如果存在）
- 功能细节拆解（如果存在）

**可选文档**：
- MVP方案
- 用户画像

**读取失败处理**：

如果 PRD 文档不存在：

> ⚠️ 未找到 PRD 文档
>
> 用户故事需要明确的功能需求作为输入。
>
> 您可以选择：
> A) 执行 /pm-docs 生成 PRD
> B) 使用功能细节拆解作为输入
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add konglong87/superpm/pm-user-story@sha256:ddf4e70ab5107075

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

3 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	9,707 B	A	view · diff
git:20260924.26fb3bb	2026-09-24	26fb3bb	9,367 B	A	view · diff
git:20260730.fea8df7	2026-07-30	fea8df7	9,447 B	A	view · diff
git:20260730.1745f93	2026-07-30	1745f93	9,772 B	A	view · diff
git:20260702.72f7781	2026-07-02	72f7781	9,639 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 (9707 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_kqvv6nmcbozckroy
GET https://markdownregistry.com/api/v1/resolve?ref=konglong87/superpm/pm-user-story
GET https://markdownregistry.com/api/v1/blob/ddf4e70ab51070759e7e836b14a9db34bfbbce5bbf3fea1acd90dcd347462d9a

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.