lyzbcy-blog-maintainer

# lyzbcy.github.io 项目维护 Skill 这个 Skill 不是通用的 Jekyll 教程，而是 **这个仓库自己的接手说明 + 易错点说明 + 安全维护流程**。 ## 目标 在接手 `lyzbcy.github.io` 项目时： - 快速理解仓库结构 - 优先避开已经踩过的坑 - 用更安全的方式修改内容 - 在需要时再逐步展开更细的参考文档 ## 使用原则 1. **先识别任务类型，再读对应参考文件。** 不要一上来把所有参考文档都读完。 2. **优先最小修改。** 对已有文章、布局、脚本、workflow，尽量只改目标点位。 3. **修改前先看上下文。** 特别是 HTML、YAML front matter、Liquid、JS 混合区域，不能盲改。 4. **对中文内容和编码保持敏感。** 这个仓库包含大量中文文章与前端模板，任何批量替换、脚本回写、跨工具编辑前，都要先确认编码策略。 5. **先本地确认，再提交发布。** 涉及页面结构、加密文章、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) 修改时遵循安全流程 1. 先读目标文件，不要凭猜测替换 2. 小步编辑，避免大块正则误伤 3. 涉及中文文件回写时，确认编码不被破坏 4. 涉及线上页面时，优先验证生成结果或 diff 5. 发布后记录新增坑点到对应 reference，而不是重新堆回单一“大杂烩文档” ## 输出要求 当你协助维护这个仓库时，输出应尽量包含： - 改了什么 - 为什么这么改 - 是否有 repo-specific 风险 - 如果发现新坑，应该补到哪个 reference 文件里 ## 维护规则 ### 新经验怎么写 不要再往一个无限增长的“错题本”里堆流水账。 应按主题写入： - `references/frontend-and-ui.md` - `references/deploy-and-workflow.md` - `references/content-and-posts.md` - `references/maintenance-rules.md` ### 什么内容值得沉淀 只沉淀： - 高复现概率的坑 - 这个仓库特有的约定 - 会导致破坏性结果的错误操作 - 对新人接手很关键的快速判断规则 不要沉淀： - 一次性的闲聊记录 - 纯过程流水账 - 没有抽象价值的临时命令 ## 快速决策提示 如果你只剩很少时间，至少先做这三件事： 1. 读取目标文件原文 2. 读取最相关的 reference 文件 3. 只做最小范围修改