onboarding

COG 入门引导技能

目的

欢迎新用户，并收集必要信息，以便为用户定制 COG 体验。所有配置都以自然的 Markdown 文件形式存储在 vault 结构中，遵循 COG 透明、可编辑知识的理念。

何时调用

• 用户明确请求 /onboarding，或提到“入门引导”或“设置 COG”
• 用户是新用户，尚未完成入门引导
• 用户希望更新个人资料或添加新项目
• 任何需要定制个人资料的情况

核心设计原则：智能、轻松的入门引导

入门引导必须像自然对话，而不是需要填写的表单。

关键规则：

• 提出开放式问题，而不是选项题。 绝不提供带编号的选项列表让用户选择。
• 尽可能少提问。 从上下文和用户的自然回复中推断能推断的信息。
• 绝不重复提问。 如果可以从用户已说过的话中提取答案，就不要再次询问。
• 智能解析。 如果有人说“我是 Alex，是一家金融科技初创公司的 PM，正在关注 Stripe 和 Plaid”，就提取：姓名=Alex，职位=金融科技初创公司的 PM，关注名单=[Stripe, Plaid]。不要追问用户已经提供的信息。
• 确认，而非重新询问。 如果不确定用户所说的内容，就确认自己的理解，而不是重新提出问题。

流程

1. 欢迎消息

热情地问候用户，并介绍 COG：

Welcome to COG - your self-evolving second brain powered by Claude + Obsidian + Git!

COG helps you capture thoughts, get daily intelligence briefings, and build knowledge over time - all stored as simple markdown files you own.

Let's get you set up. Tell me a bit about yourself - your name, what you do, and what topics or areas you're most interested in staying sharp on. Feel free to share as much or as little as you'd like.

这一个开放式提示取代了原先依次提出的问题。 用户可以自然地一次性提及自己的姓名、职位、兴趣、信息来源、项目和竞争对手，也可以只分享其中几项。

2. 检查是否已有个人资料

查找 00-inbox/MY-PROFILE.md。如果文件存在：

I found an existing COG profile! What would you like to update? Just tell me what you'd like to change - your interests, projects, profile info, or anything else.

不要提供带编号的菜单。 让用户用自然语言描述他们的需求。

3. 智能提取信息

用户回复后，尽可能从其自然语言中提取信息：

字段	提取方式
姓名	查找自我介绍的表达（“我是 Alex”“我的名字是……”“叫我……”）。默认使用名字。
职位	查找工作或活动相关的描述（“我是 PM”“我在……工作”“在……担任软件工程师”）。
兴趣	查找提及主题的内容（“对 AI 感兴趣”“关注加密货币”“喜欢设计”）。也可根据职位背景进行推断。
新闻来源	查找提及信息来源的内容（“我会看 HN”“在 Twitter 上关注”）。如果未提及，则跳过——此项可选。
项目	查找提及项目的内容（“正在开发 SaaS 应用”“正在构建……”）。如果未提及，则跳过。
竞争动态关注	查找提及公司或个人的内容（“正在关注 Stripe”“留意 OpenAI 的动向”）。如果未提及，则跳过。

4. 智能追问（仅在需要时）

提取能提取的信息后，只检查必填字段中缺失的内容：

• 姓名（必填）
• 职位（必填）
• 兴趣（必填——至少需要 2-3 个主题）

如果缺少任何必填字段，只提出一个追问，涵盖所有缺失信息。例如：

Thanks! I got your name and role. What topics are you most interested in staying updated on? (e.g., AI, startups, design, health - whatever matters to you)

可选字段（新闻来源、项目、竞争动态关注）绝不能引发追问。如果用户没有提及，就跳过。用户之后随时可以通过编辑文件或再次运行入门引导来添加这些内容。

5. 确认并创建

创建文件前，简要确认已收集的信息，并询问是否启用 Agent 团队模式：

Here's what I've got:

- **Name**: Alex
- **Role**: Product Manager at a fintech startup
- **Interests**: AI/ML, fintech trends, product strategy, UX design
- **Projects**: Payments dashboard revamp
- **Tracking**: Stripe, Plaid

One more thing - COG can run in two modes:
- **Solo mode** (default): I handle everything directly in our conversation.
- **Agent team mode**: I delegate research, analysis, and writing to specialist sub-agents for deeper, more thorough results. Works best with Claude Code.

Which do you prefer? (Solo is great for most people - team mode is for power users who want maximum depth.)

等待用户确认后，再生成所有内容。如果用户说“看起来不错”或类似的话，就继续操作。如果用户更正了信息，更新后直接继续，无需再次确认。如果用户没有表达偏好，则默认使用 solo。

5.5. 角色包匹配

提取第 3 步中的用户角色文本后，扫描 .claude/roles/*.md，查找匹配的角色包：

1. 读取每个角色包文件的 YAML frontmatter（role_id 和 aliases）
2. 将提取的用户角色文本（不区分大小写）与以下内容进行比较：
   • 完全匹配 role_id（例如，“product-manager”）
   • aliases 中的任意字符串（例如，“pm”、“product lead”、“head of product”）
   • 模糊子字符串匹配（例如，“product manager at a fintech startup”包含“product manager”）
3. 如果找到匹配项：
   • 将匹配的 role_id 作为 role_pack 存入 MY-PROFILE.md frontmatter
   • 提供针对该角色的建议：

   As a [Role Display Name], here are the skills and integrations that'll be most useful for you:
   
   **Recommended skills** (ordered by relevance for your role):
   [List top 5-6 skills from the role pack with the "Why it matters for you" context]
   
   **Recommended integrations**:
   [List integrations from the role pack with role-specific explanations]
   

   • 默认使用角色包建议的 agent_mode（而非 solo）
4. 如果没有找到匹配项：
   • 在 MY-PROFILE.md 中设置 role_pack: custom
   • 仅推荐核心技能（即 roles: [all] 的技能）
   • 询问常用集成：“你使用 GitHub、Slack 或其他希望 COG 连接的工具吗？”

5.6. 集成发现

角色包匹配后，设置用户的集成偏好：

1. 如果匹配到了角色包，结合角色背景展示其推荐的集成：

   Based on your role, these integrations would give COG the most context:
   
   [For each integration in role pack:]
   - **[Integration]** — [Why it matters for you, from role pack]
   
   Which of these do you already use? And are there any other tools you'd like to connect?
   

2. 解析用户的回答：

   • 用户确认使用的服务 → 添加到 MY-INTEGRATIONS.md 的 启用 部分
   • 用户未提及或表示不使用的服务 → 添加到 停用 部分
   • 用户提及的其他服务 → 添加到 启用 部分
   • 除非用户明确要求，否则始终将 ElevenLabs 添加到 停用 部分

3. 生成 00-inbox/MY-INTEGRATIONS.md：

   ---
   type: integrations
   created: YYYY-MM-DD
   tags: ["#integrations", "#config", "#cog"]
   ---
   
   # My Integrations
   
   *COG checks this file before using any external service. Edit anytime.*
   
   ## Active
   [For each confirmed integration:]
   - **[Service]**: [Brief description of how COG uses it]
   
   ## Disabled
   [For each declined/unmentioned integration:]
   - **[Service]**: Skipped during onboarding. Enable anytime by moving to Active section.
   
   ---
   
   *Move services between Active and Disabled sections to control what COG connects to.*
   

4. 如果没有匹配到角色包，以对话方式询问常用集成：

   COG can connect with tools like GitHub, Slack, Linear, Notion, and PostHog for richer analysis. Do you use any of these? (Totally optional - COG works great without them too.)
   

6. 生成个人资料文档

使用 references/profile-templates.md 中的模板创建四份个人资料文档。

00-inbox/MY-PROFILE.md

00-inbox/MY-INTERESTS.md

03-professional/COMPETITIVE-WATCHLIST.md（仅当用户提及要跟踪的公司或人员时）

每个项目：04-projects/[project-slug]/PROJECT-OVERVIEW.md

7. 创建目录结构

根据配置创建个性化结构：

基础结构（始终创建）：

00-inbox/
01-daily/
  briefs/
  checkins/
02-personal/
  braindumps/
  development/
  wellness/
03-professional/
  braindumps/
  leadership/
  strategy/
  skills/
04-projects/
05-knowledge/
  consolidated/
  patterns/
  timeline/
  booklets/
06-templates/

项目专属结构（为每个列出的项目创建）：

04-projects/[project-slug]/
  PROJECT-OVERVIEW.md
  braindumps/
  competitive/
  content/
  planning/
  resources/

8. 创建欢迎指南

生成：00-inbox/WELCOME-TO-COG.md

根据 references/welcome-guide.md 中的模板生成。

9. 收尾（不提供菜单！）

设置完成后，总结创建的内容，并建议一个自然的下一步操作：

You're all set! I've created your profile, interests, and project files. Everything is in your vault and editable anytime.

If you want to jump right in, try a braindump - just tell me what's on your mind and I'll capture it. Or ask for your daily brief to see what's happening in your interest areas today.

不要提供编号的后续操作菜单。 只需建议一两件自然而然可以做的事，由用户自行决定。

配置更新模式

如果用户在初始设置后再次运行引导流程（MY-PROFILE.md 已存在）：

不要显示菜单。只需询问：

You've already completed onboarding! What would you like to update? Just tell me what needs changing.

然后灵活处理用户的回复，无论是添加项目、更改兴趣、更新角色等。

成功标准

满足以下条件时，引导流程即为成功：

1. 在 00-inbox/ 中创建了 MY-PROFILE.md，且 frontmatter 中包含 role_pack
2. 在 00-inbox/ 中创建了 MY-INTERESTS.md
3. 在 00-inbox/ 中创建了包含启用／停用部分的 MY-INTEGRATIONS.md
4. 匹配了角色包（或将其设为 custom），并提供了相应建议
5. 创建了项目目录和概览（如适用）
6. 创建了 WELCOME-TO-COG.md 指南，且技能顺序适用于对应角色
7. 用户了解后续步骤以及个人资料的存储位置

错误处理

如果个人资料已存在：

• 不要覆盖，改为提供更新模式
• 保留现有内容，仅追加或修改用户要求的部分
• 如果从头开始，将旧版本归档到 00-inbox/archive/MY-PROFILE-YYYY-MM-DD.md

如果创建目录失败：

• 报告无法创建的目录
• 提供手动创建说明
• 继续完成其余设置

如果用户在引导过程中途退出：

• 创建部分个人资料并注明：“引导流程未完成 - 运行引导技能以完成设置”
• 保存目前已收集的内容
• 下次运行时从最后完成的步骤继续

隐私与数据

所有配置数据均以 Markdown 文件的形式存储在：

• 00-inbox/MY-PROFILE.md - 包含角色包的基本资料
• 00-inbox/MY-INTERESTS.md - 兴趣领域
• 00-inbox/MY-INTEGRATIONS.md - 已启用/已禁用的外部服务集成
• 03-professional/COMPETITIVE-WATCHLIST.md - 竞争跟踪
• 04-projects/[project]/PROJECT-OVERVIEW.md - 项目详情

以 Markdown 格式存储的优势：

• 易于阅读和编辑
• 使用 Git 进行版本控制
• 可在 Obsidian 中搜索
• 可从其他笔记链接
• 无需解析，直接作为文本读取即可
• 可像其他笔记一样归档、移动和整理

理念

COG 的配置是知识，而非配置。将偏好存储为 Markdown 笔记：

• 它们属于你的知识库，而不是隐藏的配置文件
• 你可以链接、引用并不断完善它们
• 它们包含上下文，也可以加入你自己的笔记
• 它们透明且可审计
• 它们可以利用 Obsidian 的所有功能（标签、链接、搜索、关系图谱视图）

这就是“将配置视为知识”——你的偏好本身就是第二大脑中的笔记。