Skip to content

LeoYeAI/agent-master-skills / skills/agent-memory-system-guide

Agent Memory System Guide

Verified

An agent memory workflow guide for OpenClaw and Codex with MEMORY.md, daily notes, SESSION-STATE, working-buffer, Obsidian archiving, and optional OpenViking support.

FileKindSize
INSTALL.mdmarkdown1.1 KB
README.mdmarkdown12.4 KB
README_CN.mdmarkdown11.6 KB
README_EN.mdmarkdown12.3 KB
SKILL.mdskill md18.8 KB
_meta.jsonconfig833 B
docs/superpowers/plans/2026-03-21-agent-memory-system-guide-obsidian-native.mdmarkdown5.3 KB
docs/superpowers/plans/2026-03-25-memory-backup-import-export.mdmarkdown3.9 KB
docs/superpowers/plans/2026-03-25-memory-examples-maintenance.mdmarkdown3.2 KB
docs/superpowers/plans/2026-03-25-report-warning-example.mdmarkdown1.9 KB
docs/superpowers/plans/2026-03-26-import-clean-mode.mdmarkdown8.6 KB
docs/superpowers/plans/2026-03-26-metadata-bootstrap-safety.mdmarkdown5.4 KB
docs/superpowers/plans/2026-03-27-memory-positioning.mdmarkdown2.6 KB
docs/superpowers/plans/2026-03-27-report-json.mdmarkdown5.5 KB
docs/superpowers/specs/2026-03-21-agent-memory-system-guide-obsidian-design.mdmarkdown5.1 KB
docs/superpowers/specs/2026-03-25-memory-backup-import-export-design.mdmarkdown3.1 KB
docs/superpowers/specs/2026-03-25-memory-examples-maintenance-design.mdmarkdown2.8 KB
docs/superpowers/specs/2026-03-26-import-clean-mode-design.mdmarkdown5.6 KB
docs/superpowers/specs/2026-03-26-metadata-bootstrap-safety-design.mdmarkdown5.0 KB
docs/superpowers/specs/2026-03-27-memory-positioning-design.mdmarkdown4.4 KB
docs/superpowers/specs/2026-03-27-report-json-design.mdmarkdown4.0 KB
manifest.tomlconfig944 B
scripts/memory_capture.pyscript17.3 KB
templates/OBSIDIAN-NOTE.mdmarkdown530 B
templates/SESSION-STATE.mdmarkdown137 B
templates/memory-capture.mdmarkdown385 B
templates/working-buffer.mdmarkdown105 B
tests/test_gitignore_publish_artifacts.pyscript514 B
tests/test_install_contract.pyscript384 B
tests/test_memory_capture_contract.pyscript6.9 KB
tests/test_memory_capture_script.pyscript16.8 KB
tests/test_memory_recovery_contract.pyscript1.5 KB
tests/test_obsidian_contract.pyscript503 B
tests/test_obsidian_template_contract.pyscript183 B
tests/test_openclaw_memory_search_contract.pyscript366 B
tests/test_openviking_optional_contract.pyscript371 B
tests/test_readme_openviking_optional.pyscript383 B
tests/test_release_manifest_contract.pyscript1.3 KB
tests/test_skill_positioning_contract.pyscript849 B

tests/test_memory_capture_contract.py

View on GitHub
from pathlib import Path


def test_skill_mentions_memory_capture_flow():
    repo_root = Path(__file__).resolve().parents[1]
    skill_text = (repo_root / 'SKILL.md').read_text(encoding='utf-8')

    assert '任务结束 30 秒记录流程' in skill_text
    assert '候选记忆' in skill_text
    assert 'memory-capture.md' in skill_text
    assert '导出备份' in skill_text
    assert '导入恢复' in skill_text
    assert '导入前备份' in skill_text
    assert '--clean' in skill_text
    assert 'clean restore' in skill_text


def test_memory_capture_template_exists():
    repo_root = Path(__file__).resolve().parents[1]
    template_text = (repo_root / 'templates' / 'memory-capture.md').read_text(encoding='utf-8')

    assert '候选决策' in template_text
    assert '候选踩坑' in template_text
    assert '候选长期记忆' in template_text


def test_readmes_document_cross_device_backup_restore():
    repo_root = Path(__file__).resolve().parents[1]
    readme_text = (repo_root / 'README.md').read_text(encoding='utf-8')
    readme_cn_text = (repo_root / 'README_CN.md').read_text(encoding='utf-8')
    readme_en_text = (repo_root / 'README_EN.md').read_text(encoding='utf-8')

    assert 'export' in readme_text
    assert 'import' in readme_text
    assert '--clean' in readme_text
    assert '新设备' in readme_cn_text
    assert '导入前备份' in readme_cn_text
    assert '--clean' in readme_cn_text
    assert '保守' in readme_cn_text
    assert 'new device' in readme_en_text
    assert 'pre-import backup' in readme_en_text
    assert '--clean' in readme_en_text
    assert 'conservative' in readme_en_text
    assert 'overwrite-style restore' in readme_en_text


def test_skill_declares_working_buffer_as_only_short_term_scratchpad():
    repo_root = Path(__file__).resolve().parents[1]
    skill_text = (repo_root / 'SKILL.md').read_text(encoding='utf-8')

    assert '`working-buffer.md` 是唯一的短期毛坯区' in skill_text
    assert '其他 skill 如果也有 working buffer 概念,应复用这个文件' in skill_text
    assert '不要再创建第二份并行写入的 WAL / buffer 文件' in skill_text


def test_readmes_document_memory_layers_and_lookup_order():
    repo_root = Path(__file__).resolve().parents[1]
    readme_paths = ['README.md', 'README_CN.md', 'README_EN.md']

    for path in readme_paths:
        text = (repo_root / path).read_text(encoding='utf-8')
        assert 'MEMORY.md' in text
        assert 'memory/' in text

    readme_cn_text = (repo_root / 'README_CN.md').read_text(encoding='utf-8')
    assert '`MEMORY.md` 用于启动时快速参考' in readme_cn_text
    assert '`memory/` 用于每日笔记和深度归档' in readme_cn_text
    assert '检索顺序' in readme_cn_text


def test_readme_documents_memory_workflow_examples():
    repo_root = Path(__file__).resolve().parents[1]
    readme_text = (repo_root / 'README.md').read_text(encoding='utf-8')

    assert 'First-time workspace bootstrap' in readme_text
    assert 'End-of-task memory capture' in readme_text
    assert 'Distill a daily note into `MEMORY.md`' in readme_text
    assert '### Workflow examples' in readme_text
    assert '### Report examples' in readme_text
    assert 'Maintenance report command' in readme_text
    assert 'python3 scripts/memory_capture.py report' in readme_text
    assert 'Memory workspace report for /path/to/workspace' in readme_text
    assert 'Missing supported file: SESSION-STATE.md' in readme_text
    assert 'python3 scripts/memory_capture.py report --workspace /path/to/workspace --output /path/to/workspace-report.md' in readme_text
    assert '# Memory workspace report' in readme_text
    assert '## Supported files' in readme_text
    assert '## Obsidian setup guide' in readme_text
    assert 'attachments/' in readme_text
    assert 'Calendar' in readme_text
    assert 'Templater' in readme_text
    assert 'crontab' in readme_text
    assert '0 9 * * *' in readme_text
    assert '## Sync options and trade-offs' in readme_text
    assert 'Obsidian Sync' in readme_text
    assert 'Syncthing' in readme_text
    assert 'iCloud' in readme_text
    assert 'git' in readme_text


def test_bilingual_readmes_cover_examples_and_report():
    repo_root = Path(__file__).resolve().parents[1]
    readme_cn_text = (repo_root / 'README_CN.md').read_text(encoding='utf-8')
    readme_en_text = (repo_root / 'README_EN.md').read_text(encoding='utf-8')

    assert '首次引导' in readme_cn_text
    assert '任务结束记忆捕获' in readme_cn_text
    assert '每日笔记蒸馏' in readme_cn_text
    assert '### 工作流示例' in readme_cn_text
    assert '### 报告示例' in readme_cn_text
    assert '维护报告' in readme_cn_text
    assert 'Memory workspace report for /path/to/workspace' in readme_cn_text
    assert 'Missing supported file: SESSION-STATE.md' in readme_cn_text
    assert 'workspace-report.md' in readme_cn_text
    assert '# Memory workspace report' in readme_cn_text
    assert '## Obsidian 配置指南' in readme_cn_text
    assert 'Calendar' in readme_cn_text
    assert 'Templater' in readme_cn_text
    assert 'crontab' in readme_cn_text
    assert '## 同步方案与取舍' in readme_cn_text
    assert 'Obsidian Sync' in readme_cn_text
    assert 'Syncthing' in readme_cn_text
    assert 'iCloud' in readme_cn_text

    assert 'first-time workspace bootstrap' in readme_en_text
    assert 'end-of-task memory capture' in readme_en_text
    assert 'daily note distillation' in readme_en_text
    assert '### Workflow examples' in readme_en_text
    assert '### Report examples' in readme_en_text
    assert 'maintenance report command' in readme_en_text
    assert 'Memory workspace report for /path/to/workspace' in readme_en_text
    assert 'Missing supported file: SESSION-STATE.md' in readme_en_text
    assert 'workspace-report.md' in readme_en_text
    assert '# Memory workspace report' in readme_en_text
    assert '## Obsidian setup guide' in readme_en_text
    assert 'crontab' in readme_en_text
    assert '## Sync options and trade-offs' in readme_en_text
    assert 'Obsidian Sync' in readme_en_text
    assert 'Syncthing' in readme_en_text


def test_skill_mentions_obsidian_setup_and_scheduled_maintenance():
    repo_root = Path(__file__).resolve().parents[1]
    skill_text = (repo_root / 'SKILL.md').read_text(encoding='utf-8')

    assert 'Obsidian 配置' in skill_text
    assert 'attachments/' in skill_text
    assert 'Dataview' in skill_text
    assert 'crontab' in skill_text
    assert '不要自动写入 `MEMORY.md`' in skill_text
    assert '同步取舍' in skill_text
    assert 'Obsidian Sync' in skill_text
    assert 'Syncthing' in skill_text


def test_skill_mentions_report_command():
    repo_root = Path(__file__).resolve().parents[1]
    skill_text = (repo_root / 'SKILL.md').read_text(encoding='utf-8')

    assert 'report command' in skill_text
    assert 'supported files' in skill_text
    assert 'python3 scripts/memory_capture.py report' in skill_text
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall