用途:为 Hugo 静态博客提供对话式后台,替代 CMS。用户说要发帖或改内容,技能按仓库约定修改 content/、放入图片、commit、push,走仓库现有部署流程自动上线。适用于 content/posts/*.md 加 categories/tags taxonomy、由 GitHub Pages Actions 部署的 Hugo 站;其它 Hugo 仓库也可用,需先对齐约定。
前置检测:确认在 Hugo 仓库根(有 hugo.toml 或 config.toml 和 content/);读 hugo.toml 获取 timeZone 和 taxonomies;查看现有帖子 front matter,确认字段与默认格式一致,不一致以仓库现状为准。
主要能力与用法:新增帖子时用脚本生成,避免手写 front matter 漂移:echo "<正文 markdown>" | python3 <SKILL_DIR>/scripts/new-post.py --repo <仓库根> --title "标题" --category "知天命" --slug 可选英文slug。不传 --slug 时按标题派生文件名,不传 --url 时默认 /<首个类目>/<标题或slug>/。编辑帖子直接改对应 md,内容变更后更新 lastmod,date 不动。管理类目先用 bash <SKILL_DIR>/scripts/categories.sh <仓库根> 列出现有类目避免重复;新增类目写入 categories[] 即可,改名或合并需批量替换并提醒旧链接失效。上传图片用 python3 <SKILL_DIR>/scripts/add-image.py <本地图片> --repo <仓库根> --alt "说明",新图放 static/uploads/<年>/,超 2000px 宽会用 macOS sips 自动缩小。发布前可 hugo server -D 本地预览,确认后用 bash <SKILL_DIR>/scripts/publish.sh "post: <标题>" <仓库根> 发布,本人 push 会触发 deploy.yml 构建上线。
限制:只做新增/编辑帖子、管理类目、上传图片、发布;不做评论、用户管理、草稿工作流、定时发布。图片不要放进 static/wp-content/uploads/ 历史目录,需避免 url 撞车,类目命名先查重。