memory

Memory 是 orchestkit 提供的统一读取侧记忆技能，用于对知识图谱执行读取与访问操作，包含搜索、加载、同步、历史与可视化等子命令。

用途该技能面向跨会话的记忆读取场景，帮助使用者检索过往决策与模式、在会话开始时加载相关上下文、查看决策时间线，以及将知识图谱渲染为 Mermaid 图。

主要能力

search：搜索过往决策、模式与实体，支持 --category（映射到 metadata.category）、--limit、--agent（按 agent_id 限定范围）、--global 等过滤标志。
load：在会话开始时自动加载相关记忆，支持 --project、--global。
history：以表格、Mermaid 或 JSON 输出决策时间线，支持 --since、--mermaid。
viz：将知识图谱渲染为 Mermaid 图。
status：执行记忆系统健康检查。

跨会话读取策略资料给出的分层读取顺序为：

~/.claude/projects/<slug>/memory/MEMORY.md（持久索引，始终优先加载）
.claude/chain/state.json 加最近的 NN-*.json 交接文件（会话延续）
MCP mcp__memory__search_nodes，用于文件系统索引无法回答的内容（类型化图遍历）第 1 层成本低（索引文件小），第 2 层范围明确（会话专属），第 3 层具有选择性（仅在需要时使用）。应避免将完整知识图谱倾倒进上下文，先用索引缩小搜索范围。

使用方式调用形式为 memory <subcommand> <query>，其中第一个参数为子命令（search、load、history、viz、status），第二个参数起为搜索查询或标志。若未提供子命令，技能会通过 AskUserQuestion 询问用户需要哪种记忆操作。

定时扫描仓库中的 .github/workflows/memory-staleness.yml 定时任务每晚 04:00 UTC 运行，调用 scripts/staleness_cron.py 扫描全部 memory MCP 实体，标记最新观测时间戳早于 30 天的实体，并将 Markdown 报告写入 docs/reports/memory-staleness-YYYY-MM-DD.md。命令示例：

python3 ${CLAUDE_SKILL_DIR}/scripts/staleness_cron.py docs/reports/
--threshold-days 30 --limit 50

自动跳过条件（均以退出码 0 结束并记录 WARN 日志）：yg-mcp-core 不可导入（未安装 yg-mcp-core>=0.3.0，该包位于私有 pypi.yonyon.ai，仅 HQ 可用）；memory MCP 不可达（服务器宕机或 .mcp.json 未定义 memory）。

报告内容包括：实体总数、陈旧与新鲜实体计数；按陈旧度排序的前 N 条陈旧条目（无时间戳者优先，随后由旧到新）；每行包含名称、entityType、天数、观测数量；按时间桶给出建议操作（超过 90 天需复核，超过 180 天为归档候选）。无时间戳的实体被视为陈旧，需要人工介入（回填 last_read 观测或修剪）。纯辅助函数（parse_iso_timestamp、latest_observation_timestamp、is_stale、build_report_payload、render_markdown）位于同目录的 staleness_lib.py 中，便于单元测试。

工作流程

解析子命令：提取第一个参数作为子命令；若无子命令则调用 AskUserQuestion；校验子命令属于 search、load、history、viz、status；解析其余标志；检查 --agent <agent-id> 标志并映射为 agent_id: "ork:{agent-id}"。
执行子命令：按子命令路由到相应处理器。
报告结果：按操作类型格式化输出。

规则速查

entity-extraction-patterns（rules/entity-extraction-patterns.md，HIGH）：实体类型、关系类型、图查询语义。
deduplication-strategy（rules/deduplication-strategy.md，HIGH）：Edit-over-Write 模式、基于锚点的插入、验证。

会话恢复 references/session-resume-patterns.md 提供 CC 2.1.31 恢复提示、结束前上下文捕获，以及针对 PR、issue 与实现的恢复工作流。

相关技能 ork:remember 负责存储决策与模式（写入侧）。

错误处理

viz 时图为空：提示可使用 remember。
子命令无效：显示用法帮助。
记忆文件损坏：报告并提供修复选项。
搜索查询为空：改为显示最近实体。
无搜索结果：建议替代方案。

限制资料未提供该技能的收费、价格、平台支持范围与效果数据，这些信息暂未提供。

技能介绍