| 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_typecontent_subtyperequired_modulesprimary_sourceevidence_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。内容类型决定“需要什么结构”，主题分配决定“哪个已注册主题能承载它”；两者通过能力契约相连，不形成强绑定。
