概述

LifeOS Plugin 是一个面向 AI 代理的通用技能与 MCP（Model Context Protocol）集成框架，专为 LifeOS 个人生产力操作系统设计。该系统由 Convex 驱动，提供 37 种工作流技能，涵盖项目管理、联系人管理、日程安排、语音笔记、健康追踪（Oura Ring）、财务管理、人生教练、人生方向规划等多个领域。

资料来源：README.md:1-6

核心定位

资料来源：README.md:1-10

环境要求

环境变量配置

在开始安装之前，需要准备以下环境变量。这些变量用于连接 LifeOS 的 Convex 后端服务。

必需的环境变量

# Convex 部署 URL
export LIFEOS_CONVEX_URL=https://your-app.convex.site

# LifeOS 用户 ID
export LIFEOS_USER_ID=your-user-id

# Convex API 密钥
export LIFEOS_API_KEY=your-api-key

配置说明

资料来源：README.md:1-6

Claude Code 安装

Claude Code 是 Anthropic 官方提供的命令行工具，支持通过插件机制扩展功能。

安装命令

claude plugin add github:starascendin/lifeos-plugin

安装后配置

1. 确保环境变量已正确设置
2. 重启 Claude Code 会话以加载插件
3. 验证安装：运行 /help 或任意 LifeOS skill（如 /daily-plan）

资料来源：README.md:26-29

OpenCode 安装

OpenCode 支持原生读取 .claude/skills/ 目录，需要将 skills 目录复制或符号链接到正确位置。

方式一：复制（推荐用于独立使用）

cp -r skills/ .claude/skills/lifeos/

方式二：符号链接（推荐用于开发或同步更新）

ln -s /path/to/lifeos-plugin/skills .claude/skills/lifeos

链接结构示意

graph LR
    A[lifeos-plugin<br/>skills/] -->|ln -s| B[.claude/skills/lifeos]
    B -->|引用| A

资料来源：README.md:33-42

MCP 服务器配置

lifeos-plugin 通过 MCP (Model Context Protocol) 协议提供服务。配置 MCP 服务器有三种方式：

方式一：MCP 配置文件（JSON）

在 AI 助手的 MCP 配置文件中添加以下内容：

{
  "mcpServers": {
    "lifeos": {
      "command": "npx",
      "args": [
        "@starascendin/lifeos-mcp@latest",
        "--url", "YOUR_CONVEX_URL",
        "--user-id", "YOUR_USER_ID",
        "--api-key", "YOUR_API_KEY"
      ]
    }
  }
}

方式二：环境变量（推荐）

将环境变量写入 shell 配置文件（如 ~/.bashrc、~/.zshrc 或 ~/.config/fish/config.fish）：

# ~/.zshrc 或 ~/.bashrc
export LIFEOS_CONVEX_URL=https://your-app.convex.site
export LIFEOS_USER_ID=your-user-id
export LIFEOS_API_KEY=your-api-key

然后重新加载配置：

source ~/.zshrc  # 或 source ~/.bashrc

方式三：项目级配置

在项目根目录创建 .env 文件（需确保 .gitignore 包含此文件）：

LIFEOS_CONVEX_URL=https://your-app.convex.site
LIFEOS_USER_ID=your-user-id
LIFEOS_API_KEY=your-api-key

资料来源：README.md:45-60

手动安装

对于不支持插件机制的 AI 助手，可以采用手动安装方式：

安装步骤

目录结构要求

your-agent/
├── skills/
│   ├── lifeos/           # 复制或链接自 lifeos-plugin
│   │   ├── daily-plan/
│   │   ├── weekly-plan/
│   │   ├── sprint-plan/
│   │   ├── ppv/
│   │   └── ... (共37个skills)
│   └── ...

插件更新

更新插件仓库

# 进入插件目录
cd /path/to/lifeos-plugin

# 拉取最新代码
git pull

更新 MCP 服务器

MCP 服务器默认使用 @latest 标签，会自动更新。如需固定版本：

{
  "mcpServers": {
    "lifeos": {
      "command": "npx",
      "args": [
        "@starascendin/[email protected]",  // 固定版本号
        "--url", "YOUR_CONVEX_URL",
        "--user-id", "YOUR_USER_ID",
        "--api-key", "YOUR_API_KEY"
      ]
    }
  }
}

资料来源：README.md:107-116

配置验证

安装完成后，可以通过以下方式验证配置是否正确：

验证 MCP 连接

在 AI 助手中运行以下命令之一：

预期输出

如果配置正确，应该能看到：

• 当前周期的任务列表
• 本周的每日计划
• 健康/财务/习惯等数据摘要

如果出现连接错误，请检查：

1. 环境变量是否正确设置
2. Convex URL 是否可访问
3. API Key 是否有效且未过期

故障排除

快速开始流程

graph TD
    A[准备 Convex 凭据] --> B[设置环境变量]
    B --> C{选择安装方式}
    C -->|Claude Code| D[运行 plugin add 命令]
    C -->|OpenCode| E[复制或链接 skills 目录]
    C -->|手动安装| F[复制 skills + 配置 MCP]
    D --> G[重启 AI 助手]
    E --> G
    F --> G
    G --> H[验证安装 - 运行任意 Skill]

按照上述流程完成配置后，即可使用全部 37 个 Universal Skills 和 126 个 MCP 工具。

概述

MCP 服务器是 LifeOS Plugin 的核心基础设施，它作为 AI Agent 与 LifeOS 后端服务之间的桥梁，通过标准化的协议实现双向通信。服务器采用 MCP 协议暴露 126 个工具（Tools）和 28 个提示（Prompts），使各类 AI 客户端（如 Claude Code、OpenCode 等）能够访问和操作 LifeOS 中的数据与工作流程。

资料来源：AGENTS.md

系统架构

整体架构图

graph TD
    subgraph "AI 客户端层"
        A["Claude Code / OpenCode"]
        B["其他 MCP 兼容客户端"]
    end
    
    subgraph "MCP 服务器层"
        C["@starascendin/lifeos-mcp"]
    end
    
    subgraph "LifeOS 后端"
        D["Convex 部署"]
        E["数据存储"]
        F["业务逻辑"]
    end
    
    A --> C
    B --> C
    C --> D
    D --> E
    D --> F
    
    G["环境变量配置"] -.-> C

组件说明

快速启动

安装命令

通过 Claude Code 安装插件：

claude plugin add github:starascendin/lifeos-plugin

资料来源：README.md:27

环境变量配置

配置三个必需的环境变量以启用 MCP 服务器认证：

export LIFEOS_CONVEX_URL=https://your-app.convex.site
export LIFEOS_USER_ID=your-user-id
export LIFEOS_API_KEY=your-api-key

资料来源：README.md:1-8

MCP 服务器配置文件

在项目根目录创建 .mcp.json 文件：

{
  "mcpServers": {
    "lifeos": {
      "command": "npx",
      "args": [
        "@starascendin/lifeos-mcp@latest",
        "--url", "YOUR_CONVEX_URL",
        "--user-id", "YOUR_USER_ID",
        "--api-key", "YOUR_API_KEY"
      ]
    }
  }
}

资料来源：README.md:52-65

MCP 工具生态

工具分类总览

MCP 服务器提供 126 个工具，分为以下主要类别：

资料来源：AGENTS.md

核心规划工具

MCP 服务器提供了强大的规划工具集，用于支持各类规划工作流：

#### 1. 规划上下文获取工具

get_planning_context 是最核心的上下文获取工具，支持丰富的筛选参数：

get_planning_context({
  date?: string,           // 指定日期
  weekStartDate?: string,  // 周起始日期
  include: {
    daily: boolean,        // 每日视图数据
    weekly: boolean,       // 每周视图数据
    currentCycle: boolean,  // 当前冲刺/周期数据
    backlog: boolean,      // 待办事项池
    habits: boolean,       // 习惯数据
    dailyFields: boolean,   // 每日字段配置
    calendar: boolean,      // 日历事件
    voiceMemos: boolean     // 语音备忘录
  }
})

资料来源：skills/daily-plan/SKILL.md

#### 2. 规划变更应用工具

apply_planning_patch 是用于执行变更的核心工具：

资料来源：skills/daily-plan/SKILL.md

健康数据集成工具

Oura Ring 健康数据的完整集成：

资料来源：skills/health-weekly/SKILL.md

PPV 生活设计工具

PPV（Purpose, Principles, Vision）是一套完整的人生设计系统：

资料来源：skills/ppv/SKILL.md

MCP 提示（Prompts）

除了 126 个工具外，MCP 服务器还暴露了 28 个提示，这些提示封装了完整的工作流逻辑：

每日工作流提示

资料来源：README.md:17-23

回顾与计划提示

资料来源：README.md:24-35

客户与项目管理提示

资料来源：README.md:36-46

工作流集成

技能与 MCP 工具的关系

Skills（技能）是对 MCP 工具的高级封装，每个 Skill 通常会组合使用多个 MCP 工具来完成复杂任务：

graph LR
    A["Skill 调用"] --> B["get_planning_context"]
    A --> C["业务逻辑处理"]
    A --> D["apply_planning_patch"]
    A --> E["其他数据工具"]
    
    B --> F["获取 LifeOS 数据"]
    D --> G["写入 LifeOS 数据"]
    E --> F
    E --> G

典型规划工作流

以 daily-plan 为例，展示 MCP 工具的典型使用模式：

sequenceDiagram
    participant S as Skill
    participant MCP as MCP Server
    participant LifeOS as Convex Backend
    
    S->>MCP: get_planning_context()
    MCP->>LifeOS: 查询规划上下文数据
    LifeOS-->>MCP: 返回每日/每周/周期/待办数据
    MCP-->>S: 完整上下文对象
    
    S->>S: 分析数据，构建日计划
    Note over S: 选取 Top 3<br/>安排任务调度<br/>调整周期分配
    
    S->>MCP: apply_planning_patch(mode="day")
    Note over MCP: create_issue<br/>schedule_issue<br/>set_top_priority<br/>save_daily_note
    MCP->>LifeOS: 执行变更操作
    LifeOS-->>MCP: 确认变更
    MCP-->>S: 返回变更结果

资料来源：skills/daily-plan/SKILL.md

图谱查询工具

MCP 服务器提供了强大的图谱查询功能，用于理解实体之间的关系：

资料来源：skills/ppv/SKILL.md

客户端集成

Claude Code 集成

Claude Code 通过插件机制直接集成 MCP 服务器：

# 安装插件（自动配置 MCP 服务器和技能）
claude plugin add github:starascendin/lifeos-plugin

安装后，Claude Code 自动获得：

• 37 个技能（Skills）
• 126 个 MCP 工具
• 28 个 MCP 提示

资料来源：README.md:27-30

OpenCode 集成

OpenCode 原生读取 .claude/skills/ 目录：

# 方式 A：复制技能目录
cp -r skills/ .claude/skills/lifeos/

# 方式 B：符号链接（推荐，便于更新）
ln -s /path/to/lifeos-plugin/skills .claude/skills/lifeos

资料来源：README.md:35-44

更新维护

插件更新

# 更新插件仓库
cd /path/to/lifeos-plugin && git pull

# MCP 服务器自动更新（使用 npx @latest）
# 或在 .mcp.json 中锁定版本

资料来源：AGENTS.md

总结

MCP 服务器架构是 LifeOS Plugin 的核心通信层，它通过 MCP 协议标准化的接口，将 LifeOS 的全部功能暴露给各类 AI 客户端。架构设计的关键特点包括：

1. 标准化协议：采用 MCP 协议，确保与多种 AI 客户端的兼容性
2. 丰富的工具集：126 个工具覆盖项目管理、健康数据、财务、习惯等全生活领域
3. 封装的工作流：28 个提示封装了完整的规划、回顾、管理流程
4. 灵活的认证：基于环境变量的 API Key + User ID 认证机制
5. 图谱能力：支持实体间关系的图谱查询，便于理解复杂关联

概述

日常管理工作流是 LifeOS Plugin 为个人生产力管理提供的核心技能集合，涵盖从每日晨会到日终复盘的完整工作周期。这些工作流通过 MCP（Model Context Protocol）工具与 Convex 后端交互，实现任务的查看、创建、更新和调度操作。四个核心技能共同构成了一个闭环的每日生产力管理系统，帮助用户高效规划一天、跟踪进度并在一天结束时进行总结反思。

核心技能架构

LifeOS Plugin 的日常管理工作流包含四个相互关联的技能，每个技能针对工作日的不同阶段：

资料来源：README.md:14-25

技能调用流程图

graph TD
    A[开始新的一天] --> B[daily-standup<br/>晨间简报]
    B --> C{查看任务和进度}
    C --> D[daily-plan<br/>今日规划]
    D --> E{捕获临时想法}
    E --> F[capture<br/>快速捕获]
    F --> G[执行工作]
    G --> H[end-of-day<br/>日终复盘]
    H --> I[结束一天<br/>进入明日循环]

晨间简报（daily-standup）

功能说明

daily-standup 技能提供每日的站立会议式简报，帮助用户快速了解当天的任务概览和迭代进度。该技能通过调用 LifeOS MCP 工具收集当日议程、任务列表、逾期任务和当前迭代周期信息，并以结构化格式呈现。

资料来源：skills/daily-standup/SKILL.md:1-7

使用的 MCP 工具

资料来源：skills/daily-standup/SKILL.md:8-11

输出格式

晨间简报的输出包含以下五个核心部分：

1. Today's Focus — 今日重点关注的 3 项事务
2. Tasks Due — 今日截止的任务列表，含优先级标记
3. Overdue — 需要立即处理的逾期任务
4. Sprint Progress — 迭代完成百分比和关键统计
5. Calendar — 今日会议或事件安排

该技能支持通过 $ARGUMENTS 参数指定特定日期，默认为当天日期。

今日规划（daily-plan）

功能说明

daily-plan 是日常管理工作流中的核心变异技能，用于在获取规划上下文后对 LifeOS 进行实际的变更操作。这是一个完全自动化的变异工作流，执行后不会请求用户确认。

资料来源：skills/daily-plan/SKILL.md:1-5

工作流程

graph TD
    A[调用 get_planning_context] --> B[收集规划上下文]
    B --> C[构建今日计划]
    C --> D{创建/调度/分配任务}
    C --> E{设置优先级}
    C --> F{更新周期目标}
    C --> G{保存每日笔记}
    D --> H[apply_planning_patch<br/>dryRun=false]
    E --> H
    F --> H
    G --> H
    H --> I[报告变更结果]

规划上下文参数

调用 get_planning_context 时使用的参数配置：

资料来源：skills/daily-plan/SKILL.md:8-18

支持的变异操作

通过 apply_planning_patch 的 mode="day" 可以执行以下操作：

资料来源：skills/daily-plan/SKILL.md:24-35

规划原则

规划今日工作时需要遵循以下原则：

• 从规划上下文中选取今日最重要的 3 项事务
• 通过设置 dueDate 来安排任务的执行时间
• 将相关的待办工作拉入当前活跃迭代周期
• 如果计划改变了迭代焦点，需同步更新当前迭代目标
• 根据今日日历和当前迭代的工作负载保持计划现实可行

资料来源：skills/daily-plan/SKILL.md:13-21

日终复盘（end-of-day）

功能说明

end-of-day 技能用于日终收尾，包含今日完成情况汇总和明日规划。这是一个变异工作流，会对 LifeOS 进行实际的记录和更新操作。

资料来源：README.md:18-19

核心功能

1. 完成情况汇总 — 总结当日完成的任务和未完成的工作
2. 明日计划准备 — 为第二天的工作做好初步规划
3. 更新迭代状态 — 记录迭代进度和任何变更

快速捕获（capture）

功能说明

capture 技能提供了一种快速记录想法、任务或笔记的方式，并具备自动路由到适当位置的能力。这对于在执行工作过程中快速捕获灵感或临时任务特别有用。

资料来源：README.md:21-22

自动路由机制

捕获的内容会根据类型自动路由到不同的目的地：

使用场景

• 在专注工作时突然出现的想法
• 会议中快速记录的要点
• 客户沟通时的新需求或反馈
• 任何需要稍后处理但不应打断当前流程的信息

集成与配置

MCP 服务器配置

日常管理工作流依赖于 LifeOS MCP 服务器的正常运行。配置方式有两种：

方式一：MCP 服务器配置（JSON）

{
  "mcpServers": {
    "lifeos": {
      "command": "npx",
      "args": [
        "@starascendin/lifeos-mcp@latest",
        "--url", "YOUR_CONVEX_URL",
        "--user-id", "YOUR_USER_ID",
        "--api-key", "YOUR_API_KEY"
      ]
    }
  }
}

资料来源：README.md:52-63

方式二：环境变量配置

export LIFEOS_CONVEX_URL=https://your-app.convex.site
export LIFEOS_USER_ID=your-user-id
export LIFEOS_API_KEY=your-api-key

资料来源：README.md:37-40

Claude Code 集成

claude plugin add github:starascendin/lifeos-plugin

OpenCode 集成

OpenCode 原生读取 .claude/skills/ 目录，复制或符号链接 skills 目录：

# 复制方式
cp -r skills/ .claude/skills/lifeos/

# 符号链接方式
ln -s /path/to/lifeos-plugin/skills .claude/skills/lifeos

资料来源：README.md:43-50

与其他工作流的协同

日常管理工作流并非孤立存在，它们与 LifeOS Plugin 提供的其他工作流形成完整的生产力管理系统：

graph LR
    subgraph 日常管理
        A[daily-standup] --> B[daily-plan]
        B --> C[end-of-day]
        C --> D[capture]
    end
    
    subgraph 规划类工作流
        E[weekly-plan] --> A
        C --> F[sprint-plan]
    end
    
    subgraph 周期性回顾
        A --> G[weekly-review]
        C --> H[monthly-review]
        H --> I[cycle-review]
    end
    
    subgraph 专业领域
        A --> J[health-weekly]
        A --> K[daily-training-report]
        D --> L[voice-notes]
    end

规划类工作流的关联

sprint-plan 技能提供了迭代周期的规划能力，与 daily-plan 的 include.currentCycle 参数紧密相关。两者共享 get_planning_context 和 apply_planning_patch 工具。

资料来源：skills/sprint-plan/SKILL.md:1-20

健康与习惯追踪的关联

daily-standup 可以结合 daily-training-report 提供更全面的晨间简报：

资料来源：skills/daily-training-report/SKILL.md:1-25

最佳实践

晨间简报使用建议

1. 每天工作开始时首先运行 daily-standup
2. 根据逾期任务的数量决定是否需要立即处理
3. 将 sprint 进度作为当日工作节奏的参考
4. 使用 $ARGUMENTS 指定特定日期查看历史记录

今日规划执行策略

1. 规划前先完成晨间简报获取完整上下文
2. 遵循"一次只做一件事"原则设置 Top 3 优先级
3. 将模糊的想法通过 capture 记录后再继续规划
4. 规划变更后及时更新迭代目标保持一致性
5. 使用 save_daily_note 生成可读的日计划存档

日终复盘建议

1. 记录完成的任务和实际花费的时间
2. 识别未完成任务的原因（阻塞、估计偏差、优先级变更）
3. 为次日准备 1-3 个明确的优先任务
4. 积累数据为周期性回顾提供依据

相关资源

• 完整技能列表: README.md
• MCP 工具参考: AGENTS.md
• 迭代规划: sprint-plan 技能
• 周度规划: weekly-plan 技能
• 语音笔记: voice-notes 技能
• 健康追踪: health-weekly 技能

概述

复盘与规划工作流是 LifeOS Plugin 中用于周期性回顾过去、规划未来的核心功能集合。这些工作流涵盖了从每日微观规划到年度宏观审视的完整时间跨度，帮助用户系统性地审视已完成工作、评估当前状态，并制定下一步行动计划。

这些工作流分为两大类别：复盘类工作流侧重于回顾和分析已完成的工作，而规划类工作流则专注于创建变更并应用到 LifeOS 系统中。两者相互配合，形成完整的"回顾-反思-计划-执行"闭环。

资料来源：README.md:15-30

架构总览

复盘与规划工作流遵循统一的设计模式，每个工作流都通过 LifeOS MCP 工具与 Convex 后端进行交互：

graph TD
    A[用户触发工作流] --> B[获取上下文数据]
    B --> C[分析评估]
    C --> D{工作流类型}
    D -->|复盘类| E[展示分析结果]
    D -->|规划类| F[执行变更操作]
    E --> G[生成报告]
    F --> H[应用变更到LifeOS]
    H --> G
    G --> I[更新Daily Note/Weekly Note]

核心设计原则

复盘类工作流

周期循环复盘

#### 每日回顾 (Daily Review)

每日回顾嵌入在 daily-plan 工作流中，通过获取今日待办任务、日历和习惯数据来进行快速审视。

#### 周期回顾 (Cycle Review)

周期回顾用于审视当前冲刺/周期的完成情况，支持延期项的处理：

graph TD
    A[获取当前Cycle数据] --> B[计算完成率]
    B --> C{完成率达标?}
    C -->|是| D[庆祝成就]
    C -->|否| E[分析延期原因]
    E --> F{是否滚动到下周期?}
    F -->|是| G[执行延期操作]
    F -->|否| H[标记为风险项]
    G --> I[更新Cycle数据]
    H --> J[记录风险]

执行操作：

• 延期项自动滚动到下一个周期
• 未完成项标记为风险项
• 更新周期元数据

资料来源：skills/cycle-review/SKILL.md:1-15

#### 周回顾 (Weekly Review)

周回顾是最高频的复盘工作流，系统性地审视一周内的工作成果：

资料来源：skills/weekly-review/SKILL.md:1-12

#### 月回顾 (Monthly Review)

月回顾提供更宏观的视角，整合多周数据形成月度洞察：

• 成就总结：本月重大胜利和完成的工作
• 项目进展：各活跃项目的状态
• Sprint表现：跨周期的平均完成率
• 客户健康度：各客户关系状态
• 主题模式：笔记和完成工作的模式识别
• 结转项：滚转到下月的工作
• 反思：什么有效、什么无效
• 下月重点：下月前三优先级

资料来源：skills/monthly-review/SKILL.md:1-25

#### 年度倡议回顾 (Initiative Review)

年度层面的审视，按类别查看目标进展：

graph LR
    A[年度倡议] --> B[按类别分组]
    B --> C[各倡议进度]
    C --> D[偏差分析]
    D --> E[调整建议]

资料来源：skills/initiative-review/SKILL.md:1-8

专项复盘

#### 健康周检视 (Health Weekly)

每周健康数据综合回顾，整合 Oura Ring 的多维度数据：

资料来源：skills/health-weekly/SKILL.md:1-20

#### 客户成功分类 (Customer Success Triage)

客户请求的三级分类体系：

资料来源：skills/customer-success-triage/SKILL.md:1-25

规划类工作流

周期规划工作流

规划类工作流是会变更 LifeOS 状态的变异工作流，执行后直接修改系统数据，不询问确认。

graph TD
    A[调用 get_planning_context] --> B[构建计划]
    B --> C{验证计划可行性}
    C -->|可行| D[调用 apply_planning_patch]
    C -->|不可行| E[调整计划]
    E --> C
    D --> F[执行变更]
    F --> G[报告结果]

资料来源：skills/sprint-plan/SKILL.md:1-20

#### 日计划 (Daily Plan)

日计划工作流的核心操作：

资料来源：skills/daily-plan/SKILL.md:1-30

#### 周计划 (Weekly Plan)

周计划在日计划基础上扩展到整周视角：

周计划关键决策点：

1. 更新周期目标：当周期焦点需要调整时
2. 分配待办项：将选定的待办任务纳入当前周期
3. 跨周调度：使用 dueDate 安排一周的工作
4. 设置近优先级：确定近期的首要任务
5. 保持可执行性：确保今日计划足够具体可执行

资料来源：skills/weekly-plan/SKILL.md:1-35

#### Sprint计划 (Sprint Plan)

Sprint计划专注于当前周期层面的规划：

• 更新周期目标（当焦点需要改变时）
• 将适当的待办工作拉入当前周期
• 使用 dueDate 安排近期工作
• 设置首要任务的最高优先级
• 避免当前周期过载

资料来源：skills/sprint-plan/SKILL.md:1-25

规划上下文数据模型

get_planning_context 获取的完整上下文结构：

{
  "include": {
    "daily": true,
    "weekly": true,
    "currentCycle": true,
    "backlog": true,
    "habits": true,
    "dailyFields": true,
    "calendar": true,
    "voiceMemos": true
  }
}

复盘与规划的协同关系

复盘和规划工作流形成闭环，两者数据互通：

graph LR
    A[周回顾] --> B[识别模式和风险]
    B --> C[周计划]
    C --> D[执行]
    D --> E[日计划/日执行]
    E --> F{周期结束}
    F --> G[周期回顾]
    G --> H[延期决策]
    H --> I[Sprint计划]
    I --> D
    I --> C

数据流向

MCP 工具清单

复盘与规划工作流依赖的核心 MCP 工具：

资料来源：AGENTS.md:50-80

最佳实践

执行顺序建议

1. 高频周期先执行：日计划 → 周计划 → Sprint计划
2. 复盘为规划提供输入：先回顾再规划
3. 专项复盘按需触发：健康周检视、客户分类等
4. 自动执行避免中断：规划类工作流设计为自动执行

数据一致性维护

• 规划变更后检查 Daily Note 是否同步更新
• 周期结束时执行周期回顾，避免延期项丢失
• 月度回顾时验证所有周期数据的完整性

异常处理

与其他模块的集成

复盘与规划工作流并非孤立存在，它与其他 LifeOS 模块紧密集成：

graph TD
    A[复盘与规划] --> B[PPV人生设计]
    A --> C[教练模块]
    A --> D[语音备忘录]
    A --> E[健康追踪]
    B --> F[Vision更新触发规划调整]
    C --> G[教练行动项纳入Sprint]
    D --> H[语音洞察转化为任务]
    E --> I[健康数据影响容量评估]

• PPV人生设计：愿景变更可能触发周期目标调整
• 教练模块：教练行动项可纳入 Sprint 计划
• 语音备忘录：语音洞察通过结晶化流程转化为具体任务
• 健康追踪：健康数据影响个人容量评估和计划可行性

资料来源：skills/ppv/SKILL.md:1-30, skills/voice-notes/SKILL.md:1-20, skills/daily-training-report/SKILL.md:1-15

概述

项目与客户管理是 LifeOS Plugin 提供的核心功能模块，涵盖从项目状态追踪、冲刺规划到客户关系维护的完整工作流程。该模块通过 MCP（Model Context Protocol）工具与 Convex 后端交互，支持 37 种工作技能，涵盖项目看板、阶段分解、任务统计、阻塞项识别等能力。

资料来源：README.md:1-37

核心技能体系

技能矩阵

资料来源：README.md:42-56

项目状态管理

project-status 技能

project-status 技能用于深入分析单个项目的健康状况，通过 MCP 工具获取项目的多维度数据。

工作流程：

graph TD
    A[输入项目名称] --> B[get_project_workspace]
    B --> C[收集项目数据]
    C --> D[分析阶段进度]
    C --> E[统计任务状态]
    C --> F[识别阻塞项]
    D --> G[生成项目状态报告]
    E --> G
    F --> G

输出内容：

• 阶段分解：项目各阶段的完成情况
• 任务统计：任务总数、进行中、已完成、阻塞数量
• 阻塞项识别：明确指出阻碍项目推进的问题
• 风险预警：进度滞后或资源不足的警示

资料来源：README.md:48

客户管理

client-brief 技能

client-brief 技能提供特定客户的完整视图，帮助快速了解与客户的全部互动情况。

数据结构：

graph TD
    A[client-brief 技能] --> B[项目列表]
    A --> C[最近沟通记录]
    A --> D[待办任务]
    A --> E[备注历史]
    A --> F[健康指标]

使用方式：

/client-brief "Acme Corp"

核心数据源：

资料来源：README.md:49

client-health 技能

client-health 技能提供跨所有客户的健康仪表盘，便于管理者快速掌握整体客户状况。

功能特点：

• 实时汇总所有客户的健康指标
• 识别需要关注的客户
• 追踪客户互动频率
• 预警潜在的客户流失风险

资料来源：README.md:50

冲刺规划

sprint-plan 技能

sprint-plan 技能是变异型工作流，用于规划当前冲刺周期并直接应用变更到 LifeOS。

执行步骤：

1. 调用 get_planning_context，包含以下参数：

• include.currentCycle=true
• include.backlog=true
• include.weekly=true
• include.daily=true

1. 构建冲刺计划：

• 更新冲刺目标（当焦点需要调整时）
• 从待办事项中拉取合适的工作到当前冲刺
• 使用 dueDate 安排近期工作
• 设置最高优先级
• 避免冲刺过载

1. 调用 apply_planning_patch，参数：

• mode="cycle"
• dryRun=false

可用操作：

执行后报告内容：

• 当前冲刺目标与容量
• 分配、创建或安排的任务
• 最高优先级列表
• 任何风险或过载警告

资料来源：skills/sprint-plan/SKILL.md:1-45

客户成功分类

customer-success-triage 技能

customer-success-triage 技能用于系统性地分类处理客户请求和客户成功工作。

工作流程：

graph TD
    A[输入客户名称] --> B[get_client_success_workspace]
    B --> C[审查工作区数据]
    C --> D[recentThreads]
    C --> E[recentMeetings]
    C --> F[notes]
    C --> G[openTasks]
    C --> H[projects]
    D --> I[需要时深入]
    E --> I
    F --> I
    G --> I
    I --> J[分类发现]
    J --> K[生成分类报告]

分类类别：

MCP 工具调用顺序：

1. get_client_success_workspace — 获取客户工作区
2. get_beeper_thread_messages — 聊天详情
3. get_fathom_meeting / get_fathom_transcript — Fathom 会议详情
4. get_granola_meeting / get_granola_transcript — Granola 会议详情
5. get_client_notes — 已有笔记历史

写入操作策略：

• 使用 create_client_note 或 update_client_note 保存持久性账户记忆
• 仅对执行工作使用 create_issue 或 update_issue
• 优先更新现有笔记/任务，避免创建重复项
• 不删除任何内容

资料来源：skills/customer-success-triage/SKILL.md:1-50

收件箱分类

inbox-triage 技能

inbox-triage 技能将捕获的笔记处理为可执行任务、标签和链接。

执行流程：

graph TD
    A[获取最近笔记] --> B[获取可用项目]
    A --> C[获取联系人]
    B --> D[分析每条笔记]
    C --> D
    D --> E{分析结果}
    E -->|动作项| F[转换为任务]
    E -->|提及人员| G[链接到人员]
    E -->|关联项目| H[分配到项目]
    E -->|需要分类| I[添加标签]
    F --> J[显示分类列表]
    G --> J
    H --> J
    I --> J
    J --> K{用户确认}
    K -->|是| L[执行变更]
    K -->|否| M[调整建议]

MCP 工具调用：

1. get_recent_notes — 获取最近 20 条未处理捕获
2. get_projects — 了解可用项目用于分配
3. get_people — 了解联系人用于链接

分类建议类型：

自动模式：

当 $ARGUMENTS 包含 "auto" 时，自动使用最佳猜测执行处理，无需询问确认。

资料来源：skills/inbox-triage/SKILL.md:1-45

逾期追踪

overdue 技能

overdue 技能用于识别和追踪所有逾期及即将逾期的项目。

功能：

• 列出所有逾期任务
• 识别滑向逾期的项目
• 提供优先级建议
• 生成逾期报告

资料来源：README.md:56

数据流向

完整工作流架构

graph LR
    subgraph 输入层
        A[用户请求] --> B[MCP 工具调用]
    end
    
    subgraph 处理层
        B --> C[get_planning_context]
        B --> D[get_client_workspace]
        B --> E[get_project_workspace]
        B --> F[get_recent_notes]
    end
    
    subgraph 分析层
        C --> G[数据聚合]
        D --> G
        E --> G
        F --> G
    end
    
    subgraph 变异层
        G --> H[apply_planning_patch]
        H --> I[create_issue]
        H --> J[update_issue]
        H --> K[assign_issue_to_current_cycle]
        H --> L[create_client_note]
    end
    
    subgraph 输出层
        I --> M[LifeOS 更新]
        J --> M
        K --> M
        L --> M
        G --> N[报告生成]
    end

MCP 工具清单

项目与客户管理相关的核心 MCP 工具：

最佳实践

客户管理

1. 定期客户简报：使用 client-brief 定期了解客户全景
2. 健康监控：通过 client-health 追踪客户整体状况
3. 主动分类：使用 customer-success-triage 及时处理客户请求

项目执行

1. 冲刺对齐：确保项目任务与当前冲刺目标一致
2. 避免过载：设置合理的冲刺容量
3. 优先级管理：使用 set_top_priority 明确即时焦点

任务处理

1. 及时收件箱清空：使用 inbox-triage 将想法转化为行动
2. 逾期追踪：定期检查 overdue 任务
3. 避免重复：优先更新现有任务而非创建新任务

配置要求

MCP 服务器配置

{
  "mcpServers": {
    "lifeos": {
      "command": "npx",
      "args": [
        "@starascendin/lifeos-mcp@latest",
        "--url", "YOUR_CONVEX_URL",
        "--user-id", "YOUR_USER_ID",
        "--api-key", "YOUR_API_KEY"
      ]
    }
  }
}

环境变量

资料来源：README.md:25-45

概述

语音笔记工作流是 LifeOS Plugin 中用于探索、分析和保存语音备忘录的综合功能模块。该工作流通过 MCP（Model Context Protocol）工具与 LifeOS 后端交互，支持用户以对话方式回顾、整理和提炼语音记录中的洞察。

语音笔记工作流的核心价值在于将分散的语音记录转化为可执行的知识资产，通过 AI 驱动的分析帮助用户发现语音笔记中的模式、关联和行动项。

概述

健康数据集成是 LifeOS Plugin 提供的核心功能模块之一，通过 MCP（Model Context Protocol）工具与 Oura Ring 智能戒指设备进行深度集成。该模块能够采集用户的睡眠、活动、准备度、压力、心率等多项生理指标，并将其与任务管理、日程规划和习惯追踪等生产力功能无缝结合。

LifeOS Plugin 提供了 126 个 MCP 工具，其中健康数据相关的工具覆盖了 Oura Ring 的完整数据维度：睡眠（sleep）、活动（activity）、准备度（readiness）、压力（stress）、血氧（SpO2）、心率（heart rate）以及锻炼记录（workouts）。资料来源：AGENTS.md

数据架构

┌─────────────────────────────────────────────────────────────┐
│                     Oura Ring 设备                          │
└─────────────────────────┬───────────────────────────────────┘
                          │ 生理数据同步
                          ▼
┌─────────────────────────────────────────────────────────────┐
│                     Convex 后端平台                          │
│  ┌─────────┐ ┌──────────┐ ┌──────────┐ ┌─────────────────┐  │
│  │  睡眠   │ │   活动   │ │  准备度  │ │   心率/压力    │  │
│  │ Sleep   │ │ Activity │ │ Readiness│ │ HR/Stress/SpO2 │  │
│  └────┬────┘ └────┬─────┘ └────┬─────┘ └────────┬────────┘  │
│       └──────────┴────────────┴───────────────┘            │
│                          │                                  │
└──────────────────────────┼──────────────────────────────────┘
                           │ MCP 工具调用
                           ▼
┌─────────────────────────────────────────────────────────────┐
│              LifeOS Plugin Skills 层                         │
│  ┌──────────────┐ ┌──────────────┐ ┌──────────────────────┐  │
│  │ health-check│ │health-weekly │ │daily-training-report │  │
│  └──────────────┘ └──────────────┘ └──────────────────────┘  │
└─────────────────────────────────────────────────────────────┘

核心 MCP 工具清单

健康数据获取工具

资料来源：skills/health-weekly/SKILL.md

主要技能模块

1. 快速健康检查 (health-check)

快速健康检查模块提供即时的健康数据概览，适合日常快速了解身体状态。

数据采集范围：

• 7 天睡眠数据：分数、总睡眠时长趋势、入睡时间一致性、平均呼吸率
• 7 天活动数据：活动分数、每日步数、活动卡路里
• 7 天准备度数据：准备度分数、趋势方向（改善/下降/稳定）
• 7 天心率数据：静息心率趋势、HRV 数据
• 7 天恢复力数据：当前恢复力级别及趋势
• 7 天 VO2max 和心血管年龄数据

输出格式：

- 整体状态：快速评估（优秀/良好/需要关注）
- 睡眠：平均分数、总睡眠时长趋势、入睡时间一致性...
- 活动：平均分数、每日步数、活动卡路里
- 准备度：平均分数、趋势方向
- 心率：静息 HR 趋势、HRV
- 恢复力：当前级别和趋势
- 健身：VO2max 趋势、心血管年龄与实际年龄对比
- 洞察：2-3 条基于数据的可操作建议

资料来源：skills/health-check/SKILL.md:1-37

参数说明：

2. 每周健康回顾 (health-weekly)

每周健康回顾模块提供更全面的健康数据分析，适用于周末复盘和趋势识别。

数据采集范围：

所有数据默认采集 14 天记录，以获得更准确的趋势分析。

输出结构：

• 睡眠质量：周平均分数、最佳/最差夜晚、睡眠时长趋势、深睡/REM 平衡、入睡时间一致性、平均呼吸率
• 活动模式：周步数平均、主动日与休息日对比、卡路里燃烧
• 准备度与恢复：分数趋势、压力与恢复平衡、体温趋势
• 恢复力：日级别趋势（限于 exceptional 级别）、贡献因素分解
• 健身指标：VO2max 趋势（ml/kg/min）、心血管年龄趋势、周对比变化
• 锻炼记录：锻炼类型、时长、强度

资料来源：skills/health-weekly/SKILL.md:1-50

3. 每日训练报告 (daily-training-report)

每日训练报告将健康数据与习惯追踪、任务管理和教练反馈整合，提供全面的个人训练日报。

数据采集清单：

1. 昨日习惯：get_habits_for_date（昨日日期）
2. 今日习惯：get_habits_for_date（今日日期）
3. 所有习惯：get_habits（连续记录概览）
4. 睡眠：get_health_sleep（days=1）
5. 准备度：get_health_readiness（days=1）
6. 活动：get_health_activity（days=1）
7. 今日日程：get_daily_agenda
8. 今日任务：get_todays_tasks
9. 年度目标：get_initiatives
10. 教练待办：get_coaching_action_items

报告输出结构：

**昨日成果**
- 习惯记分卡：X/Y 完成（列出每项习惯及状态）
- 连续记录保持或中断（明确指出中断的连续记录）
- 健康数据：睡眠分数、准备度分数、活动分数
- 日评分：基于习惯完成率和健康数据

**今日计划**
- Top 3 优先级（来自日程和置顶任务）
- 今日习惯安排（含连续计数）
- 健康建议

资料来源：skills/daily-training-report/SKILL.md:1-40

数据流向图

graph LR
    A[Oura Ring] -->|实时同步| B[Convex 后端]
    B -->|数据存储| C[健康数据表]
    C -->|MCP 工具| D[health-check]
    C -->|MCP 工具| E[health-weekly]
    C -->|MCP 工具| F[daily-training-report]
    D -->|输出| G[快速概览]
    E -->|输出| H[详细周报]
    F -->|输出| I[训练日报]
    G -->|整合| J[用户决策]
    H -->|整合| J
    I -->|整合| J

健康指标参考表

使用场景

场景一：晨间快速检视

用户在早晨启动工作前，希望快速了解昨夜睡眠质量和今日身体准备状态。

调用：/health-check
默认回溯：7 天
输出：简洁的健康仪表板，包含关键指标和洞察

场景二：周末健康复盘

用户在周末进行深度健康回顾，分析两周内的趋势变化。

调用：/health-weekly
回溯天数：14 天
输出：详细的周健康报告，包含趋势分析和改进建议

场景三：训练日报整合

运动员或健身爱好者将健康数据与当日任务、习惯追踪整合。

调用：/daily-training-report
整合数据：睡眠、准备度、活动 + 习惯 + 日程 + 教练反馈
输出：全面的个人训练日报

配置要求

健康数据集成需要以下环境配置：

资料来源：README.md

与其他模块的集成

健康数据不仅是独立的健康监测功能，还与 LifeOS 的其他核心功能深度集成：

graph TD
    A[健康数据 Oura] --> B[习惯系统]
    A --> C[任务系统]
    A --> D[教练系统]
    A --> E[日程系统]
    A --> F[PPV 人生设计]
    B --> G[每日训练报告]
    C --> G
    D --> G
    E --> G

集成点说明

最佳实践

1. 定期回顾：建议每周运行一次 /health-weekly，识别健康趋势
2. 数据驱动决策：根据准备度分数调整高强度任务的安排
3. 习惯关联：将健康指标与习惯系统结合，形成完整的自我管理系统
4. 教练整合：将健康数据洞察转化为可执行的教练行动项
5. 连续记录监控：关注连续记录状态，避免因中断影响长期数据准确性

技术限制

• 健康数据回溯天数受 MCP 工具参数限制，默认最大为 14 天
• VO2max 和心血管年龄为估算值，仅供参考
• 恢复力数据级别显示限于 exceptional 级别
• 锻炼记录优先使用 label 而非 activity 字段作为显示名称

概述

财务管理（Financial Management）是LifeOS插件的核心功能模块之一，为用户提供全面的个人财务可视化和分析能力。该模块通过与Convex后端集成，实时获取用户的财务数据，包括净资产概览、账户余额、交易记录和支出模式分析。

财务管理模块的核心价值在于将分散的财务数据聚合为可操作的洞察，帮助用户了解财务状况、追踪消费习惯、监控净资产趋势。

资料来源：README.md

技能清单

资料来源：README.md, AGENTS.md

架构设计

数据流架构

graph TD
    A[用户请求] --> B[Skill 技能层]
    B --> C{技能类型}
    C -->|概览| D[finance-overview]
    C -->|支出| E[finance-spending]
    D --> F[get_finance_net_worth]
    D --> G[get_finance_accounts]
    D --> H[get_finance_snapshots]
    E --> I[get_finance_daily_spending]
    E --> J[get_finance_transactions]
    F --> K[Convex 后端]
    G --> K
    H --> K
    I --> K
    J --> K
    K --> L[数据聚合处理]
    L --> M[美元转换]
    M --> N[可视化报告]

MCP工具集成

财务管理的底层由126个MCP工具支撑，其中专门用于财务数据访问的工具包括：

资料来源：AGENTS.md

finance-overview 技能详解

功能描述

finance-overview 技能提供完整的财务概览视图，整合净资产、资产配置和负债信息，以仪表盘形式呈现给用户。

核心流程

1. 调用 get_finance_net_worth 获取当前净资产及账户分类
2. 调用 get_finance_accounts 获取所有账户详细信息
3. 调用 get_finance_snapshots 获取90天净值历史趋势
4. 聚合数据并转换为美元格式
5. 生成可视化财务仪表盘

资料来源：skills/finance-overview/SKILL.md

输出内容

数据转换规则

所有从后端获取的金额数据均以美分为单位存储，技能层负责将其转换为美元格式并以货币形式展示。

# 伪代码示例
amount_in_cents = 12345
amount_in_dollars = amount_in_cents / 100
formatted = f"${amount_in_dollars:,.2f}"  # $123.45

资料来源：skills/finance-overview/SKILL.md

可选参数

finance-spending 技能详解

功能描述

finance-spending 技能专注于消费行为分析，帮助用户识别消费模式、高消费日和异常支出。

核心流程

1. 调用 get_finance_daily_spending 获取最近30天的每日收入/支出聚合数据
2. 调用 get_finance_transactions 获取最近50笔交易详情
3. 分析消费模式并识别规律
4. 生成支出分析报告

资料来源：skills/finance-spending/SKILL.md

输出内容

可选参数

MCP 工具详细规格

get_finance_net_worth

获取用户的净资产数据，包括资产和负债的分类汇总。

调用方式：

{
  "name": "get_finance_net_worth",
  "arguments": {}
}

返回值结构：

{
  "totalNetWorth": 123456789,
  "totalAssets": 150000000,
  "totalLiabilities": 26543211,
  "breakdown": {
    "assets": [...],
    "liabilities": [...]
  }
}

注意：所有金额以美分为单位存储

get_finance_accounts

获取用户所有关联的金融账户信息。

调用方式：

{
  "name": "get_finance_accounts",
  "arguments": {}
}

返回值结构：

{
  "accounts": [
    {
      "id": "acc_xxx",
      "name": "主要支票账户",
      "type": "checking",
      "balance": 500000
    }
  ]
}

get_finance_snapshots

获取指定时间范围内的净资产历史快照，用于趋势分析。

调用方式：

{
  "name": "get_finance_snapshots",
  "arguments": {
    "days": 90
  }
}

get_finance_daily_spending

获取每日支出聚合数据，用于消费模式分析。

调用方式：

{
  "name": "get_finance_daily_spending",
  "arguments": {
    "days": 30
  }
}

get_finance_transactions

获取最近的交易记录明细。

调用方式：

{
  "name": "get_finance_transactions",
  "arguments": {
    "limit": 50
  }
}

资料来源：AGENTS.md

使用示例

场景一：查看财务概览

用户输入: /finance-overview

执行流程：

sequenceDiagram
    participant U as 用户
    participant S as Skill
    participant M as MCP Server
    participant C as Convex
    
    U->>S: /finance-overview
    S->>M: get_finance_net_worth
    M->>C: 查询净资产
    C-->>M: 返回数据
    M-->>S: net_worth 数据
    S->>M: get_finance_accounts
    M->>C: 查询账户
    C-->>M: 账户列表
    M-->>S: accounts 数据
    S->>M: get_finance_snapshots
    M->>C: 查询90天快照
    C-->>M: 快照历史
    M-->>S: snapshots 数据
    S->>S: 数据聚合处理
    S->>S: 美分→美元转换
    S-->>U: 财务仪表盘

场景二：分析90天消费趋势

用户输入: /finance-spending 90

此命令将分析过去90天的支出数据，而非默认的30天。

场景三：与其他技能联动

财务管理可与 daily-training-report 技能联动，在每日训练报告中包含财务健康检查：

graph LR
    A[daily-training-report] --> B[财务快照]
    B --> C{财务状态}
    C -->|正常| D[纳入报告]
    C -->|异常| E[预警提示]

资料来源：skills/daily-training-report/SKILL.md

数据存储规范

单位约定

转换函数

def cents_to_dollars(cents: int) -> float:
    """美分支转换为美元"""
    return cents / 100

def format_currency(cents: int) -> str:
    """格式化为货币字符串"""
    return f"${cents_to_dollars(cents):,.2f}"

最佳实践

1. 定期查看财务概览

建议用户每周运行一次 finance-overview 技能，以监控净资产变化趋势。

2. 支出模式识别

利用 finance-spending 的消费模式分析功能，识别非必要的开支。

3. 参数优化

• 需要快速概览时使用默认参数
• 需要深度分析时可传入更长的时间范围（如90天或180天）

4. 数据整合

财务数据可与习惯追踪、健康数据整合，形成全面的个人生产力报告。

扩展能力

财务管理模块未来可能支持：

• 预算设置与追踪
• 账单提醒
• 投资组合分析
• 税务优化建议
• 多币种支持

概述

人际关系管理是 LifeOS Plugin 中的核心功能模块，通过 MCP 工具与 LifeOS 系统集成，提供联系人查询、会议准备、后续跟进、关系健康监测以及快速上下文切换等能力。该模块旨在帮助用户维护和深化与客户、合作伙伴及团队成员的关系，同时确保重要互动不会被遗漏。

人际关系管理功能覆盖了从初次联系到持续维护的完整关系生命周期，支持通过 AI 洞察分析沟通风格和关系状态。资料来源：README.md

核心技能体系

技能概览

资料来源：AGENTS.md

架构流程图

graph TD
    A[用户请求] --> B{请求类型}
    B -->|联系人查询| C[contact-lookup]
    B -->|会议准备| D[meeting-prep]
    B -->|跟进追踪| E[follow-ups]
    B -->|关系健康| F[relationship-pulse]
    B -->|上下文切换| G[context-switch]
    
    C --> H[get_contact_dossier]
    D --> I[get_planning_context]
    E --> J[数据聚合]
    F --> K[关系分析]
    G --> L[快速加载]
    
    H --> M[展示联系人档案]
    I --> N[展示会议上下文]
    J --> O[待跟进列表]
    K --> P[关系状态报告]
    L --> Q[上下文摘要]

联系人档案查询

功能说明

contact-lookup 技能提供完整的联系人档案查询能力，支持通过姓名进行模糊搜索，返回联系人的全面信息包括个人资料、AI 生成的性格洞察、沟通风格建议以及历史互动记录。

资料来源：skills/contact-lookup/SKILL.md

工作流程

graph LR
    A[输入: 联系人姓名] --> B[get_contact_dossier]
    B --> C[返回档案数据]
    C --> D{数据结构}
    D -->|人员信息| E[Profile 档案]
    D -->|AI洞察| F[AI Insights]
    D -->|消息| G[Beeper Threads]
    D -->|会议| H[Granola Meetings]
    D -->|语音| I[Voice Memos]
    E --> J[格式化展示]
    F --> J
    G --> J
    H --> J
    I --> J

档案展示结构

使用要求

• 参数：$ARGUMENTS 必须包含联系人姓名
• 工具调用：get_contact_dossier with nameQuery
• 无姓名时系统会提示用户输入

会议准备

功能说明

meeting-prep 技能帮助用户在进行会议前全面了解与会者的背景信息，聚合相关项目进展、历史沟通、开放任务等上下文，支持用户带着充分的准备进入会议。

资料来源：skills/meeting-prep/SKILL.md

准备内容

MCP 工具依赖

graph TD
    A[meeting-prep] --> B[get_contact_dossier]
    A --> C[get_client_success_workspace]
    A --> D[get_beeper_thread_messages]
    A --> E[get_granola_meeting]
    A --> F[get_fathom_meeting]
    A --> G[get_client_notes]
    
    B --> H[基本信息]
    C --> I[项目与任务]
    D --> J[聊天记录]
    E --> K[会议记录]
    F --> L[Fathom 录制]
    G --> M[历史笔记]

跟进追踪

功能说明

follow-ups 技能主动识别需要与用户进行后续互动的联系人，确保重要关系不会被忽视。该功能会扫描系统中的互动记录和任务状态，生成需要跟进的人员清单。

资料来源：skills/follow-ups/SKILL.md

追踪范围

关系健康监测

功能说明

relationship-pulse 技能通过分析互动频率、响应时间和关系紧密度等指标，识别可能被用户忽视的关系，帮助用户主动维护重要的人际网络。

资料来源：skills/relationship-pulse/SKILL.md

健康指标

快速上下文切换

功能说明

context-switch 技能支持用户在不同客户或项目之间快速切换，加载目标对象的相关信息，减少上下文切换带来的认知负担，提升多任务处理效率。

资料来源：skills/context-switch/SKILL.md

上下文内容

使用场景

graph TD
    A[当前上下文] --> B[调用 context-switch]
    B --> C[输入: 客户/项目名称]
    C --> D[加载目标上下文]
    D --> E[展示快速摘要]
    E --> F[开始新工作]
    
    G[定期切换] --> H[保持全局视野]
    G --> I[避免信息孤岛]

MCP 工具集

联系人相关工具

数据模型

erDiagram
    CONTACT ||--o{ INTERACTION : has
    CONTACT ||--o{ PROJECT : related_to
    CONTACT {
        string id PK
        string name
        string relationshipType
        string email
        string phone
        string notes
        json aiInsights
    }
    INTERACTION {
        string id PK
        string contactId FK
        string type "message|meeting|voice"
        datetime timestamp
        string summary
    }

最佳实践

1. 定期关系维护

• 每周运行一次 relationship-pulse 检查被忽视的关系
• 使用 follow-ups 作为每周回顾的一部分
• 为重要联系人设置定期跟进提醒

2. 会议准备流程

• 会议前使用 meeting-prep 获取完整上下文
• 查看对方的 AI 洞察了解沟通偏好
• 回顾历史互动记录避免重复话题

3. 上下文管理

• 在多项目环境中频繁使用 context-switch
• 切换后快速确认上下文正确性
• 完成项目后主动切换回全局视图

4. 联系人数据维护

• 通过 contact-lookup 定期审查联系人档案
• 更新过时信息保持数据准确性
• 利用 AI Insights 改善沟通方式

配置与集成

MCP 服务配置

{
  "mcpServers": {
    "lifeos": {
      "command": "npx",
      "args": [
        "@starascendin/lifeos-mcp@latest",
        "--url", "YOUR_CONVEX_URL",
        "--user-id", "YOUR_USER_ID",
        "--api-key", "YOUR_API_KEY"
      ]
    }
  }
}

环境变量配置

资料来源：README.md

相关技能索引

总结

人际关系管理模块构成了 LifeOS Plugin 中维护人际网络的完整解决方案。通过 contact-lookup、meeting-prep、follow-ups、relationship-pulse 和 context-switch 五个核心技能的协同工作，用户可以实现从联系人信息管理到关系健康监测的全面覆盖。该模块深度集成了 Beeper 消息、Granola 会议、Fathom 录制和语音备忘录等多个数据源，结合 AI 生成的洞察分析，帮助用户建立更有效的人际沟通策略。

Pitfall Log / 踩坑日志

项目：starascendin/lifeos-plugin

摘要：发现 8 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：配置坑 - 可能修改宿主 AI 配置。

1. 配置坑 · 可能修改宿主 AI 配置

• 严重度：medium
• 证据强度：source_linked
• 发现：项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。
• 对用户的影响：安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。
• 建议检查：列出会写入的配置文件、目录和卸载/回滚步骤。
• 防护动作：涉及宿主配置目录时必须给回滚路径，不能只给安装命令。
• 证据：capability.host_targets | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | host_targets=mcp_host, claude, claude_code

2. 能力坑 · 能力判断依赖假设

• 严重度：medium
• 证据强度：source_linked
• 发现：README/documentation is current enough for a first validation pass.
• 对用户的影响：假设不成立时，用户拿不到承诺的能力。
• 建议检查：将假设转成下游验证清单。
• 防护动作：假设必须转成验证项；没有验证结果前不能写成事实。
• 证据：capability.assumptions | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | README/documentation is current enough for a first validation pass.

3. 维护坑 · 维护活跃度未知

• 严重度：medium
• 证据强度：source_linked
• 发现：未记录 last_activity_observed。
• 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。
• 建议检查：补 GitHub 最近 commit、release、issue/PR 响应信号。
• 防护动作：维护活跃度未知时，推荐强度不能标为高信任。
• 证据：evidence.maintainer_signals | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | last_activity_observed missing

4. 安全/权限坑 · 下游验证发现风险项

• 严重度：medium
• 证据强度：source_linked
• 发现：no_demo
• 对用户的影响：下游已经要求复核，不能在页面中弱化。
• 建议检查：进入安全/权限治理复核队列。
• 防护动作：下游风险存在时必须保持 review/recommendation 降级。
• 证据：downstream_validation.risk_items | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | no_demo; severity=medium

5. 安全/权限坑 · 存在安全注意事项

• 严重度：medium
• 证据强度：source_linked
• 发现：No sandbox install has been executed yet; downstream must verify before user use.
• 对用户的影响：用户安装前需要知道权限边界和敏感操作。
• 建议检查：转成明确权限清单和安全审查提示。
• 防护动作：安全注意事项必须面向用户前置展示。
• 证据：risks.safety_notes | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | No sandbox install has been executed yet; downstream must verify before user use.

6. 安全/权限坑 · 存在评分风险

• 严重度：medium
• 证据强度：source_linked
• 发现：no_demo
• 对用户的影响：风险会影响是否适合普通用户安装。
• 建议检查：把风险写入边界卡，并确认是否需要人工复核。
• 防护动作：评分风险必须进入边界卡，不能只作为内部分数。
• 证据：risks.scoring_risks | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | no_demo; severity=medium

7. 维护坑 · issue/PR 响应质量未知

• 严重度：low
• 证据强度：source_linked
• 发现：issue_or_pr_quality=unknown。
• 对用户的影响：用户无法判断遇到问题后是否有人维护。
• 建议检查：抽样最近 issue/PR，判断是否长期无人处理。
• 防护动作：issue/PR 响应未知时，必须提示维护风险。
• 证据：evidence.maintainer_signals | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | issue_or_pr_quality=unknown

8. 维护坑 · 发布节奏不明确

• 严重度：low
• 证据强度：source_linked
• 发现：release_recency=unknown。
• 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。
• 建议检查：确认最近 release/tag 和 README 安装命令是否一致。
• 防护动作：发布节奏未知或过期时，安装说明必须标注可能漂移。
• 证据：evidence.maintainer_signals | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | release_recency=unknown