project-registrylisted
Use when the user asks to list, create, delete, modify, search, view project details, save a project, exit a project, roll back a version, or update project development records for projects managed in ~/projects/PROJECTS.json. Triggers: "查看/列出项目", "新建/创建项目", "删除项目", "修改项目", "搜索项目", "项目详情", "项目统计", "项目清单", "项目列表", "保存项目", "退出", "返���", "更新记录", "开发记录", "项目上下文", "进度记录", "回滚", "恢复版本", "版本回滚", "撤销保存", "检查项目", "体检", "为什么", "归因", "决策背景", "audit". English triggers: "list/create/delete/save project", "project registry", "project status", "progress record", "project context", "rollback", "restore version", "why", "attribution", "audit", "project check".
SUNQSHENG/project-registry · ★ 1 · AI & Automation · score 67
Install: claude install-skill SUNQSHENG/project-registry
# project-registry
> **EN** — A Claude Code skill that manages a personal project registry (`~/projects/PROJECTS.json`) with per-project AI-readable development logs (CLAUDE.md): list, create, delete, save, session-resume, decision attribution, health check and version rollback from one menu. The UI text is Chinese-first, but **triggers work in both Chinese and English and every feature is fully functional regardless of language** (the AI understands both). Install: `npx skills add SUNQSHENG/project-registry` or `/plugin marketplace add SUNQSHENG/project-registry`.
## 概述
管理 `~/projects/PROJECTS.json` 注册的项目清单,提供项目的增删改查和统计功能。项目以 `<key>/` 子目录形式存放在 `~/projects/` 下,每个项目包含 README.md 记录背景和范围。
操作项目时自动 `cd` 到对应项目目录。
## 数据源
```
~/projects/
PROJECTS.json # 项目注册清单(唯一权威来源)
<key>/ # 项目目录
README.md # 项目背景和范围说明(面向人)
CLAUDE.md # 项目开发记录(面向 AI,每次对话自动加载)
```
所有项目**必须**存放在 `~/projects/` 目录下。
> **区别:** README.md 给开发者/协作者看项目概况;CLAUDE.md 给 AI 看,记录开发过程中的决策、状态、上下文,确保长项目不丢失信息。
### PROJECTS.json 结构
```json
{
"description": "项目清单 — 所有项目在此登记",
"updated": "2026-03-01",
"nextSeq": 3,
"projects": [
{
"seq": 1,
"key": "pet_hospital_crm_20260301",
"name": "宠物医院CRM",
"status": "已完成",
"created": "2026-03-01"
}
]
}
```
## 操作入口
每次进入 skill 时,先 `cd ~` 回到用户根目录,然后读取 PROJECTS.json 展示清单和精简菜单(不做目录级检测):
```
📋 当前项目清单(共 N 个)
┌─────┬──────────────────────────────┬─────────────────┬──────────────────────┬──────────┬────────────┐
│