mcpField
P
puda-memory

puda-memory

github.com/pudap生产力188 次安装4 天前更新
代码仓库

关于 puda-memory

Puda Memory 是用于项目长期记录的技能,将协议文件链接和按时间排序的操作历史维护在各项目的 project.md 中。它要求使用真实时间戳,帮助保持运行记录可复现、可审计。

主要功能

  1. 01在 project.md 维护项目记录
  2. 02链接 protocols/ 下的协议文件
  3. 03按时间记录创建、更新和运行
  4. 04从相关文件读取真实时间戳

适用场景

  1. 01创建或更新协议后记录变更
  2. 02每次运行协议后补充历史

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/pudap/skills --skill puda-memory

安装后在 Claude Code 中输入/puda-memory确认已加载。

详细介绍

Puda Memory

目标

将 project.md 维护为每个项目的唯一事实来源:记录协议链接和按时间顺序排列的历史,以确保运行可复现、可审计。

重要:持久化所有与项目相关的状态,以确保运行可复现、可审计。

每个项目文件夹都应将 project.md 作为记录该项目所有信息的唯一位置,用于长期记忆。以下路径均相对于项目文件夹(其中包含 protocols/)。

何时更新

  • 创建协议文件后
  • 更新协议或基于协议派生出新协议后
  • 每次运行协议后

在 project.md 中记录什么

  • 协议:使用指向 protocols/ 下协议文件的显式 Markdown 链接。在“Protocols”部分中,按 [<protocol_id>](protocols/<protocol_id>.json) 的格式列出每个协议,并可在链接后添加简短说明(例如 [<protocol_id>](protocols/<protocol_id>.json) — <summary>)。
  • 历史记录:按时间顺序记录操作,并使用 ISO 8601 时间戳。必须使用真实时间戳,绝不可猜测或使用占位符。从相关文件中获取时间戳:“ran”条目使用日志文件的第一行;“created”/“updated”条目使用协议 JSON 文件中的 timestamp 键。所有文件路径都必须使用显式 Markdown 链接。每项操作追加一行,格式如下:
    • <timestamp> created [<protocol_id>](protocols/<protocol_id>.json)
    • <timestamp> updated [<old_protocol_id>](protocols/<old_protocol_id>.json) to [<new_protocol_id>](protocols/<new_protocol_id>.json)
    • ` ran <protocol_id>

评论

支持 Markdown