FreePublished on GitHub

nature-experiment-log

Organize experiment photos, audio, and notes into Markdown logs with structured metadata. Assign experiment and sample batch IDs, archive original attachments, and optionally connect records to Feishu group messages or an Obsidian notebook.

OriginalShow the original description

标准化实验日志记录——直接上传或读取本地图片、语音和文字，产出带 YAML frontmatter 的 Markdown；可选集成飞书 CLI 与 Obsidian。

Yuan1z0825/nature-skills

Works withObsidian

See how to install

Good for

Turning experiment photos and voice notes into consistent logs
Tracking the same sample batch across multiple experiments
Archiving original files with links from experiment logs
Reviewing experiment indexes and anomalies in Obsidian

Files included (11)

SKILL.md6.3 KB
agents/openai.yaml238 B
manifest.yaml1.5 KB
README_EN.md2.3 KB
README.md2.2 KB
references/example-electrochemical.md1.8 KB
references/example-log.md2.0 KB
references/example-thermal-stability.md1.7 KB
templates/anomaly-log.md577 B
templates/equipment-tracking.md870 B
templates/experiment-index.md653 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

experiment-log — 实验日志标准化

输入方式

用户通过以下任一方式提交实验原始材料时自动加载：

直接上传 — 在当前会话提交图片、音频、语音转录或文字。
本地材料 — 提供本地文件或文件夹路径，由 agent 读取并整理。
飞书群 — 通过可选的 feishu-cli-integration 读取群消息和附件。

输出方式

本地 Markdown — 将日志和原始附件保存到用户指定的普通本地文件夹；未指定目录时，先返回可保存的 Markdown，不擅自选择路径。
Obsidian vault — 通过可选的 obsidian skill 写入 vault，并使用附带模板建立索引、异常记录和设备追踪。

核心流程不要求安装飞书或 Obsidian。使用飞书群输入时，才需要 bot 已加入目标群并具备 im:message、im:message.group_msg 和 im:resource 权限。

处理流程

接收上传材料、读取本地文件，或从已配置的飞书群获取材料。
通过 vision_analyze 和文本解析提取结构化信息。
对缺失或模糊字段向用户确认，不猜测实验条件或结果。
确认输出方式和目标目录，生成实验 ID 与样品批次 ID。
写出 {OUTPUT_ROOT}/实验日志/{体系}/{类型}/{exp_id}.md。
将原始附件归档到 {OUTPUT_ROOT}/raw/experiments/YYYY.MM.DD_描述_EXPID/，并在日志中建立引用。
如启用索引模板，更新实验索引；发现异常时追加异常记录。
告知用户生成文件及原始材料的具体位置。

模糊信息（温度记不清、样品编号不明）主动询问，不猜测写入。

目录结构

/vault/
├── raw/experiments/                       ← 原始层（归档）
│   └── YYYY.MM.DD_描述_EXPID/
│       ├── 笔记.md
│       ├── 图片/
│       └── 语音/
│
wiki/实验日志/                              ← 标准层（产出）
├── 实验索引.md
├── 异常记录.md
├── {体系A}/
│   ├── 实验类型1/
│   ├── 实验类型2/
│   └── ...
├── {体系B}/
│   └── ...
└── 公共/
    └── 设备与试剂追踪.md

实验 ID 规则

{体系代码}-{设备代码}-YYMMDD-{序号}
  │        │       │       └─ 当日序号（001 起）
  │        │       └─ 日期
  │        └─ 设备代码（M=马弗炉, T=管式炉, E=电化学, G=手套箱, F=可控气氛炉, B=通用）
  └─ 体系代码（自定义，如 CL / NO / OX / HY 等）

样品批次 ID 规则

{体系代码}-{候选编号}-B{序号}
  │        │         └─ 配盐批次序号
  │        └─ 候选配方编号
  └─ 体系代码

同一批样品跨多个实验时 sample_batch 保持一致，便于 dataview 追踪。

设备代码

代码	设备	场景
M	马弗炉	热处理、浸泡腐蚀
T	管式炉	气氛控制、脱水、热稳定性
E	电化学工作站	CV/SWV/EIS
G	手套箱	配盐、称量、取样
F	可控气氛炉	精密气氛控制
B	通用	干燥、清洗、制样

按实际设备扩展。

可选的 Obsidian 集成

本 skill 可以只向普通本地文件夹输出 Markdown，也可以与 Obsidian vault 配合使用。Obsidian 是一个基于本地 Markdown 文件的笔记系统，配合 Dataview 插件可实现实验数据的动态查询和仪表盘。

为什么用 Obsidian：

所有日志为纯文本 Markdown，可版本控制、可全文搜索
YAML frontmatter 结构使 dataview 可自动生成实验列表、异常汇总、设备使用记录
本地存储，无云依赖性，数据安全

安装 skill 后需在 vault 中创建以下文件：

文件	模板	用途
`实验日志/实验索引.md`	`templates/experiment-index.md`	Dataview 查询仪表盘
`实验日志/异常记录.md`	`templates/anomaly-log.md`	异常记录
`实验日志/公共/设备与试剂追踪.md`	`templates/equipment-tracking.md`	设备与试剂追踪

将模板文件复制到你的 Obsidian vault 对应位置即可使用。

参考示例

references/ 目录包含三个完整的实验日志示例，覆盖常见实验类型：

文件	实验类型
`references/example-log.md`	材料腐蚀浸泡实验
`references/example-electrochemical.md`	电化学表征（CV 窗口测试）
`references/example-thermal-stability.md`	热稳定性实验

每个示例均包含完整的 YAML frontmatter 和 Markdown 正文，可直接作为模板修改使用。

可选的飞书 CLI 集成

需要从飞书群获取材料时，使用 feishu-cli-integration skill：

拉消息：lark-cli im +chat-messages-list --chat-id oc_*** --page-size 30 --sort asc
下载图片：lark-cli im +messages-resources-download --message-id *** --file-key *** --type image --output <相对路径>
⚠️ --output 只接受相对路径，先 cd 到 raw/experiments/ 归档目录

群 ID 和 bot 权限按 feishu-cli-integration skill 的配置获取。

自定义指南

体系代码：按你的实验体系自定义（如 CL/NO/OR/PO）
实验类型：在 wiki/实验日志/{体系}/ 下按需创建子目录
YAML 字段：模板是建议结构，可增删字段
设备代码：按实际实验室设备扩展
输出根目录：可以是普通本地文件夹，也可以是 Obsidian vault 根目录

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

More skills from this repository

nature-academic-search

FreeSummary

Search academic literature across sources, verify references, and convert citation files. Build PubMed queries using MeSH, its subject vocabulary, or audit citations to distinguish independent citations and document who cited a paper and how.

Search academic literature across multiple sources
Verify references extracted from a document
Build a MeSH-based PubMed search strategy