📌 Skill基础信息
- Skill名称:onboard
- 简称:onboard
- 来源:社区第三方(iBrain-BVBA)
- 运行宿主:只能在 Claude-Code CLI 中运行
- 核心定位:为 gutt 记忆集成系统提供首次使用引导,验证 MCP 连接、演示记忆搜索与捕获功能,并解释 HUD 状态栏和活动钩子机制,适用于新用户初始化配置场景。
🧩 内部核心组成
该 Skill 主要通过流程化步骤实现引导功能,包含以下核心组件:
子Agent集合
【无公开信息】
斜杠命令
| 命令名 | 功能简述 |
|---|---|
| /gutt-pro:setup | 配置 gutt MCP 服务器 |
| /gutt-pro:statusline | 启用/禁用状态栏 HUD |
| /memory-search | 搜索记忆图谱 |
| /memory-capture | 捕获记忆内容 |
| /skills-discovery | 分析可用技能 |
MCP工具
search_memory_nodes: 搜索记忆节点add_memory: 添加记忆记录
模板文件
【无公开信息】
Hooks钩子
| Hook名称 | 触发事件 | 功能描述 |
|---|---|---|
| session-start | SessionStart | 开启会话记录并运行状态TTL清理 |
| session-connectivity | SessionStart (async) | 检测MCP配置状态 |
| session-end | SessionEnd | 最终化会话记录并清理会话休眠 |
| user-prompt-submit | UserPromptSubmit | 在每个提示前注入相关记忆上下文 |
| post-memory-search | PostToolUse (gutt) | 记录记忆搜索行为 |
| prompt hook | Stop | 判断是否值得捕获到记忆 |
规则约束
- 状态栏HUD默认关闭,需要用户主动启用
- MCP连接验证是后续功能的前提条件
目录结构
【无公开信息】
🛠 安装与启用方式
安装命令:
skills install --user iBrain-BVBA/gutt-claude-code-plugin
前置依赖:
- 需要预先配置 gutt MCP 服务器
- 需要有效的 API key 或访问令牌
配置要求:
- 需要在
.claude/settings.json中配置 MCP 服务器 URL
启动方式:
- 通过触发词自动触发:
onboard,getting started,first time,setup guide,how does this work - 支持
--check模式进行快速验证
📋 标准工作流
- 用户输入:用户输入任意触发词启动引导流程
- MCP检测:Skill 检查项目设置中的 gutt MCP 配置
- 连接验证:执行测试查询验证 MCP 连接状态
- 首次搜索:演示记忆检索功能,展示知识图谱结果
- 首次捕获:创建 onboarding 记录到记忆系统
- HUD说明:解释状态栏功能和使用方法
- 钩子介绍:列出所有活动钩子及其功能
- 后续指引:提供下一步使用建议和可用命令
⚠️ 关键限制、缺陷、注意事项
- 平台限制:仅支持 Claude-Code CLI,不支持其他 Agent 工具
- 网络要求:需要稳定网络连接访问 MCP 服务器
- 配置依赖:必须正确配置 MCP 服务器 URL 才能正常使用
- 状态栏限制:插件无法自动安装状态栏,需要用户手动启用
- 生产环境:适合开发环境使用,生产环境需充分测试
- 记忆容量:新安装时记忆图谱为空,需要时间积累内容
✅ 适用场景 & ❌ 不适合场景
适用场景:
- gutt 记忆集成系统的首次安装配置
- 新团队成员 onboarding 流程
- 需要了解记忆搜索和捕获功能的开发人员
- 希望集成组织知识管理的工作流程
不适合场景:
- 已正确配置并熟悉 gutt 系统的用户
- 无需记忆集成功能的简单项目
- 网络环境不稳定无法连接 MCP 服务器的情况
- 对命令行操作不熟悉的非技术用户
如何安装
skills install --user iBrain-BVBA/gutt-claude-code-plugin通用安装教程:在哪里输入上面的命令
上面的命令本质是在「终端 / 命令行」中调用技能管理器,把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同,按下面操作即可:
- 打开工具自带的终端面板,或系统终端(macOS「终端」、Windows「PowerShell」、Linux「Terminal」)。
- 把上面的安装命令复制进去,回车运行,等待下载与注册完成。
- 重启或重新加载 AI 工具,让新安装的 Skill 被识别。
- 新建对话并触发:直接描述用途,或通过该工具的技能 / 斜杠菜单选中此 Skill。
Claude 桌面版(macOS / Windows)
桌面版没有内置命令行,Skill 需通过 Claude Code CLI 安装。打开系统终端,先执行 npm install -g @anthropic-ai/claude-code,再运行上面的安装命令;完成后完全退出并重新打开 Claude。
Claude Code(终端 CLI)
直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面,再在对话中引用该 Skill(/ 斜杠菜单或直接描述用途)。
VS Code(含 GitHub Copilot)
打开终端面板:菜单「终端 → 新建终端」,或快捷键 Ctrl+`(macOS 为 ⌃+`)。在终端里运行上面的命令;装完后执行「重新加载窗口」(Ctrl+Shift+P → Reload Window),让 Copilot 等扩展识别新技能。
Cursor
底部「终端」面板(Ctrl+`)即是内置终端。粘贴运行上面的命令,完成后在命令面板执行「Reload Window」刷新,再开始对话。
Windsurf
底部「终端」面板运行命令;也可直接使用其内置 Agent 终端,在对话侧执行安装。
其他工具(ChatGPT、本地脚本等)
不支持本地终端的产品,可先在本机终端完成安装,再在对话中描述该 Skill 的能力让其调用;不同工具的命令格式请以其官方文档为准。
风险提示
本 Skill 涉及读取隐私 / 敏感信息(如密钥、环境变量、凭据)。安装前请确认其用途是否必要。
检测到隐私/敏感信息读取(预设模式 #4)
命中检测项
- privacy_collect
Aitishiku.com