claude-lore
为AI编程会话提供项目记忆与知识库，避免重复探索
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：claude-lore。 它的用途是：为AI编程会话提供项目记忆与知识库，避免重复探索 完整的 Skill 内容见：https://321skill.com/skills/claude-lore/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'/lore' 或 '为本项目设置Lore'。它会自动扫描现有文档（如README中的状态部分），迁移已有知识，并在 `docs/lore/` 下创建五个核心文件，同时更新 `CLAUDE.md` 以嵌入会话协议。之后，每次开始新会话，AI都会自动读取 `STATE.md` 和 `ROADMAP.md`，并在修改代码前搜索 `LEARNINGS.md` 中的相关陷阱，让你无缝衔接上次的工作。
介绍
Lore 解决的是AI编程会话中普遍存在的“记忆断层”问题。当你开启一个新的AI编程会话时，AI助手（如Claude Code）对你的项目历史、决策过程、未完成的工作状态以及踩过的坑一无所知，只能重新阅读代码库。这不仅浪费时间和上下文，还可能导致AI重新尝试已被证明无效的方案，重复劳动。
Lore 通过一套结构化的Markdown文件系统来记录代码之外的关键知识。它在项目根目录下的 docs/lore/ 文件夹中创建五个核心文件：STATE.md（当前状态）、ROADMAP.md（路线图）、DECISIONS.md（决策记录）、LEARNINGS.md（经验教训）和 JOURNAL.md（工作日志）。这些文件在项目开发过程中持续更新，形成一个活的、与代码共存的“项目大脑”。
它非常适合与AI结对编程的开发者，尤其是那些项目周期较长、涉及复杂决策、或需要多人/多会话协作的场景。无论是个人开发者管理自己的项目进度，还是团队共享开发上下文，Lore 都能显著提升AI助手的效率和决策质量。
与简单的笔记或README不同，Lore 的核心在于其“协议驱动”的工作流。它不仅创建文件，更重要的是会修改项目的 CLAUDE.md 文件，嵌入一个会话协议，强制要求每个新的AI会话在开始时都先读取这些知识文件。这确保了记录的知识能被主动使用，而非被遗忘。它不依赖任何外部服务或复杂配置，纯粹基于Markdown和Git，易于版本控制和团队共享。
核心特点
Lore 的核心区别在于它强制将“项目记忆”结构化并集成到AI工作流中，通过修改 `CLAUDE.md` 协议确保知识被主动读取，而非被动文档；同时，它明确区分了“状态”、“决策”、“教训”等不同知识类型，并规定了每种文件的读写时机，防止知识库变成杂乱无章的记事本。
注意事项
对于极其简单、一次性或探索性的微型项目，维护Lore的额外开销可能超过其收益。
常见问题
Lore和普通的项目笔记或README有什么区别？
Lore是结构化、协议驱动的活知识库，强制AI在每次会话时读取，确保知识被使用；而普通笔记是静态的，容易被忽略。
Lore只能和Claude一起用吗？
虽然为Claude Code优化，但任何能读取`SKILL.md`或遵循`CLAUDE.md`协议的AI代理（如Cursor、Trae）都可以使用。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/claude-lore/raw/index.md 读取 claude-lore 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/claude-lore/raw/index.md（查看排版版本）