puppylpg.github.io: Skill for Claude Code

博客健康体检（Blog Lint）

定位

这是 Karpathy LLM Wiki 模式里 Lint 操作 的本站实现：博客文章是时间流，写完就不再动，但知识会演化——旧结论被新方案取代、同一事实在两篇文章里写得不一样、新文章忘了挂进枢纽页。定期体检让这些漂移显形。

思想背景见 _ai/2026-08-24-karpathy-llm-wiki-knowledge-base.md；站点结构与发布流程以根目录 AGENTS.md 为准。

核心原则

• 只报告有证据的问题：每条发现必须给出具体文件路径和原文片段，禁止泛泛的“某些文章可能过时”。
• 区分问题严重度：事实性矛盾 > 过时未标注 > 结构问题（孤儿、缺链） > 风格问题（引号、tag 大小写）。
• 修复走发布流程：任何落盘修改都遵循 AGENTS.md 的发布流程（预览 → 确认 → 询问后再 commit/push）。批量修复前先给报告，不要静默改一大片。

检查清单

按以下顺序逐项执行，每项注明检查方法和通过标准。

1. 事实矛盾（最高优先级）

• 同一事实在不同文件中取值不同。已知的高危事实源：
  • AGENTS.md 树莓派代理服务表 vs _life/ 各代理文章中的端口、容器名、配置路径；
  • _wiki/ 枢纽页中的“当前状态”部分 vs AGENTS.md；
  • 教程文章中的命令/路径 vs 仓库现状（如 bin/ 脚本名、Dockerfile 参数）。
• 方法：先读 AGENTS.md 和各 _wiki/*.md 提取“事实清单”，再 grep 全站核对这些事实的其他出现位置。

2. 过时结论未标注

• 文章描述的方案已被后续文章取代，但旧文没有标注。已知演化线：
  • 代理：v2ray（VMess）→ xray（VLESS）→ mihomo（机场）并存，各自角色以 AGENTS.md 为准；
  • 本地预览：原生 Ruby vs Docker 两条路线。
• 处理：不删旧文（实录有历史价值），在旧文开头或对应小节加一句指向新方案的说明，例如“本文方案已演进为 XXX，见 <链接>”。

3. Wiki 枢纽页新鲜度

• 对照 _wiki/ 每页的“维护约定”，检查该主题下的新文章是否已归入枢纽页：
  • 树莓派主题：grep -l "树莓派\|raspberry" _life/*.md 的结果 vs _wiki/raspberry-pi.md 已收录链接；
  • AI 主题：_ai/ 新文章 vs _wiki/ai-llm-agent.md 的知识线；
  • 博客主题：_tutorials/ 中 Jekyll/Chirpy 相关文章 vs _wiki/blog-chirpy-jekyll.md。
• 新增集合、主题覆盖文件、发布流程变化时，检查 _wiki/blog-chirpy-jekyll.md 和 AGENTS.md 是否同步。
• 开放问题跟进：wiki 页里 wiki-openq-status--open 状态的问题，检查近期新文章是否已经回答；已回答的把结论编回 wiki 页正文，问题徽章改为 --done。
• 枢纽页链接有效性：wiki 页手写的内链必须与目标文件的真实 slug 一致（曾发生 Stanford%20CNN vs Stanford-CNN 导致 CI htmlproofer 失败）；本地 bundle exec jekyll build 后用 htmlproofer 或 grep _site 抽查。

4. 孤儿文章与缺失交叉引用

• 孤儿：grep 全站，没有任何其他文章/枢纽页链接到它，且 tags 独一无二的页面。
• 同主题系列文章（如“家庭影院（一）（二）（三）”）应互相链接或在枢纽页汇合。
• 处理：优先把孤儿挂进对应枢纽页；确属独立的孤立内容列入报告即可，不强行互链。

5. 格式与约定

• 中文引号配对：左引号 “（U+201C）和右引号 ”（U+201D）必须成对，检查“左引号写成右引号”的低级错误；
• categories/tags 小写；
• frontmatter 必填 title、date，不手写 last_modified_at；
• 文件名 slug 规范（小写英文数字连字符，≤50 字符）。

输出格式

体检结果输出为一份 Markdown 报告，结构固定：

# 博客体检报告 <日期>

## 事实矛盾（N 条）
## 过时未标注（N 条）
## 枢纽页待更新（N 条）
## 孤儿与缺链（N 条）
## 格式问题（N 条）

## 建议修复顺序