ah-memory

name	ah-memory
description	Use when 需要在多个 ah-* 技能之间持续追踪进度、同步待办与避免会话切换后状态丢失时。

执行 Obsidian 的读取、检索、写入等动作时，优先调用官方技能：obsidian-cli。

AI 记忆系统

目标：在所有 ah-* 技能之间统一状态追踪，确保“可继续、可回溯、不丢任务”。

启动即执行

1. 读取 {{metaPaths.memory}}/STATUS.md。
2. 根据当前技能识别相关待处理项（阅读/制卡/项目/回顾/缓冲任务）。
3. 若存在待处理项，先提示用户：继续处理或开始新任务。

流程锁定规则（高优先级）

• 记忆流程是底层能力，不因用户提及其他主题而中断。
• 仅在两种情况允许提前退出：
  • 用户明确输入其他命令并要求切换。
  • 用户明确要求停止当前任务。
• 流程完成标志：任务文件已更新 + STATUS.md 已整合 + 下一步已明确。

重要提醒

• 禁止使用示例数据，状态与进度必须来自真实文件或用户确认。
• 禁止跳过结束整合；未写回 STATUS.md 视为未完成。
• 输出必须包含具体文件路径与更新内容，不能只说“已同步”。

核心机制（保持原功能）

两阶段更新

1. 阶段 1（会话中，高频）：更新任务专属文件。
2. 阶段 2（结束前，低频）：整合到 STATUS.md。

检查点写入

• 在每个关键节点写入一次任务专属文件。
• 会话结束前必须完成一次最终整合，避免跨会话状态丢失。

目录规范

必须使用以下结构：

{{metaPaths.memory}}/
├── STATUS.md
├── reading/
├── cards/
├── projects/
├── legacy/
└── reviews/

状态传递规则

• 读取方：每个技能启动时读取 STATUS.md 的相关区块。
• 写入方：每个技能结束时写回本次增量状态。
• 常见传递：ah-read -> ah-card、ah-review -> ah-note/ah-week/ah-month、ah-project -> ah-archive。

输出标准

• 必须输出：本次更新了哪些文件、更新了哪些状态、是否产生新的待办。
• 若有未完成项，必须输出明确下一步（建议技能 + 对应路径）。
• 输出内容必须可追溯，不允许仅给“已更新”这类模糊结果。

检查清单

• 已读取 {{metaPaths.memory}}/STATUS.md
• 已识别并提示相关待处理项
• 已在关键节点更新任务专属文件
• 已在结束阶段整合更新 STATUS.md
• 已写明跨技能传递与下一步建议

渐进加载（按需读取）

• 接口与异常规则：references/skill-interface-spec.md
• 全局状态与缓冲区模板：references/status-and-buffer-rules.md
• 任务专属文件模板：references/task-file-templates.md

相关技能

• ah：统一入口，启动时展示待处理项
• ah-note：早晨拉取缓冲任务
• ah-read / ah-card：阅读到制卡的状态接力
• ah-review / ah-week / ah-month：残留任务分层清理
• ah-project / ah-archive：项目状态流转与归档