# zhctprompt 项目 IPO 使用说明

`zhctprompt` 是产品开发部的控制项目，不是业务代码仓库。所有人使用它时，按同一套 IPO 口径协作：

```text
Input -> Process -> Output
```

核心蓝图是“一总五分”：

- 一总：产品开发部从“项目制开发团队”升级为“AI 原生的软硬一体产品交付组织”。
- 五分：场景产品化、软件平台化、硬件体系化、AI 工程化、交付资产化。
- 总公式：客户场景 -> 软件入口 -> 硬件能力 -> AI 工程底座 -> 交付资产。

产品系统总规范见 `standards-stack/prompt/governance/ZHCTPROMPT_PRODUCT_SYSTEM_OPERATING_STANDARD.md`。现在所有产品开发部相关任务先归入三条主线，再进入五模块 IPO：

1. 产品开发部总控体系
2. 智慧食堂产品战略体系
3. 康比特食安方案资产体系

## 1. 每个人先输入什么

所有输入都要先说清楚来源、目标、当前状态和验收方式。不要只说“改一下”“整理一下”“看一下”。

| 角色 | 必须输入 | 推荐入口 |
| --- | --- | --- |
| 管理者 / 产品负责人 | 目标场景、优先级、客户或内部目标、验收指标、希望沉淀的能力 | `PROJECT_IPO_USAGE_GUIDE.md`、`standards-stack/management/product-development-department/PRODUCT_DEVELOPMENT_DEPARTMENT_BLUEPRINT.md` |
| 项目经理 / 交付负责人 | 客户项目、阶段、合同或售前背景、时间计划、风险、验收证据、微盘路径 | `modules/project/README.md`、`work_company_knowledge/knowledge-map.md`、`tasks/QUEUE.md` |
| 产品 / UI / 方案人员 | 目标用户、业务流程、页面入口、原型或蓝湖资料、方案约束、演示对象 | `modules/product/README.md`、`modules/product/ui/README.md`、`product_pingan_yunchu/README.md` |
| 前端 / 后端 / 小程序 / APP 开发 | 云效任务号、目标仓库、目标分支、接口或页面范围、验证命令、回滚边界 | `AGENTS.md`、`control/local-paths.md`、`standards-stack/agent-skills/skills/karpathy-guidelines/SKILL.md` |
| 安卓 / 设备 / 硬件负责人 | 设备清单、型号或 SDK、协议、数据上传链路、测试设备、异常处理要求 | `work_android/README.md`、对应 `work_<project>/README.md` |
| AI 工程 / Agent 负责人 | 任务说明、上下文来源、代码索引、Prompt/MCP 需求、评估指标 | `standards-stack/agent-skills/README.md`、`standards-stack/llm-wiki/` |
| QA / 测试负责人 | 测试场景、账号环境、接口范围、测试数据、成功/异常/边界标准 | `work_store/apifox/`、`standards-stack/agent-skills/skills/api-contract-test-coverage/SKILL.md` |
| 全体成员 | 本周做的场景、所属模块、连接对象、交付成果、复用资产、量化指标、协同对象 | `HEARTBEAT.md`、`tasks/QUEUE.md`、`control/task-index/tasks.tsv` |

## 2. 项目如何处理这些输入

项目的处理过程不是“直接找人改代码”，而是先把输入归一成任务，再路由到正确的模块、skill、目录和证据面。

| Process 步骤 | 处理动作 | 使用的项目面 |
| --- | --- | --- |
| 1. DEFINE | 把自然语言、文档、截图、云效项或微盘资料整理成目标、范围、非目标、验收指标 | `tasks/QUEUE.md`、`standards-stack/prompt/governance/TASK_CONTRACT.md` |
| 2. CLASSIFY | 映射到五个模块：场景产品化、软件平台化、硬件体系化、AI 工程化、交付资产化 | `PRODUCT_DEVELOPMENT_DEPARTMENT_BLUEPRINT.md`、`product-development-master-agent` |
| 3. ROUTE | 按模块选择专业 skill：云效、Codeup、微盘、产品设计、API 契约、设备、手册视频、知识库 | `standards-stack/agent-skills/skills/` |
| 4. BUILD | 在对应位置执行：控制项目写文档和索引；业务代码在 `zhctproject/<repo>`；微盘原件留在微盘 | `work_<project>/`、`modules/`、`standards-stack/`、业务仓库 |
| 5. VERIFY | 跑测试、生成截图、检查接口、复核手册视频、验证索引和任务证据 | `control/scripts/`、`work*/summary.md`、测试报告 |
| 6. SHIP | 写回队列、心跳、任务索引、证据路径和复用规则 | `HEARTBEAT.md`、`tasks/QUEUE.md`、`control/task-index/items/` |

## 3. 项目最终输出什么

输出必须能被后来的人复用。一次任务如果只留下口头结论，不算完整输出。

| Output 类型 | 具体产物 | 默认位置 |
| --- | --- | --- |
| 产品地图 | 场景、软件入口、硬件设备、状态、负责人、验收指标 | `standards-stack/management/product-development-department/`、`modules/product/` |
| 项目资料索引 | 客户项目、阶段、源文件路径、售前/交付/售后资料导航 | `modules/project/`、`work_company_knowledge/`、`work_<project>/` |
| 代码交付 | 分支、提交、MR、测试结果、回滚说明 | 业务仓库 + `work_<project>/summary.md` |
| API / 测试资产 | OpenAPI/Apifox、接口矩阵、自动化场景、异常/边界测试 | `work_store/apifox/`、目标项目测试目录 |
| 硬件接入包 | 设备清单、协议/SDK、数据流、联调记录、故障处理、测试用例 | `work_android/`、对应 `work_<project>/` |
| AI 工程资产 | Prompt、MCP 配置、上下文、代码索引、benchmark、团队 skill | `standards-stack/agent-skills/`、`standards-stack/llm-wiki/` |
| 交付资产 | 演示记录、录屏、用户手册、Word 手册、小视频、上线/复盘记录 | `work*/manual-video/`、`work*/summary.md` |
| 恢复资产 | 当前状态、下一步、任务号、证据路径、复用 skill | `HEARTBEAT.md`、`tasks/QUEUE.md`、`control/task-index/tasks.tsv` |

## 4. 五个模块的 IPO 模板

| 模块 | Input | Process | Output |
| --- | --- | --- | --- |
| 场景产品化 | 客户/角色、业务流程、痛点、软硬触点、验收指标 | 把项目名转成客户场景，建立场景-入口-设备-指标关系 | 场景说明、客户需求、验收标准、项目资料索引 |
| 软件平台化 | 页面/流程、权限、接口、数据、演示目标、目标仓库 | 按入口组织 PC、移动端、小程序、APP、企微、钉钉、API 等能力 | 页面/接口交付、Design.md、API 契约、演示记录 |
| 硬件体系化 | 设备清单、协议/SDK、数据上传链路、异常处理、测试设备 | 建立设备分类、接入模板、联调计划、责任矩阵和测试包 | 设备接入文档、数据流、联调记录、故障处理、测试用例 |
| AI 工程化 | 任务说明、上下文、代码索引、Prompt/MCP、模型或工具约束 | 让 AI 进入开发、测试、文档、知识库和评估流程 | Prompt、skill、代码索引、benchmark、评估表、知识库 |
| 交付资产化 | 完成功能、演示对象、安全账号、上线计划、复盘指标 | 上线前演示，判断合并/上线，录屏并生成手册和小视频 | 演示视频、用户手册、上线记录、复盘文档、培训材料 |

## 5. 已建立的五模块入口

以后不要只引用表格，直接进入对应模块目录登记和填写。

| 模块 | 入口 | 索引 | 模板 |
| --- | --- | --- | --- |
| 场景产品化 | `modules/project/scenario-productization/README.md` | `modules/project/scenario-productization/scenario-map.csv` | `modules/project/scenario-productization/templates/scenario-brief.md` |
| 软件平台化 | `modules/product/software-platformization/README.md` | `modules/product/software-platformization/software-entry-map.csv` | `modules/product/software-platformization/templates/software-entry-brief.md` |
| 硬件体系化 | `work_android/hardware-systemization/README.md` | `work_android/hardware-systemization/device-intake-map.csv` | `work_android/hardware-systemization/templates/device-intake.md` |
| AI 工程化 | `standards-stack/ai-engineering/README.md` | `standards-stack/ai-engineering/ai-engineering-map.csv` | `standards-stack/ai-engineering/templates/ai-coding-evaluation.md` |
| 交付资产化 | `work/delivery-assetization/README.md` | `work/delivery-assetization/delivery-asset-map.csv` | `work/delivery-assetization/templates/delivery-pack.md` |

总运行图见 `standards-stack/management/product-development-department/FIVE_MODULE_OPERATING_MAP.md`。

### 5.1 当前产品体系总览

智慧食堂 + 职工营养健康资料已归入产品战略体系：

- 产品体系目录：`modules/product/strategy/smart-canteen-nutrition-system/`
- HTML 总览：`modules/product/products/smart-canteen/architecture/2026-05-14-smart-canteen-nutrition-architecture/smart-canteen-nutrition-architecture.html`
- 文件级资料映射：`modules/product/strategy/smart-canteen-nutrition-system/material-architecture-map.csv`
- 软件能力表：`modules/product/strategy/smart-canteen-nutrition-system/software-capability-map.csv`
- 硬件能力表：`modules/product/strategy/smart-canteen-nutrition-system/hardware-capability-map.csv`
- 职工营养健康表：`modules/product/strategy/smart-canteen-nutrition-system/nutrition-health-map.csv`
- 行业报告来源索引：`modules/product/strategy/smart-canteen-nutrition-system/industry-report-source-index.csv`
- 行业报告结论归档：`modules/product/strategy/smart-canteen-nutrition-system/industry-report-conclusions.md`
- 行业结论产品动作表：`modules/product/strategy/smart-canteen-nutrition-system/industry-report-product-actions.csv`
- 行业报告封面展示索引：`modules/product/strategy/smart-canteen-nutrition-system/industry-report-cover-gallery.csv`

## 6. 每个人周会/日报填空公式

统一使用下面一句话，避免只报局部动作：

```text
我负责的【场景】属于【五个模块中的哪一块】，
连接【软件入口/硬件设备/数据接口】，
本周交付【成果】，
沉淀【可复用资产】，
验收指标是【量化结果】，
需要【协同对象】。
```

如果某一项填不出来，就说明这件事还没有进入项目的可管理状态，需要先补输入或补验收指标。

### 6.1 产研策略下的日报/周报/月报规则

产研策略规范见 `standards-stack/management/product-development-department/PRODUCT_RND_STRATEGY_2026.md`。所有日报、周报、月报先按结论表达，再补证据，不接受 8-10 条琐碎事项堆叠。

每条工作必须至少对齐以下三类产品策略之一：

| 策略标签 | 检查问题 | 证据方向 |
| --- | --- | --- |
| 产品差异性 | 是否体现营养健康核心，是否形成软著、资质、功能、硬件参数、控标参数等差异化成果？ | 证书、软著、参数库、竞品评分、产品截图、客户可见能力。 |
| 产品标准化 | 是否把项目经验沉淀为人群+需求+解决方案的场景化方案？ | 用户访谈、政策分析、竞品分析、场景方案、模板。 |
| AI赋能 | 是否沉淀 AI 技能、知识资产或 AI Native 工作流？ | Prompt、skill、知识库、结构化数据、自动化报告、Agent 工作流。 |

无关基础沟通只作为依赖或风险记录，不作为主要成果。

## 7. 目录使用规则

| 要做的事 | 放哪里 | 不要做什么 |
| --- | --- | --- |
| 控制项目规则、总蓝图、skill | `standards-stack/` | 不要散落在个人聊天记录里 |
| 客户项目或外部受控项目资料 | `work_<project>/` | 不要混进通用 `work/` |
| 跨项目方法和一次性证据 | `work/<date-topic>/` | 不要写成未验证的长期规则 |
| 产品方案、UI、原型、开发项目入口 | `modules/product/` | 不要复制业务代码 |
| 微盘项目和公司知识库索引 | `modules/project/`、`work_company_knowledge/` | 不要批量复制微盘原始大文件 |
| 业务代码 | `zhctproject/<repo>` 或登记的同事本地仓库 | 不要复制进 `zhctprompt` |
| 任务恢复和索引 | `HEARTBEAT.md`、`tasks/QUEUE.md`、`control/task-index/` | 不要只在最终回复里记录状态 |

## 8. 停止条件

遇到下面情况先停，不要硬推进：

- 输入没有目标场景、目标项目或验收指标。
- 需要改业务代码但还没有任务分支或独立 worktree。
- 设备型号、协议、客户状态、云效状态没有证据来源。
- 涉及生产数据库、支付、认证、权限、设备控制等高风险契约。
- 手册、录屏、截图会泄露敏感信息或触发真实写入。

停止时必须写清 blocked path、blocked command、observed output、missing input 和 next safe action。