MARVIN快速上手教程：5步搭建你的AI参谋长，零基础也能完成

MARVIN 是一款基于 Claude Code 构建的开源 AI 参谋长（AI Chief of Staff） 模板，它能记住你的每段对话、追踪工作与生活目标、连接邮件与日历等常用应用，并主动提醒你的待办事项。本教程将通过 5 个步骤，带你零基础完成 MARVIN 的搭建与日常使用。

为什么选择 MARVIN？🎯

相比普通聊天机器人，MARVIN 的核心优势在于持续记忆 + 主动管理：

• 会话连续性：隔天再聊，它依然记得上次聊到哪
• 目标追踪：设定工作与个人目标，MARVIN 会监督进度并推动你前进
• 工具集成：连接 Google Workspace、Microsoft 365、Slack、Jira、Notion 等
• 可进化：用简单的 Markdown 文件就能添加命令、智能体和技能
• 思维伙伴：它不是"应声虫"，会质疑薄弱的想法、帮你做决策

想深入了解设计理念，可以阅读 README.md 和 CLAUDE.md。

第1步：一键安装 MARVIN 模板

前置条件（只需准备两项）：

• 已安装 Claude Code（终端里的 AI 编程助手）
• 已安装 git

打开终端，执行以下命令下载模板：

git clone https://gitcode.com/gh_mirrors/mar/marvin-template
cd marvin-template

下载完成后，目录里已经包含了 state/goals.md、state/current.md 等状态文件，以及 .claude/commands/start.md 等内置命令——这些就是 MARVIN 的"骨架"。

💡 如果你习惯用 GitHub Copilot CLI，也可以直接运行 gh copilot suggest "run setup script for marvin"，.marvin/setup.sh 脚本会自动完成环境检查、工作区创建和 Shell 快捷别名配置。

第2步：启动 Claude Code，让 MARVIN 自动引导设置

进入模板目录后，输入一条命令启动：

claude

然后对它说："Help me set up MARVIN"（帮我设置 MARVIN）。

接下来大约 10 分钟，MARVIN 会按照 .marvin/onboarding.md 中的引导流程，像向导一样一步步问你：

1. 👤 你的名字、职位和所在公司
2. 🎯 你的工作目标（KPI、项目）和个人目标（健身、写作等）
3. 💬 你喜欢的沟通风格（专业 / 轻松 / 冷幽默）
4. 📁 把个人工作区放在哪里（推荐桌面或文档目录）

全程只需回答问题和点击"Accept"授权，MARVIN 会自动帮你创建 ~/marvin 个人工作区、写入个人资料，并设置终端快捷命令 marvin，以后在任何目录输入它就能秒开。

第3步：认识你的个人工作区 📁

MARVIN 采用"模板与工作区分离"的设计，你的数据和模板互不干扰：

~/marvin/              你的工作区（所有数据都在这里）
├── CLAUDE.md          你的个人资料和偏好
├── state/             目标与优先级
│   ├── current.md     当前重点、未完成的线头
│   └── goals.md       工作目标 + 个人目标
├── sessions/          每日会话记录
└── reports/           周报存放处

~/marvin-template/     模板目录（用于获取更新，保留勿删）

关键文件	作用
state/current.md	当前优先级与开放任务，每次 /end 自动更新
state/goals.md	目标清单，支持按月份追踪进度
sessions/	按日期命名的会话日志，实现跨天记忆

✅ 放心：模板更新永远不会覆盖你的个人数据，随时可以通过 /sync 安全拉取新功能。

第4步：掌握日常四步曲 ⏰

搭建完成后，与 MARVIN 合作一天的节奏只有四个斜杠命令：

时机	命令	效果
早上开工	/start	生成今日简报：优先级、日程、目标进度
工作间隙	/update	快速存档，切换任务前保住进度
下班收工	/end	总结当天内容，持久化到会话日志
每周一	/report	自动生成上周工作总结

举个例子，早上输入 /start，MARVIN 会先读取 state/current.md、state/goals.md 和最近三天的会话记录，然后输出一份结构化简报：PRIORITIES（今日重点）→ CALENDAR（日程）→ GOALS（目标进度）。如果状态文件超过 3 天没更新，它还会主动提醒你刷新。

白天则完全自然对话即可——让它记任务、查日程、写周报，它都会自动记住上下文。想查看所有命令，输入 /help 就行。

第5步：连接日常工具，持续扩展 🔌

MARVIN 开箱即用的能力有限，但扩展方式简单得惊人：直接用自然语言告诉它。

连接应用——只需说"Help me connect to Jira"（帮我连接 Jira），它会自动配置集成并引导你完成认证：

集成	能做什么
Google Workspace	Gmail、日历、Drive
Microsoft 365	Outlook、日历、OneDrive、Teams
Atlassian	Jira 工单、Confluence 文档
Slack	频道消息监控与发布
Notion / Linear	页面查询、项目追踪
Telegram	手机上直接和 MARVIN 对话

各集成的详细说明都在 .marvin/integrations/ 目录中。

自定义能力——MARVIN 支持三种扩展方式，全部用 Markdown 文件定义：

• Commands（.claude/commands/）：斜杠触发的固定工作流
• Agents（.claude/agents/）：可委派的专家子代理，如 research-agent 负责深度调研
• Skills（.claude/skills/）：根据对话上下文自动激活的能力

最快的方式是直接说"Give yourself the ability to X"（给自己添加 X 能力），它会帮你生成对应的文件。完整的扩展指南见 docs/extending.md。

进阶玩家不妨看看 docs/patterns/README.md，里面有内容流水线、会议处理、多源调研、移动端接入等 7 个来自实战的架构模式。

常见问题速查 💬

Q：忘记保存进度怎么办？ A：输入 /update 即可快速存档；长会话中建议每隔一段时间执行一次。

Q：模板更新了我的新功能，怎么同步？ A：在工作区运行 /sync，只拉取新增能力，不覆盖你的个人数据。

Q：MARVIN 为什么有时"反驳"我？ A：这是它的"思维伙伴"设定——主动质疑薄弱想法、帮你压测决策。如果想让它只执行不提问，直接告诉它即可。

总结 🏁

回顾一下 5 步搭建流程：克隆模板 → 一句话引导式设置 → 认识工作区 → 掌握 /start 四步曲 → 连接工具持续扩展。整个过程零基础也能完成，而你得到的不仅是一个 AI 聊天窗口，而是一位永不遗忘、主动提醒、还会帮你思考的 AI 参谋长。现在就去输入 claude，开始你的第一步吧！