Project Registry Skill：让 Claude Code 记住你做过什么、接下来该做什么

Project Registry Skill：让 Claude Code 记住你做过什么、接下来该做什么

Claude Code 很强，但它记不住你上周在哪个项目里做了什么。一旦新会话开启，它就像一个刚入职的实习生——不知道项目背景、不记得你做过的决策、不清楚下一步该往哪走。Project Registry 就是来解决这个问题的：它是一个 Claude Code Skill，帮你把所有项目管起来，让 AI 在任意时刻都能恢复完整的项目上下文和决策链条。

这个 Skill 的核心价值在于”跨会话记忆”。它用一份 ~/projects/PROJECTS.json 作为全局项目索引，每个项目文件夹里有 CLAUDE.md 记录状态、决策和待办，.memory/ 目录自动存档对话记录。Claude Code 每次进入项目目录时自动加载 CLAUDE.md，你不需要重复解释项目背景。

GitHub: https://github.com/SUNQSHENG/project-registry

作者是 SUNQSHENG（GitHub username: SUNQSHENG），目前项目在 skilld.dev 等 Skill 目录中处于上升期，2026 年 8 月初发布后进入 Trending 榜单，是近期值得关注的新 Skill 之一。

Project Registry 将个人开发者同时推进的多个项目（正式项目、边项目、学习项目）的上下文管理做成了一条完整链路。传统方式下，Claude Code 新会话等于重新开始——你得把项目背景、已做决策、待办事项再说一遍。这个 Skill 把这个过程自动化：每个项目有自己的 CLAUDE.md，进入项目目录时 AI 自动读取；退出时只需说”save”或”exit”，Claude 会自动更新 CLAUDE.md，记录决策原因和优先待办；下次回来时，输入项目编号即可恢复上次进度。

项目结构分为三层：PROJECTS.json 是全局索引，记录所有项目的基本信息和状态；每个项目目录下有 README.md（给人看的背景说明）、CLAUDE.md（给 AI 看的状态、决策、待办）和 .memory/（自动存档的对话记录，gitignore 不提交）。整个系统无硬编码路径，支持任意项目根目录配置。

该 Skill 的设计哲学是”intent-driven, never pushy”——系统是你的工作流，Claude 不会主动推销项目，只在被问到时才响应。这避免了在每个会话里被项目列表打断的烦恼。

核心功能包括：项目增删改查与统计（通过 PROJECTS.json）、新项目一键脚手架（自动创建目录、初始化 Git、写入模板文件）、会话恢复（进入项目即加载上次进度和优先待办）、决策归因（”why X”命令返回决策时间线，包含原因、状态和影响）、自动保存（”save”或”exit”强制更新 CLAUDE.md）、上下文自动备份（transcript 每条响应后存档，即使终端被 kill 也能恢复）、健康检查（批量检查 CLAUDE.md 状态一致性、僵尸项目和未实现的决策）和版本回滚（CLAUDE.md/项目文件/注册表均可回滚，带 diff 确认和备份优先）。

安装方式非常简单，支持多种入口：

# 方式1: npx 一键安装
npx @sunqsheng/project-registry

# 方式2: skills 命令
npx skills add SUNQSHENG/project-registry

# 方式3: Claude Code 插件市场
/plugin marketplace add SUNQSHENG/project-registry

# 方式4: 手动克隆
git clone https://github.com/SUNQSHENG/project-registry
cp -r project-registry/skills/project-registry ~/.claude/skills/

安装完成后，输入”list projects”或”/project-registry”即可唤起交互菜单。

这个 Skill 适合以下场景和人群：多项目并行的个人开发者，同时推进工作项目、Side Project 和学习实验，Claude Code 每次新会话都丢失上下文；需要记录决策过程的团队成员，项目周期长、决策多、时间久了不记得当时为什么选某个方案；希望 Claude Code 能真正成为长期协作者的用户，而非每次都从零开始。

典型使用流程：输入”list projects”唤起菜单，键入项目编号进入该项目（此时 Claude 自动加载 CLAUDE.md 并恢复上次进度），正常开展开发工作，完成后说”save”或”exit”保存进度，之后任何时候回到项目只需输入项目编号，Claude 立即知道上次做了什么、下一步该做什么，遇到问题说”why X”可以查看该决策的原因链和影响。

输入示例：

“list projects” → 菜单显示所有项目及状态（进行中/暂停/已完成）
“2” → 进入项目 2，Claude 加载 CLAUDE.md，显示”上次完成了用户认证模块，下一步是接支付 API”
“save” → Claude 更新 CLAUDE.md，记录本次对话中的决策和下次待办
“why X” → 返回决策时间线，例如”为什么选 Stripe 而非微信支付：原因、状态（已执行）、影响（需要处理退款逻辑）”

Project Registry 解决的是一个非常具体但普遍的问题：Claude Code 在多项目场景下的”记忆丧失症”。它不改变 Claude Code 的核心能力，而是给它加了一层持久化上下文层。对于同时推进多个项目的开发者来说，这个 Skill 能显著减少重复解释上下文的时间，让每次 Claude 会话都能直接切入正题。

GitHub: https://github.com/SUNQSHENG/project-registry