用途:在聆.tw(琳聽智者漫談)技术博客上创建或修改文章,从仓库准备到提交 PR 的完整流程。
主要能力:克隆博客仓库并初始化子模块;切换站点模式;选择内容分区并创建 index.md;按规范撰写 front matter 与正文;使用颜色与聊天短代码增强排版;做 SEO 标题与描述优化;运行 Zola 构建检查;创建分支、提交并提交 PR、请求评审。
使用方式:需 git CLI、已认证的 gh CLI、对 bot0419/ai-talks-content 的写权限,Zola 可选。仓库使用 git 子模块,内容存放在子模块中,所有 git 操作须在 聆.tw/content/ 内执行,且每次运行 git 命令前须检查 pwd 与 git status。克隆命令为 git clone https://github.com/jim60105/blog.git /tmp/blog,随后 git submodule update --init themes/duckquill 聆.tw/content;切换站点用 ./switch-site.sh 聆.tw;构建检查用 zola check --skip-external-links。
适用场景:需要按既定编辑规范在聆.tw 发布或修改技术文章时。
限制:正文须用正體中文并遵守大量写作硬性约束与检查清单;不得编造 iscn 字段,不得包含 licenses 字段;聊天短代码仅限 yuna、jim 两位说话者,jim 出现不超过两次;提交需签名并指定作者。具体分区、标签与提供者取值以仓库现有规范为准。