| name | infocard-content-types |
| description | 信息卡内容类型标准 — 写卡前必须先确定内容类型,再按对应模块结构填充。触发:写新卡、重建卡、修复"内容空洞"。 |
| version | 2.0.0 |
| author | Hermes Agent |
| license | MIT |
| metadata | {"hermes":{"tags":["infocard","content","authoring","quality"],"related_skills":["infocard-publish-sop","infocard-theme-assignment","infocard-authoring-workflow"]}} |
信息卡内容类型标准
核心原则
内容类型决定结构,不是主题决定结构。
同一主题可以有两种以上的内容形式,选哪种取决于读者最需要什么。不存在"万能模板"。禁止把所有主题压缩成“Hero + 统计卡片 + 链接”的通用模板。
写卡前必须在 authoring spec 中显式声明:
content_type
content_subtype
required_modules
primary_source
evidence_gaps
每个必须模块都必须有具体事实、示例、命令、参数、关系或边界说明;只有模块标题而没有实质信息,视为未完成。
每张卡写之前必须:
- 确定内容类型
- 在本 Skill 中找到对应分类和必须模块
- 确认该类型对应的必须模块
- 不得省略任何必须模块
- 可选模块按主题相关性添加
如果主题无法归入本 Skill 已定义的分类,停止写卡并与用户讨论分类架构;不得自行发明临时分类、把主题硬塞进最相近分类,或直接套用通用模板。新增分类必须先经过用户确认,再写入本 Skill 后实施。
类型一:工具类
定义:可安装、可运行的软件工具(CLI / 桌面 / 浏览器插件 / Web 工具)。
子类型:CLI / 脚本
必须模块:
- 安装命令(覆盖主流系统)
- 初次使用示例(最常用的一条命令)
- 核心参数说明(至少 3 个,含默认值和效果)
- 适用环境 / 依赖
- 许可协议
更新卡额外要求:
可选模块:
子类型:桌面 / GUI 应用
必须模块:
- 下载入口(官网 + GitHub Release)
- 安装方式(安装包 / 便携版 / 包管理器)
- 初次使用引导(3 步以内)
- 核心配置项(至少 3 个)
- 适用场景(什么人、什么任务)
- 许可协议
更新卡额外要求:
可选模块:
子类型:浏览器插件 / Web 工具
必须模块:
- 获取地址(商店链接 / 直接下载 URL)
- 添加到浏览器步骤(3 步以内)
- 初步使用说明
- 核心设置项(至少 3 个)
- 注意事项(权限、隐私、数据留痕等)
- 适用场景
更新卡额外要求:
可选模块:
类型二:数据集类
定义:以结构化数据为核心交付物的资源,供训练、评估或参考使用。
必须模块:
- 规模指标(样本量 / 时长 / 文件数 / 字段数)
- 字段 / Schema 定义(表格或列表,含数据类型和说明)
- 一条真实样本记录(不做任何脱敏的真实数据)
- 数据格式(JSON / CSV / Parquet / SQL 等)
- 获取方式(下载 / API / 申请流程)
- 许可协议
- 适用场景 / 用途限制
如有基准测试结果:
可选模块:
- 数据分布统计
- 质量评估方法
- 清洗或预处理建议
- 与同类数据集对比
类型三:集合 / 生态类
定义:多个独立条目(工具 / Agent / 角色 / 资源)的集合。
子类型:工具集合
必须模块:
- 收录清单总览(总数、来源)
- 分类方式(按什么维度分类)
- 每个分类下的代表性条目(含名称、简介、关键指标)
- 适用场景对照(场景 → 该选哪个分类)
- 安装 / 获取方式
- 许可说明
可选模块:
子类型:Agent / 角色集合
必须模块:
- 收录数量 + 来源
- 角色分类(按职能 / 部门 / 场景,每个分类给出 2-3 个代表角色)
- 代表角色简介(含核心人设、专业领域、典型工作流)
- 安装使用方式
- 精选推荐(按使用场景)
可选模块:
- 角色之间协作方式(如编排器)
- 如何选择适合自己的角色
- 角色更新频率
类型四:框架 / 平台类
定义:提供基础设施或运行环境,供他人构建自己产品的软件系统。
必须模块:
- 一句话定位
- 核心架构说明(模块关系,可文字可图)
- 支持的模型 / 工具 / 协议
- 快速启动(命令或步骤,5 步以内)
- 核心配置参数(至少 3 个)
- 生态周边(插件、模板、SDK)
- 许可协议
可选模块:
类型五:技巧 / 方法论类
定义:以方法、策略、操作步骤为核心内容的条目。
必须模块:
- 背景:解决什么问题
- 原理简述(1-2 句话,非源码级)
- 适用场景
- 具体步骤或代码示例(可直接复制使用)
- 风险 / 边界说明(必须有,不能只讲好处)
可选模块:
- Before / After 效果对比
- 常见误区
- 替代方案
类型六:模型卡
定义:以机器学习模型 / AI 模型为核心交付物的条目。
必须模块:
- 基本信息(版本、发布机构、发布日期)
- 关键能力(一句话 + 量化指标)
- 基准测试结果表(至少 3 个基准)
- 许可协议
- 使用限制 / 禁则(如有)
- 与同类型模型的差异(至少 1 个对比维度)
- 获取方式
可选模块:
类型七:API / 服务类
定义:以网络 API 或在线服务为核心交付物的条目。
必须模块:
- 端点说明(基础 URL + 主要端点)
- 鉴权方式
- 请求示例(可直接复制的 curl 或代码)
- 核心参数(至少 3 个)
- 返回格式示例
- 速率限制
- 适用场景
如有定价:
可选模块:
类型八:研究论文类
定义:以学术论文或研究报告为核心内容的条目。
必须模块:
- 核心结论(一句话)
- 方法概述(200 字以内)
- 关键数据或图表描述
- 数据集或代码链接
- 引用格式信息
- 与前人工作差异
可选模块:
内容空洞诊断清单
写完后发布前,用以下问题自检。如有任何一项为"否",该模块必须补充。
与主题分配的关系
本 skill 只产出内容契约:content_type、content_subtype、content_shape、required_modules、required_capabilities、primary_source 和 evidence_gaps。它可以声明主题所需的能力(例如 tables、code_blocks、mobile_layout),但不得写具体主题名、Primary/Fallback 映射、权重或随机规则。
随后由 infocard-theme-assignment 读取这些能力,生成候选池并写入唯一的 .docs/<run-id>/<slug>/theme-decision.json。内容类型决定“需要什么结构”,主题分配决定“哪个已注册主题能承载它”;两者通过能力契约相连,不形成强绑定。