MARVIN - 你的 AI 秘书

MARVIN = 管理日程、阅读各类重要通知

一位能够记住你所有对话、跟踪目标进度并帮助你保持井然有序的 AI 助手。就像拥有一位永不遗忘的私人秘书。

为什么选择 MARVIN？

MARVIN 基于 Claude Code 扩展了专为高效完成任务而设计的功能：

• 会话连续性：无论相隔多日，都能从上次中断的地方继续。每次对话都会基于之前的交流不断深化。
• 目标跟踪：设定工作和个人目标，MARVIN 会监控进展并适时提醒你向前推进。
• 工具集成：可连接 Google Workspace、Microsoft 365、Atlassian、Slack、Linear、Notion、Telegram 等多种平台。
• 可扩展性：根据你的工作流程添加自定义命令、代理和技能。只需简单的 Markdown 文件即可创建新功能。
• 思考伙伴：MARVIN 不会盲目附和，而是会质疑薄弱的想法、提出深入问题，并协助你理性决策。它绝非“唯命是从”的助手。

快速开始使用 Claude Code

1. 克隆本仓库：

   git clone https://github.com/SterlingChin/marvin-template.git
   cd marvin-template
   

2. 在 Claude Code 中打开：

   claude
   

3. 让 MARVIN 帮你完成设置：

   “帮我设置 MARVIN”

仅此而已。接下来，MARVIN 会引导你完成个人资料、目标设定、工作区位置以及可选集成等步骤。

使用 GitHub Copilot CLI 快速上手

想用 Copilot CLI 快速搭建 MARVIN 吗？操作如下：

前提条件

• 已安装并认证 GitHub Copilot CLI

快速设置

通过以下 Copilot 命令开始：

# 切换到你的项目目录
gh copilot suggest "克隆 MARVIN 模板仓库"

# 运行设置脚本
gh copilot suggest "运行 MARVIN 的设置脚本"

# 启动 MARVIN
gh copilot suggest "启动 MARVIN AI 助手"

.marvin/setup.sh 脚本将负责完整的安装流程：包括依赖项安装、工作区创建、个人资料设置以及 shell 别名配置。只需按照提示操作，即可轻松配置你的 AI 秘书。

如需进一步集成其他工具（例如 Google Workspace、Slack 等），可执行：

gh copilot suggest "配置 MARVIN 的集成"

你能获得什么

日常工作流

每天以 /start 开始简报：优先级、截止日期及目标进展。在一天中自然地与 MARVIN 互动，它会记住一切。结束时使用 /end 保存上下文，以便下次继续。

在会话之间，可以使用 /update 快速保存当前进度而不终止会话。而 /sync 则会将模板中的最新功能同步到你的工作区。

命令列表

命令	功能描述
/start	开启每日简报
/end	结束会话并保存所有内容
/update	快速保存当前进度
/report	生成每周总结
/commit	审核并提交 Git 更改
/status	检查集成状态及工作区健康状况
/sync	获取模板更新
/help	显示所有命令及集成信息

集成支持

MARVIN 可无缝对接你常用的工具：

集成	提供的功能
Google Workspace (.marvin/integrations/google-workspace/)	Gmail、日历、云端硬盘
Microsoft 365 (.marvin/integrations/ms365/)	Outlook、日历、OneDrive、Teams
Atlassian (.marvin/integrations/atlassian/)	Jira、Confluence
Slack (.marvin/integrations/slack/)	监控频道、发布消息
Linear (.marvin/integrations/linear/)	问题追踪
Notion (.marvin/integrations/notion/)	阅读页面、查询数据库
Telegram (.marvin/integrations/telegram/)	通过手机与 MARVIN 对话
Parallel Search (.marvin/integrations/parallel-search/)	网络搜索能力

每个集成模块都包含详细的设置说明。

技能与代理

MARVIN 使用 .claude/ 目录结构实现功能扩展：

• 命令（.claude/commands/）：用户通过斜杠命令触发的工作流程。
• 代理（.claude/agents/）：MARVIN 为特定任务临时创建的子代理。
• 技能（.claude/skills/）：Claude Code 根据上下文调用的可复用功能。

每种类型都提供了模板文件。只需说“为 X 创建一个技能”，MARVIN 就会自动生成相应文件。

工作原理

MARVIN 将你的工作区与模板分离：

~/marvin/                    你的工作区（存放个人数据）
├── CLAUDE.md               你的个人资料和偏好设置
├── state/                  你的目标和优先级
├── sessions/               你每日会话的日志
└── ...

~/marvin-template/          模板（用于获取更新）
├── .marvin/                设置脚本和集成模块
├── .claude/                命令和代理模板
└── ...

你的工作区保存所有个人数据，而模板则提供功能更新。只需在工作区中运行 /sync，即可拉取新功能，同时不会覆盖你的现有数据。

从旧版本迁移

如果你之前使用的是未进行工作区分割的 MARVIN 版本：

cd marvin-template
./.marvin/migrate.sh

该脚本会将你的个人资料、目标、会话记录、报告及自定义技能复制到新的工作区。旧安装中的任何内容都不会被删除。确认新工作区正常运行后，再清理旧版本即可。

如何贡献

MARVIN 欢迎你在以下三个方面贡献力量：

1. 集成：为新工具添加支持。请参考 .marvin/integrations/CLAUDE.md 了解模式和安全要求。
2. 命令、代理、技能：扩展 MARVIN 的功能。相关模板位于 .claude/commands/、.claude/agents/ 和 .claude/skills/ 目录下。
3. 修复 Bug：发现问题了吗？提交包含修复代码和测试用例的 PR 即可。

请先 Fork 仓库，创建分支并提交 PR。所有贡献都将经过审核。

关于我们

MARVIN 的名字来源于《银河系漫游指南》中的偏执型安卓机器人。

由 Sterling Chin 创建。

MARVIN 快速上手指南

MARVIN 是一款基于 Claude Code 的 AI 首席助理工具，具备会话记忆、目标追踪及多平台集成能力，旨在帮助用户高效管理工作流。

环境准备

在开始之前，请确保满足以下系统要求：

• 操作系统：Linux, macOS 或 Windows (WSL)
• 核心依赖：
  • Claude Code (必须安装并登录)
  • Git
• 可选依赖（若使用 GitHub Copilot CLI 模式）：
  • GitHub Copilot CLI (需完成认证 gh auth login)

注意：目前官方未提供中国镜像源，请确保网络环境可正常访问 GitHub 及 Claude 服务。

安装步骤

方式一：通过 Claude Code 安装（推荐）

这是最标准的安装方式，MARVIN 将引导你完成所有配置。

1. 克隆仓库

   git clone https://github.com/SterlingChin/marvin-template.git
   cd marvin-template
   

2. 启动 Claude Code

   claude
   

3. 初始化配置 在对话框中输入以下指令，MARVIN 会自动引导你设置个人资料、工作空间路径及可选集成：

   "Help me set up MARVIN"

方式二：通过 GitHub Copilot CLI 安装

如果你习惯使用 Copilot CLI，可使用以下命令快速部署：

# 1. 克隆模板仓库
gh copilot suggest "clone marvin template repository"

# 2. 运行安装脚本（自动处理依赖、创建工作空间及配置 Shell 别名）
gh copilot suggest "run setup script for marvin"

# 3. 启动助手
gh copilot suggest "start marvin AI assistant"

如需配置 Google Workspace、Slack 等额外集成，可继续执行：

gh copilot suggest "configure marvin integrations"

基本使用

安装完成后，你的个人数据将存储在独立的工作空间目录（默认为 ~/marvin），与模板代码分离。

日常 workflows

• 开始一天：输入 /start 获取今日简报（包含优先级、截止日期及目标进度）。
• 保存进度：工作中随时输入 /update 保存当前上下文，无需结束会话。
• 结束一天：输入 /end 结束会话并完整保存状态，以便下次接续。
• 同步更新：当模板有新功能时，在工作空间内输入 /sync 即可拉取更新而不覆盖个人数据。

常用命令速查

命令	功能描述
/start	开启每日简报
/end	结束会话并存档
/update	快速保存进度 checkpoint
/report	生成周报总结
/commit	审查并提交 Git 变更
/status	检查集成状态与工作空间健康度
/sync	从模板同步最新功能
/help	查看所有可用命令

扩展能力

你可以直接通过自然语言让 MARVIN 创建新的技能或代理。例如：

"create a skill for analyzing python logs"

MARVIN 会自动在 .claude/skills/ 目录下生成相应的配置文件，扩展其能力边界。