← Back to Skills Marketplace
italks

Crayfish Diary

by italks · GitHub ↗ · v0.1.1 · MIT-0
cross-platform ⚠ suspicious
395
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install crayfish-diary
Description
A WorkBuddy skill for quick diary and memo recording with automatic year/month/day directory organization. Supports Chinese and English triggers - start with...
README (SKILL.md)

龙虾日记技能

概述

这是一个帮助用户快速记录日记、备忘内容的技能。当用户请求记录内容时,自动在指定空间创建结构化的日记存储目录,按年月日组织 markdown 文件,方便用户管理和检索历史记录。

使用场景

此技能应在以下情况下触发:

  • 用户说"帮我记一下"或"help me record"开始记录,说"结束记录"或"end recording"结束记录
  • 用户想快速记录想法、待办事项、会议记录等内容
  • 用户需要创建日记或备忘录
  • 用户表达需要记录信息的意图

工作流程

1. 开始记录

当用户说"帮我记一下"或"help me record"或"start recording"时,技能开始监听并记录后续内容。

  1. 确定日记存储位置:
    • 如果用户明确指定了存储位置(如"在 Claw 空间记一下"),则使用指定空间
    • 如果没有指定,默认在当前工作空间创建 龙虾日记 目录
  2. 提示用户:"好的,请继续说,我会记录下来。说'结束记录'或'end recording'完成记录。"

2. 收集内容

收集用户后续的所有对话内容,直到用户说"结束记录"。

3. 创建目录结构

按以下层级创建目录:

龙虾日记/
└── YYYY/           # 年份目录(如 2026)
    └── MM/         # 月份目录(如 03)
        └── DD/     # 日期目录(如 11)
            └── *.md  # 具体的日记文件

例如:

龙虾日记/
└── 2026/
    └── 03/
        └── 11/
            └── 日常记录.md

4. 创建日记文件

日记文件命名规则:

  • 如果用户给了标题,使用用户提供的标题作为文件名
  • 如果没有标题,使用时间戳作为文件名,如 22-00-日常记录.md
  • 文件名格式:[时间]-[标题].md

5. 生成摘要

为当天所有日记生成摘要,放在日期目录的 README.md 中:

# YYYY-MM-DD 日记摘要

## 记录列表

1. **[时间] [标题]**: [内容前50字摘要]...
2. **[时间] [标题]**: [内容前50字摘要]...

---
*共 N 条记录*

6. 写入内容

在 markdown 文件中写入以下内容:

# [标题]

**时间**: YYYY-MM-DD HH:mm
**标签**: [用户指定的标签,如无则省略]

---

[用户要记录的内容]

---

*由龙虾日记自动记录*

执行示例

示例 1:简单记录

用户输入:

帮我记一下

智能体回复:

好的,请继续说,我会记录下来。说"结束记录"完成记录。

用户继续:

今天完成了技能开发任务,创建了一个龙虾日记技能
结束记录

执行步骤:

  1. 创建目录:龙虾日记/2026/03/11/
  2. 创建文件:22-00-技能开发任务.md
  3. 更新日期摘要:龙虾日记/2026/03/11/README.md
  4. 写入内容:
# 技能开发任务

**时间**: 2026-03-11 22:00

---

今天完成了技能开发任务,创建了一个龙虾日记技能

---

*由龙虾日记自动记录*

示例 2:带标题的记录

用户输入:

帮我记一下会议纪要

用户继续:

今天讨论了新产品的设计方案,确定了三个核心功能
结束记录

执行步骤:

  1. 创建目录:龙虾日记/2026/03/11/
  2. 创建文件:会议纪要.md
  3. 更新日期摘要
  4. 写入内容

示例 3:指定空间的记录

用户输入:

在 Claw 空间帮我记一下

用户继续:

我的学习笔记:今天学习了 Python 异步编程
结束记录

执行步骤:

  1. 在 Claw 空间创建目录:龙虾日记/2026/03/11/
  2. 创建文件:学习笔记.md
  3. 更新日期摘要
  4. 写入内容

技术实现

目录创建

使用 execute_command 工具创建目录:

mkdir -p "空间路径/龙虾日记/YYYY/MM/DD"

文件写入

使用 write_to_file 工具创建 markdown 文件,包含完整的日记格式。

时间处理

  • 年份:YYYY 格式(如 2026)
  • 月份:MM 格式(如 03)
  • 日期:DD 格式(如 11)
  • 时间:HH:mm 格式(如 22:00)

当前日期时间从系统信息中获取。

注意事项

  1. 如果目录已存在,不需要重新创建
  2. 如果文件已存在,询问用户是追加内容还是创建新文件
  3. 保持 markdown 格式的整洁和一致性
  4. 支持中英文混合的文件命名
  5. 对于特殊字符(如 / : * ? " \x3C > |),在文件名中替换为下划线或删除

扩展功能(可选)

  • 支持为日记添加标签分类
  • 支持检索历史日记
  • 支持导出日记为 PDF 或其他格式
  • 支持日记模板自定义
Usage Guidance
This skill appears internally consistent, but consider these practical points before installing: - Storage location: diary files are written to the workspace path (default '龙虾日记' under the provided base_path). Confirm that the workspace or filesystem location is private and backed up as you expect. - Sensitive data: anything you say while recording will be written to disk in plain text Markdown. Don’t record secrets you wouldn’t want stored in that location. - publish.sh: a shipping helper script can push to the developer's GitHub repo if run manually; don’t run it unless you intend to publish the skill and understand which git credentials and remote will be used. - File permissions: ensure file permissions on the workspace are appropriate so other users/processes cannot read your diaries. - Minor metadata mismatch: registry version differs from clawhub.json version — this is likely a packaging oversight, not malicious, but you may want to confirm the source repository if you plan to trust the package. If you want stronger assurances, ask for the authoritative source repository or run the Python script in a controlled test folder first to confirm its behavior.
Capability Analysis
Type: OpenClaw Skill Name: crayfish-diary Version: 0.1.1 The skill bundle is classified as suspicious because SKILL.md instructs the AI agent to use the high-risk 'execute_command' tool for shell-based directory creation (mkdir -p), which introduces a potential shell injection vulnerability if workspace paths or user-provided titles are not strictly sanitized. While the provided Python script 'scripts/create_diary.py' implements safer file-handling logic using Pathlib, the explicit instruction to use raw shell commands is a risky practice. No evidence of intentional malice, such as data exfiltration or unauthorized access, was found in the code or instructions.
Capability Assessment
Purpose & Capability
Name/description match the provided code and instructions. The Python script creates year/month/day directories, sanitizes filenames, writes markdown files, and updates a daily README — all consistent with a diary/memo skill. The included publish script and repo metadata are typical for a developer release artifact (minor version string mismatch: registry lists 0.1.1 while clawhub.json states 1.0.0).
Instruction Scope
SKILL.md explicitly instructs the agent to collect the user's subsequent conversation until an 'end recording' trigger and to create directories and files in a specified workspace. This is expected for a recording diary skill, but it does mean conversational content will be written to disk in the workspace; users should be aware of where the base_path/space resolves and who can access that storage.
Install Mechanism
No install spec is present (instruction-only skill). The code files are plain Python and a shell script; nothing is being downloaded or auto-installed. This is the lower-risk model for skills that write files locally.
Credentials
The skill requests no environment variables, no credentials, and no special config paths. All file I/O is local under a base_path provided to the script or the agent's workspace. No unrelated services or secrets are requested.
Persistence & Privilege
always is false and the skill does not request persistent system privileges. It does include a publish.sh that, if run manually, could push the repository to GitHub (requiring the user's git credentials), but the SKILL.md does not instruct automatic use of that script or any privileged modifications to other skills or global settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install crayfish-diary
  3. After installation, invoke the skill by name or use /crayfish-diary
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
crayfish-diary 0.1.1 - Added English support: now recognizes "help me record", "start recording", and "end recording" as triggers, in addition to Chinese phrases. - Updated skill description and examples to reflect bilingual (Chinese/English) usage. - No code or functionality changes detected; documentation updated for clarity and broader audience.
v0.1.0
Initial release of crayfish-diary skill. - Enables quick recording of diary and memo content using natural language triggers like "记一下", "记录", "日记", "备忘", and "记下来". - Automatically creates structured markdown files organized by year, month, and day in a "龙虾日记" directory, with support for custom storage spaces. - Prompts user to start and stop recording; captures all content between "帮我记一下" and "结束记录". - Generates daily summary (README.md) listing all records with time, title, and short content preview. - Supports custom titles, handles filename formatting and special character sanitization. - Provides clear workflow and usage examples for different day-to-day recording scenarios.
Metadata
Slug crayfish-diary
Version 0.1.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Crayfish Diary?

A WorkBuddy skill for quick diary and memo recording with automatic year/month/day directory organization. Supports Chinese and English triggers - start with... It is an AI Agent Skill for Claude Code / OpenClaw, with 395 downloads so far.

How do I install Crayfish Diary?

Run "/install crayfish-diary" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Crayfish Diary free?

Yes, Crayfish Diary is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Crayfish Diary support?

Crayfish Diary is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Crayfish Diary?

It is built and maintained by italks (@italks); the current version is v0.1.1.

💬 Comments