Metodologia de Design de Produto
yideng-xl/jg-product-design-skills
Fluxo completo de design: requisito → PRD → protótipo → tarefas
Ver no GitHubSuite de skills para transformar requisitos brutos em PRD estruturado e protótipos HTML de alta fidelidade. Implementa fluxo completo: requisito → PRD → protótipo → tarefas em sistema de rastreamento, com suporte a versionamento e distribuição automática em equipes.
Instalação
npx convez-ai yideng-xl/jg-product-design-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Transformar requisitos vagos em PRD estruturado com sete passos metodológicos
- Gerar protótipos HTML de alta fidelidade a partir de PRD finalizado
- Sincronizar PRD com sistema de rastreamento (Zentao) para distribuição a desenvolvedores
Veredito

Skill robusto e maduro para equipes de produto que precisam padronizar e acelerar o fluxo de design. Inclui automação de versionamento e distribuição, adequado para organizações com processos estabelecidos.
README
A tradução para o português deste README ainda está na fila.
jg-product-design-skills
产品设计方法论 Claude plugin。从粗需求到 PRD、从 PRD 到高保真原型的完整工作流。
维护者维护、git 发布、团队自动更新。
包含的 skill
| Skill name | displayName | 触发场景 | 文件 |
|---|---|---|---|
requirements2prd | 粗需求到PRD | 用户给一句话粗需求,需要做成可评审的 PRD | skills/requirements2prd/SKILL.md |
prd2prototype | PRD到原型 | 有了 PRD,需要做 HTML 原型用于产品评审 | skills/prd2prototype/SKILL.md |
prd2zentao | PRD到禅道需求 | PRD 定稿后,把第四章产品范围批量同步成禅道研发需求 | skills/prd2zentao/SKILL.md |
工作流(完整闭环)
粗需求(一句话)
↓ 触发 skill: requirements2prd
│ · 需求规模定级(大模块走完整流程 / 具体功能走轻量细化)
│ · 商业本质三问(降本/增效/合规) ← 仅大模块
│ · 五看三定 ← 仅大模块
│ · 苏格拉底式引导讨论
│ · 七步法(5W / 约束 / 数据模型 / 状态机 / 视图 / PDCA / 挂起话题)
│ · 历史债务子框架(优化场景)
↓
PRD 草稿 + 挂起话题 + 术语字典 + 数据模型 + 状态机
↓ 触发 skill: prd2prototype
│ · 七步法(IA / 设计语言 / 共性组件 / 主线先做 / 列宽 / 原型说明分区 / 目的地)
│ · 第 8 步:回写 PRD + 锁定本轮迭代 + 拉通设计/技术/QA
↓
HTML 原型 + PRD 终稿 + 本轮迭代范围 + 设计/技术/QA 确认
↓ 触发 skill: prd2zentao
│ · 确认目标产品 productID / 模块 moduleID / 来源
│ · 按 PRD 第四章拆需求 → 字段映射 → API 批量 upsert
│ · 模块只到二级 / needNotReview / 验证落位
↓
禅道研发需求(开发可领、可估、可追踪)
↓ 开发
代码实现
安装(团队成员一次性配置)
方式一:Claude Code(推荐)
cd ~/.claude/plugins/
git clone https://github.com/yideng-xl/jg-product-design-skills.git
Claude Code 启动时会自动扫描 ~/.claude/plugins/ 下的 plugin,识别 plugin.json,加载 skills。
方式二:Cowork mode
在 Cowork 的 plugin 管理界面里:
- 选择"从 git URL 导入" → 填仓库地址
https://github.com/yideng-xl/jg-product-design-skills - 或下载压缩包后选择"本地导入"
触发(团队成员日常使用)
自动触发(推荐)
Claude 在看到用户消息里包含 description 关键词时,会自动加载对应 skill:
requirements2prd的关键词:粗需求 / 做 PRD / 产品方案 / 新模块设计 / 需求拆解 / 产品需求文档 / requirements / PRDprd2prototype的关键词:做原型 / HTML 原型 / 高保真原型 / 产品评审 / 原型规范 / prototype / mockupprd2zentao的关键词:同步禅道 / 建禅道需求 / 把 PRD 提到禅道 / 批量提研发需求 / 需求落禅道 / zentao
用户:"老板说要做一个 X 模块,你帮我做个 PRD" Claude:[自动加载 skills/requirements2prd/SKILL.md,按七步法开始]
显式触发
/requirements2prd
/prd2prototype
维护者发布流程
推荐用一键脚本
release.sh。它会自动堵住三类历史坑:版本号漂移(plugin.json 与 marketplace.json 不一致)、空壳 tag(tag 指向旧 commit、内容是旧的)、漏提交(本地改了 skill 但忘了 commit,同事更新时拉不到)。
一键发布(推荐)
每次有新踩坑 / 新最佳实践要沉淀进 skill:
# 1. 改 SKILL.md 内容(补踩坑案例 / 改检查清单等)
vim skills/requirements2prd/SKILL.md
# 2. 在 CHANGELOG.md 顶部写好本版本条目(脚本会强制检查,没写就拒绝发布)
# PATCH 改文案/补案例 → 1.9.0 -> 1.9.1
# MINOR 加检查清单条目 / 新章节 → 1.9.x -> 1.10.0
# MAJOR 七步法变结构 / 加删 skill → 1.x.x -> 2.0.0
vim CHANGELOG.md
# 3. 一条命令发布(版本号同步 + 打 tag + 推送,一气呵成)
./release.sh 1.10.0 "requirements2prd 补充 XX 场景踩坑"
脚本依次执行:校验版本号格式 → 确认 tag 未被占用(本地 + 远端)→ 检查 CHANGELOG 已有该版本条目 → 把 plugin.json / marketplace.json 所有 version 字段同步成新版本 → git add -A 列出全部改动并让你按 y 确认 → commit → 在该 commit 上打 tag → push 当前分支 + tag。
手动发布(脚本不可用时的兜底)
# 版本号四处必须一致,一个都不能落下
vim .claude-plugin/plugin.json # "version"
vim .claude-plugin/marketplace.json # metadata.version + plugins[0].version
vim CHANGELOG.md # 加新版本条目
git add -A
git commit -m "1.10.0: 一句话说明"
git tag -a v1.10.0 -m v1.10.0 # tag 必须打在含本次改动的 commit 上
git push origin main
git push origin v1.10.0
⚠️ 不要在 GitHub Releases 界面对着旧 commit 单独建 tag —— 那会产生"空壳 tag"(tag 名是新版本,内容却是旧的),Cowork 会拉到错内容。tag 一律由
release.sh或上面的命令在真实 commit 上打。
提交规范
提交消息格式:<version>: <一句话说明>,例如:
1.9.1: 补充 X 项目的"状态机命名冲突"踩坑1.10.0: prd2prototype 增加"无障碍 a11y 检查清单"
Cowork 如何判断"有更新"(机制,实测)
Cowork 追踪的是 git 提交(commit),不是版本号。 这点搞清楚后,"时好时坏"就有解释了:
- 插件菜单
⋮里那行Synced commit: xxxxxxx,就是它当前同步到的 commit。只要追踪分支(main)出现新 commit,它就认为有更新——与版本号是多少无关。 - 界面显示的
Version数字,读的是.claude-plugin/plugin.json的version字段(实测:曾出现 marketplace.json=1.6.0、plugin.json=1.5.0,界面显示 1.5.0)。所以版本号只是"给人看的标签",不参与更新判断。 - 推论:让 Cowork 检测到更新的唯一可靠动作 = 往 main 推一个新 commit。
release.sh每次都产生新 commit 并 push,所以它不只是兜底——它直接产出了 Cowork 依赖的那个触发信号,同时把 plugin.json 版本号一起升,保证界面数字也跟着变。 - tag 不参与 Cowork 的分支同步(tag 不会移动,而 Sync automatically 针对的是会前进的分支)。tag 仍保留,供 Claude Code 锁版本(
git checkout v1.x)和人查阅。
待确认:Cowork 究竟追踪 main 分支 HEAD 还是某个 release——从现象看是分支 HEAD,但无法从本地缓存 100% 证实。验证法:推一个新 commit 但不打 tag,看
Check for updates是否仍能检测到;能,即为追踪分支 HEAD。
团队成员更新流程
Cowork mode(推荐)
- 开启自动同步:插件菜单
⋮ → Sync automatically打开后,维护者往 main 推新 commit,几分钟内自动拉取,无需删除重装。 - 手动检查:
⋮ → Check for updates强制和远端比对并拉取。详情页那个
Update按钮若是灰的,是因为 Cowork 缓存的同步状态还没识别到新 commit;用⋮ → Check for updates才会真正去远端比对。 - 刚 push 完没反应:GitHub 内容接口有几分钟缓存,等 2–3 分钟再点一次
Check for updates。 - 兜底(极少用):仍拉不到时
⋮ → Remove卸载,再用+重新添加 git URL 强制全新 clone。正常流程不该走到这步。
Claude Code
cd ~/.claude/plugins/jg-product-design-skills
git fetch
git log HEAD..origin/main --oneline # 看有什么新提交
cat CHANGELOG.md # 看变更说明
git pull # 确认后拉取
强制锁定某版本
某项目不想被新版本打扰:
cd ~/.claude/plugins/jg-product-design-skills
git checkout v1.9.0 # 锁到指定 tag
文件结构
jg-product-design-skills/
├── .claude-plugin/
│ ├── plugin.json # 插件元信息(version 等;界面 Version 读这里)
│ └── marketplace.json # marketplace 索引(metadata.version + plugins[].version)
├── release.sh # 一键发布脚本(版本号同步 + 打 tag + 推送)
├── CHANGELOG.md # 变更日志(每次升版本必更,release.sh 会强制检查)
├── README.md # 本文件
└── skills/
├── requirements2prd/
│ └── SKILL.md # 粗需求 → PRD 方法论
├── prd2prototype/
│ └── SKILL.md # PRD → 原型 方法论
└── prd2zentao/
├── SKILL.md # PRD → 禅道研发需求 方法论
└── 前期操作手册.md # 装扩展/登录禅道/确认产品 等前置步骤
来源
两个 skill 来自一个真实 B 端项目的完整复盘。原始项目复盘不随 plugin 分发(项目级敏感细节),plugin 内只保留可通用复用的方法论。
维护者
yideng
License
Internal use only.