SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场create-blog-post-tw

create-blog-post-tw

写作与研究

查看项目

更新于 10-16 08:20

技能介绍

用途

该技能引导在正体中文 AI 辅助技术博客「聆.tw（琳聽智者漫談）」上创建一篇新技术文章的完整工作流，从仓库设置一直到提交 PR。当用户想要撰写新博客文章、创建文章或向该博客投稿时使用。

前置条件

  • 可用的 git CLI
  • 已通过 GitHub 认证的 gh CLI
  • 对 jim60105/ai-talks-content 的写入权限

使用方式（工作流）

步骤 1：克隆仓库

若尚未克隆博客仓库：

git clone --recurse-submodules https://github.com/jim60105/blog.git cd blog

若已克隆但缺少子模块：

git submodule update --init --recursive

若已克隆且子模块存在，只需确保其为最新：

git pull origin master

步骤 2：准备子模块

进入内容子模块并确保其位于最新 master：

cd 聆.tw/content git checkout master git pull origin master cd ../..

步骤 3：切换到 聆.tw 模式

在项目根目录（blog/）执行：

./switch-site.sh 聆.tw

这会为 config.toml、content/、static/ 和 wrangler.jsonc 创建指向 聆.tw/ 的符号链接。

步骤 4：选择栏目并准备文件

列出可用的内容栏目：

ls -d 聆.tw/content/*/

选择与主题最相关的栏目。若没有合适的，使用 Uncategorized。

步骤 5：创建文章文件

创建一个使用 slug 化文件名的 markdown 文件（小写、连字符、英文、具描述性）：

touch 聆.tw/content/<Section>/my-descriptive-slug.md

命名约定：使用小写英文单词，以连字符分隔。slug 应简洁地描述文章内容。

步骤 6：撰写 Front Matter

阅读项目根目录的 AGENTS.md 以获取最新的 front matter 规范。所需格式：

+++ title = "文章標題（正體中文）" description = "SEO 友善的文章描述，包含所有重要關鍵字（正體中文）" date = "YYYY-MM-DDTHH:MM:SSZ" updated = "YYYY-MM-DDTHH:MM:SSZ" draft = false

[taxonomies] tags = ["Tag1", "Tag2"] providers = [ "Felo Search" ]

[extra] withAI = "https://the.ai.resource/used" +++

规则：

  • title：简洁、SEO 友好、正体中文
  • description：包含所有关键词，对搜索结果有吸引力
  • date：ISO 8601 UTC 格式，使用当前时间戳
  • updated：ISO 8601 UTC 格式，使用当前时间戳
  • tags：与现有文章格式一致的相关标签
  • providers：撰写文章时使用的 AI 辅助提供方（如有）
  • withAI：关于 AI 辅助的简要说明或所用 AI 资源的 URL。可选，但为透明起见建议填写
  • 切勿伪造 iscn 字段——只有用户才能生成该字段

步骤 7：撰写博客文章内容

阅读项目根目录的 .github/instructions/quill-sage.instructions.md 以获取完整编辑指南。快速参考见 references/writing-guidelines.md。

关键规则：

  • 使用正体中文（zh-TW）与全角标点撰写
  • 中文字符与字母数字字符之间加一个空格
  • 使用倒金字塔结构：核心结论在前，证据在后
  • 除非明确要求，避免项目符号列表；优先使用自然段落
  • 使用 ## 和 ### 子标题组织内容
  • 以「讀者」「大家」「各位」或「你」称呼读者，绝不使用「您」
  • 以「我」指代作者，绝不使用「我們」
  • 开头段落陈述核心结论与范围
  • 结尾段落不得使用口号式结尾

步骤 8：添加格式与颜色短代码

审阅文章并用以下方式增强：

  • 粗体（text）用于强调关键词
  • 斜体（text）在合适处使用
  • 用于优缺点对比的颜色短代码：
    • 绿色（正面）：{{ cg(body="positive text") }} 或 {% cg() %}block text{% end %}
    • 红色（负面）：{{ cr(body="negative text") }} 或 {% cr() %}block text{% end %}

步骤 9：添加聊天短代码

使用聊天短代码创建对话式内容，使文章生动：

{% chat(speaker="yuna") %} Question or statement from Yuna {% end %}

{% chat(speaker="jim") %} Response from Jim (author, displayed as 琳, aligned right) {% end %}

可用说话者：chatgpt、claude、gemini、copilot、felo、jim（作者，右对齐）、yoruka，或任意自定义名称。默认/用户获得通用用户头像。

设计能自然引入主题、提出澄清问题或引出有趣角度的对话。聊天格式应增加价值，而不仅仅是装饰。

步骤 10：SEO 审阅——重写标题与描述

完成内容后，重新评估：

  • 标题：为 SEO 重写。将主要关键词放在靠前位置。保持简洁但具描述性。正体中文。
  • 描述：重写以包含文章中的所有重要关键词。此文本会出现在搜索结果中——使其有吸引力且信息丰富。理想长度约 150-160 字符。

步骤 11：若标题变更则重命名文件

若标题有重大修改，重命名文件以匹配：

mv 聆.tw/content/<Section>/old-slug.md 聆.tw/content/<Section>/new-better-slug.md

slug 应以英文反映最终标题内容。

步骤 12：创建分支、提交与 PR

所有 git 操作都在子模块（聆.tw/content/）内进行：

cd 聆.tw/content git checkout -b post/<slug-name> git add <Section>/new-post-file.md git commit --signoff --author="GitHub Copilot bot@ChenJ.im" -m "feat: add post <descriptive-title>

Add new blog post about <topic summary>.

Co-authored-by: GitHub Copilot bot@ChenJ.im" git push origin post/<slug-name>

然后创建针对 jim60105/ai-talks-content 上 master 的 PR：

gh pr create
--repo jim60105/ai-talks-content
--base master
--head post/<slug-name>
--title "feat: add post <descriptive-title>"
--body "Add new blog post: <title>

<brief description of content>

Written with AI assistance."

步骤 13：请求审阅

gh pr edit --repo jim60105/ai-talks-content <PR_NUMBER> --add-reviewer jim60105

术语映射

撰写内容时应用以下正体中文映射：create = 建立，object = 物件，queue = 佇列，stack = 堆疊，information = 資訊，code = 程式碼，running = 執行，library = 函式庫，building = 建構，package = 套件，video = 影片，class = 類別，function = 函式，memory = 記憶體，document = 文件，example = 範例，tutorial = 指南。

适用场景

适用于需要向「聆.tw（琳聽智者漫談）」博客投稿技术文章、并希望按既定规范完成从仓库准备到 PR 提交全流程的场景。

限制

使用前需具备 git CLI、已认证的 gh CLI，并拥有 jim60105/ai-talks-content 的写入权限。iscn 字段只能由用户生成，不得伪造。