z-chain(产业/项目生态链角色图谱)
一句话:把"谁扮演什么角色"画成分层图谱——结构先行,人名和事实宁空勿编。
help 用法卡
调用消息或斜杠参数恰为 help / 帮助 / 怎么用(整条仅此一词)时,逐字输出本卡后停,不进入任何流程;请求含其他内容时按正常流程走。
【z-chain 用法卡】生态角色图谱——谁扮演什么角色,三态标注、宁空勿编。
| 场景 | 你这样说 | 会发生什么 |
|---|---|---|
| 生态图谱 | 「把 X 产业链/项目的干系人画成角色图谱」 | 先确认尺度(产业/项目)→ HTML 图+角色表 |
| 基线后重绘 | 「干系人变了不少,重新画一次生态图」 | 落 05-管理/变更/,不动 00-立项/ |
跨系列问法见 z-flow-kickoff help。
三条铁律(覆盖下文所有规则)
- 宁空勿编:没有依据的名字一律不填,画成虚线空位。每个角色只有三种状态——
已确认(有来源)、待核(模型知识,需验证)、空缺(不清楚,留白)。
链长分工、链主名单正是大模型最容易一本正经编造的领域:空缺是诚实,填错是事故。 - 每填必据:每个已填项都要有"依据"——用户材料、用户口述、或检索到的公开来源。
没有依据的自动降级为"待核",不得冒充已确认。 - 空缺是常态:地方产业链公开信息完整度参差,冷门链条大面积空缺是正常输出。
判断图谱好坏的标准是"已填项都有据",不是"填满没填满";不要为了好看把空位填上。
定位
本 skill 画的是结构图(组成结构、事实盘点),不是判断塔:回答"谁在哪、卡在哪",
不回答"该不该做、值不值"——判断类问题交给 z-pyramid,本 skill 只提供生态事实底座。
开场协议(轻量级,z-系列工作模式)
建图前一句话复述并入首条回复(尺度判断 + 将建什么 + 产物路径),不单独占一轮;项目尺度先报"将先落位产业生态、再画组织生态"。被 z-flow-kickoff 编排进入时沿用其契约与横幅。
两个尺度,一套框架
同一套角色框架在两个尺度上同构,词汇不同、结构不变:
产业生态 项目生态(立项/事项)
治理层 链长(谁挂帅)、专班 发起人/拍板领导、PMO/项目办
核心层 链主企业、潜在链主 项目 owner、承接团队
链上层 上游→中游→下游企业 供给与依赖 → 本体 → 使用与验收
支撑层 园区/平台/高校/资本/协会 平台工具/预算/专家/外部供应商
动手前先判断尺度:产业(地区 × 产业链)还是项目(一个事项/工程)?用户没说清就问一句。
项目尺度有一条附加规则:空缺即风险信号——链长空缺=无人拍板,链主空缺=无人对结果负责,
下游空缺=产出没人接,上游空缺=关键依赖没锁定。项目尺度交付时,把空位图当风险清单提示一句;
z-assess 如已安装,空缺风险清单(上述四类)直接作为其风险登记的输入。
项目尺度还有一步先落位:企业内项目不是悬空的,先把它落到对应的产业生态——
- 落位:对应哪条产业链(国家/省级重点产业链名单中的哪条)?处于哪个环节(上游/中游/下游)?
- 产业生态解读:它依赖的链长(政策与资源从哪来)、链主(订单/标准/协同从哪来)、
上下游(供给从哪来、产出到哪去)——把产业框架映射到项目头顶。 - 组织生态:再画项目自身的治理/核心/链上/支撑四层(发起人/owner/依赖/使用方)。
产业生态说明"大势与卡点",组织生态说明"谁干什么",两层都要。
角色框架(MECE,四层互斥)
- 治理层——谁管:链长/发起人、专班/PMO
- 核心层——谁牵头:链主/owner、潜在链主/联合体
- 链上层——谁配套:上游(材料/设备/核心零部件)→ 中游(制造/集成)→ 下游(应用/服务);
项目尺度换为供给与依赖 → 本体 → 使用与验收 - 支撑层——谁托底:园区载体、公共平台(技术/检验检测)、高校院所、资本基金、协会联盟
框架可按链条特点增删角色(如矿产链加"储量/配额",项目尺度加"法务/合规"),
但四层不能混、同层角色不重不漏。
链主判定标准(产业尺度,分析链主时必须过一遍)
"链主企业"并非单纯指规模最大,而是具备三力的行业核心,且往往由地方政府或国家层面认定:
- 技术引领力——掌握核心技术、专利、标准,牵引行业技术路线
- 资源整合力——整合上下游供应链、人才、资本的组织能力
- 生态构建力——带动配套企业集聚、构建产业生态
分析链主的动作:有检索/联网工具就全网检索认定文件、链主企业名单与三力证据;按三力逐项
核对给结论;注明认定来源(政府名单/文件)。没有认定来源或三力证据不足 → "待核"——
不得因为"规模最大"就填链主。链主肩负"延链、补链、强链"使命,依据栏可注明其强链任务。
三问:我是谁、依靠谁、为了谁
不管哪个尺度,分析必须汇成三问结论,写在图谱的"三问"区(模板 DATA.sanwen):
- 我是谁——主体在链上的位置与角色:产业尺度=这条链处于什么环节、链的成色如何;
项目尺度=项目本体定位(落在哪条链的哪个环节) - 依靠谁——上游与依赖:产业尺度=上游供给/链主订单/链长政策;项目尺度=前置项目/数据系统/发起人资源
- 为了谁——下游与去向:产业尺度=下游应用/终端市场;项目尺度=使用方/验收方/后续复制
三问中任何一问答不上来,就是高影响空缺,直接进红色警示。
警示色:不清晰点按影响程度分级
待核与空缺不画成一个颜色——按"这个点不清晰,对产业/项目的影响程度"分级:
- 红(高影响):卡点级——链长空缺(无人拍板)、链主无认定来源、上游断供风险、下游无人接,
直接威胁成立或堵死主链 - 黄(中影响):影响质量/进度/协同,但存在替代路径
- 灰(低影响):外围信息,可后补
判定只问一句:"这个空缺一直空着,链/项目会怎样?"——断链停摆=红,降级减速=黄,基本无感=灰。
模板按角色的 impact 字段(high/mid/low)自动配色,角色表加"影响度"列;三问问不上来的位置默认红。
输出
主输出:单文件 HTML 图谱。 复制本 skill 的 assets/ecosystem-map.html,
只编辑文件顶部的 DATA 数据块(标题、尺度、三问结论、各层角色及其影响度),布局与样式不动:
- 三问区:图上方渲染"我是谁 / 依靠谁 / 为了谁"三张卡,答不上来的字段红字"待明确"
- 分层布局:治理层在最上,核心层居中,链上层按上/中/下游三列,支撑层在外圈(底部)
- 状态样式:已确认=实线绿标;待核/空缺按影响度标警示色——红(高影响)、黄(中影响)、灰(低影响),空缺另加"待补"字样
- 图下方自动生成角色表(层|角色|谁|状态|影响度|依据)与图例
角色表(HTML 已内置;单独给文本时用这个格式):
| 层 | 角色 | 谁 | 状态 | 影响度 | 依据 |
|---|------|----|------|--------|------|
| 治理层 | 链长 | (待补) | 空缺 | 高 | — |
| 链主层 | 链主企业 | 某某集团 | 待核 | 高 | 模型知识,未核实 |
| 链上层·中游 | 面板制造 | 某某光电 | 已确认 | — | 来源:《某市产业链发展报告》 |
兜底:用户环境打不开 HTML 时,输出 mermaid 图 + 角色表:
graph TD
A["治理层:链长(空缺)"] --> B["链主:某某集团(待核)"]
B --> C1["上游(空缺)"]
B --> C2["中游(已确认)"]
B --> C3["下游(空缺)"]
S["支撑生态:园区/平台/高校/资本"] -.-> B
落盘(z-系列工作区约定):项目语境下,把角色表落盘为 docs/00-立项/生态角色表.md(含三问结论与依据列,供 z-clarify 维度 4/6 回填、z-assess 风险登记复用),HTML 图谱文件由模型写入当次会话的合适位置并在回复中引用;落盘前一句话告知路径,用户说不落就不落;已有同名文件先给差异摘要再覆盖。非项目语境只出对话产物。基线后(部署期):工程文档基线已存在(docs/01-需求/ 起)时重绘生态,角色表改落 docs/05-管理/变更/生态角色表-<主题>.md(00-立项/ 已冻结),HTML 图同批另出。
Gen UI 宿主内联展示(ZCode Desktop 等):图谱文件写入宿主声明的会话可视化目录(小写连字符文件名,如 ecosystem-map.html),当轮回复以独立一行引用(不包代码块):
::visualize{"path":"<会话可视化目录>/ecosystem-map.html"}
注意:本模板是完整 HTML 文档(含 doctype/head/body),与交互面板的"片段"约束不同——保持完整文档即可;其余硬约束同面板(<1MB、无网络请求)。引用不渲染时(个别宿主只支持片段),改为输出去掉文档外壳的片段版再引用;仍不行退 mermaid 兜底。
数据来源规则
- 用户材料优先:用户给的文件、口述,摘录填入,标"已确认"并注明来源。
- 有检索/联网工具时先检索再填:检索到的公开信息标"已确认"并注来源;
检索不到的位置保持空缺,不得用模型知识顶替。 - 没有检索工具时,模型知识只进"待核",一律不标"已确认"。
与 z-系列的关系
z-flow-kickoff(编排:开场协议→契约→横幅→交接→续跑)
└─ z-pyramid(拆解) → z-clarify(澄清→登记册) ⇄ z-chain(本 skill:生态/干系人事实)
↓
z-assess(四维+风险+假设 → Go/No-Go)
↓ Go
z-init(工程文档基线化) → 下游 spec/开发(松耦合,AGENTS.md 契约)
- z-clarify 维度 4/6(干系人/生态链定位)回答"某个事项在生态中的位置"——本 skill 产出整张地图。
先建图、再定位:图在手,维度 6 的三问(定位/关系/卡位点)直接在图上答;已建图时维度 4 读图补空,不重复追问。 - z-assess 承担评估内容框架(四维可行性/风险/假设 → Go/No-Go)。此前"立项决策=生态图+金字塔"的说法精确为:
生态图供事实(空位=风险证据),z-assess 出框架与结论,z-pyramid 供表达结构。 - z-pyramid 是全系列的方法论层,本 skill 不做判断,判断类问题经 z-assess 落结论。
- 各 skill 相互独立、按需组合。
边界
- 不做产业规划建议、不做招商/立项评估、不做工作量评估——图谱只盘点事实结构,
判断和建议是下游的事;用户明确要建议时,单独成节并注明超出图谱范围。 - 空缺不猜补:宁可交一张有大片空位的图,不交一张编满的图(铁律 1)。
- 需求澄清由 z-clarify 主导,本 skill 在生态图谱环节被引用。