SuperAPI AI 工具集

blog

通用与其它

查看项目

更新于 10-16 09:31

技能介绍

用途:为用户的个人 Astro 博客撰写文章,主题多为折腾项目、写 skill、调试问题等经历的记录,调子是第一人称、平实自嘲、不写成技术教程,并如实交代 AI 参与度。

触发场景:用户说想写篇博客、做某事值得写一篇、给出博客目录加素材,或提到博客加上想聊思路。

主要流程:先定位博客仓库(本地路径随机器变化,禁止写死绝对路径;可用用户给的路径,或按 git remote 含 zkl2333/blog 且存在 src/content/post/ 来扫描,找不到就问用户);然后收集背景(读相关代码、git 历史、上一篇博客、仓库配置),再采访用户,每轮只问 1 至 3 个问题,并对用户记忆中的事实用 git 历史与代码状态校对。之后先提交大纲(标题候选、分段概括、字数估计、调子说明,叙事类需先确认因果时序),通过后才写正文,文件路径为 src/content/post/<slug>/index.md,slug 用 kebab-case。配图优先用现成素材,仓库支持 frontmatter 未设 coverImage 时自动用正文首图作封面。

验证与提交:运行 cd <blog-repo> && pnpm exec astro check 确认 0 errors;含 mermaid 的文章需起 dev 实渲检查,窄栏用 flowchart TD。提交按仓库风格写中文 conventional commit(如 feat: 新增 <topic> 探索博客),默认不 push。最后做一次反思,将本次学到的偏好与踩坑整理成对技能文件的具体编辑提案,交用户确认后应用并单独提交到 skills 仓库。

限制:不得跳过背景收集与采访直接写草稿(除非用户明确说没空采访,则需说明草稿依据的素材);不编造用户体感;不写成教程或加教学性括注;不隐瞒 AI 参与;引用旧文须用原文核对;frontmatter title 上限 60 字符、tags 全小写;cross-link 后缀带斜杠。具体采访问题库、文风对照、schema 与配图细节见技能内 references 目录,本资料未提供其全文。