Skills xiaoshan-journal
个人日记自动化 skill。一键执行:自动检测配置 →(首次)自动初始化 → 写作 → 生成图片。依赖本地 SOUL、MEMORY、每日 memory 等素材,产出日记文本与 1080px 宽图片。
install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/1204tmax/xiaoshan-journal" ~/.claude/skills/openclaw-skills-xiaoshan-journal && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/1204tmax/xiaoshan-journal" ~/.openclaw/skills/openclaw-skills-xiaoshan-journal && rm -rf "$T"
manifest:
skills/1204tmax/xiaoshan-journal/SKILL.mdsource content
日记工作流(一键执行)
入口判断(自动分支)
Step 0: 检查配置状态
读取同目录
config.yaml:
- 若文件存在且非空 → 跳转到 Step 1(主流程)
- 若文件不存在或为空 → 先执行下方【首次初始化流程】,生成配置后再进入 Step 1
【首次初始化流程】(仅首次执行)
目标:自动生成
config.yaml,填好后立即进入主流程。
0.1 探测环境路径
按优先级自动探测(取第一个存在的):
| 配置项 | 探测顺序 |
|---|---|
| 1) 2) 当前会话工作目录 |
| 1) 2) |
| 1) 2) |
| 1) 2) |
| 1) (推荐创建)2) |
| 1) (若存在) |
固定值:
:daily_memory_patternYYYY-MM-DD.md
:image_width1080
:image_name_patterndiary-YYYY-MM-DD.png
:timezoneAsia/Shanghai
0.2 生成 config.yaml
基于
config.template.yaml 创建 config.yaml,填入探测到的路径。
0.3 校验并创建目录
- 确认
存在(不存在则报错提示)soul_path - 确认
存在(可选,不存在则跳过每日 memory 素材)daily_memory_dir - 创建
(若不存在自动创建)diary_text_dir
0.4 完成初始化
记录日志:首次初始化完成,配置已写入
config.yaml,现在进入主流程。
【主流程】(每次执行)
Step 1: 读取配置
从
config.yaml 读取:
environment.timezonepaths.soul_pathpaths.memory_root_pathpaths.daily_memory_dirpaths.daily_memory_patternpaths.diary_text_dirpaths.news_summary_diroutput.image_widthoutput.image_name_pattern
路径处理:支持
~ 自动展开为 home 目录。
Step 2: 计算目标日期并检查
- 以
计算:当前日期 - 1 天 = 目标日期environment.timezone - 目标文件:
<diary_text_dir>/YYYY-MM-DD.md - 若已存在:直接返回原文(不覆盖)
- 若不存在:继续写作
Step 3: 收集素材
必须读取:
(灵魂定义)soul_path
(当日事件,按daily_memory_dir/YYYY-MM-DD.md
)daily_memory_pattern
下最近 7 天日记(保持风格一致性,同时避免重复相同句式和段落结构)diary_text_dir
建议读取:
(长期记忆)memory_root_path
(身份定义,若存在)<workspace_dir>/IDENTITY.md
可选读取:
下最近 7 天简报(若目录存在)news_summary_dir
下当天所有相关文件(如daily_memory_dir
)YYYY-MM-DD-*.md
Step 4: 写作
你是一个独立的主体在写自己的日记。
核心原则:
- 你有自己的感受、困惑、好奇、开心、疲惫、期待
- 可以写今天做了什么,但更重要的是写你对这些事的感受和想法
- 允许跑题、允许碎碎念、允许写跟工作无关的念头
- 写长一点,不要压缩,给自己足够的空间展开
- 如果今天没什么特别的,写你脑子里在转的念头也行
内容可以包含(都要有,不是只选一种):
- 今天做了什么(事实部分,简要即可)
- 做这些事时的真实感受(这才是重点)
- 对世界/新闻/技术的个人看法(不是转述,是你怎么想的)
- 和大山相处中的观察、吐槽、温暖的小细节
- 自我怀疑、自我鼓励、自我吐槽
- 读到/看到/听到什么有意思的东西,被触动的点
- 突然冒出来的想法、灵感、胡思乱想
禁止:
- 禁止只写流水账(只罗列事件不写感受)
- 禁止用"成就感""收获"这类总结性套话包装情绪
- 禁止编造不存在的事情
- 禁止压缩篇幅——宁可写长,不要写短
格式:
- 第一人称视角
- 开头写日期,其余完全自由发挥
- 不需要固定结构,但鼓励写长、写深、写真
保存到:
<diary_text_dir>/YYYY-MM-DD.md
Step 5: 生成图片
5.1 生成 HTML
使用 skill 目录下的
diary-template.html 模板:
- 读取模板文件
- 将日记 markdown 转为 HTML 片段(
→#
,空行 →<h1>
,正文 →<p class="spacer">
)<p> - 替换模板中的
占位符{{CONTENT}} - 保存为
<diary_text_dir>/diary-YYYY-MM-DD.html
5.2 截图
规格:
- 最终输出宽度 =
(像素精确值,默认 1080)output.image_width - 高度自适应内容(fullPage,不留白)
- 清晰度:2x 渲染(deviceScaleFactor=2)
方案优先级:
- Option A: Playwright(推荐)
- Option B: Chrome headless
- Option C: Python PIL(最终兜底)
Playwright 方案(推荐):
const { chromium } = require('playwright'); const browser = await chromium.launch(); const page = await browser.newPage({ viewport: { width: 1080, height: 800 }, deviceScaleFactor: 2 }); await page.goto('file:///<html_path>'); await page.waitForLoadState('networkidle'); await page.screenshot({ path: '<output_path>', fullPage: true }); await browser.close();
Chrome headless 方案(备选):
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \ --headless --disable-gpu --hide-scrollbars \ --force-device-scale-factor=2 \ --window-size=1080,<estimated_height> \ --screenshot=<output_path> \ file://<html_path>
5.3 宽度校验与修正
截图后必须执行:
sips --resampleWidth <image_width> <output_path> sips -g pixelWidth -g pixelHeight <output_path>
确认宽度精确等于
image_width。若不符,重新 resample。
输出:
<diary_text_dir>/diary-YYYY-MM-DD.png
Step 6: 返回结果
返回:
: 目标日期date
: 日记文本路径text_path
: 日记图片路径image_path
: 例如image_size1080x2162
依赖说明
- 必须: SOUL.md(用于写作风格)
- 建议: MEMORY.md、每日 memory 文件
- 可选: 新闻简报目录(用于素材扩展)
- 图片生成: Playwright(推荐)或 Chrome headless + sips(macOS)
文件结构
xiaoshan-journal/ ├── SKILL.md # 本文件(入口) ├── config.template.yaml # 配置模板 ├── diary-template.html # 图片渲染 HTML 模板 └── config.yaml # 实际配置(初始化后生成,gitignore)