用一个 skill 让 Claude 把开发过程写进博客

---
name: devlog
description: 把做完的开发工作写成用户博客（Mac 上的 LZWcc-Blog）里的文章，或者并进已有的文章。用户输入 /devlog，或者说"写进博客""记到博客""写篇文章""更新博客"时使用。
---

博客仓库在 Mac 的 `/Users/lzwcc/Documents/Code/LZWcc-Blog`（Astro），文章放在 `src/content/blog/<slug>.md`。读写都通过 `ssh lzwcc`，改文件按全局 CLAUDE.md 的 python 精确替换来做。

**文章是给读者看的完成品**，只写做完、验证过的东西。需求清单、进度、"接下来"、待办都不写进文章。还没做完的部分不提，等做完再写。

## 步骤

1. **确定写进哪篇**。本目录的 `posts.md` 记着项目和文章的对应关系。已有文章的，把新内容并进去：放进对应的小节，过时的内容直接改掉，不要在末尾追加"更新"段落。新主题就新建一篇，并在 `posts.md` 补上对应关系。不确定写进哪篇时问用户。
2. **写**。规则见下面"文章怎么写"。改已有文章时，先用 `grep -n '^## \|^### '` 看结构，再按需要 `sed -n` 读相关部分，不要整篇读进来。
3. **检查**。设置 `publishDate`（新文章）或 `updatedDate`（已有文章），然后运行 `check.sh`。
4. **回复**。列出改了哪几处，每处一句，不要贴全文。用户没要求就不要提交。

## 文章怎么写

用户自己说过，这些内容"和 AI slop 没什么区别"。所以目标是短、准、能照着用，不追求好看。

- **按主题组织，不按日期**。一般的顺序是：要解决的问题 → 方案和原因 → 怎么用 → 踩过的坑（表格，三列：现象 / 原因 / 解决）→ 附录（设置清单、命令汇总）。
- **同一件事只写一处**。设置项和命令放进附录，正文引用它。
- **只写验证过的事**。实测过的写结果，个别没验证的细节要写明"没测过"。体感类结论（顺不顺、卡不卡、好不好用）必须等用户实测后再写，不要用推理改写用户的实测结论。
- **过时的内容直接改掉**，不保留"这段改过几次"之类的过程。
- 文中的"我"是用户本人。不写客套话，不写总结性的空话。
- **篇幅**。一个主题一篇。超过大约 200 行时，先列出精简方案（删什么、合并什么、能省多少行），等用户确认后再改。
- 用户想要"可以直接复制的提示词"时，单独放一节，用 ```` ```text ```` 代码块，写成以后还能复用的通用版本，参考 `voice-input-before-ai-coding.md`。

## 格式和检查

- 日期格式：`publishDate: 2026-10-21 10:24:18`，不加引号，不带时区，这是项目的惯例。`updatedDate` 也用这个格式。时间取 Mac 当前时间：`date '+%Y-%m-%d %H:%M:%S'`。
- title 不超过 60 个字符，description 不超过 160 个字符（`src/content.config.ts` 会校验）。
- 站内链接写成 `/blog/<slug>/`。
- 检查（frontmatter、页内锚点、`astro build`）：`ssh lzwcc bash -s -- <slug> < ~/.claude/skills/devlog/check.sh`。提交前加 `full`，跑完整的 `npm run build`：`bash -s -- <slug> full`。
- 提交时只 `git add` 对应的文章，提交说明不加 AI 署名。push 走 HTTPS 和钥匙串，通过 ssh 执行会失败（`-25308`），要请用户在 Mac 本地执行 `git push`。

#!/bin/bash
# 在 Mac 上检查一篇博客文章：frontmatter 长度、页内锚点、构建。
# 用法（在本机执行）：ssh lzwcc bash -s -- <slug> [full] < ~/.claude/skills/devlog/check.sh
set -u
slug=${1:?用法: check.sh <slug> [full]}
cd ~/Documents/Code/LZWcc-Blog || exit 1
f=src/content/blog/$slug.md
[ -f "$f" ] || f=src/content/blog/$slug/index.md
[ -f "$f" ] || { echo "找不到文章: $slug"; exit 1; }
export PATH=$HOME/.nvm/versions/node/v22.20.0/bin:$PATH

echo "== ${f}（$(wc -l < "$f" | tr -d ' ') 行）"
/usr/bin/python3 - "$f" <<'PY'
import re, sys
s = open(sys.argv[1], encoding='utf-8').read()
fm = s.split('\n---\n', 1)[0]
for k, limit in (('title', 60), ('description', 160)):
    m = re.search(rf'^{k}: (.*)$', fm, re.M)
    v = m.group(1).strip().strip('\'"') if m else ''
    print(f"{'OK  ' if v and len(v) <= limit else 'BAD '}{k} {len(v)}/{limit}")
for k in ('publishDate', 'updatedDate'):
    m = re.search(rf'^{k}: (.*)$', fm, re.M)
    if m:
        ok = re.fullmatch(r'\d{4}-\d\d-\d\d \d\d:\d\d:\d\d', m.group(1))
        print(f"{'OK  ' if ok else 'BAD '}{k} {m.group(1)}")
PY

node --input-type=module -e "
import S from 'github-slugger'; import fs from 'fs';
const s = new S(); const md = fs.readFileSync('$f', 'utf8');
const ids = new Set(md.split('\n').filter(l => /^#{2,4} /.test(l)).map(l => s.slug(l.replace(/^#+ /, ''))));
let n = 0;
for (const m of md.matchAll(/\]\(#([^)]+)\)/g)) { n++; console.log((ids.has(m[1]) ? 'OK   锚点 ' : 'MISS 锚点 ') + m[1]); }
if (!n) console.log('OK   没有页内锚点');"

if [ "${2:-}" = full ]; then
  (perl -e 'alarm shift; exec @ARGV' 500 npm run build) > /tmp/blog-build.log 2>&1
else
  (perl -e 'alarm shift; exec @ARGV' 300 npx astro build) > /tmp/blog-build.log 2>&1
fi
echo "build exit=$?"; grep -E '^- [0-9]+ errors' /tmp/blog-build.log; tail -1 /tmp/blog-build.log