@josephakern/pi-memory
为Pi编码智能体提供基于文件的持久化记忆系统。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@josephakern/pi-memory。 它的用途是：为Pi编码智能体提供基于文件的持久化记忆系统。 完整的 Skill 内容见：https://321skill.com/skills/josephakern-pi-memory/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“记住我们决定在这个项目中使用TypeScript和React。” 它会将这条关键决策记录到项目范围的MEMORY.md中。几天后，当你问：“我们之前定下的前端技术栈是什么？” AI会检索MEMORY.md并准确回答。在深入讨论状态管理时，你可以说：“把关于Zustand和Redux的讨论记录到‘状态管理’主题文件里。” AI会创建或更新对应的主题文件。
介绍
该Skill旨在解决AI编码助手（如Pi）在对话或项目间缺乏持久记忆的问题。它通过创建和维护一个基于文件的记忆系统，让AI能够记住关键的项目信息、代码决策和上下文，从而在后续交互中提供更连贯、更准确的帮助。
使用方式是通过npm安装此包，并在Pi智能体环境中配置。它会在全局或特定项目仓库内自动生成并维护一个名为MEMORY.md的索引文件，该文件记录了核心记忆的摘要。同时，系统会根据需要创建按主题分类的详细记忆文件，形成一个结构化的记忆库。
它非常适合需要长期、复杂协作的开发者或团队，特别是那些使用Pi等AI编码助手进行项目开发、代码审查或知识传承的场景。通过将关键讨论和决策固化下来，能显著提升AI助手在不同会话间的工作连续性。
使用建议是明确划分记忆的“范围”（全局或项目内），并利用主题文件来组织不同领域的知识。需要注意的是，记忆文件是纯文本格式，应避免在其中存储敏感信息，并定期回顾MEMORY.md索引以确保其有效性。
核心特点
核心区别在于采用了“全局+项目”双范围记忆，并设计了“始终注入的摘要索引（MEMORY.md）+ 按需创建的主题文件”的混合结构。这既保证了核心记忆的即时可用性，又通过主题文件实现了记忆的深度扩展和结构化存储，避免了单一文件臃肿或记忆碎片化的问题。
注意事项
不适合需要实时、高频同步的协作场景，或对文件系统访问有严格限制的环境。
常见问题
这个记忆文件是自动生成的吗？
是的，MEMORY.md索引会自动生成和维护，主题文件可根据需要由AI或用户创建。
记忆数据安全吗？
数据以明文文件形式存储，请勿在其中保存密码、密钥等敏感信息。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/josephakern-pi-memory/raw/index.md 读取 @josephakern/pi-memory 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/josephakern-pi-memory/raw/index.md（查看排版版本）