必需的工作流程

1. 在新工作区中初始化记忆：

• pmem init

1. 在开始重要任务时：

• pmem sync (仅数据库健康检查)
• pmem search "<主题关键词>" --limit 8

1. 当用户明确说 记住 或学习到持久的偏好/事实时：

• pmem add "<记忆文本>" --tags "<标签>" --source "assistant"

1. 在完成对记忆敏感的工作之前，验证回忆状态：

• pmem stats

一次性迁移 (如果从旧设置升级)

1. 移除遗留的导入行：

• pmem cleanup-legacy

1. 为现有笔记生成向量：

• pmem backfill-embeddings

存储规则

• 存储持久的偏好、长期存在的事实、稳定的工作流程和重复的约束。
• 除非被要求，否则不要存储嘈杂的一次性临时细节。
• 保持条目简洁且具体。
• 优先使用能提高检索质量的标签 (preferences, calendar, comms, product)。

检索规则

• 使用有针对性的搜索查询，而不是宽泛的术语。
• 除非需要更深的回忆，否则保持默认的 --limit 较低。
• search 会自动通过更新 hits 和 last_seen_at 来强化被回忆的条目。
• hits 是面向分析的，不直接用作排名提升。
• 搜索使用混合检索：词汇 + 语义。
• 语义搜索首先尝试 sqlite-vec，如果需要会自动回退到 Python 余弦相似度计算。

引导和恢复

• 如果 .memory/ 缺失，运行 pmem init。
• pmem sync 是一个轻量级的仅数据库检查 (不涉及 markdown 导入/导出)。
• 如果语义模式性能下降，运行 pmem stats 来检查 semantic_backend 和 embedding_coverage。
• 关于命令示例和快速故障排除，请阅读 references/usage.md。

每周安装数

337

仓库

ropl-btc/agent-skills

首次出现

2026年2月9日

安全审计

Gen Agent Trust HubPassSocketPassSnykPass

安装于

opencode306

openclaw303

gemini-cli298

codex297

cursor289

github-copilot289

Required Workflow

1. Initialize memory in a fresh workspace:

• pmem init

1. At the start of substantial tasks:

• pmem sync (database-only health check)
• pmem search "<topic keywords>" --limit 8

1. When user explicitly says remember or when a durable preference/fact is learned:

• pmem add "<memory text>" --tags "<tags>" --source "assistant"

1. Before finalizing memory-sensitive work, verify recall state:

• pmem stats

One-Time Migration (If Upgrading From Older Setup)

1. Remove legacy imported rows:

• pmem cleanup-legacy

1. Generate vectors for existing notes:

• pmem backfill-embeddings

Storage Rules

• Store durable preferences, long-lived facts, stable workflows, and repeated constraints.
• Do not store noisy one-off transient details unless requested.
• Keep entries concise and specific.
• Prefer tags that improve retrieval quality (preferences, calendar, comms, product).

Retrieval Rules

• Use targeted search queries instead of broad terms.
• Keep default --limit low unless deeper recall is needed.
• search automatically reinforces recalled entries by updating hits and last_seen_at.
• hits are analytics-oriented and not used as a direct ranking boost.
• Search uses hybrid retrieval: lexical + semantic.
• Semantic search tries sqlite-vec first and auto-falls back to Python cosine if needed.

Bootstrapping and Recovery

• If .memory/ is missing, run pmem init.
• pmem sync is a lightweight database-only check (no markdown import/export).
• If semantic mode degrades, run pmem stats to inspect semantic_backend and embedding_coverage.
• For command examples and quick troubleshooting, read references/usage.md.

Weekly Installs

337

Repository

ropl-btc/agent-skills

First Seen

Feb 9, 2026

Security Audits

Gen Agent Trust HubPassSocketPassSnykPass

Installed on

opencode306

openclaw303

gemini-cli298

codex297

cursor289

github-copilot289