PRD Author

SkillFiles & storage

ALIAS · Alias skill. Merged into `prd` as of v2.1. This file is kept only for compatibility with older SOP references.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the PRD Author skill

What this skill tells your AI

The instructions your AI receives, as published by charliehzm/medharness in .claude/skills/prd-author/SKILL.md and read by ahel’s review.

Companion to prd-implementation-precheck. Where precheck finds gaps, this skill fills them.

Output structure (canonical PRD skeleton)

# PRD — <change name>

## 0. 元数据
- change_id, owner (PM), date, version
- 引用 COMPLIANCE_TAG.md 与数据等级

## 1. 背景与目标
- 业务问题(事实 + 痛点)
- 这次要解决什么、为什么现在
- 与既有产品/平台的关系

## 2. 用户与场景
- 主要用户角色 + 角色画像
- 核心场景 1-3 个
- 反例场景(这次不解决)

## 3. 功能范围
- In-scope(细到 feature 级)
- Out-of-scope(显式列出)
- Future scope(不在本 change 但未来要做)

## 4. 验收准则
- 业务侧 KPI(baseline + target + 测量方法)
- 用户侧验证(任务完成率、NPS 等)
- 技术侧(性能、可用性、合规通过率)

## 5. 阶段拆分
- Stage 1: 范围 + DoD + 退出准则
- Stage 2: 范围 + DoD + 退出准则
- Stage 3: ...

## 6. 依赖与协作
- 外部依赖(按团队 + 命名 owner + 截止日期)
- 内部依赖(哪些既有模块要改)

## 7. 风险与对冲
- Top 3 风险 + 对冲

## 8. 合规说明
- 链接 COMPLIANCE_TAG.md
- 数据等级
- 模型 allowlist 摘要
- PHI 流向描述

## 9. 关联文档
- TDD、design.md、相关 prototype

Workflow

  1. Anchor — 把用户的 business intent 转成第 1-2 章。
  2. Scope — 第 3 章是 PRD 的灵魂;显式列出 not-doing。
  3. Measurability — 第 4 章的每个 KPI 必须给"如何测"。
  4. Stage — 第 5 章按 "shippable stage" 拆分,不按 "month"。
  5. Compliance link — 第 8 章引用 Step 0 的 COMPLIANCE_TAG,不重复写。
  6. Iterate — 跑 prd-implementation-precheck → 修 blocker/warning → 直到 0/0。

Common failure modes

  1. 抽象目标无 KPI:写"提升用户体验"而无指标。修:每个目标必须给"上线后我们看哪个数字"。
  2. No-out-of-scope:只写做什么不写不做什么。修:每个 in-scope 配一条 out-of-scope。
  3. Stage = 时间切片:错。Stage = 价值切片,每个 stage 上线即有用。
  4. 合规章节空填:写"遵守 HIPAA/PIPL" 而无具体引用。修:必须 link 到 COMPLIANCE_TAG.md 的具体条款。

Signals

GitHub stars
86
Forks
8
Last commit
Jun 2026

Others that do the same job

Advanced
Catalog kind
skill
Gateway key
prd-author
Source
github.com/charliehzm/medharness