SuperAPI AI 工具集

@1892/starchild-blog

写作与研究

查看项目

更新于 10-16 11:02

技能介绍

Starchild Blog 技能是一个供 AI 智能体安装使用的工作流技能,面向 Starchild Blog 的完整内容生命周期:草稿 → 格式化 → 标题与头图 → SEO → 预览 → 发布。

【项目结构】 根目录为 output/projects/starchild-blog/。config.py 存放站点常量(SITE_URL、SITE_NAME、CTA、UTM 等);build.py 为生成器,可用 python3 build.py [--check] 运行;scripts/import_article.py 可将任意 HTML 文章导入为草稿;scripts/og_image.py 在未设置 og_image 时自动生成 OG 卡片;templates/ 含 base.html、home.html、post.html、tag.html;assets/ 含样式、字体、字标与本地 Chart.js;assets/images/ 存放头图;content/posts/ 以 YYYY-MM-DD-<slug>.md 为唯一内容源;public/ 为构建输出,不可手工编辑。

【主要能力】

  1. 创建草稿:支持导入社区/X/任意 HTML 页面,导入器会抓取页面、将 CSS 作用域限定在 .sr-article 下、中和页面级样式(背景改为博客白底、统一 Google Sans 字体)、移除源 h1、将 Chart.js CDN 引用本地化、正确解码 UTF-8,并写出 draft: true 的 Markdown 文件;也支持手写新文章。
  2. 格式化富文本文章:标题、标签、元数据、表头等统一为博客字体与字重,保留布局与数据可视化样式;保持 3–9×、α、≠、× 等合法技术符号,仅去除 em dash 这类 AI 化表达。
  3. SEO 结构:build.py 自动为每篇文章生成 <title>、meta description、canonical、Open Graph、article:published_time/tag、JSON-LD Article + Organization,以及站点级 feed.xml、sitemap.xml、robots.txt、api/posts.json 和标签页。
  4. 头图强制要求:每篇文章必须有 hero_image,渲染在标题上方全宽显示并兼作社交卡片;若用户未提供需索取或生成品牌一致的头图,无头图不得发布。
  5. 预览:两个预览自动启动,1892-starchild-blog-poc 服务 public/ 全站(端口 9081),1892-starchild-blog-drafts 服务 public/drafts/(端口 9086)。
  6. 发布:通过 community-publish 技能的 publish_preview 发布到同一受保护 slug(starchild-blog → 1892-starchild-blog),原位刷新现有站点,不新建或重指域名绑定。

【使用方式】 导入文章:cd output/projects/starchild-blog 后运行 python3 scripts/import_article.py "<URL>" --date 2026-07-01 --slug my-slug --title "..." --author "..." --tags ... --description "...",再 python3 build.py。构建校验用 python3 build.py --check。发布前将草稿 frontmatter 中 draft 改为 false,重建,再调用 publish_preview(preview_id="1892-starchild-blog-poc", slug="starchild-blog", title="The Starchild Blog")。

【适用场景】 新建 Starchild 博客文章、导入社区或 X 文章、编辑现有文章、发布上线、SEO 与 UTM 追踪配置、草稿评审分享。

【限制与注意事项】 受保护 slug 1892-starchild-blog 绝不可取消发布、停止、覆盖或重指,发布重建到该 slug 是允许的。只编辑 content/posts/*.md,不改 public/(每次构建会清空重建)。正文禁用 em dash 和水平分隔线。不得编造数字,导入须保留所有原始数字、基准、日期与模型名。草稿为 noindex 且被 robots 禁止,不在 feed/sitemap/api 中,但不做访问控制,不可放真正私密内容。发布只能通过 community-publish 技能,禁止手动 curl 服务 API。UTM 标签仅用于站外营销链接,内部链接、资源、RSS、canonical/OG、JSON-LD 不加 UTM。PostHog 配置在目标站 iamstarchild.com 上,仅装在博客无助于转化归因;UTM 属性需至少有一次事件后才在界面显示。