PM-K12–skills：产品经理完整工作流 Skill（edu-pm-workflow）

调研日期：2026-09-14 | 数据来源：GitHub API、README.md、SKILL.md 全文、仓库目录树、GitHub 搜索
仓库：https://github.com/beautfulmt/PM-K12--skills

一句话定位

“把一句需求描述逐步落成可评审、可截图、可持续迭代的产品交付物”：一个面向产品经理的通用 Agent 工作流 Skill——从需求调研分析 → PRD → 交互原型 → 业务/交互流程图 → 功能验收清单 → 数据分析，全流程输出可直接评审的 HTML 工件，而非纯提示词。

💡 一句话价值：让 AI 助手不只是“帮写 PRD 文本”，而是产出带骨架校验、可交互预览、可一键复制带原型图的工程级 PRD 交付物；仓库名 PM-K12 中的 K12 即作者所在在线教育场景（skill 内部名 edu-pm-workflow）。

1. 项目背景

  • ⭐ 86★ · 14 fork · 0 issue（2026-09-14 GitHub API 实测）· 无 LICENSE · 主语言 Python
  • 创建于 2026-04-12，最后推送 2026-09-13（发布 v3.1，服务运行时 3.3.0；09-13 还有 Chrome 导出修复——持续活跃维护）
  • 作者：beautfulmt（2026-02 注册，共 3 个公开仓库，无公开姓名/简介）：
    • PM-K12--skills（本仓库，86★）
    • k12-decision-roundtable（1★，K12 在线大班课决策圆桌 Codex Skill）
    • edu-app-competitor-intelligence（0★，教育 App 竞品情报）
    • → 判断为 K12 在线教育产品经理，本 skill 是其在真实业务中打磨出来的工作流
  • 定位：单工作流深挖型 Skill——不是技能集合，而是围绕“一条需求”的 4 条分支工作流（PRD / 需求挖掘 / 验收 / 数据分析）+ 一套本地导出服务

仓库结构（33 个文件）：

目录/文件 作用
SKILL.md 主 skill 说明书（17KB，含路由表、每分支硬规则、防呆清单）
assets/workflows/edu-pm-{prd,demand,acceptance,data-analysis}.md 4 条分支工作流规范（安装进项目后放 .agents/workflows/，可编辑）
assets/templates/prd-content.html PRD 正文骨架——写 PRD 先复制它，不手写 HTML 结构
assets/scripts/validate_prd.py PRD 机械校验器（交付前必跑，红了先修再交）
assets/scripts/{start_service,pm_bootstrap,pm_runtime,prototype_server,prototype_launcher,pm_launchagent}.py 本地截图/导出服务（Playwright 真实渲染）
assets/scripts/prototype-export-client.js 前端导出拦截器，统一走本地服务
assets/config/mcp.json.example Pencil MCP 可选接入示例
scripts/{initialize.py,init.sh,init.bat} 跨平台安装器（initialize.py 为唯一真相，sh/bat 只是薄壳）
scripts/known_hashes.json 文件哈希清单（防篡改/版本比对）

2. 环境要求

项 要求 说明
Python 3.9+ Windows 安装时务必勾选 Add python.exe to PATH；入口脚本检测不到会停在窗口提示
Playwright 首次自动安装 首次启动准备运行环境约 1-2 分钟，之后秒开
浏览器 优先复用系统 Edge / Chrome 正常情况零下载；没有才回落到 Playwright 自带 Chromium
本地服务 Windows 需手动保持窗口 双击 启动原型导出服务.bat 并保持开着；macOS 用 launchd socket 按需自启（空闲零进程）
venv 放用户目录，不落项目目录 %LOCALAPPDATA%\pm-workflow\（避开 OneDrive/iCloud 同步与超长路径）

3. 怎么用 / 依赖 / 配置 / 上手难度

安装（只需一次，可重复执行安全）：

rem Windows：在项目目录执行（或资源管理器里双击 init.bat）
py -3 <skill目录>\scripts\initialize.py --project .
# macOS / Linux
bash <skill目录>/scripts/init.sh

安装后项目获得：.agents/workflows/*.md（4 条工作流规范）+ scripts/（服务）+ .handoff/（跨会话交接）。重复执行会刷服务运行时、保留你改过的工作流、新版写到 .pm-workflow/updates/ 供对比合并、旧版备份到 .handoff/skill-backups/。

启动与自检：

py -3 scripts\start_service.py --doctor   # 一次打印解释器/运行环境/浏览器/端口/配置/代理

上手难度：中。会一次性的 Python 环境 + 项目初始化 + 本地服务三个概念；但安装器、--doctor 自检、README/SKILL 极详尽的防呆规则（连“Windows 没有 python3 命令要用 py -3”“find 在 Windows 是 System32\find.exe 别 shell out”都写了），把踩坑空间压得很小。

4. 对我的价值

  • 学习借鉴价值（高）：这是一个“AI Skill 工程化”的极好范本——SKILL.md 路由表按用户意图分发 4 条工作流；.agents/workflows/ 把规范做成可编辑文件而非写死在提示词里；validate_prd.py 机械校验器；跨会话 .handoff/ 交接；本地 http 导出服务 + Playwright 截图替代 html2canvas；端口按项目路径确定性推导且可自愈。这套模式可直接迁移到自己的 skill 开发/知识库工作流。
  • 工具链借鉴：Mermaid 流程图（theme:’base’ 浅色细描边直角连线）、时序图出可复制源码块、零遮挡几何审计（auditFlow + 导出拦截）、双栏预览 scroll-spy、base64 内嵌原型图——对做 AI 视频分镜/知识库图解/文档自动化都有参考价值。
  • 直接落地价值（中低）：除非你近期接产品经理/PRD 类任务，否则不急着装；但若日后需要，它能一步到位产出可评审 HTML 交付物。

5. 能力边界

✅ 能做什么

  • PRD HTML：固定章节顺序（项目信息→版本记录→需求背景→需求目标→需求概述→业务流程图→交互流程图→详细方案→数据埋点→时序图），按需求大小裁剪（核心骨架恒定保留，其余 7 章按需省略且裁剪前先征得确认）
  • 交互原型：单文件 HTML，hash 跳转、平铺预览、iframe 嵌入、真实渲染 PNG 导出
  • 业务流程图 + 交互流程图（Screen Flow）：Mermaid/曼哈顿直角路由，所有核心界面拼成一张带跳转箭头的画布，零遮挡硬指标 + 几何审计自动修复 + 导出拦截
  • 时序图：Mermaid 源码文本块（sequenceDiagram + stateDiagram-v2），可复制给研发/测试
  • 需求挖掘 / 验收清单 / 数据分析：需求洞察报告、可勾选验收 checklist、带图表指标的数据分析报告
  • 编辑体验：全文档 contenteditable + 撤销重做（⌘Z/⌘⇧Z）+ 一键复制全文（原型自动转 base64 内嵌）+ 双栏预览 scroll-spy
  • 机械校验：交付前 validate_prd.py 检查章节/表头列数/编号连续/data-preview/埋点命名等

❌ 不能做什么

  • 无 LICENSE（关键）：仓库未声明许可证 → 保留所有权利，复制/分发/商用需作者授权，只能参考学习
  • 不产出 Markdown 文档（默认 HTML 工件，除非明确要求）
  • Pencil 高保真设计只是可选 MCP 接入，不是内置能力
  • 撤销重做不承诺跨刷新保留（history 仅内存）
  • 需要本机 Python/浏览器环境；Windows 上手需手动保持服务窗口

⚠️ 注意事项

  • 无 license、无 issue 追踪习惯（0 issue，反馈渠道弱）、作者无背景背书（1 follower）
  • 本地导出服务会拉起本地 http 端口 + Playwright——只在信任项目内使用

6. 与同类对比

项目 ★ 定位 输出形态 许可 与它的差异
PM-K12–skills（本文） 86 单工作流深挖：需求→PRD→原型→验收→数据 可评审 HTML 工件 + 校验器 + 本地导出服务 ❌ 无 深度最深、工程化最重，偏“交付物工厂”
mohitagw15856/pm-claude-skills 1364 1098 个通用 Agent Skills 大合集 纯 Markdown 提示词 MIT 广度碾压但 PM 只是其中一个；无产物工程链
peterfei/ai-agent-team 434 多角色 AI 开发团队（PM 是角色之一） 多 Agent 编排 — 团队协作视角，不是单 PM 工作流
Fokkyp/claude-skills 216 中文 PM Claude skills（商业环境测试过） Markdown 技能/提示词 — 同语言竞争；偏技能清单，无 HTML 交付管线
wuwu119/lenny-pm-skills 186 Lenny Rachitsky 洞察中文版 86 技能 Markdown 技能 — 方法论合集（策略/定位类），非执行型工作流
killvxk/pm-skills-zh 160 65 技能 + 36 工作流中文翻译 Markdown 技能 — 翻译搬运，覆盖广但非原创工程
konglong87/superPM 66 产品经理全生命周期 skills 提示词 — 生命周期覆盖相似，缺 PRD 机械校验/导出服务
huohuodong94-crypto/prd-copilot-skill 27 澄清模糊需求→生成精简 Markdown PRD Markdown PRD — 轻量替代；不产交互原型/流程图

结论：同类中文 PM skill 大多是方法论/提示词清单（lenny、pm-skills-zh、Fokkyp），而 PM-K12–skills 是少数把交付物做成工程化产物的（HTML 骨架 + 机械校验 + 零遮挡审计 + 本地截图服务），工程深度在同档中文项目里突出；代价是无 license + 个人项目 + 传播度低，Star 只有 86，缺社区背书。

7. 社区反馈 / 可靠性

  • 维护活跃度高：近 2 天仍有提交（09-13 Chrome 导出修复、09-12 v3.1 发布），README/SKILL 中文文档极其详尽
  • 工程严谨度：有 validate_prd.py 机械校验、known_hashes.json 哈希清单、--doctor 自检、端口自愈、导出降级三层机制——代码质量明显高于同类个人项目平均水准
  • 社区规模小：86★ · 14 fork · 0 issue；外部提及基本为零（Bing/DDG 只搜到 GitHub 自身页面，无知乎/掘金等中文社区讨论）
  • ⚠️ 可靠性结论：作品可信、生态脆弱——工程实现值得学习借鉴，但因无 license、无 issue 渠道、作者无背书、传播有限，不建议在生产环境直接依赖；当“高质量参考实现”用。

refer

说明：本页为调研整理笔记。数据基于 2026-09-14 时的公开信息（GitHub API 实测 star/更新、README/SKILL 全文、目录树）。star 数为 GitHub API 返回值（页面抓取被 504 拦截未能二次核对）。技能安装与用法以官方 README 为准；该仓库无 LICENSE，复制/商用需作者授权。