关于 puda-memory
Puda Memory 是用于项目长期记录的技能,将协议文件链接和按时间排序的操作历史维护在各项目的 project.md 中。它要求使用真实时间戳,帮助保持运行记录可复现、可审计。
主要功能
- 01在 project.md 维护项目记录
- 02链接 protocols/ 下的协议文件
- 03按时间记录创建、更新和运行
- 04从相关文件读取真实时间戳
适用场景
- 01创建或更新协议后记录变更
- 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