name: onboard description: 交互式vault设置和上下文加载。首次运行时,个性化您的vault。后续运行时,加载完整上下文。在会话开始时或当Claude需要完整vault上下文时使用。 allowed-tools: Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion model: sonnet user-invocable: true
引导技能
交互式vault设置(首次运行)和上下文加载(后续运行)。
用法
/onboard # 完整引导(首次运行设置,非首次运行则加载上下文)
/onboard Projects/MyProject # 加载特定项目上下文
首次运行设置
如果vault根目录中存在文件FIRST_RUN,则表示这是一个新vault。运行交互式设置:
步骤1:欢迎
问候用户并解释将要发生的事:
- “我会问几个问题来个性化您的vault(约2分钟)”
- “您的答案将本地保存在vault-config.json中”
- “您可以随时通过编辑该文件或再次运行/onboard来更改这些设置”
步骤2:提问
使用AskUserQuestion交互式提问:
问题1:您的姓名
- “我应该怎么称呼您?”
- 用于个性化提示和问候
问题2:偏好复习日
- “您偏好哪一天进行每周复习?”
- 选项:周日(推荐)、周六、周一、周五
- 由
/review自动检测和会话初始提醒使用
问题3:主要目标领域
- “目前哪些领域对您最重要?(选择2-4个)”
- 选项:职业与专业、健康与健康、人际关系、个人成长
- 同时提供:财务、创意与乐趣、学习、其他
- multiSelect: true
- 用于自定义目标模板建议
问题4:工作风格
- “您偏好Claude如何交互?”
- 选项:直接简明(推荐)、教练与挑战、详细彻底、最小化——仅执行任务
- 设置输出风格偏好
步骤3:保存配置
在vault根目录写入vault-config.json:
{
"name": "用户姓名",
"reviewDay": "Sunday",
"goalAreas": ["Career & Professional", "Health & Wellness"],
"workStyle": "Direct and concise",
"setupDate": "2026-02-15",
"version": "3.1"
}
步骤4:个性化CLAUDE.md
编辑根目录CLAUDE.md:
- 将
[CUSTOMIZE: Add your personal mission statement here]替换为基于他们目标领域的提示 - 更新“当前焦点”部分以引用他们选择的领域
步骤5:移除首次运行标记
rm FIRST_RUN
步骤6:确认设置
告诉用户:
- “您的vault已设置完成!以下是可用内容:”
- 简要概述级联功能
- “尝试
/daily开始您的第一个晨间例程” - “尝试
/review随时使用——它会自动检测正确的复习类型”
然后继续进行以下标准上下文加载。
标准上下文加载(后续运行)
本技能的作用
-
发现上下文文件
- 搜索所有CLAUDE.md文件
- 遍历项目目录
- 尊重深度限制
-
加载分层上下文
- 首先根CLAUDE.md(全局上下文)
- 项目特定CLAUDE.md文件
- 最近每日笔记用于当前状态
-
扫描活跃项目
- 自动发现所有
Projects/*/CLAUDE.md文件 - 提取项目名称、阶段、进度和目标链接
- 在引导输出中显示活跃项目计数和摘要
- 自动发现所有
-
读取用户偏好
- 如果存在则加载
vault-config.json - 应用姓名、复习日、工作风格偏好
- 使用目标领域来优先加载上下文
- 如果存在则加载
-
构建理解
- 您的个人使命/目标
- 项目结构和状态
- 工作流程偏好
- 自定义惯例
上下文层级
vault/
├── CLAUDE.md # [1] 全局上下文 - 首先加载
├── Projects/
│ ├── Project A/
│ │ └── CLAUDE.md # [2] 项目上下文
│ └── Project B/
│ └── CLAUDE.md # [3] 另一个项目上下文
└── Areas/
└── Health/
└── CLAUDE.md # [4] 区域特定上下文
CLAUDE.md 文件结构
根CLAUDE.md应包含
# Claude的系统上下文
## 个人使命
[您的人生使命/目的]
## 当前焦点
[您现在在做什么]
## 偏好
- 写作风格:[正式/休闲/技术]
- 详细程度:[高/中/低]
## 惯例
- 文件命名:[您的模式]
- 标签系统:[您的标签]
项目CLAUDE.md应包含
# 项目:[名称]
## 概述
[本项目的内容]
## 当前状态
[进展情况]
## 关键决策
[已做的重要选择]
## 下一步
[需要做什么]
智能上下文加载
最近活动
自动考虑:
- 最近7天的每日笔记
- 当前周的复习
- 最近修改的项目
项目摘要
加载完整上下文时,包含项目概述:
### 活跃项目(N)
| 项目 | 阶段 | 进度 | 目标 |
|---------|-------|----------|------|
| [[ProjectA]] | 活跃 | 60% | [[目标 1]] |
| [[ProjectB]] | 规划 | 10% | [[目标 3]] |
选择性加载
用于聚焦协助:
/onboard Projects/WebApp # 仅特定项目
/onboard Goals # 仅目标上下文
使用案例
启动会话
/onboard
“根据我的目标帮我规划一天”
项目工作
/onboard Projects/MyApp
“帮我重构认证模块”
每周规划
/onboard Goals
“分析我的一周并提出改进建议”
上下文变量
您的CLAUDE.md文件可以包含偏好:
## Claude的变量
- DEFAULT_LANGUAGE: JavaScript
- TIMEZONE: America/New_York
- COMMUNICATION_STYLE: Direct and concise
最佳实践
保持上下文更新
- 每月审查CLAUDE.md文件
- 重大决策后更新
- 移除过时信息
- 添加新学习
具体明确
- 清晰的项目描述
- 具体的偏好
- 具体的例子
- 定义的惯例
分层信息
- 全局 → 区域 → 项目 → 任务
- 一般 → 具体
- 战略 → 战术
隐私与安全
切勿包含在CLAUDE.md中
- 密码或凭证
- 个人身份号码
- 金融账户详情
- 私人API密钥
安全的上下文例子
- “我从事医疗技术工作”
- “我的项目涉及Web开发”
- “我偏好晨间工作时段”
集成
与以下协同工作:
- 所有其他技能(提供上下文)
/daily- 有上下文更好的每日规划/weekly- 信息丰富的每周复习/monthly- 有完整上下文的每月复习/project- 项目状态概述- 目标跟踪 - 理解目标级联