品牌系统 · 竞品调研 · 图文 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 → 项目状态 + 版本规格 + 可执行任务
以下是输出形态示例，使用虚构产品展示；实际内容和视觉会根据你的产品、品牌与确认结果生成，并不是固定模板。
| 你可以这样说 | OpenProd 交付的结果 |
|---|---|
使用 make-brand-design，为我的产品建立品牌系统。先确认视觉方向，再制作完整规范和素材包。 |
品牌定位、视觉方向、Logo 家族、深浅色版本、颜色、字体、图标、应用示例、Design Tokens、素材清单及分类压缩包。概念稿、正式母版和待生产素材会明确区分。 |
 |
**它解决的是：**品牌结果不再停留在“这一张图挺好看”，而是继续回答团队真正会问的问题——Logo 去哪里下载？深色背景用哪个版本？字体和颜色怎么用？哪些素材已经批准？
| 你可以这样说 | OpenProd 交付的结果 |
|---|---|
使用 make-prd，为这个产品创建页面级 PRD。先确认页面范围和一张视觉基准图。 |
产品目标、用户流程、范围与排除项、逐页功能表、加载/空/错误/权限等状态、验收标准，以及每个页面独立的设计图。 |
 |
**关键差异：**页面设计图必须作为真实图片插入对应需求表格，不能用“图 X”、文件名或链接占位，也不能把图片丢在表格外面假装完成。
| 你可以这样说 | OpenProd 交付的结果 |
|---|---|
使用 project-control-panel，在当前仓库建立项目管理体系。不要修改业务代码，不要部署。 |
给产品负责人的 Control Panel、给产品与开发的版本规格、给 Agent 的可执行任务、决策与风险边界、分支与发布溯源、环境验收 Gate，以及可选的 PNG/SVG/HTML 状态面板。 |
 |
**它解决的是：**人不需要读一堆代码就能理解项目，Agent 也不会因为“说人话”而丢失文件、约束、验收命令等执行细节。涉及登录、支付、Webhook、异步任务或外部 Provider 时，它还会阻止把临时 Preview 当成完整端到端验收。
| 你可以这样说 | OpenProd 交付的结果 |
|---|---|
使用 make-competitor-research，把这些体验手稿、截图和录屏整理成一篇竞品调研。 |
新建一篇独立报告，保留原始调研清单不变；用流程画板按时间连接真实体验节点，再按 URL/产品空间拆页面、按组件分析功能与反馈；截图放在对应组件证据行。 |
 |
**关键差异：**用户步骤、页面、组件、状态不会再混写。步骤属于时间流程；页面由 URL、路由或产品空间决定；登录、生成、错误、结果等变化通常属于页面内组件。飞书等支持白板的目标会用流程画板表达真实操作顺序，不支持白板时才退化为文字流程。图片是证据，不是装饰；事实、用户感受和 Agent 推断分开，缺证据就明确写未测试或无法确认。
| 选择 | 常见结果 | OpenProd 的做法 |
|---|---|---|
| 直接和通用 AI 聊 | 输出质量依赖当次提示词；换对话后流程容易漂移 | 把经过验证的流程、检查项和交付结构写进可版本化 Skill |
| 只使用文档模板 | 有栏目，但不会主动补齐信息、生成素材、检查最终结构 | Agent 按流程询问、生成、等待确认、交付并回读验证 |
| 只使用设计生成工具 | 容易得到漂亮单图，但缺少需求、资产状态和治理规则 | 品牌输出配套素材包；PRD 图片与具体功能、状态和验收绑定 |
| 使用重型项目管理平台 | 适合排期协作，但产品事实仍可能散落在聊天、文档和代码里 | 把轻量管理层直接放进仓库，保留可读状态和精确执行规格 |
| 使用单一 Agent 专属插件 | 安装方便，但换 Agent 时方法难复用 | 核心是 Markdown、参考文件和 Python；平台元数据只是可选适配 |
| 把所有流程强绑在一起 | 小需求也被迫执行完整流水线 | 四个 Skill 独立触发；上游产物存在就读取，不存在也不阻塞 |
OpenProd 更适合这些人：
- 一个人或小团队，需要借助 AI 把产品从想法推进到可执行状态；
- 产品经理、创始人、设计师，希望产物不仅“能看”，还可以交给下一角色继续工作；
- 使用多个 Coding Agent，希望方法和项目事实不随工具切换而丢失；
- 不想先购买或维护一套重型系统，但需要比聊天记录更可靠的工作方式。
OpenProd 不是 Jira、Linear、Figma 或知识库的替代品。它负责生成和维护清晰的产品资产；你仍然可以把结果发布到已有工具中。
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、迁移数据库或部署服务。
新机器、已有旧版 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 symlinkOpenProd 的核心工作流不绑定某个 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。