前言¶

产品或研究侧常常先交出 HTML 原型、低代码页面或截图 Demo，研发却要据此估工时、拆接口、定验收标准。若只靠口头讲解或零散备注，前后端对「字段从哪来、接口是复用还是新建」容易各说各话，排期也难对齐。

下面介绍 SkillHub 上的 亿欧 Demo 转技术方案（坐标 @org-nbb03iiz/yiou-demo-to-tech）。它按固定工作流把业务描述与 Demo 材料整理成工程可执行的技术方案，并单独输出待确认问题、任务拆解与成熟度评级，目标是把展示型 Demo 推进到可评估、可拆解、可开发、可验收的实施规划，而不是直接生成生产代码。

这是什么¶

亿欧 Demo 转技术方案（包内标识 Yiou DemoToTech）是亿欧发布的企业来源（enterprise）文档生成类 Skill，当前版本 1.0.0，分类为 dev-programming。SkillHub 页面标注 requires_api_key=false，安装与调用不依赖额外 API Key。

它结合亿欧智库研究流程与数据平台产品交付经验，将业务 Demo、产品原型和需求描述转化为研发可用的方案文档：页面流程、模块字段、业务规则、接口需求、数据归属、验收标准与开发任务等，并强制区分「业务提供 / Demo 识别 / 模型推断」与接口状态（复用、新增、待确认、前端本地处理），减少凭空假设已有内部接口。

核心功能¶

依据 Skill 包内 SKILL.md，已核实的能力如下。

输入形态

• 必填：business_description（业务目标、场景与预期价值）。
• 建议：demo_code（HTML/React/Vue/低代码片段）、demo_screenshot、target_platform（PC / H5 / MiniProgram / Admin）。
• 可选：reference_docs、known_data_sources、constraints。

固定工作流（九步）

1. 理解业务目标、角色与核心场景。
2. 拆解 Demo 为页面清单、模块、字段、操作与流程。
3. 提取显性与隐性业务规则。
4. 推断实体、字段与数据归属。
5. 草拟接口需求。
6. 补充边界、异常、权限与超时。
7. 标注推断内容与未决事项。
8. 生成主文档、结构化 JSON、问题清单、任务拆解与验收标准。
9. 评定文档成熟度 L1–L4。

五类输出

1. 主技术文档（Markdown），章节须覆盖包内 templates/tech_doc_template.md（功能概述、页面流程、模块字段、业务规则、数据结构、接口需求、权限与异常、前后端建议、验收标准、待确认问题、任务拆解、成熟度评级等）。
2. 结构化 JSON，字段须覆盖 templates/structured_output_template.json。
3. 待确认问题表（question、impact_scope、priority、default_suggestion、owner）。
4. 开发任务拆解（side：FE/BE/QA，及 task、priority、notes）。
5. 验收标准（按功能、数据、交互、权限、导出分组）。

质量与约束

• 质量门禁：缺少业务目标、使用角色、页面流程、核心字段、数据来源（或明确未知）、验收标准时，不得标记为可进入开发；缺项须写入 blocking_gaps，且不得评为 L3/L4。
• 明确不生成生产代码、不替业务做最终决策、不编造已有接口或数据来源。

典型触发语包括：「把这个 Demo 转成技术方案」「整理成前后端可开发文档」「输出接口和数据结构」「生成待确认问题和验收标准」，以及行业研究、产业链、企业扫描、投融资、市场洞察等 Demo 转开发文档类表述。

安装与启用¶

Skill 基于通用 SKILL.md 格式，通过 SkillHub CLI 安装到当前 Agent 的 skills 目录；装错目录会导致 Agent 无法加载，需按环境指定 --dir。

1. 检查或安装 SkillHub CLI

command -v skillhub && skillhub --version

未安装时可按 SkillHub 安装说明 执行完整安装（示例）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2. 安装本 Skill

官方页面与 CLI 搜索均给出同一安装方式：

skillhub install yiou-demo-to-tech --namespace org-nbb03iiz --dir <你的 Agent skills 目录>

常见 skills 目录（摘自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

也可将下面提示词交给已接入 SkillHub 安装流程的 AI，让其按 https://skillhub.cn/install/skillhub.md 安装 @org-nbb03iiz/yiou-demo-to-tech。

安装完成后，在对应客户端中启用或刷新 Skills 配置（以各客户端文档为准），对话中即可按触发语调用。

典型用法¶

结构化输入（建议）

向 Agent 提供 JSON，便于对齐必填与可选项：

{
  "business_description": "string, required",
  "demo_code": "string, optional",
  "demo_screenshot": "string or list, optional",
  "reference_docs": "string or list, optional",
  "target_platform": "PC | H5 | MiniProgram | Admin",
  "known_data_sources": "string or list, optional",
  "constraints": "string or list, optional"
}

快速启动提示词

Skill 包内提供可直接粘贴的短提示词，用于一次性声明输出范围与标注规则：

你是 Yiou DemoToTech skill。请把业务描述和 Demo 转成可评估、可拆解、可开发、可验收的技术方案文档。
适用场景包括行业研究、产业链、企业扫描、投融资、数据分析、市场洞察、战略咨询等亿欧业务场景。
必须输出：功能概述、页面流程、模块字段、业务规则、数据结构、接口需求（含状态）、权限与异常、前后端建议、验收标准、待确认问题、开发任务拆解、成熟度评级。
成熟度评级必须包含等级、评级原因、阻塞缺口；凡是推断必须标注“模型推断，待确认”；接口不确定时一律标注“待确认”。

经过上面的步骤，应同时得到 Markdown 主文档、结构化 JSON、问题表、任务表与分组验收标准；接口项上每个状态只能是「复用 / 新增 / 待确认 / 前端本地处理」之一。

适用场景与注意¶

适合谁

• 产品经理、行业研究员、解决方案同学：在研发评审前把 Demo 与业务语言整理成统一文档。
• 前端、后端、测试负责人：需要页面清单、字段、接口草案、任务侧（FE/BE/QA）与验收条目，用于粗估与排期。
• 亿欧数据平台及相关研究类产品场景（Skill 自述中列举的行业研究、产业链、投融资等方向）。

限制与注意

• 输出是方案与拆解，不是可上线代码；Skill 明文禁止声称 Demo 可直接用于生产。
• 推断内容必须标「模型推断，待确认」；不确定的接口一律「待确认」，不得编造内部已有接口。
• 成熟度 L3/L4 依赖质量门禁必填项；信息不足时应接受 L1/L2，并优先补齐 blocking_gaps 中的缺口。
• SkillHub 抓取元数据（截至页面展示）：评分 100000，下载 841 次，安装计数 0；统计会随商店更新变化，以 SkillHub 技能页 为准。

结尾¶

亿欧 Demo 转技术方案把「看得见」的 Demo 转成「能评审、能拆任务、能写验收」的文档体系，并用来源标签、接口状态与 L1–L4 成熟度约束推断边界。若你手头已有原型代码或截图，并希望在开发前对齐前后端与数据归属，可通过 SkillHub 安装 @org-nbb03iiz/yiou-demo-to-tech。

• 官方地址：https://api.skillhub.cn/org-nbb03iiz/yiou-demo-to-tech
• SkillHub 页面：https://www.skillhub.cn/skills/org-nbb03iiz/yiou-demo-to-tech