vibe-coding-prd-skill

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

vibe-coding-prd-skill

★ 24 Open GitHub ↗

Turn raw requirements and PRDs into coding-agent-ready Markdown PRDs with four confirmation gates.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Vibe Coding PRD Skill

**把需求、原始 PRD、竞品分析和零散想法，整理成 Claude Code / Codex 可直接执行的工程 PRD。**

![Codex Skill](https://img.shields.io/badge/Codex-Skill-111827?style=for-the-badge)
![Output](https://img.shields.io/badge/Output-Markdown-2563EB?style=for-the-badge)
![Workflow](https://img.shields.io/badge/Workflow-4%20Gates-10B981?style=for-the-badge)
![Language](https://img.shields.io/badge/Language-中文-F59E0B?style=for-the-badge)

`帮我写一个用来 vibe coding 的 PRD`

</div>

---

## 它解决什么问题

普通 PRD 往往包含商业背景、汇报话术和大量模糊描述，编码 Agent 仍然需要猜测范围、交互和验收方式。

这个 Skill 会保留工程实现真正需要的信息，并通过四次强制确认，生成边界明确、技术可落地、可以逐条验收的 Markdown PRD。

```mermaid
flowchart LR
    A[需求 / 原始 PRD / 竞品分析] --> B{识别输入类型}
    B --> C[澄清真实需求]
    C --> D[① 需求定义]
    D --> E[② 功能与 MVP]
    E --> F[③ 技术栈]
    F --> G[④ 框架原型]
    G --> H[AI / 传统产品明细设计]
    H --> I[可观察验收标准]
    I --> J[编码 Agent 可执行 PRD.md]
```

## 四个确认关卡

| 关卡 | 确认内容 | 防止的问题 |
|---|---|---|
| ① 需求定义 | 用户、场景、痛点、产品形态、输入输出、不做范围 | 做错产品 |
| ② 功能优先级 | MVP、Next、Later、不做、开发顺序 | 范围无限膨胀 |
| ③ 技术栈 | 前后端、数据库、AI、部署及功能映射 | 技术选型过度复杂 |
| ④ 框架原型 | 页面结构、核心路径、状态与低保真线框图 | 交互理解不一致 |

> 四个关卡没有全部得到用户确认时，Skill 不会输出“最终 PRD”。

## 核心能力

- 自动判断输入属于明确需求、原始 PRD、竞品分析、混合材料还是模糊想法。
- 需求不清晰时，通过选择题逐步确认用户、场景、痛点和产品形态。
- 遇到飞书 Docx / Wiki 链接时，联用 `lark-doc` Skill 读取正文。
- 将原始 PRD 中的功能重排为 `MVP / Next / Later / 不做`。
- 面向技术小白比较技术方案，并把每项核心功能映射到实现技术。
- 输出 ASCII 框架原型；复杂流程可补充 Mermaid。
- AI 产品补充 Agent 工作流、Prompt、Tool、状态记忆和质量验证。
- 传统产品补充角色权限、数据实体、接口、状态流转和异常处理。
- 将验收标准写成“前置条件 → 用户动作 → 可观察结果”。

## 触发方式

自然语言触发：

```text
帮我写一个用来 vibe coding 的 PRD
```

显式触发：

```text
$vibe-coding-prd 把这份需求整理成 Codex 可以直接开发的 PRD
```

也可以提供飞书文档：

```text
$vibe-coding-prd 转写这个原始 PRD：https://example.feishu.cn/wiki/xxxx
```

## 安装

```bash
git clone https://github.com/1killermouse/vibe-coding-prd-skill.git
mkdir -p ~/.codex/skills
cp -R vibe-coding-prd-skill/vibe-coding-prd ~/.codex/skills/
```

重启 Codex 后即可使用。

## 仓库结构

```text
vibe-coding-prd-skill/
├── README.md
└── vibe-coding-prd/
    ├── SKILL.md
    ├── agents/
    │   └── openai.yaml
    └── references/
        └── prd-template.md
```

## 最终产物包含什么

```mermaid
mindmap
  root((Vibe Coding PRD))
    需求定义
      目标用户
      使用场景
      核心痛点
      产品边界
    功能规划
      MVP
      后续阶段
      明确不做
    产品设计
      用户流程
      框架原型
      状态与异常
    技术方案
      技术栈
      数据与接口
      部署与安全
    AI设计
      Agent工作流
      Prompt
      Tools
      质量验证
    交付标准
      验收用例
      开发顺序
      完成定义
```

## 设计原则

- 不替用户猜产品决策。
- 推荐可以主动，但必须让用户确认。
- 不写商业套话，不堆产品黑话。
- 不使用“体验良好”这类不可验证的验收标准。
- 最终文档应让 Claude Code / Codex 无需猜测范围、顺序和交互结果。

vibe-coding-prd-skill

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README