一句话需求 → AI 编程助手真的能照着实现的 PRD，不是模板，是带产品判断的判断书
写在前面
「我想做一个英语单词学习网站」「开发一个 iOS 提词器」「设计一个窦唯官网」——这种一句话需求你扔给 AI 编程助手，要么它回你一堆模板（让你自己填），要么它脑补出一个跟你想法完全不同的产品。
qiaomu-ai-prd 是向阳乔木（@vista8）的最新作品，MIT 协议、开源，2026-06-12 上线 6 天拿了 150 stars。它做的事情是：在你说出 ” 一句话 ” 之后，替你想清楚产品判断，再把判断写成开发者和 AI 都能执行的 11 章 PRD，并提供自检工具保证质量。
它不是 PRD 模板，是「带产品判断的 PRD 生成 Skill」。
一、它解决什么问题
| 维度 | 数据 |
|---|---|
| 仓库 | joeseesun/qiaomu-ai-prd |
| 协议 | MIT |
| Stars / Forks | 150 / 5 |
| 最近 commit | 2026-06-12（活跃） |
| Open Issues | 0 |
| 体积 | 46 KB（轻量） |
| 安装 | npx skills add joeseesun/qiaomu-ai-prd |
| 自检 | `python3 ~/.agents/skills/qiaomu-ai-prd/scripts/lint_prd.py |
一句话定位：把 ” 我有一个 X 的想法 ” → 速读卡 + 11 章 PRD + AI 验收剧本。
二、核心机制：AI 速读卡 + 三层约束 + 验收剧本
这是 qiaomu-ai-prd 最值钱的设计，三层 缺一不可：
1. AI 速读卡（开篇即产品判断）
不是模板填空，是把 ” 产品定位 / 核心循环 / 硬约束 / 推荐默认 / 发挥空间 / 超预期机会 ” 压成一张卡，开发者 / AI 第一眼就能抓到骨架。例（项目自带的 WordPulse 示例）：
产品一句话：一个自带复习节奏的个人词库学习网站
核心循环：导入词库 → 练习 → 标记掌握度 → 自动复习
硬约束：P0 必须完成一次学习和复习闭环
推荐默认：本地优先保存，不要求账号
发挥空间：练习动效、分数反馈、复习完成页可以更有记忆点
超预期机会：生成一张 ” 今日掌握 18 个词 ” 的分享卡
2. 三层约束（不让 AI 跑偏、也不让 AI 太死）
| 层级 | 作用 | 示例 |
|---|---|---|
| 硬约束 | 不能偏离 | “P0 必须完成一次学习和复习闭环 ” |
| 推荐默认 | 默认这么做，特殊场景可调 | “ 本地优先保存，不要求账号 ” |
| 发挥空间 | 大胆做得更好 | “ 练习动效可以更有记忆点 ” |
这三层 = “AI 知道哪里 不能 偏离、哪里 可以 大胆做得更好 ”，是真正能落地的产品判断。
3. 验收剧本（最后一公里）
第十一章 必须 写给实现者，包含诚实的已知未知项和至少 3 条验收剧本。AI 编程助手写完代码后，可以直接照剧本自检。
三、差异化：11 章 PRD + 9 种模式 + lint 自检
11 章结构（不缩水）
| 章节 | 内容 |
|---|---|
| 一 | 产品概述、定位、竞品差异、用户画像、可行性边界 |
| 二 | 顶层布局、核心模块、真实状态、正常路径、失败路径 |
| 三 | 超越竞品的差异化功能，及为什么竞品做不到 |
| 四 | 带 // 注释的数据模型、技术架构、依赖选择理由 |
| 五 | 超预期机会、交互细节、输出系统、P0-P3 优先级 |
| 六 | 数字化性能指标（不是 ” 快 ” 而是 ”2200ms”） |
| 七 | 模块状态（默认 / 激活 / 空 / 错误） |
| 八 | 开发者交接、替换技术原则 |
| 九 | 验收剧本（≥ 3 条） |
| 十 | 已知未知项 |
| 十一 | 给实现者的 ” 实施 ” 说明 |
9 种模式（按需切）
| 模式 | 作用 |
|---|---|
| 深度模式 | 每个模块增加边界情况分析 |
| 精简模式 | 详细写 P0，其余标注待扩展 |
| 前端视角 | 增加组件拆分和状态管理建议 |
| 后端视角 | 增加 API 和数据库设计 |
| 移动优先 | 图示和交互优先按移动端设计 |
| 创意模式 | 保留硬约束，扩展发挥空间 |
| 竞品深挖 | 深入分析竞品弱点和盲区 |
| 商业化 | 增加付费功能和变现路径 |
| 开源友好 | 技术选型优先考虑宽松许可证 |
lint_prd.py 自检
硬性质量门槛：
- 主要模块都有真实内容的 ASCII 图
- 必须含 AI 速读卡 + 三层约束 + 超预期机会
- 模块覆盖默认 / 激活 / 空 / 错误四种相关状态
- 数据模型字段有
//注释，顶层对象含version - 性能指标必须是 数字（不是 ” 快 ”” 流畅 ”）
- 第十一章 ≥ 3 条验收剧本
跑 `python3 scripts/lint_prd.py
## 四、工具能力对照
| 能力 | qiaomu-ai-prd |
|—|—|
| 一句话输入 | ✅ |
| 速读卡输出 | ✅（首屏即产品判断）|
| 三层约束（硬 / 默认 / 发挥）| ✅ 独有 |
| ASCII 布局图 | ✅（带真实内容）|
| 11 章完整 PRD | ✅ |
| 9 种模式切换 | ✅ |
| 数据模型带注释 | ✅ |
| 性能指标数字化 | ✅ |
| 验收剧本 | ✅（≥ 3 条）|
| lint 自检 | ✅ Python 脚本 |
| 已知未知项 | ✅ 第十章 |
| 多平台 | 任何支持 local skills 的 agent |
## 五、对比：传统 PRD 模板 vs AI 编程 prompt
| 维度 | 飞书 /Notion PRD 模板 | Cursor/Cline 直给 prompt | **qiaomu-ai-prd** |
|—|—|—|—|
| 速度 | 慢（手动填模板）| 快（但效果差）| ** 快（1 句话进，11 章出）** |
| 产品判断 | 靠自己 | 靠模型脑补 | ** 替你想 ** |
| AI 可执行 | ❌ 人写给人看 | ⚠️ 散落 prompt | **✅ 11 章结构化 ** |
| 验收剧本 | ❌ 走流程 | ❌ 没剧本 | **≥ 3 条 ** |
| 模式切换 | ❌ 单一模板 | ⚠️ 取决于 prompt | **9 种模式 ** |
| 自检 | ❌ 靠人 review | ❌ | **✅ lint_prd.py** |
| 许可 | 模板供应商 | 看你 prompt | **MIT 开源 ** |
** 结论 **：模板是 ” 工具人 ”，prompt 是 ” 赌 AI”，qiaomu-ai-prd 是 ” 带产品判断的 PRD Skill”。
## 六、实战：3 步跑通
### Step 1：装
“`bash
npx skills add joeseesun/qiaomu-ai-prd
“`
验证：
“`bash
test -f ~/.agents/skills/qiaomu-ai-prd/SKILL.md && echo “OK”
python3 ~/.agents/skills/qiaomu-ai-prd/scripts/lint_prd.py –help
“`
### Step 2：让 agent 读 skill 后写 PRD
> 用 qiaomu-ai-prd 给我写一个英语单词学习网站的 PRD，前端视角 + 移动优先。
输出会包含 11 章 + ASCII 布局图 + 验收剧本。`scripts/lint_prd.py` 跑一遍无错才算完。
### Step 3：交给 AI 编程助手
把 PRD 文件路径丢给 Cursor / Cline / Claude Code，**AI 可以照着实施并自检 **（因为它有速读卡 + 三层约束 + 验收剧本）。
## 七、决策表（按场景推荐）
| 场景 | 推荐 | 理由 |
|—|—|—|
| 你是 PM，想 5 分钟出一份能交给开发的 PRD | ✅ qiaomu-ai-prd | 速读卡 + 11 章 + lint |
| 你是独立开发者，一句话想法 + AI 编程 | ✅ qiaomu-ai-prd + Cursor | AI 可直接照 PRD 实施 |
| 你是大厂 PM，要走 IPD/CMMI 流程 | ❌ | 流程太轻，不够重 |
| 你只是想 brainstorm 几个方向 | ❌ | 杀鸡用牛刀 |
| 你是 toB 商业化产品，要详细财务模型 | ⚠️ + 商业化模式 | 单开 ” 商业化 ” 模式可补 |
| 你是开源独立开发者，担心许可 | ✅ 开源友好模式 | 技术选型优先宽松许可证 |
## 八、风险与坑
1. ** 新项目（6 天）** —— 2026-06-12 才创建，社区尚浅，遇到 bug 大概率要直接看源码或提 issue
2. ** 强依赖 agent 跑通 skills 机制 ** —— 你用的 agent（Claude Code / Codex / Cursor / OpenCode）必须支持本地 skills 目录，否则 SKILL.md 加载不到
3. ** 三层约束需要输入含产品判断 ** —— 如果你只说 ” 做个 X”，没给核心用户和平台，AI 速读卡会偏空；建议补一句 ” 核心用户是 Y，主平台是 Z”
4. ** 性能指标需要联网核查包信息 ** —— lint 会标 ” 未知 ”，别瞎编
5. ** 创意模式 ** 容易过度发挥 —— 如果你想要克制输出，别切这个模式
## 九、总结
**qiaomu-ai-prd 最值得装的 3 个理由 **：
1. ** 速读卡 + 三层约束 ** 让 AI 真的知道你想要什么，不会跑偏也不会太死
2. **11 章 + ASCII 布局图 + 数据模型注释 ** 是 ** 给 AI 看 ** 的 PRD，不是给人填的模板
3. **lint_prd.py + ≥ 3 条验收剧本 ** 让交付有质量门槛，不是 ”AI 自由发挥 ”
先试一周：拿你最近的一个 ” 一句话想法 ” 跑一遍 qiaomu-ai-prd，对比你之前给 Cursor 的 prompt，** 交付质量会让你重新评估 PRD 的位置 **。
## 参考
– [joeseesun/qiaomu-ai-prd · GitHub](https://github.com/joeseesun/qiaomu-ai-prd) — 官方仓库
– [向阳乔木 @vista8 · X](https://x.com/vista8) — 作者 Twitter
– [joeseesun · GitHub](https://github.com/joeseesun/) — 同作者其他工具（乔木画布、aihot 等）
– [qiaomu-ai-prd#installation](https://github.com/joeseesun/qiaomu-ai-prd#%E4%B8%AD%E6%96%87) — npx skills 安装说明
– [scripts/lint_prd.py](https://github.com/joeseesun/qiaomu-ai-prd) — PRD 自检脚本
– [qiaomu-daily-journey](https://github.com/joeseesun/qiaomu_daily_journey) — 同作者日志备份项目
– [Qiaomu-QuickPrompt](https://github.com/joeseesun/Qiaomu-QuickPrompt) — 同作者 Chrome 侧边栏 prompt 管理器