13 KiB
13 KiB
AI 持久上下文管理框架
Claude Code AI工作流 项目管理 上下文记忆 效率工具
Nexus
快速开始：使用此模板 → 克隆仓库 → 在 VS Code 中打开 → 启动 Claude Code → 说"hi"
你现在面临的问题
每次开启新的 Claude 会话时：
- 你要重新介绍自己是谁、做什么的
- 你要重新描述项目及进度
- 你要从头搭建相同的工作流
- 你会丢失上下文、洞察和工作动力
如果 Claude 能记住一切，会怎样？
看看效果（2 分钟）
第一次使用：
你："hi"
AI：显示 Nexus 菜单：
🧠 记忆 - 未配置 ▸ '设置目标'
📦 项目 - 暂无 ▸ '创建项目'
🔧 技能 - 26 个可用
💡 建议：'设置目标' 让 Nexus 了解你
你："为启动 v2.0 仪表板创建项目"
AI：[创建项目结构，引导规划]
✅ 项目已创建：01-dashboard-launch
下次会话：
你："hi"
AI：显示你的上下文：
🧠 记忆 - 角色：SaaS 产品经理 | 目标：发布 v2.0
📦 项目 - • dashboard-launch | 进行中 | 42%
💡 建议：'继续 dashboard-launch' - 从 42% 处恢复
你："继续 dashboard-launch"
AI：[加载全部上下文，精确显示上次进度]
"你正处于第 2 阶段：设计。下一个任务：审查线框图。"
这就是魔法所在。 永远不用重新解释。
实现这一切的原理
Nexus 为你提供三样东西：
1. 持久化记忆
你的角色、目标和学习成果保存在文件中。每次会话，Claude 自动加载它们。你永远不会从零开始。
2. 结构化项目
工作在项目中进行——包含规划文档、任务列表和进度跟踪。一切自动保存。
3. 可复用技能
捕获你重复执行的工作流。做完某件有用的事后说"创建技能"，它就永远变成一个单命令操作。
快速开始
前置条件
- Claude Code 账号 — 在此注册
- Visual Studio Code — 下载
- Claude Code VS Code 扩展 — 从 VS Code 应用商店安装
- Python 3.x — 下载
第一步：创建你的 Nexus
- 点击 使用此模板
- 为仓库命名（如
my-nexus），点击 创建仓库 - 克隆并打开：
git clone https://github.com/YOUR-USERNAME/my-nexus.git cd my-nexus code .
第二步：启动 Claude Code
- 通过 Claude Code 扩展打开 Claude 聊天（点击侧边栏的 Claude 图标）
- 说：
hi
系统自动激活并显示菜单。
第三步：开始工作
你可以立即开始工作——无需任何设置！
| 你说 | 发生什么 |
|---|---|
"创建项目" |
通过引导开始新项目 |
"设置目标" |
用你的角色和目标个性化 Nexus |
"设置工作区" |
整理你的文件夹 |
"完成" |
保存进度，结束会话 |
可选：学习系统
准备好后，6 个可选学习技能带你全面掌握系统：
| 技能 | 触发词 | 时长 |
|---|---|---|
| setup-goals | "设置目标" | 8-10 分钟 |
| setup-workspace | "设置工作区" | 5-8 分钟 |
| learn-integrations | "学习集成" | 10-12 分钟 |
| learn-projects | "学习项目" | 8-10 分钟 |
| learn-skills | "学习技能" | 10-12 分钟 |
| learn-nexus | "学习 nexus" | 15-18 分钟 |
三大核心概念
记忆——你的持久上下文
01-memory/ 文件夹存储你的信息（首次运行时自动创建）：
01-memory/
├── goals.md ← 你的角色、目标、成功指标
├── user-config.yaml ← 语言和偏好设置
├── core-learnings.md ← 随时间积累的规律
└── session-reports/ ← 自动生成的会话历史
每次会话，Claude 首先加载这些文件。在你开口之前，它就已了解你的上下文。
项目——结构化工作
项目有开始、中间和结束：
02-projects/01-dashboard-launch/
├── 01-planning/ ← overview.md、plan.md、steps.md
├── 02-resources/ ← 参考资料
├── 03-working/ ← 进行中的工作
└── 04-outputs/ ← 最终交付物
技能——可复用工作流
技能捕获你重复执行的操作：
你："生成状态报告"
AI：[加载技能 → 按步骤执行 → 生成报告]
做完有用的事后用 "创建技能" 来创建你自己的技能。
会话工作流程
┌─────────────────────────────────────────────────────────────┐
│ 开始："hi" │
│ → 系统加载你的记忆 │
│ → 显示你的活跃项目和技能 │
│ → 根据你的状态建议下一步 │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ 工作："继续 [项目]" 或 "[技能触发词]" │
│ → 加载相关上下文 │
│ → 系统化执行 │
│ → 跟踪进度 │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ 结束："完成" │
│ → 保存所有进度 │
│ → 用学习内容更新记忆 │
│ → 创建会话报告 │
│ → 准备好下次恢复 │
└─────────────────────────────────────────────────────────────┘
集成
用自然语言连接你的工具：
| 集成 | 触发词 | 功能 |
|---|---|---|
| Notion | "连接 notion" | 查询数据库、创建页面、管理内容 |
| Airtable | "连接 airtable" | 查询表格、管理记录、批量操作 |
| Beam AI | "连接 beam" | 管理智能体、创建任务、查看分析 |
| 任意 REST API | "添加集成" | 自动发现端点，创建实现方案 |
引导式设置带你完成 API 密钥和配置。
工作区地图
你的 04-workspace/ 文件夹在 workspace-map.md 中有完整记录——这是你文件结构的动态地图。
为什么重要：
- Nexus 通过它了解你的文件位置
- 无需询问即可找到并整理文件
- 新文件和文件夹会被自动识别
保持同步：
你："更新工作区地图"
AI：[扫描 04-workspace/，更新文档]
✅ 工作区地图已更新。发现 3 个新文件夹。
重新整理文件后偶尔运行一次。
系统要求
必需：
可选：
- 用于集成的 MCP 服务器（Notion、Airtable、Linear）
- 用于版本控制的 Git
深入了解
获取 Nexus
方式一：使用模板（推荐）
- 前往 Nexus GitHub 仓库
- 点击 "使用此模板" → "创建新仓库"
- 命名仓库，设置可见性，点击 "创建仓库"
- 克隆你的新仓库：
git clone https://github.com/YOUR-USERNAME/YOUR-REPO-NAME.git cd YOUR-REPO-NAME code .
这样你就有了自己的副本，可以提交个人数据（目标、项目、技能）。
方式二：直接克隆（用于体验）
git clone https://github.com/DorianSchlede/nexus-template.git
cd nexus-template
code .
注意：直接克隆无法将更改推送到原始仓库。
获取更新
Nexus 会定期进行系统更新（新技能、改进、修复）。更新过程中绝不会触碰你的个人数据。
更新内容
| 更新（来自上游） | 受保护（你的数据） |
|---|---|
00-system/ |
01-memory/ |
CLAUDE.md |
02-projects/ |
README.md |
03-skills/ |
04-workspace/ |
|
.env、.claude/ |
自动检查更新
启动时自动检查更新。有可用更新时，你会看到：
⚡ 有可用更新：v0.9.0 → v0.10.0
说 'update nexus' 获取最新改进
如何更新
只需说：
你："update nexus"
AI：有可用更新：v0.9.0 → v0.10.0
将更新 12 个文件
是否继续？(yes/no)
你："yes"
AI：✅ 更新完成！备份位于：.sync-backup/2024-01-15/
技术参考
以下章节供希望深入了解的用户阅读。
文件夹结构
Nexus/
│
├── CLAUDE.md # 入口点 - 启动时加载
│
├── 00-system/ # 框架（请勿修改）
│ ├── core/ # 引擎脚本
│ │ ├── orchestrator.md # AI 决策逻辑
│ │ └── nexus-loader.py # 上下文加载器 + 状态机
│ ├── skills/ # 内置系统技能（26+）
│ │ ├── learning/ # 引导技能
│ │ ├── projects/ # 项目管理
│ │ ├── skill-dev/ # 技能创建
│ │ ├── system/ # 系统工具
│ │ ├── notion/ # Notion 集成
│ │ ├── airtable/ # Airtable 集成
│ │ └── tools/ # 思维模型、生成器
│ └── documentation/ # 框架指南
│
├── 01-memory/ # 你的持久上下文
│ ├── goals.md # 角色、目标（自动创建）
│ ├── user-config.yaml # 偏好 + 学习跟踪
│ ├── core-learnings.md # 规律（持续增长）
│ └── session-reports/ # 自动生成的摘要
│
├── 02-projects/ # 你的阶段性工作
│ └── {id}-{name}/ # 每个项目
│
├── 03-skills/ # 你的自定义技能
│ └── {skill-name}/ # 你的可复用工作流
│
└── 04-workspace/ # 你的文件
└── [你的组织方式] # 文档、数据、输出
项目生命周期
| 状态 | 含义 |
|---|---|
PLANNING |
规划设计中 |
IN_PROGRESS |
积极推进中 |
COMPLETE |
所有任务完成 |
ARCHIVED |
已归档 |
内置系统技能
核心技能
| 技能 | 触发词 | 功能 |
|---|---|---|
create-project |
"创建项目" | 引导式项目创建 |
create-skill |
"创建技能" | 捕获工作流以便复用 |
execute-project |
"继续 [名称]" | 系统化项目执行 |
close-session |
"完成" | 保存进度，生成报告 |
学习技能
| 技能 | 触发词 | 功能 |
|---|---|---|
setup-goals |
"设置目标" | 个性化你的目标 |
setup-workspace |
"设置工作区" | 配置文件夹结构 |
learn-integrations |
"学习集成" | 连接外部工具 |
learn-projects |
"学习项目" | 项目系统教程 |
learn-skills |
"学习技能" | 技能系统教程 |
learn-nexus |
"学习 nexus" | 系统全面掌握 |
集成技能
| 技能 | 触发词 | 功能 |
|---|---|---|
notion-master |
"连接 notion" | Notion 数据库集成 |
airtable-master |
"连接 airtable" | Airtable 表格集成 |
add-integration |
"添加集成" | MCP 服务器设置指南 |
常用命令参考
| 命令 | 效果 |
|---|---|
"hi" |
加载系统，显示菜单 |
"创建项目" |
启动引导式项目创建 |
"创建技能" |
捕获可复用工作流 |
"继续 [名称]" |
恢复项目 |
"设置目标" |
个性化你的上下文 |
"完成" |
保存一切，结束会话 |
"验证系统" |
检查完整性 |
Nexus — 以最优方式与 AI 协作。一次构建，永久复用。永不从零开始。