424 lines
13 KiB
Markdown
424 lines
13 KiB
Markdown
# AI 持久上下文管理框架
|
||
|
||
`Claude Code` `AI工作流` `项目管理` `上下文记忆` `效率工具`
|
||
|
||
# Nexus
|
||
|
||
> **快速开始：**[使用此模板](https://github.com/DorianSchlede/nexus-template/generate) → 克隆仓库 → 在 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 账号** — [在此注册](https://claude.ai)
|
||
- [ ] **Visual Studio Code** — [下载](https://code.visualstudio.com/)
|
||
- [ ] **Claude Code VS Code 扩展** — 从 VS Code 应用商店安装
|
||
- [ ] **Python 3.x** — [下载](https://python.org)
|
||
|
||
### 第一步：创建你的 Nexus
|
||
|
||
1. 点击 **[使用此模板](https://github.com/DorianSchlede/nexus-template/generate)**
|
||
2. 为仓库命名（如 `my-nexus`），点击 **创建仓库**
|
||
3. 克隆并打开：
|
||
```bash
|
||
git clone https://github.com/YOUR-USERNAME/my-nexus.git
|
||
cd my-nexus
|
||
code .
|
||
```
|
||
|
||
### 第二步：启动 Claude Code
|
||
|
||
1. 通过 Claude Code 扩展**打开 Claude 聊天**（点击侧边栏的 Claude 图标）
|
||
2. **说：** `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 个新文件夹。
|
||
```
|
||
|
||
重新整理文件后偶尔运行一次。
|
||
|
||
---
|
||
|
||
## 系统要求
|
||
|
||
**必需：**
|
||
- Claude Code 账号（[注册](https://claude.ai)）
|
||
- Visual Studio Code（[下载](https://code.visualstudio.com/)）
|
||
- Claude Code VS Code 扩展（从应用商店安装）
|
||
- Python 3.x（[下载](https://python.org)）
|
||
|
||
**可选：**
|
||
- 用于集成的 MCP 服务器（Notion、Airtable、Linear）
|
||
- 用于版本控制的 Git
|
||
|
||
---
|
||
|
||
## 深入了解
|
||
|
||
- **[产品概述](00-system/documentation/product-overview.md)** — Nexus 解决的问题
|
||
- **[框架概述](00-system/documentation/framework-overview.md)** — 技术深度解析
|
||
|
||
---
|
||
|
||
## 获取 Nexus
|
||
|
||
### 方式一：使用模板（推荐）
|
||
|
||
1. 前往 [Nexus GitHub 仓库](https://github.com/DorianSchlede/nexus-template)
|
||
2. 点击 **"使用此模板"** → **"创建新仓库"**
|
||
3. 命名仓库，设置可见性，点击 **"创建仓库"**
|
||
4. 克隆你的新仓库：
|
||
```bash
|
||
git clone https://github.com/YOUR-USERNAME/YOUR-REPO-NAME.git
|
||
cd YOUR-REPO-NAME
|
||
code .
|
||
```
|
||
|
||
这样你就有了自己的副本，可以提交个人数据（目标、项目、技能）。
|
||
|
||
### 方式二：直接克隆（用于体验）
|
||
|
||
```bash
|
||
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 协作。一次构建，永久复用。永不从零开始。 |