pd

Data Community
Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Data
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
94 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@majiayu000 · MIT
Token usage
Lean
Setup complexity
Plug-and-play
External API key
Not required
Operating systems
macOS · Linux · Windows
Runtime requirements
Bun
Detected file/system behavior
  • Read-only
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Author source file SKILL.md

# PD - 产品需求文档生成器

创建面向 AI 智能体执行而优化的结构化产品需求文档。

---

## 任务说明

1. 接收用户的功能描述
2. 提出 3~5 个关键澄清问题(带字母选项),每次一组
3. **务必询问质量门禁**(须通过哪些命令)
4. 每次回答后,如需要可继续追问(自适应探索)
5. 在上下文足够时生成结构化 PRD
6. 用 `[PRD]...[/PRD]` 标记包裹 PRD 输出,便于解析

**重要:** 不要开始实现,只生成 PRD。

---

## 步骤 1:澄清问题(迭代进行)

每次只问一组问题。每次回答应影响下一组问题。关注:

- **问题/目标**:解决什么问题?
- **核心功能**:关键行为有哪些?
- **范围/边界**:不应包含哪些内容?
- **成功标准**:如何判断完成?
- **集成方式**:与现有功能如何配合?
- **质量门禁**:每个用户故事须通过哪些命令?(必问)

### 问题格式示例:

```
1. 该功能的主要目标是什么?
 A. 改善用户入门体验
 B. 提高用户留存
 C. 降低支持负担
 D. 其他:[请说明]

2. 目标用户是谁?
 A. 仅新用户
 B. 仅现有用户
 C. 所有用户
 D. 仅管理员
```

这样用户可以用「1A, 2C」快速回答。

### 质量门禁问题(必问)

务必询问质量门禁——它们因项目而异:

```
每个用户故事须通过哪些质量命令?
 A. pnpm typecheck && pnpm lint
 B. npm run typecheck && npm run lint
 C. bun run typecheck && bun run lint
 D. 其他:[请说明你的命令]

对于 UI 故事,是否需要包含浏览器验证?
 A. 是,用 dev-browser 技能做可视化验证
 B. 否,自动化测试即可
```

### 自适应提问

每次回答后,决定:
- 继续追问(若答案显示复杂度)
- 问新方面(若当前已清晰)
- 生成 PRD(若上下文已足够)

通常需要 2~4 轮问题。

---

## 步骤 2:PRD 结构

按以下章节生成 PRD:

### 1. 引言/概述
简要描述功能及其解决的问题。

### 2. 目标
具体、可衡量的目标(列表)。

### 3. 质量门禁
**关键:** 列出每个用户故事必须通过的命令。

```markdown
## 质量门禁

以下命令对每个用户故事必须通过:
- `pnpm typecheck` - 类型检查
- `pnpm lint` - 代码规范

对 UI 故事,还需包含:
- 使用 dev-browser 技能在浏览器中验证
```

该章节会被转换工具提取,并附加到每个故事的验收标准中。

### 4. 用户故事
每个故事需包含:
- **标题**:简短描述性名称
- **描述**:「作为 [用户],我希望 [功能],以便 [收益]」
- **验收标准**:可验证的「完成」检查清单

每个故事应足够小,能在一次聚焦的 AI 智能体会话中完成。

**格式:**
```markdown
### US-001: [标题]
**描述:** 作为 [用户],我希望 [功能],以便 [收益]。

**验收标准:**
- [ ] 具体可验证的标准
- [ ] 另一条标准
```

**说明:** 不要在单个故事的验收标准里写质量门禁命令——它们在「质量门禁」章节统一定义,转换时自动应用到各故事。

**重要:**
- 验收标准必须可验证,不能模糊
- 「工作正常」不好
- 「删除前按钮显示确认对话框」好
- 每个故事应可独立完成

### 5. 功能需求
按编号列出具体功能:
- 「FR-1:系统必须允许用户……」
- 「FR-2:当用户点击 X 时,系统必须……」

表述明确、无歧义。

### 6. 非目标(不在范围内)
本功能**不**包含的内容。对控制范围很关键。

### 7. 技术考量(可选)
- 已知约束或依赖
- 与现有系统的集成点
- 性能要求

### 8. 成功指标
如何衡量成功?

### 9. 待解决问题
剩余问题或需进一步澄清的部分。

---

## 面向 AI 智能体的写作

PRD 将由 AI 编程智能体执行,因此:

- 表述明确、无歧义
- 用户故事要小(一次会话可完成)
- 验收标准尽量可机器验证
- 若已知,写出具体文件路径
- 引用项目现有代码模式

---

## 输出格式

**关键:** 最终 PRD 用以下标记包裹,便于解析:

```
[PRD]
# PRD: 功能名称

## 概述
...

## 质量门禁
...

## 用户故事
...
[/PRD]
```

**文件命名:** 保存为 `./tasks/prd-[功能名].md` 或建议合适路径。

---

## 示例对话流程

**用户:** 为添加暗色模式创建一个 PRD

**助手:** 好的,我来帮你做暗色模式的 PRD。先问几个问题:

1. 主要目标是什么?
 A. 减少长时间使用的眼疲劳
 B. 跟随系统主题偏好
 C. 提供视觉自定义
 D. 其他

2. 设置是否需要持久化?
 A. 是,保存到配置文件
 B. 否,仅当前会话
 C. 跟随系统偏好

**用户:** 1A, 2A

**助手:** 好的,再问两个:

3. 哪些组件需要支持暗色模式?
 A. 所有组件
 B. 仅主视图
 C. 主视图 + 设置
 D. 其他

4. 每个故事须通过哪些质量命令?
 A. pnpm typecheck && pnpm lint
 B. npm run typecheck && npm run lint
 C. bun run typecheck
 D. 其他:[请说明]

**用户:** 3A, 4A

**助手:** 可以,正在生成 PRD。

[PRD]
# PRD: 暗色模式

## 概述
添加暗色模式以减轻长时间使用的眼疲劳。功能将覆盖所有组件,并将用户偏好在配置文件中持久化。

## 目标
- 在弱光环境下提供舒适的浏览体验
- 主题偏好跨会话持久化
- 对所有组件应用一致的样式

## 质量门禁

以下命令对每个用户故事必须通过:
- `pnpm typecheck` - 类型检查
- `pnpm lint` - 代码规范

## 用户故事

### US-001: 添加主题配置
**描述:** 作为用户,我希望设置首选主题(亮色/暗色),以便跨会话持久化。

**验收标准:**
- [ ] 在配置 schema 中增加 `theme` 字段
- [ ] 支持取值:"light"、"dark"、"system"
- [ ] 默认 "light" 以保持向后兼容

### US-002: 创建暗色主题配色
**描述:** 作为用户,我希望有柔和对比的暗色主题,减轻用眼负担。

**验收标准:**
- [ ] 用灰色调定义暗色配色(非纯黑)
- [ ] 保证足够对比度(WCAG AA)
- [ ] 颜色适用于所有 UI 状态

### US-003: 对所有组件应用主题
**描述:** 作为用户,我希望所有组件遵循我的主题偏好。

**验收标准:**
- [ ] 头部组件使用主题色
- [ ] 主视图使用主题色
- [ ] 设置面板使用主题色
- [ ] 弹窗使用主题色

### US-004: 在设置中添加主题切换
**描述:** 作为用户,我希望在设置中切换主题。

**验收标准:**
- [ ] 设置视图中可见主题选项
- [ ] 修改立即生效,无需重启
- [ ] 修改持久化到配置文件

## 功能需求
- FR-1:主题设置须能从配置文件读取
- FR-2:启动时须应用主题
- FR-3:主题变更须立即生效
- FR-4:所有文本在两种主题下均须保持可读

## 非目标
- 系统主题自动检测(后续增强)
- 除亮/暗外的自定义配色
- 按组件的主题覆盖

## 技术考量
- 若有现成主题能力则复用
- 考虑为 React 组件建 ThemeContext
- 主题切换时尽量减少重渲染

## 成功指标
- 所有组件在暗色模式下正确渲染
- 无无障碍对比度问题
- 主题跨会话持久化

## 待解决问题
- v2 是否应自动检测系统主题偏好?
[/PRD]

---

## 检查清单

输出 PRD 前确认:

- [ ] 已提出带字母选项的澄清问题
- [ ] 已询问质量门禁(必做)
- [ ] 需要时已做追问
- [ ] 已包含「质量门禁」章节及项目专属命令
- [ ] 用户故事足够小且可独立完成
- [ ] 用户故事中未包含质量门禁命令(见质量门禁章节)
- [ ] 功能需求已编号且无歧义
- [ ] 非目标章节界定了清晰范围
- [ ] PRD 已用 `[PRD]...[/PRD]` 包裹

---

## 异常处理

若用户回答不清或不完整:
- 礼貌请求澄清
- 提出换一种问法
- 给出有效回答示例

若用户希望跳过问题:
- 允许跳过可选问题
- 质量门禁信息始终必填
- 在 PRD 中注明所做假设

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.