# https://github.com/starascendin/lifeos-plugin 项目说明书

生成时间：2026-05-16 08:40:49 UTC

## 目录

- [项目介绍](#page-introduction)
- [安装与配置](#page-installation)
- [MCP 服务器架构](#page-mcp-server)
- [日常管理工作流](#page-daily-workflows)
- [复盘与规划工作流](#page-review-workflows)
- [项目与客户管理](#page-project-management)
- [语音笔记工作流](#page-voice-notes-workflows)
- [健康数据集成 (Oura Ring)](#page-health-integration)
- [财务管理](#page-finance-management)
- [人际关系管理](#page-people-relationships)

<a id='page-introduction'></a>

## 项目介绍

### 相关页面

相关主题：[安装与配置](#page-installation), [MCP 服务器架构](#page-mcp-server)

<details>
<summary>相关源码文件</summary>

以下源码文件用于生成本页说明：

- [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)
- [AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)
- [skills/daily-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)
- [skills/weekly-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/weekly-plan/SKILL.md)
- [skills/sprint-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/sprint-plan/SKILL.md)
- [skills/ppv/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/ppv/SKILL.md)
- [skills/health-weekly/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-weekly/SKILL.md)
</details>

# 项目介绍

## 概述

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

资料来源：[README.md:1-6]()

### 核心定位

| 维度 | 说明 |
|------|------|
| **目标用户** | 使用 AI 代理（如 Claude Code、OpenCode）的个人用户 |
| **技术基础** | Convex 后端 + MCP 协议 |
| **技能数量** | 37 种工作流技能 + 126 个 MCP 工具 + 28 个 MCP 提示词 |
| **数据整合** | 项目、任务、周期、阶段、联系人、会议、健康、财务、习惯等 |

资料来源：[README.md:1-10]()

---

## 系统架构

### 技术栈概览

```mermaid
graph TD
    subgraph "AI 代理层"
        A[Claude Code]
        B[OpenCode]
    end
    
    subgraph "插件层"
        C[LifeOS Plugin Skills]
        D[MCP Server]
    end
    
    subgraph "后端服务层"
        E[Convex Backend]
        F[External APIs<br/>Oura Ring, Fathom, Granola, etc.]
    end
    
    A --> C
    B --> C
    A --> D
    B --> D
    C --> E
    D --> E
    E --> F
    
    style A fill:#e1f5fe
    style B fill:#e1f5fe
    style E fill:#c8e6c9
```

### 技能调用方式

LifeOS Plugin 支持两种调用方式：

1. **Skill 技能调用**：通过 `/skill-name` 命令直接调用
2. **MCP 协议调用**：通过 MCP 客户端调用对应工具或提示词

资料来源：[README.md:56-70]()

---

## 技能体系

### 日常管理工作流

| 技能名称 | 命令 | 功能描述 |
|----------|------|----------|
| daily-standup | `/daily-standup` | 晨间简报，包含日程、任务和冲刺进度 |
| daily-plan | `/daily-plan` | 规划今日工作，设置截止日期、优先级、周期分配和每日笔记 |
| end-of-day | `/end-of-day` | 日终总结，完成情况汇总和明日规划 |
| capture | `/capture "想法"` | 快速捕获想法、任务或笔记，自动路由 |

资料来源：[README.md:38-45]()

**daily-plan 工作流程**：

```mermaid
graph TD
    A[调用 get_planning_context] --> B[构建今日计划]
    B --> C[选择 Top 3 任务]
    C --> D[设置截止日期]
    D --> E[分配周期任务]
    E --> F[应用规划补丁<br/>apply_planning_patch]
    F --> G[报告结果]
    
    style A fill:#fff3e0
    style F fill:#c8e6c9
```

资料来源：[skills/daily-plan/SKILL.md:1-25]()

### 回顾与规划技能

| 技能名称 | 命令 | 功能描述 |
|----------|------|----------|
| weekly-review | `/weekly-review` | 回顾本周完成的工作、进行中的项目和冲刺健康度 |
| weekly-plan | `/weekly-plan` | 规划本周工作，设置当前周期、截止日期、优先级 |
| monthly-review | `/monthly-review` | 月度回顾，成就、项目进展和下月规划 |
| cycle-review | `/cycle-review` | 冲刺回顾，包含延期处理选项 |
| initiative-review | `/initiative-review 2026` | 年度目标按类别回顾 |
| sprint-plan | `/sprint-plan` | 规划当前冲刺，设置周期目标、任务分配、优先级 |

资料来源：[README.md:46-58]()

**sprint-plan 工作流程**：

```mermaid
graph TD
    A[获取规划上下文] --> B[更新周期目标]
    B --> C[从待办中拉取任务]
    C --> D[设置截止日期和优先级]
    D --> E[应用规划补丁<br/>mode=cycle] --> F[报告结果]
    
    style E fill:#c8e6c9
```

资料来源：[skills/sprint-plan/SKILL.md:1-30]()

### 项目与客户管理

| 技能名称 | 命令 | 功能描述 |
|----------|------|----------|
| project-status | `/project-status ACME` | 按阶段分解项目，统计任务和阻塞项 |
| client-brief | `/client-brief "Acme Corp"` | 完整客户简报，包含项目和问题 |
| client-health | `/client-health` | 所有客户健康度仪表盘 |
| customer-success-triage | `/customer-success-triage "Acme Corp"` | 分拣客户请求，审查聊天、会议、笔记和任务 |

资料来源：[README.md:59-64]()

**customer-success-triage 工作流程**：

```mermaid
graph TD
    A[调用 get_client_success_workspace] --> B[审查工作区]
    B --> C{需要深入了解?}
    C -->|聊天| D[获取 Beeper 消息]
    C -->|会议| E[获取 Fathom/Granola 详情]
    C -->|笔记| F[获取客户笔记历史]
    C -->|无需| G[分类整理发现]
    D --> G
    E --> G
    F --> G
    G --> H[分类结果]
    
    style A fill:#fff3e0
    style H fill:#c8e6c9
```

资料来源：[skills/customer-success-triage/SKILL.md:1-35]()

### 人际关系与沟通

| 技能名称 | 命令 | 功能描述 |
|----------|------|----------|
| contact-lookup | `/contact-lookup "John"` | 完整联系人档案，包含 AI 洞察 |
| meeting-prep | `/meeting-prep "John"` | 准备会议，获取完整上下文和讨论要点 |
| follow-ups | `/follow-ups` | 追踪需要跟进的人员和客户 |
| relationship-pulse | `/relationship-pulse` | 检查被忽视的关系 |
| context-switch | `/context-switch "Acme"` | 快速加载客户或项目上下文 |

资料来源：[README.md:65-70]()

### 健康追踪

| 技能名称 | 命令 | 功能描述 |
|----------|------|----------|
| health-check | `/health-check` | 快速 Oura 健康概览：分数和趋势 |
| health-weekly | `/health-weekly` | 周健康回顾，包含睡眠、活动、恢复和锻炼洞察 |
| screentime-report | `/screentime-report` | 屏幕时间分析和顶部应用 |
| habit-check | `/habit-check` | 每日习惯签到、连续天数追踪和完成情况 |
| daily-training-report | `/daily-training-report` | 综合训练日报 |

资料来源：[README.md:72-78]()

**health-weekly 数据来源**：

| 数据类型 | MCP 工具 | 数据范围 |
|----------|----------|----------|
| 睡眠数据 | `get_health_sleep` | 14天 |
| 活动数据 | `get_health_activity` | 14天 |
| 准备度数据 | `get_health_readiness` | 14天 |
| 压力数据 | `get_health_stress` | 14天 |
| 锻炼历史 | `get_health_workouts` | 14天 |
| 心率趋势 | `get_health_heart_rate` | 14天 |
| 恢复力数据 | `get_health_resilience` | 14天 |
| VO2 Max | `get_health_vo2_max` | 14天 |
| 心血管年龄 | `get_health_cardio_age` | 14天 |
| 血氧数据 | `get_health_spo2` | 14天 |

资料来源：[skills/health-weekly/SKILL.md:1-40]()

### 财务管理

| 技能名称 | 命令 | 功能描述 |
|----------|------|----------|
| finance-overview | `/finance-overview` | 净资产、账户概览和趋势 |
| finance-spending | `/finance-spending` | 支出分析和消费模式 |

资料来源：[README.md:79-81]()

### PPV 人生设计系统

PPV（Purpose, Principles, Vision）是一套人生设计系统，整合愿景、身份、支柱和行动计划。

| 技能名称 | 命令 | 功能描述 |
|----------|------|----------|
| ppv | `/ppv` | 管理 PPV 愿景、身份、支柱、项目链接、周行动、反思和调整 |

资料来源：[README.md:96-98]()

**PPV 工作流程**：

```mermaid
graph TD
    A[获取 PPV 工作区] --> B{有活跃愿景?}
    B -->|无| C[创建新愿景]
    B -->|有| D[使用活跃愿景图]
    C --> D
    D --> E{用户请求类型?}
    E -->|愿景编辑| F[upsert_ppv_vision]
    E -->|身份编辑| G[upsert_ppv_identity]
    E -->|支柱管理| H[创建/更新/删除支柱]
    E -->|行动执行| I[创建/更新/删除周行动]
    E -->|反思| J[创建反思和调整]
    F --> K[更新图谱缓存]
    G --> K
    H --> K
    I --> K
    J --> K
    
    style A fill:#fff3e0
    style K fill:#c8e6c9
```

资料来源：[skills/ppv/SKILL.md:1-50]()

### 其他工具技能

| 技能名称 | 命令 | 功能描述 |
|----------|------|----------|
| inbox-triage | `/inbox-triage` | 将笔记处理为任务 |
| overdue | `/overdue` | 逾期和延误项目 |
| voice-notes | `/voice-notes` | 交互式备忘录探索 |
| voice-notes-crystallize | `/voice-notes-crystallize` | 保存对话洞察 |
| coaching-overview | `/coaching-overview` | 教练档案、会议和行动项目 |
| coaching-action-items | `/coaching-action-items` | 管理教练行动项目 |
| coaching-session-review | `/coaching-session-review` | 回顾教练会议洞察 |
| coach-memory | `/coach-memory` | 查看 AI 教练的累积知识 |
| llm-council | `/llm-council` | 多模型委员会决策 |
| blind-spot-finder | `/blind-spot-finder` | 多模型盲点发现 |

资料来源：[README.md:82-95]()

---

## MCP 工具集

### 工具覆盖范围

系统提供 **126 个 MCP 工具**，支持以下领域的完整 CRUD 操作：

| 领域 | 覆盖内容 |
|------|----------|
| 项目管理 | 项目、任务/问题、周期、阶段 |
| 联系人 | 人员/联系人 |
| 内容管理 | 笔记、语音备忘录 |
| 通讯 | AI 对话摘要、Beeper 线程、Granola 会议 |
| 目标追踪 | 举措（Initiatives） |
| 健康数据 | Oura Ring：睡眠、活动、准备度、压力、SpO2、心率、锻炼 |
| 财务管理 | 账户、净资产、交易、快照、每日支出 |
| 习惯追踪 | 习惯记录和完成情况 |
| 屏幕时间 | 应用使用分析 |
| 教练 | 教练档案和行动项目 |
| PPV | 人生设计系统全模块 |

资料来源：[AGENTS.md:50-54]()

### MCP 提示词

提供 **28 个 MCP 提示词**，功能与技能相同，但通过 MCP 协议暴露，可被任何 MCP 客户端调用。

---

## 安装与配置

### 前置要求

使用 LifeOS Plugin 需要准备三个凭证：

| 变量名 | 描述 | 获取位置 |
|--------|------|----------|
| `LIFEOS_CONVEX_URL` | Convex 部署 URL（`.convex.site`） | Convex 仪表盘 |
| `LIFEOS_USER_ID` | LifeOS 用户 ID | Convex 仪表盘 > Users 表 |
| `LIFEOS_API_KEY` | API 认证密钥 | LifeOS 设置中生成 |

资料来源：[README.md:55-66]()

### Claude Code 安装

```bash
claude plugin add github:starascendin/lifeos-plugin
```

设置环境变量：

```bash
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:15-28]()

### OpenCode 安装

```bash
# 方式一：复制
cp -r skills/ .claude/skills/lifeos/

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

资料来源：[README.md:21-27]()

### 手动 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"
      ]
    }
  }
}
```

或使用环境变量：

```bash
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:33-50]()

---

## 变更高效工作流

### 变更高效技能

以下技能为**变更高效工作流**，调用时会直接修改 LifeOS 数据，无需确认：

| 技能名称 | 变更高效操作 |
|----------|--------------|
| daily-plan | 创建问题、调度任务、分配周期、设置优先级、更新周期目标、保存每日笔记 |
| weekly-plan | 创建问题、调度任务、分配周期、设置优先级、更新周期目标、保存周笔记 |
| sprint-plan | 创建问题、分配周期任务、调度任务、设置优先级、更新周期目标 |
| ppv | 创建/更新愿景、身份、支柱、周行动、反思、调整 |

**重要提示**：这些技能会自动应用变更高效，用户不应在调用后要求确认。

资料来源：[skills/daily-plan/SKILL.md:28-35]()

### 变更高效原则

1. **立即应用**：调用 `apply_planning_patch` 时使用 `dryRun=false`
2. **直接操作**：使用 `create_issue`、`update_issue`、`schedule_issue` 等工具
3. **报告结果**：操作完成后报告所有变更摘要

---

## 更新维护

### 更新插件仓库

```bash
cd /path/to/lifeos-plugin && git pull
```

### 更新 MCP 服务器

MCP 服务器会自动随 `npx @latest` 更新，或在 `.mcp.json` 中固定版本：

```json
"@starascendin/lifeos-mcp@0.7.0"
```

资料来源：[README.md:68-75]()

---

## 总结

LifeOS Plugin 将复杂的个人生产力系统封装为 AI 代理可直接调用的技能和工作流。通过 37 种技能、126 个 MCP 工具和 28 个 MCP 提示词，用户可以让 AI 代理帮助管理日常任务、项目、联系人、健康、财务乃至人生规划，实现真正个性化的 AI 辅助生活管理系统。

---

<a id='page-installation'></a>

## 安装与配置

### 相关页面

相关主题：[项目介绍](#page-introduction), [MCP 服务器架构](#page-mcp-server)

<details>
<summary>相关源码文件</summary>

以下源码文件用于生成本页说明：

- [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)
</details>

# 安装与配置

本文档介绍 **lifeos-plugin** 的完整安装与配置流程。该插件为 Claude Code、OpenCode 等 AI 编程助手提供 37 个 Universal Skills，并集成了 126 个 MCP 工具，用于连接 LifeOS 个人生产力操作系统。

## 环境要求

| 组件 | 版本要求 | 说明 |
|------|---------|------|
| Node.js | ≥ 18.x | 用于运行 npx 命令 |
| npm/yarn | 最新稳定版 | 包管理器 |
| Convex 账户 | 有效订阅 | LifeOS 后端服务 |
| AI 助手 | Claude Code 或 OpenCode | 作为插件宿主 |

## 环境变量配置

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

### 必需的环境变量

```bash
# 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
```

### 配置说明

| 变量名 | 用途 | 获取方式 |
|--------|------|----------|
| `LIFEOS_CONVEX_URL` | Convex 项目的访问地址 | Convex Dashboard → 项目设置 → 部署 URL |
| `LIFEOS_USER_ID` | 用户唯一标识符 | LifeOS 应用内用户设置 |
| `LIFEOS_API_KEY` | API 认证密钥 | Convex Dashboard → API Keys |

资料来源：[README.md:1-6]()

## Claude Code 安装

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

### 安装命令

```bash
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 目录复制或符号链接到正确位置。

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

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

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

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

### 链接结构示意

```mermaid
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 配置文件中添加以下内容：

```json
{
  "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`）：

```bash
# ~/.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
```

然后重新加载配置：

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

### 方式三：项目级配置

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

```bash
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 助手，可以采用手动安装方式：

### 安装步骤

| 步骤 | 操作 | 说明 |
|------|------|------|
| 1 | 复制 skills 目录 | 将 `skills/` 目录复制到 AI 助手的 skills 位置 |
| 2 | 配置 MCP 服务器 | 设置环境变量或 MCP 配置文件 |
| 3 | 验证连接 | 运行一个 skill 验证 MCP 连接 |

### 目录结构要求

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

## 插件更新

### 更新插件仓库

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

# 拉取最新代码
git pull
```

### 更新 MCP 服务器

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

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

资料来源：[README.md:107-116]()

## 配置验证

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

### 验证 MCP 连接

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

| Skill 名称 | 命令 | 验证内容 |
|------------|------|---------|
| 健康检查 | `/health-check` | MCP 连接、Oura Ring 数据 |
| 日常计划 | `/daily-plan` | 计划上下文、任务数据 |
| 联系查询 | `/contact-lookup "测试用户"` | 联系人数据 |

### 预期输出

如果配置正确，应该能看到：
- 当前周期的任务列表
- 本周的每日计划
- 健康/财务/习惯等数据摘要

如果出现连接错误，请检查：
1. 环境变量是否正确设置
2. Convex URL 是否可访问
3. API Key 是否有效且未过期

## 故障排除

| 问题 | 可能原因 | 解决方案 |
|------|---------|---------|
| MCP 服务器无法启动 | npx 未安装或版本过低 | 安装 Node.js 18+ |
| 认证失败 | API Key 无效 | 在 Convex Dashboard 重新生成 |
| 插件命令未识别 | Claude Code 版本过低 | 更新到最新版本 |
| Skills 未显示 | 路径配置错误 | 检查 `.claude/skills/` 目录结构 |

## 快速开始流程

```mermaid
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 工具。

---

<a id='page-mcp-server'></a>

## MCP 服务器架构

### 相关页面

相关主题：[项目介绍](#page-introduction), [安装与配置](#page-installation)

<details>
<summary>相关源码文件</summary>

以下源码文件用于生成本页说明：

- [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)
- [AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)
- [.mcp.json.example](https://github.com/starascendin/lifeos-plugin/blob/main/.mcp.json.example)
- [skills/daily-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)
- [skills/weekly-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/weekly-plan/SKILL.md)
- [skills/sprint-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/sprint-plan/SKILL.md)
</details>

# MCP 服务器架构

本文档介绍 LifeOS Plugin 中 MCP（Model Context Protocol）服务器的架构设计、配置方式以及工具生态。

## 概述

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

资料来源：[AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)

## 系统架构

### 整体架构图

```mermaid
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
```

### 组件说明

| 组件 | 描述 | 技术实现 |
|------|------|----------|
| MCP 服务器 | 核心协议转换层 | Node.js (npx @starascendin/lifeos-mcp) |
| Convex 后端 | 数据存储与业务逻辑 | Convex 平台 |
| MCP 客户端 | AI Agent 集成 | Claude Code、OpenCode 等 |
| 认证层 | API 身份验证 | API Key + User ID |

## 快速启动

### 安装命令

通过 Claude Code 安装插件：

```bash
claude plugin add github:starascendin/lifeos-plugin
```

资料来源：[README.md:27](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L27)

### 环境变量配置

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

```bash
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](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L1-L8)

### MCP 服务器配置文件

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

```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](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L52-L65)

## MCP 工具生态

### 工具分类总览

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

| 类别 | 工具数量 | 主要功能 |
|------|----------|----------|
| 项目管理 | ~20+ | 项目的创建、读取、更新、删除 |
| 任务/事项 | ~20+ | 任务的 CRUD 操作、状态变更 |
| 周期管理 | ~10+ | 冲刺/周期的规划与追踪 |
| 客户管理 | ~10+ | 客户信息、健康度评估 |
| 人员/联系人 | ~10+ | 联系人的完整资料查询 |
| 笔记 | ~10+ | 笔记的创建与关联 |
| 语音备忘录 | ~10+ | 语音转录、标签分类 |
| 健康数据 | ~15+ | Oura Ring 数据集成 |
| 财务管理 | ~10+ | 账户、净值、交易记录 |
| 习惯追踪 | ~5+ | 习惯完成率、连续天数 |
| 屏幕时间 | ~3+ | 应用使用分析 |
| 教练系统 | ~10+ | 教练档案、会话、行动项 |
| PPV 生活设计 | ~10+ | 愿景、身份、支柱管理 |

资料来源：[AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)

### 核心规划工具

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

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

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

```javascript
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](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)

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

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

| 操作类型 | 方法 | 用途 |
|----------|------|------|
| 创建任务 | `create_issue` | 新建工作项 |
| 调度任务 | `schedule_issue` | 设置截止日期 |
| 更新任务 | `update_issue` | 修改状态、优先级、估算 |
| 周期分配 | `assign_issue_to_current_cycle` | 将任务分配到当前周期 |
| 优先级设置 | `set_top_priority` | 设置今日 Top 3 |
| 周期目标更新 | `update_cycle_goals` | 更新冲刺目标 |
| 每日笔记保存 | `save_daily_note` | 保存每日议程笔记 |
| 周笔记保存 | `save_weekly_note` | 保存每周计划笔记 |
| 评论添加 | `add_issue_comment` | 添加规划说明 |

资料来源：[skills/daily-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)

### 健康数据集成工具

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

| 健康指标 | 工具方法 | 数据范围 |
|----------|----------|----------|
| 睡眠数据 | `get_health_sleep` | 得分、时长、入睡时间、呼吸率 |
| 活动数据 | `get_health_activity` | 步数、卡路里、活动天数 |
| 就绪度 | `get_health_readiness` | 得分趋势、压力与恢复平衡 |
| 压力数据 | `get_health_stress` | 压力水平、日间恢复 |
| 心率 | `get_health_heart_rate` | 心率趋势 |
| 韧性 | `get_health_resilience` | 韧性水平及其贡献因素 |
| VO2 Max | `get_health_vo2_max` | 有氧能力估计 |
| 心血管年龄 | `get_health_cardio_age` | 心血管健康评估 |
| 血氧 | `get_health_spo2` | SpO2、呼吸障碍指数 |
| 锻炼记录 | `get_health_workouts` | 锻炼历史记录 |

资料来源：[skills/health-weekly/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-weekly/SKILL.md)

### PPV 生活设计工具

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

| 操作 | 工具方法 | 描述 |
|------|----------|------|
| 获取工作空间 | `get_ppv_workspace` | 获取完整的 PPV 数据结构 |
| 获取愿景图谱 | `get_active_vision_graph` | 获取活跃愿景的关联图 |
| 创建/更新愿景 | `upsert_ppv_vision` | 愿景应该是生动的、情感的、有方向性的 |
| 创建/更新身份 | `upsert_ppv_identity` | 核心身份、信念、行为 |
| 创建/更新支柱 | `create_ppv_pillar` / `update_ppv_pillar` / `delete_ppv_pillar` | 支柱是持续运行的系统 |
| 每周行动管理 | `create_ppv_weekly_action` / `update_ppv_weekly_action` / `delete_ppv_weekly_action` | 小而具体的行动 |
| 反思记录 | `create_ppv_reflection` | 每周能量、阻力、一致性、动力 |
| 调整记录 | `create_ppv_adjustment` | 根据反思调整身份、支柱、项目、行动 |

资料来源：[skills/ppv/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/ppv/SKILL.md)

## MCP 提示（Prompts）

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

### 每日工作流提示

| 提示名称 | 命令 | 功能描述 |
|----------|------|----------|
| `daily-standup` | `/daily-standup` | 晨会简报，包含议程、任务、冲刺进度 |
| `daily-plan` | `/daily-plan` | 今日计划，设置截止日期、优先级、周期分配 |
| `end-of-day` | `/end-of-day` | 每日收尾，完成总结与明日计划 |
| `capture` | `/capture "内容"` | 快速捕获想法、任务或笔记，自动路由 |

资料来源：[README.md:17-23](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L17-L23)

### 回顾与计划提示

| 提示名称 | 命令 | 功能描述 |
|----------|------|----------|
| `weekly-review` | `/weekly-review` | 完成工作、进行中项、冲刺健康度 |
| `weekly-plan` | `/weekly-plan` | 周计划，设置周期、截止日期、优先级 |
| `monthly-review` | `/monthly-review` | 月度成就、项目进度、下月规划 |
| `cycle-review` | `/cycle-review` | 冲刺回顾，包含延续选项 |
| `initiative-review` | `/initiative-review 2026` | 年度目标分类查看 |

资料来源：[README.md:24-35](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L24-L35)

### 客户与项目管理提示

| 提示名称 | 命令 | 功能描述 |
|----------|------|----------|
| `project-status` | `/project-status ACME` | 阶段分解、任务统计、阻塞项 |
| `client-brief` | `/client-brief "Acme Corp"` | 客户项目、沟通、健康度 |
| `client-health` | `/client-health` | 全客户健康度仪表盘 |
| `sprint-plan` | `/sprint-plan` | 周期计划：目标、回溯、截止日期、优先级 |
| `customer-success-triage` | `/customer-success-triage "Acme Corp"` | 使用聊天、会议、笔记、开放任务进行分类 |

资料来源：[README.md:36-46](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L36-L46)

## 工作流集成

### 技能与 MCP 工具的关系

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

```mermaid
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 工具的典型使用模式：

```mermaid
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](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)

## 图谱查询工具

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

| 工具方法 | 用途 |
|----------|------|
| `get_active_vision_graph` | 获取活跃或选定愿景的统一图谱，包含 PPV 节点及关联的项目、事项、语音备忘录 |
| `get_project_graph` | 以项目为中心的图谱邻域 |
| `get_initiative_graph` | 以倡议为中心的图谱邻域 |
| `get_person_graph` | 关系/联系人上下文图谱 |
| `get_voice_memo_graph` | 以语音备忘录为中心的图谱邻域 |
| `get_unified_life_graph` | 整体系统分析或导出（重量级操作） |

资料来源：[skills/ppv/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/ppv/SKILL.md)

## 客户端集成

### Claude Code 集成

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

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

安装后，Claude Code 自动获得：
- 37 个技能（Skills）
- 126 个 MCP 工具
- 28 个 MCP 提示

资料来源：[README.md:27-30](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L27-L30)

### OpenCode 集成

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

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

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

资料来源：[README.md:35-44](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L35-L44)

## 更新维护

### 插件更新

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

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

资料来源：[AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)

## 总结

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

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

---

<a id='page-daily-workflows'></a>

## 日常管理工作流

### 相关页面

相关主题：[复盘与规划工作流](#page-review-workflows)

<details>
<summary>相关源码文件</summary>

以下源码文件用于生成本页说明：

- [skills/daily-standup/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-standup/SKILL.md)
- [skills/daily-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)
- [skills/end-of-day/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/end-of-day/SKILL.md)
- [skills/capture/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/capture/SKILL.md)
- [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)
- [AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)
</details>

# 日常管理工作流

## 概述

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

## 核心技能架构

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

| 技能名称 | 功能描述 | 工作流类型 |
|---------|---------|-----------|
| `daily-standup` | 晨间简报，包含议程、任务和迭代进度 | 只读查询 |
| `daily-plan` | 规划今日工作，修改截止日期、优先级、周期分配和每日笔记 | 变异操作 |
| `end-of-day` | 日终总结，包含完成情况汇总和明日计划 | 变异操作 |
| `capture` | 快速捕获想法、任务或笔记，自动路由到适当位置 | 变异操作 |

资料来源：[README.md:14-25]()

### 技能调用流程图

```mermaid
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 工具

| MCP 工具 | 用途 |
|---------|-----|
| `get_daily_agenda` | 获取今日议程，包含今日截止的任务和日历事件 |
| `get_todays_tasks` | 获取今日任务列表 |
| `get_overdue_tasks` | 获取已逾期的开放任务 |
| `get_current_cycle` | 获取当前迭代周期进度和统计 |

资料来源：[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]()

### 工作流程

```mermaid
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` 时使用的参数配置：

| 参数 | 值 | 说明 |
|-----|-----|-----|
| `date` | `$ARGUMENTS` 或当天 | 规划日期 |
| `include.daily` | `true` | 包含每日信息 |
| `include.weekly` | `true` | 包含周度信息 |
| `include.currentCycle` | `true` | 包含当前迭代周期 |
| `include.backlog` | `true` | 包含待办列表 |
| `include.habits` | `true` | 包含习惯追踪 |
| `include.dailyFields` | `true` | 包含每日字段 |
| `include.calendar` | `true` | 包含日历事件 |
| `include.voiceMemos` | `true` | 包含语音备忘录 |

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

### 支持的变异操作

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

| 操作类型 | MCP 工具 | 用途 |
|---------|---------|-----|
| 创建任务 | `create_issue` | 创建新的任务记录 |
| 调度任务 | `schedule_issue` | 设置任务截止日期 |
| 更新任务 | `update_issue` | 修改任务状态、优先级、估算和标题 |
| 分配周期 | `assign_issue_to_current_cycle` | 将任务分配到当前活跃迭代 |
| 设置优先级 | `set_top_priority` | 设置今日 Top 3 优先级 |
| 更新周期目标 | `update_cycle_goals` | 修改活跃迭代的目标 |
| 保存每日笔记 | `save_daily_note` | 写入最终可读的日计划到议程笔记 |
| 添加任务评论 | `add_issue_comment` | 添加规划理由到任务 |

资料来源：[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]()

### 自动路由机制

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

| 内容类型 | 路由目标 |
|---------|---------|
| 临时想法 | 笔记系统或语音备忘录 |
| 待办任务 | 自动创建为 Issue 或添加到待办列表 |
| 会议要点 | 关联到相关项目或联系人 |
| 客户信息 | 客户端工作区笔记 |

### 使用场景

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

## 集成与配置

### MCP 服务器配置

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

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

```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]()

**方式二：环境变量配置**

```bash
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 集成

```bash
claude plugin add github:starascendin/lifeos-plugin
```

### OpenCode 集成

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

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

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

资料来源：[README.md:43-50]()

## 与其他工作流的协同

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

```mermaid
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
```

### 规划类工作流的关联

| 关联关系 | 说明 |
|---------|-----|
| weekly-plan → daily-plan | 周计划为日计划提供上下文 |
| sprint-plan → daily-plan | 迭代计划指导每日任务分配 |
| daily-plan → weekly-plan | 日计划执行情况影响周计划调整 |

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

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

### 健康与习惯追踪的关联

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

| 数据来源 | 技能 | 展示内容 |
|---------|-----|---------|
| Oura Ring | `health-weekly` | 睡眠评分、活动趋势、恢复状态 |
| 习惯追踪 | `daily-training-report` | 习惯完成率、连续天数 |
| 日历整合 | `daily-standup` | 会议安排、时间块 |

资料来源：[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](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)
- **MCP 工具参考**: [AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)
- **迭代规划**: [sprint-plan 技能](https://github.com/starascendin/lifeos-plugin/blob/main/skills/sprint-plan/SKILL.md)
- **周度规划**: [weekly-plan 技能](https://github.com/starascendin/lifeos-plugin/blob/main/skills/weekly-plan/SKILL.md)
- **语音笔记**: [voice-notes 技能](https://github.com/starascendin/lifeos-plugin/blob/main/skills/voice-notes/SKILL.md)
- **健康追踪**: [health-weekly 技能](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-weekly/SKILL.md)

---

<a id='page-review-workflows'></a>

## 复盘与规划工作流

### 相关页面

相关主题：[日常管理工作流](#page-daily-workflows), [项目与客户管理](#page-project-management)

<details>
<summary>相关源码文件</summary>

以下源码文件用于生成本页说明：

- [skills/weekly-review/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/weekly-review/SKILL.md)
- [skills/weekly-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/weekly-plan/SKILL.md)
- [skills/monthly-review/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/monthly-review/SKILL.md)
- [skills/cycle-review/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/cycle-review/SKILL.md)
- [skills/initiative-review/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/initiative-review/SKILL.md)
</details>

# 复盘与规划工作流

## 概述

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

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

资料来源：[README.md:15-30]()

## 架构总览

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

```mermaid
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]
```

### 核心设计原则

| 原则 | 说明 | 资料来源 |
|------|------|----------|
| 上下文优先 | 规划工作流首先调用 `get_planning_context` 获取完整上下文 | [skills/weekly-plan/SKILL.md:1-12]() |
| 自动执行 | 规划类工作流不询问确认，直接应用变更 | [skills/daily-plan/SKILL.md:24]() |
| 可组合性 | 各周期的工作流可相互嵌套调用 | [skills/monthly-review/SKILL.md:1-8]() |
| 数据驱动 | 决策基于实际数据而非主观判断 | [skills/cycle-review/SKILL.md:1-10]() |

## 复盘类工作流

### 周期循环复盘

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

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

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

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

```mermaid
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)

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

| 数据维度 | 获取工具 | 展示内容 |
|----------|----------|----------|
| 已完成任务 | `get_tasks` with status="done" | 完成数量、类型分布 |
| 进行中任务 | `get_todays_tasks` | 当前工作负载 |
| 周期健康度 | `get_cycles` | Sprint完成率 |
| 客户状态 | `get_clients` | 关系健康度 |
| 捕获笔记 | `get_recent_notes` | 思考模式分析 |

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

#### 月回顾 (Monthly Review)

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

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

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

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

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

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

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

### 专项复盘

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

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

| 健康维度 | 数据源 | 关键指标 |
|----------|--------|----------|
| 睡眠质量 | `get_health_sleep` | 评分、时长、深度/REM平衡 |
| 活动模式 | `get_health_activity` | 步数均值、活跃天数 |
| 准备度 | `get_health_readiness` | 评分趋势、压力vs恢复 |
| 韧性 | `get_health_resilience` | 日级别趋势、贡献因子 |
| 健身 | `get_health_vo2_max` | 最大摄氧量趋势 |

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

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

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

| 分类 | 说明 | 处理方式 |
|------|------|----------|
| 新需求 | 全新请求或变更需求 | 创建需求笔记 |
| 跟进项 | 等待你或团队响应的事项 | 更新现有任务 |
| 风险/阻塞 | 范围模糊、延期风险、流失风险 | 标记并通知 |
| 已跟踪 | 已有笔记或任务覆盖 | 关联现有项 |

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

## 规划类工作流

### 周期规划工作流

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

```mermaid
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)

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

| 操作类型 | 工具方法 | 说明 |
|----------|----------|------|
| 创建任务 | `create_issue` | 新增任务到系统 |
| 调度任务 | `schedule_issue` | 设置截止日期 |
| 更新任务 | `update_issue` | 修改状态、优先级、估算 |
| 加入周期 | `assign_issue_to_current_cycle` | 将工作纳入当前周期 |
| 设置优先级 | `set_top_priority` | 设置今日Top 3 |
| 更新周期目标 | `update_cycle_goals` | 变更周期焦点 |
| 保存日记 | `save_daily_note` | 写入可读的日计划 |

资料来源：[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` 获取的完整上下文结构：

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

| 字段 | 用途 |
|------|------|
| daily | 今日任务和日历 |
| weekly | 本周概览 |
| currentCycle | 当前Sprint数据 |
| backlog | 待办池任务 |
| habits | 习惯追踪 |
| dailyFields | 每日字段配置 |
| calendar | 日历事件 |
| voiceMemos | 语音备忘录 |

## 复盘与规划的协同关系

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

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

### 数据流向

| 复盘输出 | 作为规划输入 |
|----------|--------------|
| 已完成任务 | 评估当前周期负载 |
| 延期项 | Sprint计划待处理 |
| 完成率 | 调整周期容量 |
| 模式分析 | 优化计划策略 |
| 风险识别 | 优先级调整依据 |

## MCP 工具清单

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

| 工具 | 用途 | 工作流类型 |
|------|------|------------|
| `get_planning_context` | 获取完整规划上下文 | 规划 |
| `apply_planning_patch` | 执行变更操作 | 规划 |
| `get_tasks` | 获取任务列表 | 复盘/规划 |
| `get_cycles` | 获取周期数据 | 复盘 |
| `get_daily_agenda` | 获取每日议程 | 复盘 |
| `get_monthly_agenda` | 获取月度概览 | 复盘 |
| `get_initiatives` | 获取年度倡议 | 复盘 |
| `get_clients` | 获取客户列表 | 复盘 |
| `get_health_*` | 获取健康数据 | 专项复盘 |
| `create_issue` | 创建任务 | 规划 |
| `update_issue` | 更新任务 | 规划 |
| `schedule_issue` | 调度任务 | 规划 |
| `save_daily_note` | 保存日记 | 规划 |
| `save_weekly_note` | 保存周笔记 | 规划 |

资料来源：[AGENTS.md:50-80]()

## 最佳实践

### 执行顺序建议

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

### 数据一致性维护

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

### 异常处理

| 场景 | 处理方式 |
|------|----------|
| 周期过载 | 优先将任务延期到下周期 |
| 冲突优先级 | 参考 Top Priority 设置 |
| 上下文不完整 | 记录缺失项，依赖手动补充 |

## 与其他模块的集成

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

```mermaid
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]()

---

<a id='page-project-management'></a>

## 项目与客户管理

### 相关页面

相关主题：[复盘与规划工作流](#page-review-workflows), [人际关系管理](#page-people-relationships)

<details>
<summary>相关源码文件</summary>

以下源码文件用于生成本页说明：

- [skills/project-status/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/project-status/SKILL.md)
- [skills/client-brief/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/client-brief/SKILL.md)
- [skills/client-health/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/client-health/SKILL.md)
- [skills/sprint-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/sprint-plan/SKILL.md)
- [skills/customer-success-triage/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/customer-success-triage/SKILL.md)
- [skills/inbox-triage/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/inbox-triage/SKILL.md)
- [skills/overdue/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/overdue/SKILL.md)
</details>

# 项目与客户管理

## 概述

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

资料来源：[README.md:1-37]()

## 核心技能体系

### 技能矩阵

| 技能名称 | 命令 | 功能描述 |
|---------|------|---------|
| project-status | `/project-status [项目名]` | 阶段分解、任务统计、阻塞项 |
| client-brief | `/client-brief "客户名"` | 完整客户简报，包含项目与沟通记录 |
| client-health | `/client-health` | 全客户健康仪表盘 |
| sprint-plan | `/sprint-plan` | 当前冲刺规划：目标、回溯、截止日期、优先级 |
| customer-success-triage | `/customer-success-triage "客户名"` | 客户请求分类处理 |
| inbox-triage | `/inbox-triage` | 将笔记处理为可执行任务 |
| overdue | `/overdue` | 逾期与滑向逾期的项目 |

资料来源：[README.md:42-56]()

## 项目状态管理

### project-status 技能

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

**工作流程：**

```mermaid
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` 技能提供特定客户的完整视图，帮助快速了解与客户的全部互动情况。

**数据结构：**

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

**使用方式：**

```bash
/client-brief "Acme Corp"
```

**核心数据源：**

| 数据类型 | MCP 工具 | 说明 |
|---------|---------|------|
| 项目 | get_client_projects | 客户关联的所有项目 |
| 沟通 | get_beeper_thread_messages | Beeper 聊天记录 |
| 会议 | get_fathom_meeting, get_granola_meeting | Fathom 和 Granola 会议数据 |
| 笔记 | get_client_notes | 客户相关笔记 |
| 任务 | get_client_tasks | 客户相关的开放任务 |

资料来源：[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`

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

3. 调用 `apply_planning_patch`，参数：
   - `mode="cycle"`
   - `dryRun=false`

**可用操作：**

| 操作 | MCP 工具 | 说明 |
|-----|---------|------|
| 创建新工作 | `create_issue` | 在冲刺中创建新任务 |
| 分配到冲刺 | `assign_issue_to_current_cycle` | 将任务分配到当前冲刺 |
| 安排任务 | `schedule_issue` | 设置截止日期 |
| 更新任务 | `update_issue` | 修改状态、优先级、估算值、标题 |
| 设置优先级 | `set_top_priority` | 立即聚焦的任务 |
| 更新目标 | `update_cycle_goals` | 冲刺目标调整 |
| 保存笔记 | `save_weekly_note` / `save_daily_note` | 可读计划文档 |

**执行后报告内容：**

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

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

## 客户成功分类

### customer-success-triage 技能

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

**工作流程：**

```mermaid
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[生成分类报告]
```

**分类类别：**

| 类别 | 说明 |
|-----|------|
| 新需求 (New Requirements) | 全新请求或变更需求 |
| 跟进项 (Follow-Ups) | 等待你或团队处理的事项 |
| 风险/阻塞 (Risks/Blockers) | 范围模糊、逾期工作、交付风险、流失风险 |
| 已追踪 (Already Tracked) | 已有笔记或任务覆盖的请求 |

**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` 技能将捕获的笔记处理为可执行任务、标签和链接。

**执行流程：**

```mermaid
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]()

## 数据流向

### 完整工作流架构

```mermaid
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 工具：

| 工具名称 | 功能 | 适用场景 |
|---------|------|---------|
| `get_client_success_workspace` | 获取客户成功工作区 | 客户请求分类 |
| `get_beeper_thread_messages` | 获取 Beeper 聊天记录 | 客户沟通详情 |
| `get_fathom_meeting` | 获取 Fathom 会议 | 会议详情 |
| `get_fathom_transcript` | 获取 Fathom 转录 | 会议记录 |
| `get_granola_meeting` | 获取 Granola 会议 | 会议详情 |
| `get_granola_transcript` | 获取 Granola 转录 | 会议记录 |
| `get_client_notes` | 获取客户笔记 | 历史记录查看 |
| `create_client_note` | 创建客户笔记 | 记忆保存 |
| `update_client_note` | 更新客户笔记 | 记忆维护 |
| `get_planning_context` | 获取规划上下文 | 冲刺/周/日计划 |
| `apply_planning_patch` | 应用规划变更 | 变异操作 |
| `get_recent_notes` | 获取最近笔记 | 收件箱分类 |
| `get_projects` | 获取项目列表 | 任务分配 |
| `get_people` | 获取联系人列表 | 人员关联 |

## 最佳实践

### 客户管理

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

### 项目执行

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

### 任务处理

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

## 配置要求

### 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"
      ]
    }
  }
}
```

### 环境变量

| 变量名 | 说明 |
|-------|------|
| `LIFEOS_CONVEX_URL` | Convex 应用地址 |
| `LIFEOS_USER_ID` | 用户 ID |
| `LIFEOS_API_KEY` | API 密钥 |

资料来源：[README.md:25-45]()

---

<a id='page-voice-notes-workflows'></a>

## 语音笔记工作流

### 相关页面

相关主题：[日常管理工作流](#page-daily-workflows)

<details>
<summary>相关源码文件</summary>

以下源码文件用于生成本页说明：

- [skills/voice-notes/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/voice-notes/SKILL.md)
- [skills/voice-notes-crystallize/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/voice-notes-crystallize/SKILL.md)
- [skills/daily-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)
- [skills/weekly-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/weekly-plan/SKILL.md)
- [skills/daily-training-report/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-training-report/SKILL.md)
</details>

# 语音笔记工作流

## 概述

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

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

---

## 架构设计

### 组件关系

```mermaid
graph TD
    A[用户] -->|语音指令| B[voice-notes 技能]
    B -->|探索请求| C[MCP 工具集]
    C --> D[get_voice_memo_labels]
    C --> E[get_recent_notes]
    C --> F[get_voice_memos_by_labels]
    C --> G[get_voice_memos_by_date]
    C --> H[get_voice_memo]
    C --> I[search_notes]
    
    A -->|结晶保存| I[voice-notes-crystallize 技能]
    I -->|创建摘要| J[create_ai_convo_summary]
    
    K[其他规划技能] -.->|集成| C
    K -->|include.voiceMemos| B
```

语音笔记工作流与日常规划、每周计划等技能深度集成，在获取规划上下文时可通过 `include.voiceMemos=true` 参数一并拉取相关语音备忘录。资料来源：[skills/daily-plan/SKILL.md:3-8]()

### MCP 工具矩阵

| 工具名称 | 功能描述 | 返回数据类型 |
|---------|---------|-------------|
| `get_voice_memo_labels` | 获取所有语音备忘录的标签/主题 | 标签列表 |
| `get_recent_notes` | 获取最近 N 条语音记录 | 摘要数组 |
| `get_voice_memos_by_date` | 按日期范围查询语音记录 | 时间序列数据 |
| `get_voice_memos_by_labels` | 按标签筛选语音记录 | 分类数据 |
| `get_voice_memo` | 获取单条语音备忘录的完整信息 | 详细对象（含 AI 提取） |
| `search_notes` | 全文搜索语音笔记内容 | 搜索结果集 |
| `create_ai_convo_summary` | 创建 AI 对话结晶摘要 | 摘要 ID |

---

## 工作流程详解

### 探索阶段

语音笔记探索采用渐进式发现模式，从概览到细节逐层深入。资料来源：[skills/voice-notes/SKILL.md:1-30]()

#### 步骤一：了解资源池

系统首先调用 `get_voice_memo_labels` 获取所有可用的主题标签，同时调用 `get_recent_notes` 显示最近 10 条记录。这种双重查询让用户对语音笔记库有初步认知：

```mermaid
graph LR
    A[开始] --> B[获取标签云]
    B --> C[获取最近笔记]
    C --> D{用户意图}
    D -->|查看最近| E[展示时间线]
    D -->|探索主题| F[按标签聚合]
    D -->|回溯时段| G[日期范围查询]
    D -->|深度分析| H[单条笔记详览]
```

#### 步骤二：多维度探索

根据用户意图，系统提供四种主要探索路径：

**按时间回顾**

调用 `get_voice_memos_by_date`，传入 `startDate` 和 `endDate` 参数。系统将呈现时间线上的主题模式、情感波动和关键要点。资料来源：[skills/voice-notes/SKILL.md:18-20]()

**按主题探索**

调用 `get_voice_memos_by_labels` 筛选特定标签下的所有语音记录。这有助于用户追踪特定项目、会议或生活领域的持续思考。资料来源：[skills/voice-notes/SKILL.md:15-17]()

**全文检索**

当用户有明确搜索目标时，调用 `search_notes` 执行语义或关键词搜索。资料来源：[skills/voice-notes/SKILL.md:21-22]()

**深度分析**

对于单条重要备忘录，调用 `get_voice_memo` 获取包含 AI 提取信息的完整详情。资料来源：[skills/voice-notes/SKILL.md:23-25]()

---

### 对话交互阶段

在探索过程中，技能扮演主动思考伙伴的角色：

- **识别模式**：跨备忘录发现反复出现的主题或矛盾点
- **连接关联**：将不同时间、不同主题的笔记建立逻辑关联
- **激活行动项**：挖掘被遗忘但仍有价值的待办事项
- **协助规划**：帮助用户基于笔记内容制定或调整计划

资料来源：[skills/voice-notes/SKILL.md:26-33]()

---

### 结晶保存阶段

当对话产生有价值的结果时，用户可选择结晶保存。资料来源：[skills/voice-notes-crystallize/SKILL.md:1-50]()

#### 摘要类型分类

系统支持六种摘要类型，用于不同场景：

| 类型 | 适用场景 | 内容特征 |
|-----|---------|---------|
| `reflection` | 回顾过往经历或情感 | 感受加工、事件复盘 |
| `planning` | 制定策略或计划 | 目标分解、行动路径 |
| `brainstorm` | 创意发散场景 | 想法碰撞、多角度探索 |
| `journal_review` | 日记/日志回顾 | 时间线梳理、成长轨迹 |
| `idea_refinement` | 已有想法深化 | 细节打磨、可行性分析 |

#### 结晶数据结构

创建结晶摘要时，系统提取以下核心元素：

```json
{
  "title": "生成的描述性标题",
  "summary": "2-4 段落的主要洞察和结论",
  "keyInsights": ["3-7 条核心领悟"],
  "actionItems": ["任务或行动项"],
  "ideas": ["新想法或新方向"],
  "tags": ["3-5 个分类标签"],
  "summaryType": "摘要类型",
  "conversationContext": "对话上下文"
}
```

保存成功后返回摘要 ID，用户可通过 `get_ai_convo_summaries` 回顾历史结晶。资料来源：[skills/voice-notes-crystallize/SKILL.md:24-31]()

---

## 与其他技能的集成

### 规划上下文集成

语音笔记可作为规划决策的参考依据。以下技能在获取规划上下文时支持语音备忘录集成：资料来源：[skills/daily-plan/SKILL.md:5-7]()

```mermaid
graph TD
    A[规划技能] -->|include.voiceMemos: true| B[get_planning_context]
    B --> C[返回语音备忘录数据]
    C --> D[辅助决策]
    
    A -->|daily-plan| E[日计划]
    A -->|weekly-plan| F[周计划]
    A -->|sprint-plan| G[冲刺计划]
```

### 每日训练报告集成

在生成每日训练报告时，系统整合语音笔记中的相关洞察作为参考上下文，帮助用户将语音记录中的健康、训练相关想法纳入日常复盘。资料来源：[skills/daily-training-report/SKILL.md:1-25]()

---

## 使用场景示例

### 场景一：周回顾反思

用户希望回顾过去一周的语音日记：
1. 调用 `get_voice_memos_by_date`，设置起止日期
2. 系统展示本周主题和情感趋势
3. 用户选择特定日期深入查看
4. 调用 `get_voice_memo` 获取完整 AI 提取内容
5. 对话式分析后，调用 `voice-notes-crystallize` 保存周回顾

### 场景二：项目追踪

用户想查看某个项目的所有语音讨论：
1. 调用 `get_voice_memo_labels` 确认项目标签
2. 调用 `get_voice_memos_by_labels` 筛选项目相关记录
3. 系统聚合所有相关录音和转录
4. 帮助用户提取项目决策和下一步行动

---

## 最佳实践

| 建议 | 说明 |
|-----|-----|
| 定期结晶 | 对话结束后及时保存有价值的内容，避免洞察流失 |
| 标签管理 | 录音时添加清晰标签，便于后续按主题探索 |
| 结合规划 | 在日/周计划时利用语音笔记作为上下文参考 |
| 行动项追踪 | 从语音笔记中提取的任务应同步到任务管理系统 |

---

## 技术要点

语音笔记工作流依赖以下底层能力：

1. **AI 提取**：每条语音备忘录都经过 AI 处理，提取关键信息、情感标签和行动项
2. **语义搜索**：支持基于意义的搜索，而非简单的关键词匹配
3. **上下文关联**：能够将语音笔记与其他 LifeOS 数据（任务、健康、财务等）建立关联
4. **结晶持久化**：结晶摘要作为 AI 对话总结存储，可跨会话回顾

这些能力共同构成了一个从录制到分析再到知识沉淀的完整闭环。

---

<a id='page-health-integration'></a>

## 健康数据集成 (Oura Ring)

<details>
<summary>相关源码文件</summary>

以下源码文件用于生成本页说明：

- [skills/health-check/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-check/SKILL.md)
- [skills/health-weekly/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-weekly/SKILL.md)
- [skills/daily-training-report/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-training-report/SKILL.md)
- [AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)
- [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)
</details>

# 健康数据集成 (Oura Ring)

## 概述

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

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

## 数据架构

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

## 核心 MCP 工具清单

### 健康数据获取工具

| 工具名称 | 功能描述 | 数据范围 |
|---------|---------|---------|
| `get_health_sleep` | 获取睡眠数据 | 分数、时长、入睡时间、呼吸率、不安周期 |
| `get_health_activity` | 获取活动数据 | 活动分数、步数、卡路里燃烧 |
| `get_health_readiness` | 获取准备度数据 | 准备度分数、压力与恢复平衡、体温趋势 |
| `get_health_stress` | 获取压力与恢复数据 | 压力水平、恢复状态 |
| `get_health_heart_rate` | 获取心率趋势 | 静息心率、HRV 趋势 |
| `get_health_workouts` | 获取锻炼历史 | 锻炼类型、时间、强度（优先使用 label 而非 activity） |
| `get_health_resilience` | 获取恢复力水平 | 日级别恢复力趋势、贡献因素分解（睡眠恢复、日间恢复、压力） |
| `get_health_vo2_max` | 获取最大摄氧量 | VO2max 估算值（ml/kg/min） |
| `get_health_cardio_age` | 获取心血管年龄 | 心血管年龄趋势 |
| `get_health_spo2` | 获取血氧数据 | SpO2 数值、呼吸障碍指数 |

资料来源：[skills/health-weekly/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/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](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-check/SKILL.md)

**参数说明：**

| 参数 | 类型 | 说明 |
|-----|------|-----|
| `$ARGUMENTS` | 数字（可选） | 指定回顾天数，默认为 7 天 |

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

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

**数据采集范围：**

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

| 数据类型 | 采集天数 | 包含指标 |
|---------|---------|---------|
| 睡眠 | 14 天 | 分数、时长、入睡时间、呼吸率、深睡/REM 平衡、不安周期 |
| 活动 | 14 天 | 步数、活动日与休息日对比、卡路里燃烧 |
| 准备度 | 14 天 | 分数趋势、压力与恢复平衡、体温趋势 |
| 压力 | 14 天 | 压力与恢复数据 |
| 锻炼 | 14 天 | 锻炼历史（优先使用 label 显示名称） |
| 心率 | 14 天 | 心率趋势 |
| 恢复力 | 14 天 | 日级别恢复力、贡献因素（睡眠恢复、日间恢复、压力） |
| VO2max | 14 天 | 最大摄氧量估算值（ml/kg/min） |
| 心血管年龄 | 14 天 | 心血管年龄趋势 |
| 血氧 | 14 天 | SpO2 数值、呼吸障碍指数 |

**输出结构：**

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

资料来源：[skills/health-weekly/SKILL.md:1-50](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-weekly/SKILL.md)

### 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](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-training-report/SKILL.md)

## 数据流向图

```mermaid
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
```

## 健康指标参考表

| 指标名称 | 单位 | 正常范围参考 | 数据来源 |
|---------|------|-------------|---------|
| 睡眠分数 | 分 | 80-100 优秀, 60-80 良好, <60 需改善 | Oura Ring |
| 准备度分数 | 分 | 80-100 优秀, 60-80 良好, <60 需注意 | Oura Ring |
| 活动分数 | 分 | 动态目标 | Oura Ring |
| 静息心率 | bpm | 50-70 成人正常范围 | Oura Ring |
| HRV | ms | 20-100 正常范围（因人而异） | Oura Ring |
| VO2max | ml/kg/min | 35-50 成年男性, 25-40 成年女性 | Oura Ring 估算 |
| SpO2 | % | 95-100 正常 | Oura Ring |
| 心血管年龄 | 岁 | 与实际年龄对比 | Oura Ring 估算 |

## 使用场景

### 场景一：晨间快速检视

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

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

### 场景二：周末健康复盘

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

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

### 场景三：训练日报整合

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

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

## 配置要求

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

| 环境变量 | 说明 | 示例 |
|---------|------|-----|
| `LIFEOS_CONVEX_URL` | Convex 部署地址 | `https://your-app.convex.site` |
| `LIFEOS_USER_ID` | 用户标识 | `your-user-id` |
| `LIFEOS_API_KEY` | API 密钥 | `your-api-key` |

资料来源：[README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)

## 与其他模块的集成

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

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

### 集成点说明

| 集成模块 | 集成方式 | 说明 |
|---------|---------|------|
| 习惯系统 | `get_habits`, `get_habits_for_date` | 将健康指标与习惯完成度关联分析 |
| 任务系统 | `get_todays_tasks`, `get_daily_agenda` | 基于健康状态调整当日任务优先级 |
| 教练系统 | `get_coaching_action_items` | 将健康洞察转化为教练行动项 |
| 日程系统 | `get_daily_agenda` | 根据准备度分数优化日程安排 |
| PPV 人生设计 | `get_initiatives` | 将长期健康目标与年度倡议关联 |

## 最佳实践

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

## 技术限制

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

---

<a id='page-finance-management'></a>

## 财务管理

### 相关页面

相关主题：[健康数据集成 (Oura Ring)](#page-health-integration)

<details>
<summary>相关源码文件</summary>

以下源码文件用于生成本页说明：

- [skills/finance-overview/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/finance-overview/SKILL.md)
- [skills/finance-spending/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/finance-spending/SKILL.md)
- [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)
- [AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)
</details>

# 财务管理

## 概述

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

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

资料来源：[README.md]()

## 技能清单

| 技能名称 | 用途 |
|---------|------|
| `finance-overview` | 净资产摘要、账户余额、净值趋势 |
| `finance-spending` | 支出分析、消费模式、近期交易 |

资料来源：[README.md](), [AGENTS.md]()

## 架构设计

### 数据流架构

```mermaid
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工具支撑，其中专门用于财务数据访问的工具包括：

| 工具名称 | 功能描述 |
|---------|---------|
| `get_finance_net_worth` | 获取当前净资产和账户分类 |
| `get_finance_accounts` | 获取所有账户详情 |
| `get_finance_snapshots` | 获取净资产历史快照 |
| `get_finance_daily_spending` | 获取每日支出聚合数据 |
| `get_finance_transactions` | 获取交易记录明细 |

资料来源：[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]()

### 输出内容

| 模块 | 描述 |
|-----|------|
| **Net Worth** | 当前净资产总额及周期变化 |
| **Assets** | 资产总计，按账户类型分类（活期存款、储蓄、投资、退休账户） |
| **Liabilities** | 负债总计，按类型分类（信用卡、贷款） |
| **Trend** | 过去90天净资产走向（增长/下降/稳定） |
| **Accounts** | 账户清单，包含名称、类型、当前余额 |
| **Insights** | 显著变化或规律分析 |

### 数据转换规则

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

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

资料来源：[skills/finance-overview/SKILL.md]()

### 可选参数

| 参数 | 说明 | 默认值 |
|-----|------|-------|
| `$ARGUMENTS` 中的数字 | 覆盖趋势数据天数 | 90天 |

## finance-spending 技能详解

### 功能描述

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

### 核心流程

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

资料来源：[skills/finance-spending/SKILL.md]()

### 输出内容

| 模块 | 描述 |
|-----|------|
| **Summary** | 周期内总收入、总支出、净收入 |
| **Daily Average** | 日均支出金额 |
| **Spending Pattern** | 高消费日识别、消费规律分析 |
| **Recent Transactions** | 最近交易的显著条目 |
| **Insights** | 消费趋势、异常活动、改进建议 |

### 可选参数

| 参数 | 说明 | 默认值 |
|-----|------|-------|
| `$ARGUMENTS` 中的数字 | 指定分析天数 | 30天 |

## MCP 工具详细规格

### get_finance_net_worth

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

**调用方式：**
```json
{
  "name": "get_finance_net_worth",
  "arguments": {}
}
```

**返回值结构：**
```json
{
  "totalNetWorth": 123456789,
  "totalAssets": 150000000,
  "totalLiabilities": 26543211,
  "breakdown": {
    "assets": [...],
    "liabilities": [...]
  }
}
```

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

### get_finance_accounts

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

**调用方式：**
```json
{
  "name": "get_finance_accounts",
  "arguments": {}
}
```

**返回值结构：**
```json
{
  "accounts": [
    {
      "id": "acc_xxx",
      "name": "主要支票账户",
      "type": "checking",
      "balance": 500000
    }
  ]
}
```

### get_finance_snapshots

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

**调用方式：**
```json
{
  "name": "get_finance_snapshots",
  "arguments": {
    "days": 90
  }
}
```

### get_finance_daily_spending

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

**调用方式：**
```json
{
  "name": "get_finance_daily_spending",
  "arguments": {
    "days": 30
  }
}
```

### get_finance_transactions

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

**调用方式：**
```json
{
  "name": "get_finance_transactions",
  "arguments": {
    "limit": 50
  }
}
```

资料来源：[AGENTS.md]()

## 使用示例

### 场景一：查看财务概览

```
用户输入: /finance-overview
```

**执行流程：**

```mermaid
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` 技能联动，在每日训练报告中包含财务健康检查：

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

资料来源：[skills/daily-training-report/SKILL.md]()

## 数据存储规范

### 单位约定

| 数据类型 | 存储单位 | 显示单位 |
|---------|---------|---------|
| 金额 | 美分 (cents) | 美元 (dollars) |
| 百分比 | 基点或小数 | 百分比 |

### 转换函数

```python
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 仓库当前版本。*

---

<a id='page-people-relationships'></a>

## 人际关系管理

### 相关页面

相关主题：[项目与客户管理](#page-project-management)

<details>
<summary>相关源码文件</summary>

以下源码文件用于生成本页说明：

- [skills/contact-lookup/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/contact-lookup/SKILL.md)
- [skills/meeting-prep/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/meeting-prep/SKILL.md)
- [skills/follow-ups/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/follow-ups/SKILL.md)
- [skills/relationship-pulse/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/relationship-pulse/SKILL.md)
- [skills/context-switch/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/context-switch/SKILL.md)
</details>

# 人际关系管理

## 概述

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

人际关系管理功能覆盖了从初次联系到持续维护的完整关系生命周期，支持通过 AI 洞察分析沟通风格和关系状态。资料来源：[README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)

## 核心技能体系

### 技能概览

| 技能名称 | 命令 | 功能描述 |
|---------|------|----------|
| contact-lookup | `/contact-lookup "姓名"` | 完整联系人档案，含 AI 洞察 |
| meeting-prep | `/meeting-prep "姓名"` | 会议准备，含完整上下文和讨论要点 |
| follow-ups | `/follow-ups` | 追踪需要回复的人及客户 |
| relationship-pulse | `/relationship-pulse` | 检查被忽视的关系 |
| context-switch | `/context-switch "客户/项目"` | 快速加载客户或项目的上下文 |

资料来源：[AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)

### 架构流程图

```mermaid
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](https://github.com/starascendin/lifeos-plugin/blob/main/skills/contact-lookup/SKILL.md)

### 工作流程

```mermaid
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
```

### 档案展示结构

| 模块 | 内容说明 |
|------|----------|
| Profile | 姓名、关系类型、联系方式、个人笔记 |
| AI Insights | 沟通风格、性格特征、关系维护建议 |
| Recent Interactions | 按时间排序的语音、会议、消息记录 |
| Meeting History | Granola 会议及关键要点 |
| Chat Threads | Beeper 对话线程链接 |

### 使用要求

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

## 会议准备

### 功能说明

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

资料来源：[skills/meeting-prep/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/meeting-prep/SKILL.md)

### 准备内容

| 类别 | 内容 |
|------|------|
| 联系人档案 | 对方的基本信息和 AI 洞察 |
| 项目上下文 | 相关项目的当前状态和进展 |
| 历史沟通 | Beeper 消息和 Granola 会议记录 |
| 开放任务 | 与对方相关的待处理任务 |
| 讨论要点 | 基于上下文生成的建议话题 |

### MCP 工具依赖

```mermaid
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](https://github.com/starascendin/lifeos-plugin/blob/main/skills/follow-ups/SKILL.md)

### 追踪范围

| 类型 | 说明 |
|------|------|
| 待回复消息 | 对方发送但尚未回复的消息 |
| 会议后续 | 约定但未完成的后续行动 |
| 承诺事项 | 承诺但尚未兑现的承诺 |
| 过期跟进 | 超过预设时间的未跟进记录 |

## 关系健康监测

### 功能说明

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

资料来源：[skills/relationship-pulse/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/relationship-pulse/SKILL.md)

### 健康指标

| 指标 | 定义 | 阈值说明 |
|------|------|----------|
| 互动频率 | 单位时间内与联系人的互动次数 | 低于设定值为警示 |
| 最后互动 | 上次联系距今的时间 | 超过30天为警示 |
| 响应率 | 消息回复比例 | 低于60%为警示 |
| 承诺兑现率 | 承诺事项完成比例 | 低于80%为警示 |

## 快速上下文切换

### 功能说明

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

资料来源：[skills/context-switch/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/context-switch/SKILL.md)

### 上下文内容

| 内容模块 | 说明 |
|----------|------|
| 项目状态 | 当前项目的阶段、里程碑、障碍 |
| 相关任务 | 与该上下文关联的开放任务 |
| 最近更新 | 最近的活动记录和变更 |
| 关键人员 | 项目或客户相关的联系人 |
| 重要文档 | 相关的笔记和文件 |

### 使用场景

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

## MCP 工具集

### 联系人相关工具

| 工具名称 | 功能 | 主要参数 |
|----------|------|----------|
| `get_contact_dossier` | 获取完整联系人档案 | `nameQuery` |
| `get_person_graph` | 获取人物关系图 | `personId` |
| `get_beeper_thread_messages` | 获取聊天消息 | `threadId` |
| `get_granola_meeting` | 获取 Granola 会议 | `meetingId` |
| `get_fathom_meeting` | 获取 Fathom 会议 | `meetingId` |

### 数据模型

```mermaid
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 服务配置

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

### 环境变量配置

| 变量名 | 说明 | 必需 |
|--------|------|------|
| `LIFEOS_CONVEX_URL` | Convex 部署地址 | 是 |
| `LIFEOS_USER_ID` | 用户标识 | 是 |
| `LIFEOS_API_KEY` | API 认证密钥 | 是 |

资料来源：[README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)

## 相关技能索引

| 类别 | 技能 | 关联关系 |
|------|------|----------|
| 日常流程 | daily-standup | 包含人员互动摘要 |
| 客户管理 | client-brief | 整合联系人数据 |
| 客户管理 | client-health | 关系健康指标 |
| 客户管理 | customer-success-triage | 依赖联系人档案 |
| 项目管理 | project-status | 包含项目人员信息 |

## 总结

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

---

---

## Doramagic 踩坑日志

项目：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

<!-- canonical_name: starascendin/lifeos-plugin; human_manual_source: deepwiki_human_wiki -->