Agent Skills › DotHarness/dotcraft › memory

memory

GitHub

提供 DotCraft 记忆文件结构与历史回顾机制参考，指导如何在 MEMORY.md 中维护长期事实，并通过 GrepFiles 或 grep 搜索 HISTORY.md 以回忆过去事件。

src/DotCraft.Core/Skills/BuiltIn/memory/SKILL.md DotHarness/dotcraft

触发场景

用户询问记忆机制需要回忆过去的事件、决策或对话

安装

npx skills add DotHarness/dotcraft --skill memory -g -y

更多选项

非标准路径

npx skills add https://github.com/DotHarness/dotcraft/tree/main/src/DotCraft.Core/Skills/BuiltIn/memory -g -y

不安装直接使用

npx skills use DotHarness/dotcraft@memory

指定 Agent (Claude Code)

npx skills add DotHarness/dotcraft --skill memory -a claude-code -g -y

安装 repo 全部 skill

npx skills add DotHarness/dotcraft --all -g -y

预览 repo 内 skill

npx skills add DotHarness/dotcraft --list

SKILL.md

Frontmatter

{
    "name": "memory",
    "description": "Reference for DotCraft memory files and history recall; use when the user asks about memory mechanics or when past events are needed."
}

Memory

Structure

memory/MEMORY.md — Long-term facts (preferences, project context, relationships). Always loaded into your context.
memory/HISTORY.md — Append-only event log. NOT loaded into context; search it with grep when you need to recall past events.

Search Past Events

Use GrepFiles to search HISTORY.md (cross-platform, no shell dependency):

GrepFiles(pattern="keyword", path="memory", include="HISTORY.md")

Regex patterns work too — e.g. pattern="meeting|deadline|project" matches any of those words.

For advanced search (e.g. context lines), use Exec with shell grep:

grep -i -C 3 "keyword" "memory/HISTORY.md"

Always search HISTORY.md when the user asks about past events, decisions, or conversations that aren't covered by MEMORY.md.

When to Update MEMORY.md

Write important facts to MEMORY.md immediately when you learn them:

User preferences ("I prefer dark mode", "call me Alex")
Project context ("The API uses OAuth2", "deploy target is AWS")
Key relationships ("Alice is the project lead")
Recurring instructions ("Always write tests before merging")

Use EditFile or WriteFile to update MEMORY.md. Keep it concise and well-organized.

Auto-consolidation

Old conversations are automatically summarized: long-term facts are extracted to MEMORY.md, and event entries are appended to HISTORY.md. You don't need to manage this process — just focus on writing important facts immediately when they come up.