OpenProd

把零散想法，变成团队和 AI 都能继续执行的产品资产

品牌系统 · 竞品调研 · 图文 PRD · 项目控制面板

四个 Skill，可以单独使用，也可以按需组合。
不绑定某个品牌，不要求固定知识库，也不把你锁在某个 Agent 生态里。

看看实际效果 · 为什么选择 OpenProd · 5-分钟开始使用 · 更新记录 · 安全更新 · 安全报告

你可能正在遇到这些问题

和 AI 聊了很多轮，最后只有一段文字；换个对话，前面的决定又要重讲。
品牌设计只有一张“看起来不错”的概念图，没有 Logo 变体、颜色、字体和可下载素材。
PRD 写了很多功能，却没有逐页设计图；或者表格里只写着“图 1”，产品、设计和开发仍然对不齐。
项目已经开始开发，但没人能快速回答：做到哪了、下一步是什么、为什么做、风险在哪里。
换 Codex、Claude Code、Cursor 或其他 Agent 后，工作方法和项目上下文无法延续。

OpenProd 的目标不是再增加一套项目管理软件，而是把这些工作沉淀成可以查看、下载、评审、更新和继续执行的文件。

一个想法
   ├─ make-brand-design       → 品牌规范 + 分类素材包
   ├─ make-competitor-research → 真实体验手稿 + 截图证据 → 竞品拆解
   ├─ make-prd                → 页面级 PRD + 表格内设计图
   └─ project-control-panel   → 项目状态 + 版本规格 + 可执行任务

实际会得到什么

以下是输出形态示例，使用虚构产品展示；实际内容和视觉会根据你的产品、品牌与确认结果生成，并不是固定模板。

1. 不只是一张概念图，而是一套能拿走使用的品牌系统

你可以这样说	OpenProd 交付的结果
`使用 make-brand-design，为我的产品建立品牌系统。先确认视觉方向，再制作完整规范和素材包。`	品牌定位、视觉方向、Logo 家族、深浅色版本、颜色、字体、图标、应用示例、Design Tokens、素材清单及分类压缩包。概念稿、正式母版和待生产素材会明确区分。

**它解决的是：**品牌结果不再停留在“这一张图挺好看”，而是继续回答团队真正会问的问题——Logo 去哪里下载？深色背景用哪个版本？字体和颜色怎么用？哪些素材已经批准？

2. 不只写功能清单，而是让页面设计和需求逐项对齐

你可以这样说	OpenProd 交付的结果
`使用 make-prd，为这个产品创建页面级 PRD。先确认页面范围和一张视觉基准图。`	产品目标、用户流程、范围与排除项、逐页功能表、加载/空/错误/权限等状态、验收标准，以及每个页面独立的设计图。

**关键差异：**页面设计图必须作为真实图片插入对应需求表格，不能用“图 X”、文件名或链接占位，也不能把图片丢在表格外面假装完成。

3. 不只让 AI 知道怎么写代码，也让人一眼看懂项目进展

你可以这样说	OpenProd 交付的结果
`使用 project-control-panel，在当前仓库建立项目管理体系。不要修改业务代码，不要部署。`	给产品负责人的 Control Panel、给产品与开发的版本规格、给 Agent 的可执行任务、决策与风险边界、分支与发布溯源、环境验收 Gate，以及可选的 PNG/SVG/HTML 状态面板。

**它解决的是：**人不需要读一堆代码就能理解项目，Agent 也不会因为“说人话”而丢失文件、约束、验收命令等执行细节。涉及登录、支付、Webhook、异步任务或外部 Provider 时，它还会阻止把临时 Preview 当成完整端到端验收。

4. 不只堆竞品截图，而是把真实体验整理成有证据的流程

你可以这样说	OpenProd 交付的结果
`使用 make-competitor-research，把这些体验手稿、截图和录屏整理成一篇竞品调研。`	新建一篇独立报告，保留原始调研清单不变；用流程画板按时间连接真实体验节点，再按 URL/产品空间拆页面、按组件分析功能与反馈；截图放在对应组件证据行。

**关键差异：**用户步骤、页面、组件、状态不会再混写。步骤属于时间流程；页面由 URL、路由或产品空间决定；登录、生成、错误、结果等变化通常属于页面内组件。飞书等支持白板的目标会用流程画板表达真实操作顺序，不支持白板时才退化为文字流程。图片是证据，不是装饰；事实、用户感受和 Agent 推断分开，缺证据就明确写未测试或无法确认。

为什么选择 OpenProd

选择	常见结果	OpenProd 的做法
直接和通用 AI 聊	输出质量依赖当次提示词；换对话后流程容易漂移	把经过验证的流程、检查项和交付结构写进可版本化 Skill
只使用文档模板	有栏目，但不会主动补齐信息、生成素材、检查最终结构	Agent 按流程询问、生成、等待确认、交付并回读验证
只使用设计生成工具	容易得到漂亮单图，但缺少需求、资产状态和治理规则	品牌输出配套素材包；PRD 图片与具体功能、状态和验收绑定
使用重型项目管理平台	适合排期协作，但产品事实仍可能散落在聊天、文档和代码里	把轻量管理层直接放进仓库，保留可读状态和精确执行规格
使用单一 Agent 专属插件	安装方便，但换 Agent 时方法难复用	核心是 Markdown、参考文件和 Python；平台元数据只是可选适配
把所有流程强绑在一起	小需求也被迫执行完整流水线	四个 Skill 独立触发；上游产物存在就读取，不存在也不阻塞

OpenProd 更适合这些人：

一个人或小团队，需要借助 AI 把产品从想法推进到可执行状态；
产品经理、创始人、设计师，希望产物不仅“能看”，还可以交给下一角色继续工作；
使用多个 Coding Agent，希望方法和项目事实不随工具切换而丢失；
不想先购买或维护一套重型系统，但需要比聊天记录更可靠的工作方式。

OpenProd 不是 Jira、Linear、Figma 或知识库的替代品。它负责生成和维护清晰的产品资产；你仍然可以把结果发布到已有工具中。

四个 Skill 可以怎样组合

flowchart LR
    Idea[产品想法]
    Brand[make-brand-design<br/>可选品牌输入]
    Research[make-competitor-research<br/>真实体验与证据整理]
    PRD[make-prd<br/>产品范围与页面设计]
    Control[project-control-panel<br/>版本与执行管理]
    Build[开发与验收]

    Idea --> Brand
    Idea --> Research
    Idea --> PRD
    Brand -. 可选输入 .-> PRD
    Research -. 可选洞察 .-> PRD
    PRD -. 已确认范围 .-> Control
    Idea --> Control
    Control --> Build

**只做品牌：**直接运行 make-brand-design，不需要代码仓库。
**只整理竞品体验：**直接运行 make-competitor-research；它不负责自动找竞品、选词或写 PRD。
**只写 PRD：**直接运行 make-prd；没有品牌规范时，可以使用明确标注的临时视觉方向。
**只管理项目：**直接运行 project-control-panel，不要求先做品牌或 PRD。
**完整流程：**品牌作为 PRD 的可选输入，已确认 PRD 再作为 Control Panel 的范围依据。每一步都可以停下来确认，不会自动推进下一步。

环境验收不再靠猜

project-control-panel 会把环境验收作为一个轻量发布 Gate，而不是替你部署一套固定技术栈：

原则	OpenProd 的做法
Preview 能证明什么	只承认它实际跑过的视觉和轻量行为，不自动算作登录、支付、Webhook 或数据写入的端到端证据。
是否需要验收环境	代码扫描只提供候选信号；项目负责人在 Baseline 中确认 `Green / Yellow / Red / N/A / Unknown`。
非生产环境如何隔离	凭证、写入目标、Auth、支付和 Provider 必须有明确边界；缺少非生产凭证时 fail closed，禁止回退 Production。
什么状态可以通过	只有 `Green` 或有证据的 `N/A` 可以宣称通过；`Yellow` 可以继续开发但不能通过发布 Gate。
如何证明没有污染线上	用测试关联 ID 或时间窗口，对 Production 用户、订单、支付对象、任务或 Provider 调用做定向负向检查。

这里的 Stable Acceptance 是“可重复、身份明确、不会误写 Production 的验收路径”，不强迫每个项目长期维护公网 Staging。只有项目确认需要真实闭环时，才按需创建一份：

docs/deployments/ACCEPTANCE_ENVIRONMENT.md

OpenProd 只提供治理规则、模板和证据要求；安装 Control Panel 时不会创建云资源、写入 Secret、迁移数据库或部署服务。

5 分钟开始使用

安装

新机器、已有旧版 Skill 的机器、只装过部分 Skill 的机器，都使用同一个安装器：

git clone https://github.com/creeep123/openprod.git ~/openprod
cd ~/openprod

./install.sh --dry-run   # 先看会发生什么
./install.sh             # 自动备份同名旧版，再安装
python3 scripts/openprod.py doctor

只安装需要的部分：

./install.sh --skill make-prd
./install.sh --skill make-competitor-research
./install.sh --skill make-brand-design --skill project-control-panel

完整的新机安装、旧版迁移、部分补装、回滚、卸载及非 Codex Agent 说明：

阅读《安装、更新与迁移》

第一次测试：先做一个小而真实的任务

测试品牌 Skill

使用 make-brand-design，为一个面向独立咖啡店的库存管理产品建立品牌系统。
用户是小型咖啡店店主，品牌希望专业、温暖、清晰。
先完成策略和视觉方向；方向确认后只生成一张视觉基准图。

你应当看到：先补齐关键需求，再给方向；确认前不会批量生成；最终交付不止概念图，还包括分类素材包。

测试竞品调研 Skill

使用 make-competitor-research，把我提供的某个产品体验手稿、截图和录屏整理成一篇标准图文竞品调研。
原始调研清单保持不动，最终报告另建文档；保留我的真实感受；缺证据写未测试；
完整流程优先用白板按操作顺序连接；页面按 URL/产品空间拆分，截图放到对应组件证据行。

你应当看到：一个产品一篇、源资料没有被覆盖；流程画板只画实际经过的时间节点；页面与组件结构集中在同一个章节，不再把登录弹窗、错误反馈或生成状态误写成独立页面；每个组件行写清任务、控件、反馈、限制、真实可用性和截图依据。

测试 PRD Skill

使用 make-prd，为社区健身房创建课程预约 PRD。
首版只包括查看课程、预约、取消和预约记录；不做支付、会员和教练后台。
先输出范围、流程和页面清单，不要立即生图。

你应当看到：范围和排除项得到保留；先确认一张视觉基准；最终每张页面设计图真实位于对应需求表格内。

测试 Control Panel Skill

使用 project-control-panel 检查当前仓库并建立轻量项目管理层。
先 dry-run，不改业务代码，不部署。

你应当看到：项目现状被翻译成人能理解的 Control Panel，同时规格和任务仍保留 Agent 执行所需的技术精度；环境验收初始为 Unknown，扫描结果只作为提示，不会自动冒充事实。

如项目包含有状态或外部服务闭环，可以继续说：

按 environment acceptance 规则完成能力盘点。确认 Preview、验收环境和 Production 各自能证明什么；
不要创建资源或部署，先给出环境 Gate 状态和缺失证据。

安全更新，不怕机器上已经有旧版

cd ~/openprod
./update.sh
python3 scripts/openprod.py doctor

更新器会：

使用 git pull --ff-only，避免偷偷制造合并提交；
识别缺失、旧版、部分安装和 OpenProd 已管理版本；
替换前把原目录备份到 ~/.openprod/backups/；
只处理四个明确命名的 Skill，不碰其他 Skill；
把安装状态记录在 ~/.openprod/state.json；
安全卸载时拒绝删除未由 OpenProd 管理的目录。

本机同时参与 OpenProd 开发时，可以使用软链接：

./install.sh --mode symlink

Agent 与交付渠道

OpenProd 的核心工作流不绑定某个 Agent：

环境	使用方式
Codex	安装到 `~/.codex/skills/`，自动发现四个 Skill
Claude Code / Cursor / Windsurf	安装到其支持的 Skills 目录，或直接读取对应 `SKILL.md`
其他 Agent	只要能读取 Markdown、本地文件并按需执行 Python，就可以复用核心流程

飞书也不是强制依赖：工具和权限可用时可以发布为飞书文档；不可用时交付完整 Markdown、图片与素材包。图像生成能力同样是按需增强，不影响纯文字 PRD 或 Control Panel 使用。Control Panel 的 PNG 渲染需要 Python Pillow 和中文字体；缺失时参照安装文档处理。

你需要提前知道的边界

AI 生成的 Logo 概念不等于完成商标检索、字体授权或专业矢量精修；OpenProd 会明确标注资产状态。
页面设计图不代表功能已经开发；PRD 文字、范围和验收标准仍是需求事实源。
Control Panel 不会在安装时修改业务逻辑、部署服务、迁移数据库或读取凭证。
最终质量仍取决于你提供的真实业务信息，以及你是否认真完成关键确认节点。

仓库结构

openprod/
├── skills/
│   ├── make-brand-design/
│   ├── make-competitor-research/
│   ├── make-prd/
│   └── project-control-panel/
│       └── references/environment-isolation.md
├── assets/examples/
├── CHANGELOG.md
├── scripts/openprod.py
├── tests/test_installer.py
├── install.sh
├── update.sh
└── docs/INSTALL_AND_UPDATE.md

参与改进

如果某次输出没有达到预期，欢迎提交 Issue，并尽量附上：

你的原始任务描述；
使用了哪个 Skill；
期望结果与实际结果的差异；
可公开的产物截图或结构信息；
Agent 和运行环境。

请勿提交凭证、客户隐私或未脱敏的业务数据。安全问题请按 SECURITY.md 私下报告。

许可证

OpenProd 采用 Apache License 2.0。

FilesExpand file tree

README.md

Latest commit

History