linkedin-announcement-generator

Name: linkedin-announcement-generator
Author: dmccreary

github.com/dmccreary营销与增长10938 次安装1 天前更新

代码仓库

关于 linkedin-announcement-generator

linkedin-announcement-generator 是用于撰写智能教材 LinkedIn 公告的技能。它读取教材元数据和学习图指标，生成三种长度的公告版本，并单独提供首条评论中的链接文本。

主要功能

01读取教材元数据与图谱指标
02评估教材完成状态
03生成三种长度的公告版本
04单独生成首条评论链接文本
05建议相关标签和配图

适用场景

01发布已完成教材的消息
02分享章节或内容里程碑
03推广更新后的教育资源
04为课程发布准备社交媒体内容

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/dmccreary/ibook-skills --skill linkedin-announcement-generator

安装后在 Claude Code 中输入/linkedin-announcement-generator确认已加载。

详细介绍

LinkedIn 公告生成器

概述

此技能可自动为智能教材创建专业的 LinkedIn 公告。它会分析 docs/learning-graph/ 目录中的图书指标，收集有关章节、概念和教育资源的统计数据，并生成包含相关话题标签和已发布网站链接的吸引人公告文案。

这些公告旨在突出教材的范围和完整性，展示其教育特色，并吸引教育工作者、学生和学习领域的专业人士关注相关内容。

何时使用此技能

在以下情况下使用此技能：

将已完成的智能教材发布到 GitHub Pages 时
宣布重要里程碑时（例如，“前 10 章已完成！”）
推广更新或新添加的内容时
与教育技术社区分享教材时
为课程发布准备社交媒体帖子时
为会议演讲或研讨会撰写公告时
提高人们对开放教育资源的认知时

前提条件

智能教材项目应具备：

docs/learning-graph/book-metrics.json 文件，其中包含规范的教材统计数据（由 book-metrics 工具生成）。如果该文件不存在，请先使用 bk-generate-book-metrics 生成（或使用备用命令 python3 "$BK_HOME/src/book-metrics/book-metrics.py" docs）。
包含 site_name、site_url 和 site_description 的 mkdocs.yml 文件
已部署到 GitHub Pages（或其他托管平台）的网站
可选：docs/learning-graph/chapter-metrics.md，用于提供章节级别的详细信息
可选：docs/course-description.md，用于提供受众和主题信息

工作流

步骤 1：收集图书元数据

从项目配置中提取关键信息：

阅读 mkdocs.yml，获取：
- site_name - 教材标题
- site_url - 在线网站 URL（通常为 GitHub Pages）
- site_description - 教材简介
- repo_url - GitHub 仓库 URL
阅读 docs/course-description.md（如果存在），获取：
- 目标受众（年级、先修要求）
- 学科/主题
- 学习目标
- 课程背景

提取示例：

site_name: 'Geometry for High School Students'
site_url: 'https://username.github.io/geometry-course/'
site_description: 'An interactive geometry textbook with MicroSims and quizzes'

步骤 2：分析图书指标

读取规范指标文件 docs/learning-graph/book-metrics.json—— 不要解析供人阅读的 book-metrics.md 表格（容易出错），也不要自行重新统计内容。README 和案例研究技能也使用同一数据源，因此各类材料中的数字能够保持一致。

python3 - <<'PY'
import json, pathlib, sys
p = pathlib.Path("docs/learning-graph/book-metrics.json")
if not p.exists():
    sys.exit("book-metrics.json missing — run bk-generate-book-metrics first")
m = json.loads(p.read_text())["metrics"]
print(json.dumps(m, indent=2))
PY

核心指标（metrics 对象中的键）：

chapters — 章节数
concepts — 学习图谱中的概念数
glossaryTerms — 术语表词条数
faqs — 常见问题数量
quizQuestions — 测验题数量
diagrams — 图表数量
equations — 公式数量
microsims — MicroSims 数量（交互式模拟）
words — 总词数
links — 超链接数量
equivalentPages — 相当于多少印刷页
developmentStage — 作者声明的出版阶段

如果 book-metrics.json 不存在，请先使用 bk-generate-book-metrics 重新生成，然后再读取。格式定义见 src/book-metrics/book-metrics.schema.json。

妥善处理缺失的指标：

如果 diagrams = 0，则改为提及“包含公式和视觉元素”
如果测验题数量 = 0，则省略测验相关内容
如果 MicroSims = 0，则改为提及“内容全面”

步骤 3：确定教科书的完整度

根据以下指标计算完成状态：

完整度指标：

章节数 ≥ 8：内容充实的教科书
总字数 > 30,000：内容全面
测验题数 ≥ 50：评估充分
MicroSim 数量 ≥ 5：包含互动元素
等效页数 > 100：达到书籍篇幅

状态类别：

已完成（100%）：所有主要组成部分均已具备，可供使用
即将完成（90-99%）：大部分内容已完成，仅待少量补充
进行中（70-89%）：内容充实，仍在持续开发
早期发布（< 70%）：已提供初始章节，后续内容将陆续发布

根据状态选择合适的公告措辞。

步骤 4：构建公告结构

撰写 LinkedIn 帖子，包含以下部分：

1. 开场钩子（1-2 句话）

以引人注目的陈述开篇：

宣布教科书已完成或发布
提及主题和目标受众
突出其独特之处

示例：

“很高兴与大家分享一份面向 [受众] 的全新开放教育资源！”
“刚刚发布：一本关于 [主题] 的 AI 生成互动式教科书！”
“欣然宣布 [教科书名称] 已完成！”

2. 内容介绍（2-3 句话）

说明教科书的内容及其独特功能：

教育框架（布鲁姆分类法、概念依赖关系）
互动元素（MicroSim、测验）
技术栈（MkDocs、p5.js、AI 生成）
目标受众和先修要求

示例：

This intelligent textbook on [TOPIC] is designed for [AUDIENCE]. Built using MkDocs Material and AI-assisted content generation, it incorporates learning graphs, concept dependencies, and interactive MicroSims to make [TOPIC] accessible and engaging.

3. 关键指标（项目符号列表）

展示令人印象深刻的统计数据，体现内容规模：

📊 By the numbers:
• [X] chapters covering [TOPIC AREAS]
• [Y] concepts in the learning graph
• [Z] interactive MicroSims (p5.js simulations)
• [Q] quiz questions for self-assessment
• [G] glossary terms with ISO 11179-compliant definitions
• [W] total words (~[P] equivalent printed pages)

格式提示：

使用表情符号项目符号（📊、📚、🎓、⚡、🔬），增强视觉效果
对较大的数字取整（225,182 → 225,000）
将相关指标分组
突出最令人印象深刻的数据

4. 技术和 AI 披露（1-2 句话）

如实说明 AI 的参与情况和所用技术：

Generated using Claude AI skills and the intelligent textbook framework, this open-source project demonstrates how AI can augment educational content creation while maintaining quality and pedagogical rigor.

5. 行动号召（1 句话）

引导读者访问网站，但绝不要在帖子正文中放入 URL。

**“链接放在第一条评论中”规则：**研究表明，LinkedIn 的算法会显著降低正文中包含外部链接的帖子的传播范围。因此，应告知读者链接位于评论中，并将 URL 作为单独的第一条评论文本提供，由用户发布后立即粘贴：

🔗 Link to the full textbook is in the first comment below! 👇

始终随帖子一并生成第一条评论文本：

Explore the full textbook here: [SITE_URL]

此规则适用于所有外部链接（网站 URL、GitHub 仓库、博客文章）——这些链接都不应出现在帖子正文中。

6. 话题标签（8-15 个）

添加相关话题标签，提升内容的可发现性：

标准话题标签：

#AI / #ArtificialIntelligence
#GenAI / #GenerativeAI
#Education / #EdTech / #EducationalTechnology
#OpenEducation / #OER（开放教育资源）
#ELearning / #OnlineLearning

内容相关话题标签：

#Textbook / #InteractiveTextbook
#MicroSims / #Simulations
#Visualizations / #DataViz
#Diagrams / #Infographics
#Quizzes / #Assessment

技术相关话题标签：

#MkDocs / #MaterialDesign
#p5js / #JavaScript
#Python
#ClaudeAI / #AnthropicClaude

领域相关话题标签：

添加 2-4 个与主题相关的话题标签：

数学：#Mathematics、#Geometry、#Calculus、#Algebra
科学：#Physics、#Chemistry、#Biology
计算机科学：#Programming、#ComputerScience、#DataScience
历史：#History、#WorldHistory、#AmericanHistory

专业/学术话题标签：

#LMS / #LearningManagementSystem
#CurriculumDesign
#InstructionalDesign
#STEM / #STEMeducation
#HigherEd / #K12Education

**话题标签总数：**建议使用 10-15 个，以获得最佳传播效果。

步骤 5：应用语气和风格指南

LinkedIn 语气特点：

专业而平易近人
充满热情，但不过度宣传
具有教育性和信息性
以数据为依据（引用具体指标）
透明说明 AI 的参与情况
以社区为中心（分享资源）

写作最佳实践：

使用第一人称（“我很高兴分享……”）
段落保持简短（每段 2-3 行）
谨慎使用表情符号（每篇帖子 1-3 个）
使用换行提高可读性
将重要信息放在前面
以明确的行动号召结尾

避免：

过于学术化的语言
过多的专业术语
缺乏证据的说法
过度宣传的语气
标题党式的开场
使用过多表情符号

步骤 6：生成多个版本

创建三个版本的公告：

版本 1：详细版（完整长度）

完整描述并包含所有指标
1500-2000 个字符
包含所有标签
适用于：首次发布公告

版本 2：中等长度（标准长度）

仅包含关键指标（最重要的 5-6 项）
800-1200 个字符
10-12 个标签
适用于：进度更新、里程碑帖子

版本 3：精简版（短格式）

仅包含必要信息
400-600 个字符
6-8 个标签
适用于：快速更新、跨平台发布

请提供全部三个版本，供用户根据偏好选择。

步骤 7：添加可选增强内容

如有，请包含：

截图或封面图片建议：

📸 Suggested visual: Screenshot of the learning graph visualization or the textbook home page

特色亮点：

如果教材包含独特元素，请突出介绍：

“包含可在浏览器中运行的交互式 p5.js 模拟”
“包含概念依赖关系图，展示学习路径”
“包含符合 ISO 11179 标准的术语表，确保术语准确”

协作邀请：

如需征集贡献者：

“欢迎参与贡献！查看 GitHub 仓库：[REPO_URL]”
“我们正在寻找教育工作者提供反馈。有兴趣的话，请给我发私信！”

相关链接：

如适用（所有外部链接都放在第一条评论中，绝不放在帖子正文中）：

GitHub 仓库链接（面向开发者）
相关博客文章或文章链接
演示文稿幻灯片链接

步骤 8：整理格式并呈现内容

以清晰、便于复制粘贴的格式呈现 LinkedIn 公告：

## LinkedIn Announcement - Full Version

[Paste-ready text here]

---

## LinkedIn Announcement - Medium Version

[Paste-ready text here]

---

## LinkedIn Announcement - Concise Version

[Paste-ready text here]

---

## First Comment (paste immediately after publishing)

[Text containing the site URL — external links go here, never in the post body]

---

## Suggested Enhancements

**Visual:** [Description of recommended image/screenshot]

**Timing:** Best posted [weekday, time recommendation]

**Engagement Tips:**
- Tag relevant individuals or organizations if appropriate
- Respond to comments within first 2 hours for algorithm boost
- Consider posting during peak LinkedIn hours (Tuesday-Thursday, 8-10am or 12-2pm)

步骤 9：检查公告质量

定稿前，请检查公告是否符合以下要求：

步骤 10：交付公告

输出定稿后的公告文本，方便用户：

直接复制并粘贴到 LinkedIn
根据需要添加个人风格
添加可选媒体（截图、视频）
安排发布时间或立即发布

告知用户：

✅ LinkedIn announcement generated successfully!

Three variations provided (full, medium, concise) - choose the one that fits your style.

**Next steps:**
1. Copy your preferred version
2. Paste into LinkedIn post composer
3. Add a screenshot of your textbook (optional but recommended)
4. Review and post!
5. Immediately paste the provided first-comment text (with the link) as the first comment

Remember: keep the link OUT of the post body — LinkedIn reduces reach for posts with external links. The link goes in the first comment.

Pro tip: LinkedIn posts with images get 2x more engagement. Consider adding a screenshot of your learning graph or textbook homepage.

输出示例

完整长度公告示例

🎓 Excited to share a new open educational resource: an interactive textbook on Geometry designed for high school students!

This intelligent textbook combines AI-assisted content generation with proven educational frameworks. Built using MkDocs Material, it incorporates learning graphs showing concept dependencies, interactive MicroSims using p5.js, and comprehensive assessment tools to make geometry accessible and engaging.

📊 By the numbers:
• 13 chapters covering points, lines, angles, triangles, polygons, circles, and 3D geometry
• 200 concepts organized in a dependency graph
• 5 interactive MicroSims (p5.js simulations)
• 10 quiz questions for self-assessment
• 22 glossary terms with precise definitions
• 225,000+ words (~900 equivalent printed pages)

Generated using Claude AI skills and the intelligent textbook framework, this open-source project demonstrates how AI can augment educational content creation while maintaining pedagogical quality and rigor.

All content follows Bloom's Taxonomy (2001) for learning outcomes and includes detailed explanations, worked examples, and practice exercises.

🔗 Link to the full textbook is in the first comment below! 👇

#AI #GenAI #GenerativeAI #Education #EdTech #OpenEducation #OER #ELearning #Textbook #InteractiveTextbook #MicroSims #Visualizations #Quizzes #Geometry #Mathematics #MkDocs #ClaudeAI #LMS #CurriculumDesign #STEMeducation

中等长度公告示例

📚 Just published: An AI-generated interactive textbook on Geometry for high school students!

This intelligent textbook uses MkDocs Material, learning graphs, and interactive p5.js MicroSims to make geometry engaging and accessible.

Key features:
• 13 comprehensive chapters
• 200 concepts with dependency mapping
• 5 interactive simulations
• 225,000+ words of content
• Open source and freely available

Built using Claude AI and the intelligent textbook framework - demonstrating how AI can enhance educational content while maintaining quality.

Link in the first comment below! 👇

#AI #GenAI #Education #EdTech #OpenEducation #Textbook #MicroSims #Geometry #Mathematics #ClaudeAI #STEMeducation

精简公告示例

🎓 New open educational resource: Interactive Geometry textbook for high school!

✨ 13 chapters | 200 concepts | 5 MicroSims | 225K words

AI-generated using Claude and MkDocs Material. Free and open source.

📖 Link in the first comment!

#Education #EdTech #Geometry #AI #OpenEducation #Textbook

第一条评论示例

发布后立即粘贴（外部链接放在这里，而非帖子正文中）：

Explore the full textbook here: https://dmccreary.github.io/ibook-skills/

GitHub repo: https://github.com/dmccreary/ibook-skills

自定义选项

此技能可自定义以下内容：

1. 调整语气：

学术风格（正式、侧重研究）
轻松风格（友好、对话式）
宣传风格（侧重营销）
技术风格（侧重开发者）

2. 面向不同受众：

教育工作者和教师
学生和学习者
教学设计师
软件开发者
教育技术领域的领导者

3. 突出不同方面：

AI / 技术创新
开源 / 开放教育
互动元素
全面覆盖
教学方法

4. 补充背景信息：

作者背景
开发时间线
使用案例和用户评价
研究支持
奖项或认可

支持脚本

指标直接取自规范的 book-metrics.json，无需解析 Markdown。只需编写一个小型辅助脚本来加载 JSON 和站点配置：

scripts/linkedin-metrics-extractor.py

#!/usr/bin/env python3
"""Load canonical metrics + site config for LinkedIn announcements."""

import json
import yaml

def load_book_metrics(metrics_json="docs/learning-graph/book-metrics.json"):
    """Return the `metrics` dict from the canonical book-metrics.json."""
    with open(metrics_json, encoding="utf-8") as f:
        return json.load(f)["metrics"]

def extract_site_config(mkdocs_file):
    """Parse mkdocs.yml and return site metadata (name, url, description)."""
    # Implementation: Load YAML and extract site_name, site_url, etc.
    pass

def format_number(n):
    """Format numbers for readability (e.g., 225182 -> 225,000)."""
    # Implementation: Round and format large numbers
    pass

# Usage:
# python linkedin-metrics-extractor.py docs/learning-graph/book-metrics.json mkdocs.yml

质量标准

高质量的 LinkedIn 公告应当：

准确（所有指标均经过核实）
引人入胜（有吸引力的开场和叙述）
透明（承认 AI 的参与）
专业（语气适合 LinkedIn）
可付诸行动（有明确的行动号召）
易于发现（包含相关主题标签）
简洁（少于 2000 个字符）
有价值（为社区提供有用信息）

故障排除

问题： 未在 book-metrics.json 中找到指标

解决方案： 先生成指标文件——运行 bk-generate-book-metrics（或调用 book-installer 并请求 book-metrics 指南）以创建指标文件

问题： 无法获取站点 URL

解决方案： 向用户询问已部署站点的 URL 或 GitHub Pages 链接

问题： 公告过长（> 3000 个字符）

解决方案： 改用中等或简洁版本

问题： 不确定该使用哪些主题标签

解决方案： 着重选择主题领域标签（例如，数学教材可使用 #Mathematics），以及通用教育标签

资源

支持 Markdown

登录后评论

基本信息

作者: dmccreary
仓库: dmccreary/ibook-skills
分类: 营销与增长
安装次数: 38
GitHub Stars: 109

报告问题