快速开始 · 使用条件 · 工作原理 · 五个案例 · 查看 Skill

TopicMap｜选题地图

一个面向中文内容创作者、商业IP和产品团队的开源 Agent Skill。它把模糊的内容方向拆成一张可编辑、可复用的49格选题白板。

主题域 × 目标人群 × 任务场景 = 一个候选选题

不再从空白页开始想题，也不把短期热点写死在长期内容系统里。

为什么需要它

• 方向太大：知道自己要做AI、商业或装修内容，却不知道长期应该讲哪些子题。
• 用户太泛：知道目标用户是谁，但没有把不同身份和决策阶段拆开。
• 灵感不稳定：选题依赖热点和临时感觉，很难持续复用。
• 经验不可见：脑子里有很多行业知识，却没有形成一张可以讲、可以改的内容地图。

49格怎么工作

层级	数量	回答的问题	例子
核心命题	1	这个账号或产品长期帮助用户完成什么？	用AI提升电商经营效率
主题域	8	长期讲什么？	商品视觉、广告投放
目标人群	16	讲给谁听？	服饰商家、跨境卖家
任务场景	24	用户正在做什么、卡在哪里？	SKU太多做图太慢

痛点是任务场景中的阻力，不额外增加第四圈。热点、个人经历、案例和观点在选题阶段之后再加入。

五个真实案例

同一套结构可以迁移到个人IP、产品营销和不同行业。下面五张图均由 TopicMap 生成，每一层都可以独立替换和重新组合。

AI IP

BeatDesign 产品内容

商业 IP

装修建材

AI 电商

每次生成会同时得到：

*.matrix.json       结构化数据
*.excalidraw        可编辑白板
*.svg               3:4完整白板
*-preview.svg       GitHub和社交平台预览

快速开始

安装 Skill：

npx skills add https://github.com/BeatAPI/topic-map

然后对支持 Agent Skills 的智能体说：

请使用 topic-map，为我的装修建材账号建立一套49格选题矩阵。

也可以克隆仓库，把下面的目录复制或链接到本地 Skill 目录：

skills/topic-map/

需要安装吗？

不需要安装项目依赖，也不需要 API Key。具体取决于你怎么使用：

使用方式	需要什么	是否需要安装项目依赖
让智能体帮你生成	一个支持 Agent Skills 的智能体，并把 skills/topic-map/ 放进它的 Skill 目录	不需要
在本地运行生成器	Node.js	不需要 npm install
查看已经生成的 SVG	浏览器	不需要
编辑 Excalidraw 白板	在 Excalidraw 导入文件	不需要安装桌面软件

下载仓库本身不会自动生成选题。最省事的方式是把 Skill 交给兼容的智能体；如果只想使用脚本，则需要本机已有 Node.js。

直接运行生成器

生成器只使用 Node.js 内置模块，不需要额外安装运行时依赖。

校验示例输入：

npm run validate:example

生成 Excalidraw、SVG和JSON：

npm run render:example

使用自己的输入：

node skills/topic-map/scripts/render_topic_matrix.mjs \
  /path/to/your-input.json \
  --output-dir ./output

输入格式见 references/input-schema.md，分层判断见 references/layer-rules.md。

适合哪些项目

• 个人IP与自媒体账号
• 产品、开源项目和品牌内容
• 电商、装修、教育等行业账号
• 内容团队的长期选题底盘
• 需要用白板讲解选题方法的人

项目边界

这个项目只负责建立长期选题底盘，不自动生成热点库、个人故事、完整口播稿、分镜、发布计划或爆款承诺。

49格产生的是候选方向，不代表任意三格机械组合后都能成为最终标题。创作者仍需结合事实、经验和当期语境完成二次判断。

项目结构

skills/topic-map/
├── SKILL.md
├── assets/       # 示例输入
├── references/   # 层级规则与输入格式
└── scripts/      # 校验器与白板生成器

参与贡献

欢迎提交新的跨行业示例、层级边界改进和GitHub渲染问题。新增示例应保持 1 + 8 + 16 + 24 的固定结构，并避免把短期热点写进长期底盘。

License

MIT

---

_{由 BeatAPI 维护。}