| name | lyzbcy-blog-maintainer |
| description | Maintenance and handoff guide for the lyzbcy.github.io project. Use this skill whenever someone is asked to modify, debug, publish, or review this specific Jekyll/Chirpy blog repository, especially for posts, encrypted articles, GitHub Pages deployment, local preview, workflow troubleshooting, or project handoff. Also use it when a new maintainer needs to quickly understand common pitfalls, safe edit patterns, and repo-specific conventions. |
lyzbcy.github.io 项目维护 Skill
这个 Skill 不是通用的 Jekyll 教程，而是 这个仓库自己的接手说明 + 易错点说明 + 安全维护流程。
目标
在接手 lyzbcy.github.io 项目时：
- 快速理解仓库结构
- 优先避开已经踩过的坑
- 用更安全的方式修改内容
- 在需要时再逐步展开更细的参考文档
使用原则
- 先识别任务类型，再读对应参考文件。 不要一上来把所有参考文档都读完。
- 优先最小修改。 对已有文章、布局、脚本、workflow，尽量只改目标点位。
- 修改前先看上下文。 特别是 HTML、YAML front matter、Liquid、JS 混合区域，不能盲改。
- 对中文内容和编码保持敏感。 这个仓库包含大量中文文章与前端模板，任何批量替换、脚本回写、跨工具编辑前，都要先确认编码策略。
- 先本地确认，再提交发布。 涉及页面结构、加密文章、GitHub Pages workflow 时尤其如此。
推荐接手顺序
1) 先看仓库结构
重点关注：
_posts/：博客文章assets/：样式、脚本、图片等资源_config.yml：站点配置、URL、permalink 等.github/workflows/：GitHub Pages 构建/部署_includes/、_plugins/：布局与行为扩展
2) 根据任务类型读取对应参考
- 如果是 文章编辑 / 加密文章 / front matter → 读
references/content-and-posts.md
- 如果是 部署 / workflow / GitHub Pages → 读
references/deploy-and-workflow.md
- 如果是 前端交互 / 局部加密 / 页面行为 → 读
references/frontend-and-ui.md
- 如果是 准备交接 / 总结经验 / 补充规则 → 读
references/maintenance-rules.md
3) 修改时遵循安全流程
- 先读目标文件，不要凭猜测替换
- 小步编辑，避免大块正则误伤
- 涉及中文文件回写时，确认编码不被破坏
- 涉及线上页面时，优先验证生成结果或 diff
- 发布后记录新增坑点到对应 reference，而不是重新堆回单一“大杂烩文档”
输出要求
当你协助维护这个仓库时，输出应尽量包含：
- 改了什么
- 为什么这么改
- 是否有 repo-specific 风险
- 如果发现新坑，应该补到哪个 reference 文件里
维护规则
新经验怎么写
不要再往一个无限增长的“错题本”里堆流水账。
应按主题写入：
references/frontend-and-ui.mdreferences/deploy-and-workflow.mdreferences/content-and-posts.mdreferences/maintenance-rules.md
什么内容值得沉淀
只沉淀：
- 高复现概率的坑
- 这个仓库特有的约定
- 会导致破坏性结果的错误操作
- 对新人接手很关键的快速判断规则
不要沉淀：
- 一次性的闲聊记录
- 纯过程流水账
- 没有抽象价值的临时命令
快速决策提示
如果你只剩很少时间，至少先做这三件事：
- 读取目标文件原文
- 读取最相关的 reference 文件
- 只做最小范围修改
