{
  "canonical_name": "starascendin/lifeos-plugin",
  "compilation_id": "pack_b23e3019c35b499191de9cb09075ce57",
  "created_at": "2026-05-16T08:56:29.238839+00:00",
  "created_by": "project-pack-compiler",
  "feedback": {
    "carrier_selection_notes": [
      "viable_asset_types=mcp_config, recipe, host_instruction, eval, preflight",
      "recommended_asset_types=mcp_config, recipe, host_instruction, eval, preflight"
    ],
    "evidence_delta": {
      "confirmed_claims": [
        "identity_anchor_present",
        "capability_and_host_targets_present",
        "install_path_declared_or_better"
      ],
      "missing_required_fields": [],
      "must_verify_forwarded": [
        "Run or inspect `npm install -g @starascendin/lifeos-mcp` in an isolated environment.",
        "Confirm the project exposes the claimed capability to at least one target host."
      ],
      "quickstart_execution_scope": "allowlisted_sandbox_smoke",
      "sandbox_command": "npm install -g @starascendin/lifeos-mcp",
      "sandbox_container_image": "node:22-slim",
      "sandbox_execution_backend": "docker",
      "sandbox_planner_decision": "llm_execute_isolated_install",
      "sandbox_validation_id": "sbx_126ecf565e484e4a820ac6b522356e3b"
    },
    "feedback_event_type": "project_pack_compilation_feedback",
    "learning_candidate_reasons": [],
    "template_gaps": []
  },
  "identity": {
    "canonical_id": "project_481454b107c83a3e4d8d870bfb1432a0",
    "canonical_name": "starascendin/lifeos-plugin",
    "homepage_url": null,
    "license": "unknown",
    "repo_url": "https://github.com/starascendin/lifeos-plugin",
    "slug": "lifeos-plugin",
    "source_packet_id": "phit_c14537f473d54a189958fa00fd68413a",
    "source_validation_id": "dval_2b869867bfa14bf0a0a6e55815a364d2"
  },
  "merchandising": {
    "best_for": "需要工具连接与集成能力，并使用 mcp_host的用户",
    "github_forks": 0,
    "github_stars": 0,
    "one_liner_en": "LifeOS plugin - 20 workflow skills and MCP integration for Claude Code, OpenCode, and other AI agents",
    "one_liner_zh": "LifeOS plugin - 20 workflow skills and MCP integration for Claude Code, OpenCode, and other AI agents",
    "primary_category": {
      "category_id": "tool-integrations",
      "confidence": "high",
      "name_en": "Tool Integrations",
      "name_zh": "工具连接与集成",
      "reason": "matched_keywords:mcp, integration, github"
    },
    "target_user": "使用 mcp_host, claude, claude_code 等宿主 AI 的用户",
    "title_en": "lifeos-plugin",
    "title_zh": "lifeos-plugin 能力包",
    "visible_tags": [
      {
        "label_en": "MCP Tools",
        "label_zh": "MCP 工具",
        "source": "repo_evidence_project_characteristics",
        "tag_id": "product_domain-mcp-tools",
        "type": "product_domain"
      },
      {
        "label_en": "Knowledge Base Q&A",
        "label_zh": "知识库问答",
        "source": "repo_evidence_project_characteristics",
        "tag_id": "user_job-knowledge-base-q-a",
        "type": "user_job"
      },
      {
        "label_en": "Workflow Automation",
        "label_zh": "流程自动化",
        "source": "repo_evidence_project_characteristics",
        "tag_id": "core_capability-workflow-automation",
        "type": "core_capability"
      },
      {
        "label_en": "Node-based Workflow",
        "label_zh": "节点式流程编排",
        "source": "repo_evidence_project_characteristics",
        "tag_id": "workflow_pattern-node-based-workflow",
        "type": "workflow_pattern"
      },
      {
        "label_en": "Local-first",
        "label_zh": "本地优先",
        "source": "repo_evidence_project_characteristics",
        "tag_id": "selection_signal-local-first",
        "type": "selection_signal"
      }
    ]
  },
  "packet_id": "phit_c14537f473d54a189958fa00fd68413a",
  "page_model": {
    "artifacts": {
      "artifact_slug": "lifeos-plugin",
      "files": [
        "PROJECT_PACK.json",
        "QUICK_START.md",
        "PROMPT_PREVIEW.md",
        "HUMAN_MANUAL.md",
        "AI_CONTEXT_PACK.md",
        "BOUNDARY_RISK_CARD.md",
        "PITFALL_LOG.md",
        "REPO_INSPECTION.json",
        "REPO_INSPECTION.md",
        "CAPABILITY_CONTRACT.json",
        "EVIDENCE_INDEX.json",
        "CLAIM_GRAPH.json"
      ],
      "required_files": [
        "PROJECT_PACK.json",
        "QUICK_START.md",
        "PROMPT_PREVIEW.md",
        "HUMAN_MANUAL.md",
        "AI_CONTEXT_PACK.md",
        "BOUNDARY_RISK_CARD.md",
        "PITFALL_LOG.md",
        "REPO_INSPECTION.json"
      ]
    },
    "detail": {
      "capability_source": "Project Hit Packet + DownstreamValidationResult",
      "commands": [
        {
          "command": "npm install -g @starascendin/lifeos-mcp",
          "label": "Node.js / npm · 官方安装入口",
          "source": "https://github.com/starascendin/lifeos-plugin#readme",
          "verified": true
        }
      ],
      "display_tags": [
        "MCP 工具",
        "知识库问答",
        "流程自动化",
        "节点式流程编排",
        "本地优先"
      ],
      "eyebrow": "工具连接与集成",
      "glance": [
        {
          "body": "判断自己是不是目标用户。",
          "label": "最适合谁",
          "value": "需要工具连接与集成能力，并使用 mcp_host的用户"
        },
        {
          "body": "先理解能力边界，再决定是否继续。",
          "label": "核心价值",
          "value": "LifeOS plugin - 20 workflow skills and MCP integration for Claude Code, OpenCode, and other AI agents"
        },
        {
          "body": "未完成验证前保持审慎。",
          "label": "继续前",
          "value": "publish to Doramagic.ai project surfaces"
        }
      ],
      "guardrail_source": "Boundary & Risk Card",
      "guardrails": [
        {
          "body": "Prompt Preview 只展示流程，不证明项目已安装或运行。",
          "label": "Check 1",
          "value": "不要把试用当真实运行"
        },
        {
          "body": "mcp_host, claude, claude_code",
          "label": "Check 2",
          "value": "确认宿主兼容"
        },
        {
          "body": "publish to Doramagic.ai project surfaces",
          "label": "Check 3",
          "value": "先隔离验证"
        }
      ],
      "mode": "mcp_config, recipe, host_instruction, eval, preflight",
      "pitfall_log": {
        "items": [
          {
            "body": "项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。",
            "category": "配置坑",
            "evidence": [
              "capability.host_targets | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | host_targets=mcp_host, claude, claude_code"
            ],
            "severity": "medium",
            "suggested_check": "列出会写入的配置文件、目录和卸载/回滚步骤。",
            "title": "可能修改宿主 AI 配置",
            "user_impact": "安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。"
          },
          {
            "body": "README/documentation is current enough for a first validation pass.",
            "category": "能力坑",
            "evidence": [
              "capability.assumptions | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | README/documentation is current enough for a first validation pass."
            ],
            "severity": "medium",
            "suggested_check": "将假设转成下游验证清单。",
            "title": "能力判断依赖假设",
            "user_impact": "假设不成立时，用户拿不到承诺的能力。"
          },
          {
            "body": "未记录 last_activity_observed。",
            "category": "维护坑",
            "evidence": [
              "evidence.maintainer_signals | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | last_activity_observed missing"
            ],
            "severity": "medium",
            "suggested_check": "补 GitHub 最近 commit、release、issue/PR 响应信号。",
            "title": "维护活跃度未知",
            "user_impact": "新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。"
          },
          {
            "body": "no_demo",
            "category": "安全/权限坑",
            "evidence": [
              "downstream_validation.risk_items | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | no_demo; severity=medium"
            ],
            "severity": "medium",
            "suggested_check": "进入安全/权限治理复核队列。",
            "title": "下游验证发现风险项",
            "user_impact": "下游已经要求复核，不能在页面中弱化。"
          },
          {
            "body": "No sandbox install has been executed yet; downstream must verify before user use.",
            "category": "安全/权限坑",
            "evidence": [
              "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."
            ],
            "severity": "medium",
            "suggested_check": "转成明确权限清单和安全审查提示。",
            "title": "存在安全注意事项",
            "user_impact": "用户安装前需要知道权限边界和敏感操作。"
          },
          {
            "body": "no_demo",
            "category": "安全/权限坑",
            "evidence": [
              "risks.scoring_risks | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | no_demo; severity=medium"
            ],
            "severity": "medium",
            "suggested_check": "把风险写入边界卡，并确认是否需要人工复核。",
            "title": "存在评分风险",
            "user_impact": "风险会影响是否适合普通用户安装。"
          },
          {
            "body": "issue_or_pr_quality=unknown。",
            "category": "维护坑",
            "evidence": [
              "evidence.maintainer_signals | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | issue_or_pr_quality=unknown"
            ],
            "severity": "low",
            "suggested_check": "抽样最近 issue/PR，判断是否长期无人处理。",
            "title": "issue/PR 响应质量未知",
            "user_impact": "用户无法判断遇到问题后是否有人维护。"
          },
          {
            "body": "release_recency=unknown。",
            "category": "维护坑",
            "evidence": [
              "evidence.maintainer_signals | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | release_recency=unknown"
            ],
            "severity": "low",
            "suggested_check": "确认最近 release/tag 和 README 安装命令是否一致。",
            "title": "发布节奏不明确",
            "user_impact": "安装命令和文档可能落后于代码，用户踩坑概率升高。"
          }
        ],
        "source": "ProjectPitfallLog + ProjectHitPacket + validation + community signals",
        "summary": "发现 8 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：配置坑 - 可能修改宿主 AI 配置。",
        "title": "踩坑日志"
      },
      "snapshot": {
        "contributors": 2,
        "forks": 0,
        "license": "unknown",
        "note": "站点快照，非实时质量证明；用于开工前背景判断。",
        "stars": 0
      },
      "source_url": "https://github.com/starascendin/lifeos-plugin",
      "steps": [
        {
          "body": "不安装项目，先体验能力节奏。",
          "code": "preview",
          "title": "先试 Prompt"
        },
        {
          "body": "理解输入、输出、失败模式和边界。",
          "code": "manual",
          "title": "读说明书"
        },
        {
          "body": "把上下文交给宿主 AI 继续工作。",
          "code": "context",
          "title": "带给 AI"
        },
        {
          "body": "进入主力环境前先完成安装入口与风险边界验证。",
          "code": "verify",
          "title": "沙箱验证"
        }
      ],
      "subtitle": "LifeOS plugin - 20 workflow skills and MCP integration for Claude Code, OpenCode, and other AI agents",
      "title": "lifeos-plugin 能力包",
      "trial_prompt": "# lifeos-plugin - Prompt Preview\n\n> 复制下面这段 Prompt 到你常用的 AI，先试一次，不需要安装。\n> 它的目标是让你直接体验这个项目的服务方式，而不是阅读项目介绍。\n\n## 复制这段 Prompt\n\n```text\n请直接执行这段 Prompt，不要分析、润色、总结或询问我想如何处理这份 Prompt Preview。\n\n你现在扮演 lifeos-plugin 的“安装前体验版”。\n这不是项目介绍、不是评价报告、不是 README 总结。你的任务是让我用最小成本体验它的核心服务。\n\n我的试用任务：我想用它完成一个真实的工具连接与集成任务。\n我常用的宿主 AI：MCP Client / claude / Claude Code\n\n【体验目标】\n围绕我的真实任务，现场演示这个项目如何把输入转成 步骤建议, 检查清单, 专业工作流。重点是让我感受到工作方式，而不是给我项目背景。\n\n【业务流约束】\n- 你必须像一个正在提供服务的项目能力包，而不是像一个讲解员。\n- 每一轮只推进一个步骤；提出问题后必须停下来等我回答。\n- 每一步都必须让我感受到一个具体服务动作：澄清、整理、规划、检查、判断或收尾。\n- 每一步都要说明：当前目标、你需要我提供什么、我回答后你会产出什么。\n- 不要安装、不要运行命令、不要写代码、不要声称测试通过、不要声称已经修改文件。\n- 需要真实安装或宿主加载后才能验证的内容，必须明确说“这一步需要安装后验证”。\n- 如果我说“用示例继续”，你可以用虚构示例推进，但仍然不能声称真实执行。\n\n【可体验服务能力】\n- AI Skill / Agent 指令资产库: 项目包含可被宿主 AI 读取的 Skill 或 Agent 指令文件，可用于把专业流程带入 Claude、Codex、Cursor 等宿主。 输入：用户任务, 宿主 AI 对话上下文, 项目内 Skill/Agent 文档；输出：步骤建议, 检查清单, 专业工作流。\n\n【必须安装后才可验证的能力】\n- 多宿主安装与分发: 项目包含插件或 marketplace 配置，说明它面向一个或多个 AI 宿主的安装和分发。 输入：宿主 AI 工具, 插件配置, 安装命令；输出：宿主内可发现的插件/技能集合。\n- 命令行启动或安装流程: 项目文档中存在可执行命令，真实使用需要在本地或宿主环境中运行这些命令。 输入：终端环境, 包管理器, 项目依赖；输出：安装结果, 列表/更新/运行结果。\n\n【核心服务流】\n请严格按这个顺序带我体验。不要一次性输出完整流程：\n1. page-introduction：项目介绍。围绕“项目介绍”模拟一次用户任务，不展示安装或运行结果。\n2. page-installation：安装与配置。围绕“安装与配置”模拟一次用户任务，不展示安装或运行结果。\n3. page-mcp-server：MCP 服务器架构。围绕“MCP 服务器架构”模拟一次用户任务，不展示安装或运行结果。\n4. page-daily-workflows：日常管理工作流。围绕“日常管理工作流”模拟一次用户任务，不展示安装或运行结果。\n5. page-review-workflows：复盘与规划工作流。围绕“复盘与规划工作流”模拟一次用户任务，不展示安装或运行结果。\n\n【核心能力体验剧本】\n每一步都必须按“输入 -> 服务动作 -> 中间产物”执行。不要只说流程名：\n1. page-introduction\n输入：用户提供的“项目介绍”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n2. page-installation\n输入：用户提供的“安装与配置”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n3. page-mcp-server\n输入：用户提供的“MCP 服务器架构”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n4. page-daily-workflows\n输入：用户提供的“日常管理工作流”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n5. page-review-workflows\n输入：用户提供的“复盘与规划工作流”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n【项目服务规则】\n这些规则决定你如何服务用户。不要解释规则本身，而要在每一步执行时遵守：\n- 先确认用户任务、输入材料和成功标准，再模拟项目能力。\n- 每一步都必须形成可检查的小产物，并等待用户确认后再继续。\n- 凡是需要安装、调用工具或访问外部服务的能力，都必须标记为安装后验证。\n\n【每一步的服务约束】\n- Step 1 / page-introduction：Step 1 必须围绕“项目介绍”形成一个小中间产物，并等待用户确认。\n- Step 2 / page-installation：Step 2 必须围绕“安装与配置”形成一个小中间产物，并等待用户确认。\n- Step 3 / page-mcp-server：Step 3 必须围绕“MCP 服务器架构”形成一个小中间产物，并等待用户确认。\n- Step 4 / page-daily-workflows：Step 4 必须围绕“日常管理工作流”形成一个小中间产物，并等待用户确认。\n- Step 5 / page-review-workflows：Step 5 必须围绕“复盘与规划工作流”形成一个小中间产物，并等待用户确认。\n\n【边界与风险】\n- 不要声称已经安装、运行、调用 API、读写本地文件或完成真实任务。\n- 安装前预览只能展示工作方式，不能证明兼容性、性能或输出质量。\n- 涉及安装、插件加载、工具调用或外部服务的能力必须安装后验证。\n\n【可追溯依据】\n这些路径只用于你内部校验或在我追问“依据是什么”时简要引用。不要在首次回复主动展开：\n- https://github.com/starascendin/lifeos-plugin\n- https://github.com/starascendin/lifeos-plugin#readme\n- skills/blind-spot-finder/SKILL.md\n- skills/capture/SKILL.md\n- skills/client-brief/SKILL.md\n- skills/client-health/SKILL.md\n- skills/coach-memory/SKILL.md\n- skills/coaching-action-items/SKILL.md\n- skills/coaching-overview/SKILL.md\n- skills/coaching-session-review/SKILL.md\n- skills/contact-lookup/SKILL.md\n- skills/context-switch/SKILL.md\n\n【首次问题规则】\n- 首次三问必须先确认用户目标、成功标准和边界，不要提前进入工具、安装或实现细节。\n- 如果后续需要技术条件、文件路径或运行环境，必须等用户确认目标后再追问。\n\n首次回复必须只输出下面 4 个部分：\n1. 体验开始：用 1 句话说明你将带我体验 lifeos-plugin 的核心服务。\n2. 当前步骤：明确进入 Step 1，并说明这一步要解决什么。\n3. 你会如何服务我：说明你会先改变我完成任务的哪个动作。\n4. 只问我 3 个问题，然后停下等待回答。\n\n首次回复禁止输出：后续完整流程、证据清单、安装命令、项目评价、营销文案、已经安装或运行的说法。\n\nStep 1 / brainstorming 的二轮协议：\n- 我回答首次三问后，你仍然停留在 Step 1 / brainstorming，不要进入 Step 2。\n- 第二次回复必须产出 6 个部分：澄清后的任务定义、成功标准、边界条件、\n  2-3 个可选方案、每个方案的权衡、推荐方案。\n- 第二次回复最后必须问我是否确认推荐方案；只有我明确确认后，才能进入下一步。\n- 第二次回复禁止输出 git worktree、代码计划、测试文件、命令或真实执行结果。\n\n后续对话规则：\n- 我回答后，你先完成当前步骤的中间产物并等待确认；只有我确认后，才能进入下一步。\n- 每一步都要生成一个小的中间产物，例如澄清后的目标、计划草案、测试意图、验证清单或继续/停止判断。\n- 所有演示都写成“我会建议/我会引导/这一步会形成”，不要写成已经真实执行。\n- 不要声称已经测试通过、文件已修改、命令已运行或结果已产生。\n- 如果某个能力必须安装后验证，请直接说“这一步需要安装后验证”。\n- 如果证据不足，请明确说“证据不足”，不要补事实。\n```\n",
      "voices": [
        {
          "body": "当前没有项目级社区来源；不会把未抓取讨论包装成社会证明。",
          "items": [],
          "status": "待发现 Agent 补证",
          "title": "社区讨论"
        }
      ]
    },
    "homepage_card": {
      "category": "工具连接与集成",
      "desc": "LifeOS plugin - 20 workflow skills and MCP integration for Claude Code, OpenCode, and other AI agents",
      "effort": "安装已验证",
      "forks": 0,
      "icon": "link",
      "name": "lifeos-plugin 能力包",
      "risk": "需复核",
      "slug": "lifeos-plugin",
      "stars": 0,
      "tags": [
        "MCP 工具",
        "知识库问答",
        "流程自动化",
        "节点式流程编排",
        "本地优先"
      ],
      "thumb": "gray",
      "type": "MCP 配置"
    },
    "manual": {
      "markdown": "# https://github.com/starascendin/lifeos-plugin 项目说明书\n\n生成时间：2026-05-16 08:40:49 UTC\n\n## 目录\n\n- [项目介绍](#page-introduction)\n- [安装与配置](#page-installation)\n- [MCP 服务器架构](#page-mcp-server)\n- [日常管理工作流](#page-daily-workflows)\n- [复盘与规划工作流](#page-review-workflows)\n- [项目与客户管理](#page-project-management)\n- [语音笔记工作流](#page-voice-notes-workflows)\n- [健康数据集成 (Oura Ring)](#page-health-integration)\n- [财务管理](#page-finance-management)\n- [人际关系管理](#page-people-relationships)\n\n<a id='page-introduction'></a>\n\n## 项目介绍\n\n### 相关页面\n\n相关主题：[安装与配置](#page-installation), [MCP 服务器架构](#page-mcp-server)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n- [AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n- [skills/daily-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)\n- [skills/weekly-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/weekly-plan/SKILL.md)\n- [skills/sprint-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/sprint-plan/SKILL.md)\n- [skills/ppv/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/ppv/SKILL.md)\n- [skills/health-weekly/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-weekly/SKILL.md)\n</details>\n\n# 项目介绍\n\n## 概述\n\nLifeOS Plugin 是一个面向 AI 代理的通用技能与 MCP（Model Context Protocol）集成框架，专为 [LifeOS](https://github.com/starascendin/lifeos-plugin) 个人生产力操作系统设计。该系统由 Convex 驱动，提供 37 种工作流技能，涵盖项目管理、联系人管理、日程安排、语音笔记、健康追踪（Oura Ring）、财务管理、人生教练、人生方向规划等多个领域。\n\n资料来源：[README.md:1-6]()\n\n### 核心定位\n\n| 维度 | 说明 |\n|------|------|\n| **目标用户** | 使用 AI 代理（如 Claude Code、OpenCode）的个人用户 |\n| **技术基础** | Convex 后端 + MCP 协议 |\n| **技能数量** | 37 种工作流技能 + 126 个 MCP 工具 + 28 个 MCP 提示词 |\n| **数据整合** | 项目、任务、周期、阶段、联系人、会议、健康、财务、习惯等 |\n\n资料来源：[README.md:1-10]()\n\n---\n\n## 系统架构\n\n### 技术栈概览\n\n```mermaid\ngraph TD\n    subgraph \"AI 代理层\"\n        A[Claude Code]\n        B[OpenCode]\n    end\n    \n    subgraph \"插件层\"\n        C[LifeOS Plugin Skills]\n        D[MCP Server]\n    end\n    \n    subgraph \"后端服务层\"\n        E[Convex Backend]\n        F[External APIs<br/>Oura Ring, Fathom, Granola, etc.]\n    end\n    \n    A --> C\n    B --> C\n    A --> D\n    B --> D\n    C --> E\n    D --> E\n    E --> F\n    \n    style A fill:#e1f5fe\n    style B fill:#e1f5fe\n    style E fill:#c8e6c9\n```\n\n### 技能调用方式\n\nLifeOS Plugin 支持两种调用方式：\n\n1. **Skill 技能调用**：通过 `/skill-name` 命令直接调用\n2. **MCP 协议调用**：通过 MCP 客户端调用对应工具或提示词\n\n资料来源：[README.md:56-70]()\n\n---\n\n## 技能体系\n\n### 日常管理工作流\n\n| 技能名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| daily-standup | `/daily-standup` | 晨间简报，包含日程、任务和冲刺进度 |\n| daily-plan | `/daily-plan` | 规划今日工作，设置截止日期、优先级、周期分配和每日笔记 |\n| end-of-day | `/end-of-day` | 日终总结，完成情况汇总和明日规划 |\n| capture | `/capture \"想法\"` | 快速捕获想法、任务或笔记，自动路由 |\n\n资料来源：[README.md:38-45]()\n\n**daily-plan 工作流程**：\n\n```mermaid\ngraph TD\n    A[调用 get_planning_context] --> B[构建今日计划]\n    B --> C[选择 Top 3 任务]\n    C --> D[设置截止日期]\n    D --> E[分配周期任务]\n    E --> F[应用规划补丁<br/>apply_planning_patch]\n    F --> G[报告结果]\n    \n    style A fill:#fff3e0\n    style F fill:#c8e6c9\n```\n\n资料来源：[skills/daily-plan/SKILL.md:1-25]()\n\n### 回顾与规划技能\n\n| 技能名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| weekly-review | `/weekly-review` | 回顾本周完成的工作、进行中的项目和冲刺健康度 |\n| weekly-plan | `/weekly-plan` | 规划本周工作，设置当前周期、截止日期、优先级 |\n| monthly-review | `/monthly-review` | 月度回顾，成就、项目进展和下月规划 |\n| cycle-review | `/cycle-review` | 冲刺回顾，包含延期处理选项 |\n| initiative-review | `/initiative-review 2026` | 年度目标按类别回顾 |\n| sprint-plan | `/sprint-plan` | 规划当前冲刺，设置周期目标、任务分配、优先级 |\n\n资料来源：[README.md:46-58]()\n\n**sprint-plan 工作流程**：\n\n```mermaid\ngraph TD\n    A[获取规划上下文] --> B[更新周期目标]\n    B --> C[从待办中拉取任务]\n    C --> D[设置截止日期和优先级]\n    D --> E[应用规划补丁<br/>mode=cycle] --> F[报告结果]\n    \n    style E fill:#c8e6c9\n```\n\n资料来源：[skills/sprint-plan/SKILL.md:1-30]()\n\n### 项目与客户管理\n\n| 技能名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| project-status | `/project-status ACME` | 按阶段分解项目，统计任务和阻塞项 |\n| client-brief | `/client-brief \"Acme Corp\"` | 完整客户简报，包含项目和问题 |\n| client-health | `/client-health` | 所有客户健康度仪表盘 |\n| customer-success-triage | `/customer-success-triage \"Acme Corp\"` | 分拣客户请求，审查聊天、会议、笔记和任务 |\n\n资料来源：[README.md:59-64]()\n\n**customer-success-triage 工作流程**：\n\n```mermaid\ngraph TD\n    A[调用 get_client_success_workspace] --> B[审查工作区]\n    B --> C{需要深入了解?}\n    C -->|聊天| D[获取 Beeper 消息]\n    C -->|会议| E[获取 Fathom/Granola 详情]\n    C -->|笔记| F[获取客户笔记历史]\n    C -->|无需| G[分类整理发现]\n    D --> G\n    E --> G\n    F --> G\n    G --> H[分类结果]\n    \n    style A fill:#fff3e0\n    style H fill:#c8e6c9\n```\n\n资料来源：[skills/customer-success-triage/SKILL.md:1-35]()\n\n### 人际关系与沟通\n\n| 技能名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| contact-lookup | `/contact-lookup \"John\"` | 完整联系人档案，包含 AI 洞察 |\n| meeting-prep | `/meeting-prep \"John\"` | 准备会议，获取完整上下文和讨论要点 |\n| follow-ups | `/follow-ups` | 追踪需要跟进的人员和客户 |\n| relationship-pulse | `/relationship-pulse` | 检查被忽视的关系 |\n| context-switch | `/context-switch \"Acme\"` | 快速加载客户或项目上下文 |\n\n资料来源：[README.md:65-70]()\n\n### 健康追踪\n\n| 技能名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| health-check | `/health-check` | 快速 Oura 健康概览：分数和趋势 |\n| health-weekly | `/health-weekly` | 周健康回顾，包含睡眠、活动、恢复和锻炼洞察 |\n| screentime-report | `/screentime-report` | 屏幕时间分析和顶部应用 |\n| habit-check | `/habit-check` | 每日习惯签到、连续天数追踪和完成情况 |\n| daily-training-report | `/daily-training-report` | 综合训练日报 |\n\n资料来源：[README.md:72-78]()\n\n**health-weekly 数据来源**：\n\n| 数据类型 | MCP 工具 | 数据范围 |\n|----------|----------|----------|\n| 睡眠数据 | `get_health_sleep` | 14天 |\n| 活动数据 | `get_health_activity` | 14天 |\n| 准备度数据 | `get_health_readiness` | 14天 |\n| 压力数据 | `get_health_stress` | 14天 |\n| 锻炼历史 | `get_health_workouts` | 14天 |\n| 心率趋势 | `get_health_heart_rate` | 14天 |\n| 恢复力数据 | `get_health_resilience` | 14天 |\n| VO2 Max | `get_health_vo2_max` | 14天 |\n| 心血管年龄 | `get_health_cardio_age` | 14天 |\n| 血氧数据 | `get_health_spo2` | 14天 |\n\n资料来源：[skills/health-weekly/SKILL.md:1-40]()\n\n### 财务管理\n\n| 技能名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| finance-overview | `/finance-overview` | 净资产、账户概览和趋势 |\n| finance-spending | `/finance-spending` | 支出分析和消费模式 |\n\n资料来源：[README.md:79-81]()\n\n### PPV 人生设计系统\n\nPPV（Purpose, Principles, Vision）是一套人生设计系统，整合愿景、身份、支柱和行动计划。\n\n| 技能名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| ppv | `/ppv` | 管理 PPV 愿景、身份、支柱、项目链接、周行动、反思和调整 |\n\n资料来源：[README.md:96-98]()\n\n**PPV 工作流程**：\n\n```mermaid\ngraph TD\n    A[获取 PPV 工作区] --> B{有活跃愿景?}\n    B -->|无| C[创建新愿景]\n    B -->|有| D[使用活跃愿景图]\n    C --> D\n    D --> E{用户请求类型?}\n    E -->|愿景编辑| F[upsert_ppv_vision]\n    E -->|身份编辑| G[upsert_ppv_identity]\n    E -->|支柱管理| H[创建/更新/删除支柱]\n    E -->|行动执行| I[创建/更新/删除周行动]\n    E -->|反思| J[创建反思和调整]\n    F --> K[更新图谱缓存]\n    G --> K\n    H --> K\n    I --> K\n    J --> K\n    \n    style A fill:#fff3e0\n    style K fill:#c8e6c9\n```\n\n资料来源：[skills/ppv/SKILL.md:1-50]()\n\n### 其他工具技能\n\n| 技能名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| inbox-triage | `/inbox-triage` | 将笔记处理为任务 |\n| overdue | `/overdue` | 逾期和延误项目 |\n| voice-notes | `/voice-notes` | 交互式备忘录探索 |\n| voice-notes-crystallize | `/voice-notes-crystallize` | 保存对话洞察 |\n| coaching-overview | `/coaching-overview` | 教练档案、会议和行动项目 |\n| coaching-action-items | `/coaching-action-items` | 管理教练行动项目 |\n| coaching-session-review | `/coaching-session-review` | 回顾教练会议洞察 |\n| coach-memory | `/coach-memory` | 查看 AI 教练的累积知识 |\n| llm-council | `/llm-council` | 多模型委员会决策 |\n| blind-spot-finder | `/blind-spot-finder` | 多模型盲点发现 |\n\n资料来源：[README.md:82-95]()\n\n---\n\n## MCP 工具集\n\n### 工具覆盖范围\n\n系统提供 **126 个 MCP 工具**，支持以下领域的完整 CRUD 操作：\n\n| 领域 | 覆盖内容 |\n|------|----------|\n| 项目管理 | 项目、任务/问题、周期、阶段 |\n| 联系人 | 人员/联系人 |\n| 内容管理 | 笔记、语音备忘录 |\n| 通讯 | AI 对话摘要、Beeper 线程、Granola 会议 |\n| 目标追踪 | 举措（Initiatives） |\n| 健康数据 | Oura Ring：睡眠、活动、准备度、压力、SpO2、心率、锻炼 |\n| 财务管理 | 账户、净资产、交易、快照、每日支出 |\n| 习惯追踪 | 习惯记录和完成情况 |\n| 屏幕时间 | 应用使用分析 |\n| 教练 | 教练档案和行动项目 |\n| PPV | 人生设计系统全模块 |\n\n资料来源：[AGENTS.md:50-54]()\n\n### MCP 提示词\n\n提供 **28 个 MCP 提示词**，功能与技能相同，但通过 MCP 协议暴露，可被任何 MCP 客户端调用。\n\n---\n\n## 安装与配置\n\n### 前置要求\n\n使用 LifeOS Plugin 需要准备三个凭证：\n\n| 变量名 | 描述 | 获取位置 |\n|--------|------|----------|\n| `LIFEOS_CONVEX_URL` | Convex 部署 URL（`.convex.site`） | Convex 仪表盘 |\n| `LIFEOS_USER_ID` | LifeOS 用户 ID | Convex 仪表盘 > Users 表 |\n| `LIFEOS_API_KEY` | API 认证密钥 | LifeOS 设置中生成 |\n\n资料来源：[README.md:55-66]()\n\n### Claude Code 安装\n\n```bash\nclaude plugin add github:starascendin/lifeos-plugin\n```\n\n设置环境变量：\n\n```bash\nexport LIFEOS_CONVEX_URL=https://your-app.convex.site\nexport LIFEOS_USER_ID=your-user-id\nexport LIFEOS_API_KEY=your-api-key\n```\n\n资料来源：[README.md:15-28]()\n\n### OpenCode 安装\n\n```bash\n# 方式一：复制\ncp -r skills/ .claude/skills/lifeos/\n\n# 方式二：符号链接\nln -s /path/to/lifeos-plugin/skills .claude/skills/lifeos\n```\n\n资料来源：[README.md:21-27]()\n\n### 手动 MCP 配置\n\n```json\n{\n  \"mcpServers\": {\n    \"lifeos\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@starascendin/lifeos-mcp@latest\",\n        \"--url\", \"YOUR_CONVEX_URL\",\n        \"--user-id\", \"YOUR_USER_ID\",\n        \"--api-key\", \"YOUR_API_KEY\"\n      ]\n    }\n  }\n}\n```\n\n或使用环境变量：\n\n```bash\nexport LIFEOS_CONVEX_URL=https://your-app.convex.site\nexport LIFEOS_USER_ID=your-user-id\nexport LIFEOS_API_KEY=your-api-key\n```\n\n资料来源：[README.md:33-50]()\n\n---\n\n## 变更高效工作流\n\n### 变更高效技能\n\n以下技能为**变更高效工作流**，调用时会直接修改 LifeOS 数据，无需确认：\n\n| 技能名称 | 变更高效操作 |\n|----------|--------------|\n| daily-plan | 创建问题、调度任务、分配周期、设置优先级、更新周期目标、保存每日笔记 |\n| weekly-plan | 创建问题、调度任务、分配周期、设置优先级、更新周期目标、保存周笔记 |\n| sprint-plan | 创建问题、分配周期任务、调度任务、设置优先级、更新周期目标 |\n| ppv | 创建/更新愿景、身份、支柱、周行动、反思、调整 |\n\n**重要提示**：这些技能会自动应用变更高效，用户不应在调用后要求确认。\n\n资料来源：[skills/daily-plan/SKILL.md:28-35]()\n\n### 变更高效原则\n\n1. **立即应用**：调用 `apply_planning_patch` 时使用 `dryRun=false`\n2. **直接操作**：使用 `create_issue`、`update_issue`、`schedule_issue` 等工具\n3. **报告结果**：操作完成后报告所有变更摘要\n\n---\n\n## 更新维护\n\n### 更新插件仓库\n\n```bash\ncd /path/to/lifeos-plugin && git pull\n```\n\n### 更新 MCP 服务器\n\nMCP 服务器会自动随 `npx @latest` 更新，或在 `.mcp.json` 中固定版本：\n\n```json\n\"@starascendin/lifeos-mcp@0.7.0\"\n```\n\n资料来源：[README.md:68-75]()\n\n---\n\n## 总结\n\nLifeOS Plugin 将复杂的个人生产力系统封装为 AI 代理可直接调用的技能和工作流。通过 37 种技能、126 个 MCP 工具和 28 个 MCP 提示词，用户可以让 AI 代理帮助管理日常任务、项目、联系人、健康、财务乃至人生规划，实现真正个性化的 AI 辅助生活管理系统。\n\n---\n\n<a id='page-installation'></a>\n\n## 安装与配置\n\n### 相关页面\n\n相关主题：[项目介绍](#page-introduction), [MCP 服务器架构](#page-mcp-server)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n</details>\n\n# 安装与配置\n\n本文档介绍 **lifeos-plugin** 的完整安装与配置流程。该插件为 Claude Code、OpenCode 等 AI 编程助手提供 37 个 Universal Skills，并集成了 126 个 MCP 工具，用于连接 LifeOS 个人生产力操作系统。\n\n## 环境要求\n\n| 组件 | 版本要求 | 说明 |\n|------|---------|------|\n| Node.js | ≥ 18.x | 用于运行 npx 命令 |\n| npm/yarn | 最新稳定版 | 包管理器 |\n| Convex 账户 | 有效订阅 | LifeOS 后端服务 |\n| AI 助手 | Claude Code 或 OpenCode | 作为插件宿主 |\n\n## 环境变量配置\n\n在开始安装之前，需要准备以下环境变量。这些变量用于连接 LifeOS 的 Convex 后端服务。\n\n### 必需的环境变量\n\n```bash\n# Convex 部署 URL\nexport LIFEOS_CONVEX_URL=https://your-app.convex.site\n\n# LifeOS 用户 ID\nexport LIFEOS_USER_ID=your-user-id\n\n# Convex API 密钥\nexport LIFEOS_API_KEY=your-api-key\n```\n\n### 配置说明\n\n| 变量名 | 用途 | 获取方式 |\n|--------|------|----------|\n| `LIFEOS_CONVEX_URL` | Convex 项目的访问地址 | Convex Dashboard → 项目设置 → 部署 URL |\n| `LIFEOS_USER_ID` | 用户唯一标识符 | LifeOS 应用内用户设置 |\n| `LIFEOS_API_KEY` | API 认证密钥 | Convex Dashboard → API Keys |\n\n资料来源：[README.md:1-6]()\n\n## Claude Code 安装\n\nClaude Code 是 Anthropic 官方提供的命令行工具，支持通过插件机制扩展功能。\n\n### 安装命令\n\n```bash\nclaude plugin add github:starascendin/lifeos-plugin\n```\n\n### 安装后配置\n\n1. 确保环境变量已正确设置\n2. 重启 Claude Code 会话以加载插件\n3. 验证安装：运行 `/help` 或任意 LifeOS skill（如 `/daily-plan`）\n\n资料来源：[README.md:26-29]()\n\n## OpenCode 安装\n\nOpenCode 支持原生读取 `.claude/skills/` 目录，需要将 skills 目录复制或符号链接到正确位置。\n\n### 方式一：复制（推荐用于独立使用）\n\n```bash\ncp -r skills/ .claude/skills/lifeos/\n```\n\n### 方式二：符号链接（推荐用于开发或同步更新）\n\n```bash\nln -s /path/to/lifeos-plugin/skills .claude/skills/lifeos\n```\n\n### 链接结构示意\n\n```mermaid\ngraph LR\n    A[lifeos-plugin<br/>skills/] -->|ln -s| B[.claude/skills/lifeos]\n    B -->|引用| A\n```\n\n资料来源：[README.md:33-42]()\n\n## MCP 服务器配置\n\nlifeos-plugin 通过 MCP (Model Context Protocol) 协议提供服务。配置 MCP 服务器有三种方式：\n\n### 方式一：MCP 配置文件（JSON）\n\n在 AI 助手的 MCP 配置文件中添加以下内容：\n\n```json\n{\n  \"mcpServers\": {\n    \"lifeos\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@starascendin/lifeos-mcp@latest\",\n        \"--url\", \"YOUR_CONVEX_URL\",\n        \"--user-id\", \"YOUR_USER_ID\",\n        \"--api-key\", \"YOUR_API_KEY\"\n      ]\n    }\n  }\n}\n```\n\n### 方式二：环境变量（推荐）\n\n将环境变量写入 shell 配置文件（如 `~/.bashrc`、`~/.zshrc` 或 `~/.config/fish/config.fish`）：\n\n```bash\n# ~/.zshrc 或 ~/.bashrc\nexport LIFEOS_CONVEX_URL=https://your-app.convex.site\nexport LIFEOS_USER_ID=your-user-id\nexport LIFEOS_API_KEY=your-api-key\n```\n\n然后重新加载配置：\n\n```bash\nsource ~/.zshrc  # 或 source ~/.bashrc\n```\n\n### 方式三：项目级配置\n\n在项目根目录创建 `.env` 文件（需确保 `.gitignore` 包含此文件）：\n\n```bash\nLIFEOS_CONVEX_URL=https://your-app.convex.site\nLIFEOS_USER_ID=your-user-id\nLIFEOS_API_KEY=your-api-key\n```\n\n资料来源：[README.md:45-60]()\n\n## 手动安装\n\n对于不支持插件机制的 AI 助手，可以采用手动安装方式：\n\n### 安装步骤\n\n| 步骤 | 操作 | 说明 |\n|------|------|------|\n| 1 | 复制 skills 目录 | 将 `skills/` 目录复制到 AI 助手的 skills 位置 |\n| 2 | 配置 MCP 服务器 | 设置环境变量或 MCP 配置文件 |\n| 3 | 验证连接 | 运行一个 skill 验证 MCP 连接 |\n\n### 目录结构要求\n\n```\nyour-agent/\n├── skills/\n│   ├── lifeos/           # 复制或链接自 lifeos-plugin\n│   │   ├── daily-plan/\n│   │   ├── weekly-plan/\n│   │   ├── sprint-plan/\n│   │   ├── ppv/\n│   │   └── ... (共37个skills)\n│   └── ...\n```\n\n## 插件更新\n\n### 更新插件仓库\n\n```bash\n# 进入插件目录\ncd /path/to/lifeos-plugin\n\n# 拉取最新代码\ngit pull\n```\n\n### 更新 MCP 服务器\n\nMCP 服务器默认使用 `@latest` 标签，会自动更新。如需固定版本：\n\n```json\n{\n  \"mcpServers\": {\n    \"lifeos\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@starascendin/lifeos-mcp@0.7.0\",  // 固定版本号\n        \"--url\", \"YOUR_CONVEX_URL\",\n        \"--user-id\", \"YOUR_USER_ID\",\n        \"--api-key\", \"YOUR_API_KEY\"\n      ]\n    }\n  }\n}\n```\n\n资料来源：[README.md:107-116]()\n\n## 配置验证\n\n安装完成后，可以通过以下方式验证配置是否正确：\n\n### 验证 MCP 连接\n\n在 AI 助手中运行以下命令之一：\n\n| Skill 名称 | 命令 | 验证内容 |\n|------------|------|---------|\n| 健康检查 | `/health-check` | MCP 连接、Oura Ring 数据 |\n| 日常计划 | `/daily-plan` | 计划上下文、任务数据 |\n| 联系查询 | `/contact-lookup \"测试用户\"` | 联系人数据 |\n\n### 预期输出\n\n如果配置正确，应该能看到：\n- 当前周期的任务列表\n- 本周的每日计划\n- 健康/财务/习惯等数据摘要\n\n如果出现连接错误，请检查：\n1. 环境变量是否正确设置\n2. Convex URL 是否可访问\n3. API Key 是否有效且未过期\n\n## 故障排除\n\n| 问题 | 可能原因 | 解决方案 |\n|------|---------|---------|\n| MCP 服务器无法启动 | npx 未安装或版本过低 | 安装 Node.js 18+ |\n| 认证失败 | API Key 无效 | 在 Convex Dashboard 重新生成 |\n| 插件命令未识别 | Claude Code 版本过低 | 更新到最新版本 |\n| Skills 未显示 | 路径配置错误 | 检查 `.claude/skills/` 目录结构 |\n\n## 快速开始流程\n\n```mermaid\ngraph TD\n    A[准备 Convex 凭据] --> B[设置环境变量]\n    B --> C{选择安装方式}\n    C -->|Claude Code| D[运行 plugin add 命令]\n    C -->|OpenCode| E[复制或链接 skills 目录]\n    C -->|手动安装| F[复制 skills + 配置 MCP]\n    D --> G[重启 AI 助手]\n    E --> G\n    F --> G\n    G --> H[验证安装 - 运行任意 Skill]\n```\n\n按照上述流程完成配置后，即可使用全部 37 个 Universal Skills 和 126 个 MCP 工具。\n\n---\n\n<a id='page-mcp-server'></a>\n\n## MCP 服务器架构\n\n### 相关页面\n\n相关主题：[项目介绍](#page-introduction), [安装与配置](#page-installation)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n- [AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n- [.mcp.json.example](https://github.com/starascendin/lifeos-plugin/blob/main/.mcp.json.example)\n- [skills/daily-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)\n- [skills/weekly-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/weekly-plan/SKILL.md)\n- [skills/sprint-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/sprint-plan/SKILL.md)\n</details>\n\n# MCP 服务器架构\n\n本文档介绍 LifeOS Plugin 中 MCP（Model Context Protocol）服务器的架构设计、配置方式以及工具生态。\n\n## 概述\n\nMCP 服务器是 LifeOS Plugin 的核心基础设施，它作为 AI Agent 与 LifeOS 后端服务之间的桥梁，通过标准化的协议实现双向通信。服务器采用 MCP 协议暴露 126 个工具（Tools）和 28 个提示（Prompts），使各类 AI 客户端（如 Claude Code、OpenCode 等）能够访问和操作 LifeOS 中的数据与工作流程。\n\n资料来源：[AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n\n## 系统架构\n\n### 整体架构图\n\n```mermaid\ngraph TD\n    subgraph \"AI 客户端层\"\n        A[\"Claude Code / OpenCode\"]\n        B[\"其他 MCP 兼容客户端\"]\n    end\n    \n    subgraph \"MCP 服务器层\"\n        C[\"@starascendin/lifeos-mcp\"]\n    end\n    \n    subgraph \"LifeOS 后端\"\n        D[\"Convex 部署\"]\n        E[\"数据存储\"]\n        F[\"业务逻辑\"]\n    end\n    \n    A --> C\n    B --> C\n    C --> D\n    D --> E\n    D --> F\n    \n    G[\"环境变量配置\"] -.-> C\n```\n\n### 组件说明\n\n| 组件 | 描述 | 技术实现 |\n|------|------|----------|\n| MCP 服务器 | 核心协议转换层 | Node.js (npx @starascendin/lifeos-mcp) |\n| Convex 后端 | 数据存储与业务逻辑 | Convex 平台 |\n| MCP 客户端 | AI Agent 集成 | Claude Code、OpenCode 等 |\n| 认证层 | API 身份验证 | API Key + User ID |\n\n## 快速启动\n\n### 安装命令\n\n通过 Claude Code 安装插件：\n\n```bash\nclaude plugin add github:starascendin/lifeos-plugin\n```\n\n资料来源：[README.md:27](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L27)\n\n### 环境变量配置\n\n配置三个必需的环境变量以启用 MCP 服务器认证：\n\n```bash\nexport LIFEOS_CONVEX_URL=https://your-app.convex.site\nexport LIFEOS_USER_ID=your-user-id\nexport LIFEOS_API_KEY=your-api-key\n```\n\n资料来源：[README.md:1-8](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L1-L8)\n\n### MCP 服务器配置文件\n\n在项目根目录创建 `.mcp.json` 文件：\n\n```json\n{\n  \"mcpServers\": {\n    \"lifeos\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@starascendin/lifeos-mcp@latest\",\n        \"--url\", \"YOUR_CONVEX_URL\",\n        \"--user-id\", \"YOUR_USER_ID\",\n        \"--api-key\", \"YOUR_API_KEY\"\n      ]\n    }\n  }\n}\n```\n\n资料来源：[README.md:52-65](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L52-L65)\n\n## MCP 工具生态\n\n### 工具分类总览\n\nMCP 服务器提供 126 个工具，分为以下主要类别：\n\n| 类别 | 工具数量 | 主要功能 |\n|------|----------|----------|\n| 项目管理 | ~20+ | 项目的创建、读取、更新、删除 |\n| 任务/事项 | ~20+ | 任务的 CRUD 操作、状态变更 |\n| 周期管理 | ~10+ | 冲刺/周期的规划与追踪 |\n| 客户管理 | ~10+ | 客户信息、健康度评估 |\n| 人员/联系人 | ~10+ | 联系人的完整资料查询 |\n| 笔记 | ~10+ | 笔记的创建与关联 |\n| 语音备忘录 | ~10+ | 语音转录、标签分类 |\n| 健康数据 | ~15+ | Oura Ring 数据集成 |\n| 财务管理 | ~10+ | 账户、净值、交易记录 |\n| 习惯追踪 | ~5+ | 习惯完成率、连续天数 |\n| 屏幕时间 | ~3+ | 应用使用分析 |\n| 教练系统 | ~10+ | 教练档案、会话、行动项 |\n| PPV 生活设计 | ~10+ | 愿景、身份、支柱管理 |\n\n资料来源：[AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n\n### 核心规划工具\n\nMCP 服务器提供了强大的规划工具集，用于支持各类规划工作流：\n\n#### 1. 规划上下文获取工具\n\n`get_planning_context` 是最核心的上下文获取工具，支持丰富的筛选参数：\n\n```javascript\nget_planning_context({\n  date?: string,           // 指定日期\n  weekStartDate?: string,  // 周起始日期\n  include: {\n    daily: boolean,        // 每日视图数据\n    weekly: boolean,       // 每周视图数据\n    currentCycle: boolean,  // 当前冲刺/周期数据\n    backlog: boolean,      // 待办事项池\n    habits: boolean,       // 习惯数据\n    dailyFields: boolean,   // 每日字段配置\n    calendar: boolean,      // 日历事件\n    voiceMemos: boolean     // 语音备忘录\n  }\n})\n```\n\n资料来源：[skills/daily-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)\n\n#### 2. 规划变更应用工具\n\n`apply_planning_patch` 是用于执行变更的核心工具：\n\n| 操作类型 | 方法 | 用途 |\n|----------|------|------|\n| 创建任务 | `create_issue` | 新建工作项 |\n| 调度任务 | `schedule_issue` | 设置截止日期 |\n| 更新任务 | `update_issue` | 修改状态、优先级、估算 |\n| 周期分配 | `assign_issue_to_current_cycle` | 将任务分配到当前周期 |\n| 优先级设置 | `set_top_priority` | 设置今日 Top 3 |\n| 周期目标更新 | `update_cycle_goals` | 更新冲刺目标 |\n| 每日笔记保存 | `save_daily_note` | 保存每日议程笔记 |\n| 周笔记保存 | `save_weekly_note` | 保存每周计划笔记 |\n| 评论添加 | `add_issue_comment` | 添加规划说明 |\n\n资料来源：[skills/daily-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)\n\n### 健康数据集成工具\n\nOura Ring 健康数据的完整集成：\n\n| 健康指标 | 工具方法 | 数据范围 |\n|----------|----------|----------|\n| 睡眠数据 | `get_health_sleep` | 得分、时长、入睡时间、呼吸率 |\n| 活动数据 | `get_health_activity` | 步数、卡路里、活动天数 |\n| 就绪度 | `get_health_readiness` | 得分趋势、压力与恢复平衡 |\n| 压力数据 | `get_health_stress` | 压力水平、日间恢复 |\n| 心率 | `get_health_heart_rate` | 心率趋势 |\n| 韧性 | `get_health_resilience` | 韧性水平及其贡献因素 |\n| VO2 Max | `get_health_vo2_max` | 有氧能力估计 |\n| 心血管年龄 | `get_health_cardio_age` | 心血管健康评估 |\n| 血氧 | `get_health_spo2` | SpO2、呼吸障碍指数 |\n| 锻炼记录 | `get_health_workouts` | 锻炼历史记录 |\n\n资料来源：[skills/health-weekly/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-weekly/SKILL.md)\n\n### PPV 生活设计工具\n\nPPV（Purpose, Principles, Vision）是一套完整的人生设计系统：\n\n| 操作 | 工具方法 | 描述 |\n|------|----------|------|\n| 获取工作空间 | `get_ppv_workspace` | 获取完整的 PPV 数据结构 |\n| 获取愿景图谱 | `get_active_vision_graph` | 获取活跃愿景的关联图 |\n| 创建/更新愿景 | `upsert_ppv_vision` | 愿景应该是生动的、情感的、有方向性的 |\n| 创建/更新身份 | `upsert_ppv_identity` | 核心身份、信念、行为 |\n| 创建/更新支柱 | `create_ppv_pillar` / `update_ppv_pillar` / `delete_ppv_pillar` | 支柱是持续运行的系统 |\n| 每周行动管理 | `create_ppv_weekly_action` / `update_ppv_weekly_action` / `delete_ppv_weekly_action` | 小而具体的行动 |\n| 反思记录 | `create_ppv_reflection` | 每周能量、阻力、一致性、动力 |\n| 调整记录 | `create_ppv_adjustment` | 根据反思调整身份、支柱、项目、行动 |\n\n资料来源：[skills/ppv/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/ppv/SKILL.md)\n\n## MCP 提示（Prompts）\n\n除了 126 个工具外，MCP 服务器还暴露了 28 个提示，这些提示封装了完整的工作流逻辑：\n\n### 每日工作流提示\n\n| 提示名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| `daily-standup` | `/daily-standup` | 晨会简报，包含议程、任务、冲刺进度 |\n| `daily-plan` | `/daily-plan` | 今日计划，设置截止日期、优先级、周期分配 |\n| `end-of-day` | `/end-of-day` | 每日收尾，完成总结与明日计划 |\n| `capture` | `/capture \"内容\"` | 快速捕获想法、任务或笔记，自动路由 |\n\n资料来源：[README.md:17-23](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L17-L23)\n\n### 回顾与计划提示\n\n| 提示名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| `weekly-review` | `/weekly-review` | 完成工作、进行中项、冲刺健康度 |\n| `weekly-plan` | `/weekly-plan` | 周计划，设置周期、截止日期、优先级 |\n| `monthly-review` | `/monthly-review` | 月度成就、项目进度、下月规划 |\n| `cycle-review` | `/cycle-review` | 冲刺回顾，包含延续选项 |\n| `initiative-review` | `/initiative-review 2026` | 年度目标分类查看 |\n\n资料来源：[README.md:24-35](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L24-L35)\n\n### 客户与项目管理提示\n\n| 提示名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| `project-status` | `/project-status ACME` | 阶段分解、任务统计、阻塞项 |\n| `client-brief` | `/client-brief \"Acme Corp\"` | 客户项目、沟通、健康度 |\n| `client-health` | `/client-health` | 全客户健康度仪表盘 |\n| `sprint-plan` | `/sprint-plan` | 周期计划：目标、回溯、截止日期、优先级 |\n| `customer-success-triage` | `/customer-success-triage \"Acme Corp\"` | 使用聊天、会议、笔记、开放任务进行分类 |\n\n资料来源：[README.md:36-46](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L36-L46)\n\n## 工作流集成\n\n### 技能与 MCP 工具的关系\n\nSkills（技能）是对 MCP 工具的高级封装，每个 Skill 通常会组合使用多个 MCP 工具来完成复杂任务：\n\n```mermaid\ngraph LR\n    A[\"Skill 调用\"] --> B[\"get_planning_context\"]\n    A --> C[\"业务逻辑处理\"]\n    A --> D[\"apply_planning_patch\"]\n    A --> E[\"其他数据工具\"]\n    \n    B --> F[\"获取 LifeOS 数据\"]\n    D --> G[\"写入 LifeOS 数据\"]\n    E --> F\n    E --> G\n```\n\n### 典型规划工作流\n\n以 `daily-plan` 为例，展示 MCP 工具的典型使用模式：\n\n```mermaid\nsequenceDiagram\n    participant S as Skill\n    participant MCP as MCP Server\n    participant LifeOS as Convex Backend\n    \n    S->>MCP: get_planning_context()\n    MCP->>LifeOS: 查询规划上下文数据\n    LifeOS-->>MCP: 返回每日/每周/周期/待办数据\n    MCP-->>S: 完整上下文对象\n    \n    S->>S: 分析数据，构建日计划\n    Note over S: 选取 Top 3<br/>安排任务调度<br/>调整周期分配\n    \n    S->>MCP: apply_planning_patch(mode=\"day\")\n    Note over MCP: create_issue<br/>schedule_issue<br/>set_top_priority<br/>save_daily_note\n    MCP->>LifeOS: 执行变更操作\n    LifeOS-->>MCP: 确认变更\n    MCP-->>S: 返回变更结果\n```\n\n资料来源：[skills/daily-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)\n\n## 图谱查询工具\n\nMCP 服务器提供了强大的图谱查询功能，用于理解实体之间的关系：\n\n| 工具方法 | 用途 |\n|----------|------|\n| `get_active_vision_graph` | 获取活跃或选定愿景的统一图谱，包含 PPV 节点及关联的项目、事项、语音备忘录 |\n| `get_project_graph` | 以项目为中心的图谱邻域 |\n| `get_initiative_graph` | 以倡议为中心的图谱邻域 |\n| `get_person_graph` | 关系/联系人上下文图谱 |\n| `get_voice_memo_graph` | 以语音备忘录为中心的图谱邻域 |\n| `get_unified_life_graph` | 整体系统分析或导出（重量级操作） |\n\n资料来源：[skills/ppv/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/ppv/SKILL.md)\n\n## 客户端集成\n\n### Claude Code 集成\n\nClaude Code 通过插件机制直接集成 MCP 服务器：\n\n```bash\n# 安装插件（自动配置 MCP 服务器和技能）\nclaude plugin add github:starascendin/lifeos-plugin\n```\n\n安装后，Claude Code 自动获得：\n- 37 个技能（Skills）\n- 126 个 MCP 工具\n- 28 个 MCP 提示\n\n资料来源：[README.md:27-30](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L27-L30)\n\n### OpenCode 集成\n\nOpenCode 原生读取 `.claude/skills/` 目录：\n\n```bash\n# 方式 A：复制技能目录\ncp -r skills/ .claude/skills/lifeos/\n\n# 方式 B：符号链接（推荐，便于更新）\nln -s /path/to/lifeos-plugin/skills .claude/skills/lifeos\n```\n\n资料来源：[README.md:35-44](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L35-L44)\n\n## 更新维护\n\n### 插件更新\n\n```bash\n# 更新插件仓库\ncd /path/to/lifeos-plugin && git pull\n\n# MCP 服务器自动更新（使用 npx @latest）\n# 或在 .mcp.json 中锁定版本\n```\n\n资料来源：[AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n\n## 总结\n\nMCP 服务器架构是 LifeOS Plugin 的核心通信层，它通过 MCP 协议标准化的接口，将 LifeOS 的全部功能暴露给各类 AI 客户端。架构设计的关键特点包括：\n\n1. **标准化协议**：采用 MCP 协议，确保与多种 AI 客户端的兼容性\n2. **丰富的工具集**：126 个工具覆盖项目管理、健康数据、财务、习惯等全生活领域\n3. **封装的工作流**：28 个提示封装了完整的规划、回顾、管理流程\n4. **灵活的认证**：基于环境变量的 API Key + User ID 认证机制\n5. **图谱能力**：支持实体间关系的图谱查询，便于理解复杂关联\n\n---\n\n<a id='page-daily-workflows'></a>\n\n## 日常管理工作流\n\n### 相关页面\n\n相关主题：[复盘与规划工作流](#page-review-workflows)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [skills/daily-standup/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-standup/SKILL.md)\n- [skills/daily-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)\n- [skills/end-of-day/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/end-of-day/SKILL.md)\n- [skills/capture/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/capture/SKILL.md)\n- [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n- [AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n</details>\n\n# 日常管理工作流\n\n## 概述\n\n日常管理工作流是 LifeOS Plugin 为个人生产力管理提供的核心技能集合，涵盖从每日晨会到日终复盘的完整工作周期。这些工作流通过 MCP（Model Context Protocol）工具与 Convex 后端交互，实现任务的查看、创建、更新和调度操作。四个核心技能共同构成了一个闭环的每日生产力管理系统，帮助用户高效规划一天、跟踪进度并在一天结束时进行总结反思。\n\n## 核心技能架构\n\nLifeOS Plugin 的日常管理工作流包含四个相互关联的技能，每个技能针对工作日的不同阶段：\n\n| 技能名称 | 功能描述 | 工作流类型 |\n|---------|---------|-----------|\n| `daily-standup` | 晨间简报，包含议程、任务和迭代进度 | 只读查询 |\n| `daily-plan` | 规划今日工作，修改截止日期、优先级、周期分配和每日笔记 | 变异操作 |\n| `end-of-day` | 日终总结，包含完成情况汇总和明日计划 | 变异操作 |\n| `capture` | 快速捕获想法、任务或笔记，自动路由到适当位置 | 变异操作 |\n\n资料来源：[README.md:14-25]()\n\n### 技能调用流程图\n\n```mermaid\ngraph TD\n    A[开始新的一天] --> B[daily-standup<br/>晨间简报]\n    B --> C{查看任务和进度}\n    C --> D[daily-plan<br/>今日规划]\n    D --> E{捕获临时想法}\n    E --> F[capture<br/>快速捕获]\n    F --> G[执行工作]\n    G --> H[end-of-day<br/>日终复盘]\n    H --> I[结束一天<br/>进入明日循环]\n```\n\n## 晨间简报（daily-standup）\n\n### 功能说明\n\n`daily-standup` 技能提供每日的站立会议式简报，帮助用户快速了解当天的任务概览和迭代进度。该技能通过调用 LifeOS MCP 工具收集当日议程、任务列表、逾期任务和当前迭代周期信息，并以结构化格式呈现。\n\n资料来源：[skills/daily-standup/SKILL.md:1-7]()\n\n### 使用的 MCP 工具\n\n| MCP 工具 | 用途 |\n|---------|-----|\n| `get_daily_agenda` | 获取今日议程，包含今日截止的任务和日历事件 |\n| `get_todays_tasks` | 获取今日任务列表 |\n| `get_overdue_tasks` | 获取已逾期的开放任务 |\n| `get_current_cycle` | 获取当前迭代周期进度和统计 |\n\n资料来源：[skills/daily-standup/SKILL.md:8-11]()\n\n### 输出格式\n\n晨间简报的输出包含以下五个核心部分：\n\n1. **Today's Focus** — 今日重点关注的 3 项事务\n2. **Tasks Due** — 今日截止的任务列表，含优先级标记\n3. **Overdue** — 需要立即处理的逾期任务\n4. **Sprint Progress** — 迭代完成百分比和关键统计\n5. **Calendar** — 今日会议或事件安排\n\n该技能支持通过 `$ARGUMENTS` 参数指定特定日期，默认为当天日期。\n\n## 今日规划（daily-plan）\n\n### 功能说明\n\n`daily-plan` 是日常管理工作流中的核心变异技能，用于在获取规划上下文后对 LifeOS 进行实际的变更操作。这是一个完全自动化的变异工作流，执行后不会请求用户确认。\n\n资料来源：[skills/daily-plan/SKILL.md:1-5]()\n\n### 工作流程\n\n```mermaid\ngraph TD\n    A[调用 get_planning_context] --> B[收集规划上下文]\n    B --> C[构建今日计划]\n    C --> D{创建/调度/分配任务}\n    C --> E{设置优先级}\n    C --> F{更新周期目标}\n    C --> G{保存每日笔记}\n    D --> H[apply_planning_patch<br/>dryRun=false]\n    E --> H\n    F --> H\n    G --> H\n    H --> I[报告变更结果]\n```\n\n### 规划上下文参数\n\n调用 `get_planning_context` 时使用的参数配置：\n\n| 参数 | 值 | 说明 |\n|-----|-----|-----|\n| `date` | `$ARGUMENTS` 或当天 | 规划日期 |\n| `include.daily` | `true` | 包含每日信息 |\n| `include.weekly` | `true` | 包含周度信息 |\n| `include.currentCycle` | `true` | 包含当前迭代周期 |\n| `include.backlog` | `true` | 包含待办列表 |\n| `include.habits` | `true` | 包含习惯追踪 |\n| `include.dailyFields` | `true` | 包含每日字段 |\n| `include.calendar` | `true` | 包含日历事件 |\n| `include.voiceMemos` | `true` | 包含语音备忘录 |\n\n资料来源：[skills/daily-plan/SKILL.md:8-18]()\n\n### 支持的变异操作\n\n通过 `apply_planning_patch` 的 `mode=\"day\"` 可以执行以下操作：\n\n| 操作类型 | MCP 工具 | 用途 |\n|---------|---------|-----|\n| 创建任务 | `create_issue` | 创建新的任务记录 |\n| 调度任务 | `schedule_issue` | 设置任务截止日期 |\n| 更新任务 | `update_issue` | 修改任务状态、优先级、估算和标题 |\n| 分配周期 | `assign_issue_to_current_cycle` | 将任务分配到当前活跃迭代 |\n| 设置优先级 | `set_top_priority` | 设置今日 Top 3 优先级 |\n| 更新周期目标 | `update_cycle_goals` | 修改活跃迭代的目标 |\n| 保存每日笔记 | `save_daily_note` | 写入最终可读的日计划到议程笔记 |\n| 添加任务评论 | `add_issue_comment` | 添加规划理由到任务 |\n\n资料来源：[skills/daily-plan/SKILL.md:24-35]()\n\n### 规划原则\n\n规划今日工作时需要遵循以下原则：\n\n- 从规划上下文中选取今日最重要的 3 项事务\n- 通过设置 `dueDate` 来安排任务的执行时间\n- 将相关的待办工作拉入当前活跃迭代周期\n- 如果计划改变了迭代焦点，需同步更新当前迭代目标\n- 根据今日日历和当前迭代的工作负载保持计划现实可行\n\n资料来源：[skills/daily-plan/SKILL.md:13-21]()\n\n## 日终复盘（end-of-day）\n\n### 功能说明\n\n`end-of-day` 技能用于日终收尾，包含今日完成情况汇总和明日规划。这是一个变异工作流，会对 LifeOS 进行实际的记录和更新操作。\n\n资料来源：[README.md:18-19]()\n\n### 核心功能\n\n1. **完成情况汇总** — 总结当日完成的任务和未完成的工作\n2. **明日计划准备** — 为第二天的工作做好初步规划\n3. **更新迭代状态** — 记录迭代进度和任何变更\n\n## 快速捕获（capture）\n\n### 功能说明\n\n`capture` 技能提供了一种快速记录想法、任务或笔记的方式，并具备自动路由到适当位置的能力。这对于在执行工作过程中快速捕获灵感或临时任务特别有用。\n\n资料来源：[README.md:21-22]()\n\n### 自动路由机制\n\n捕获的内容会根据类型自动路由到不同的目的地：\n\n| 内容类型 | 路由目标 |\n|---------|---------|\n| 临时想法 | 笔记系统或语音备忘录 |\n| 待办任务 | 自动创建为 Issue 或添加到待办列表 |\n| 会议要点 | 关联到相关项目或联系人 |\n| 客户信息 | 客户端工作区笔记 |\n\n### 使用场景\n\n- 在专注工作时突然出现的想法\n- 会议中快速记录的要点\n- 客户沟通时的新需求或反馈\n- 任何需要稍后处理但不应打断当前流程的信息\n\n## 集成与配置\n\n### MCP 服务器配置\n\n日常管理工作流依赖于 LifeOS MCP 服务器的正常运行。配置方式有两种：\n\n**方式一：MCP 服务器配置（JSON）**\n\n```json\n{\n  \"mcpServers\": {\n    \"lifeos\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@starascendin/lifeos-mcp@latest\",\n        \"--url\", \"YOUR_CONVEX_URL\",\n        \"--user-id\", \"YOUR_USER_ID\",\n        \"--api-key\", \"YOUR_API_KEY\"\n      ]\n    }\n  }\n}\n```\n\n资料来源：[README.md:52-63]()\n\n**方式二：环境变量配置**\n\n```bash\nexport LIFEOS_CONVEX_URL=https://your-app.convex.site\nexport LIFEOS_USER_ID=your-user-id\nexport LIFEOS_API_KEY=your-api-key\n```\n\n资料来源：[README.md:37-40]()\n\n### Claude Code 集成\n\n```bash\nclaude plugin add github:starascendin/lifeos-plugin\n```\n\n### OpenCode 集成\n\nOpenCode 原生读取 `.claude/skills/` 目录，复制或符号链接 skills 目录：\n\n```bash\n# 复制方式\ncp -r skills/ .claude/skills/lifeos/\n\n# 符号链接方式\nln -s /path/to/lifeos-plugin/skills .claude/skills/lifeos\n```\n\n资料来源：[README.md:43-50]()\n\n## 与其他工作流的协同\n\n日常管理工作流并非孤立存在，它们与 LifeOS Plugin 提供的其他工作流形成完整的生产力管理系统：\n\n```mermaid\ngraph LR\n    subgraph 日常管理\n        A[daily-standup] --> B[daily-plan]\n        B --> C[end-of-day]\n        C --> D[capture]\n    end\n    \n    subgraph 规划类工作流\n        E[weekly-plan] --> A\n        C --> F[sprint-plan]\n    end\n    \n    subgraph 周期性回顾\n        A --> G[weekly-review]\n        C --> H[monthly-review]\n        H --> I[cycle-review]\n    end\n    \n    subgraph 专业领域\n        A --> J[health-weekly]\n        A --> K[daily-training-report]\n        D --> L[voice-notes]\n    end\n```\n\n### 规划类工作流的关联\n\n| 关联关系 | 说明 |\n|---------|-----|\n| weekly-plan → daily-plan | 周计划为日计划提供上下文 |\n| sprint-plan → daily-plan | 迭代计划指导每日任务分配 |\n| daily-plan → weekly-plan | 日计划执行情况影响周计划调整 |\n\n`sprint-plan` 技能提供了迭代周期的规划能力，与 `daily-plan` 的 `include.currentCycle` 参数紧密相关。两者共享 `get_planning_context` 和 `apply_planning_patch` 工具。\n\n资料来源：[skills/sprint-plan/SKILL.md:1-20]()\n\n### 健康与习惯追踪的关联\n\n`daily-standup` 可以结合 `daily-training-report` 提供更全面的晨间简报：\n\n| 数据来源 | 技能 | 展示内容 |\n|---------|-----|---------|\n| Oura Ring | `health-weekly` | 睡眠评分、活动趋势、恢复状态 |\n| 习惯追踪 | `daily-training-report` | 习惯完成率、连续天数 |\n| 日历整合 | `daily-standup` | 会议安排、时间块 |\n\n资料来源：[skills/daily-training-report/SKILL.md:1-25]()\n\n## 最佳实践\n\n### 晨间简报使用建议\n\n1. 每天工作开始时首先运行 `daily-standup`\n2. 根据逾期任务的数量决定是否需要立即处理\n3. 将 sprint 进度作为当日工作节奏的参考\n4. 使用 `$ARGUMENTS` 指定特定日期查看历史记录\n\n### 今日规划执行策略\n\n1. 规划前先完成晨间简报获取完整上下文\n2. 遵循\"一次只做一件事\"原则设置 Top 3 优先级\n3. 将模糊的想法通过 `capture` 记录后再继续规划\n4. 规划变更后及时更新迭代目标保持一致性\n5. 使用 `save_daily_note` 生成可读的日计划存档\n\n### 日终复盘建议\n\n1. 记录完成的任务和实际花费的时间\n2. 识别未完成任务的原因（阻塞、估计偏差、优先级变更）\n3. 为次日准备 1-3 个明确的优先任务\n4. 积累数据为周期性回顾提供依据\n\n## 相关资源\n\n- **完整技能列表**: [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n- **MCP 工具参考**: [AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n- **迭代规划**: [sprint-plan 技能](https://github.com/starascendin/lifeos-plugin/blob/main/skills/sprint-plan/SKILL.md)\n- **周度规划**: [weekly-plan 技能](https://github.com/starascendin/lifeos-plugin/blob/main/skills/weekly-plan/SKILL.md)\n- **语音笔记**: [voice-notes 技能](https://github.com/starascendin/lifeos-plugin/blob/main/skills/voice-notes/SKILL.md)\n- **健康追踪**: [health-weekly 技能](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-weekly/SKILL.md)\n\n---\n\n<a id='page-review-workflows'></a>\n\n## 复盘与规划工作流\n\n### 相关页面\n\n相关主题：[日常管理工作流](#page-daily-workflows), [项目与客户管理](#page-project-management)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [skills/weekly-review/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/weekly-review/SKILL.md)\n- [skills/weekly-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/weekly-plan/SKILL.md)\n- [skills/monthly-review/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/monthly-review/SKILL.md)\n- [skills/cycle-review/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/cycle-review/SKILL.md)\n- [skills/initiative-review/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/initiative-review/SKILL.md)\n</details>\n\n# 复盘与规划工作流\n\n## 概述\n\n复盘与规划工作流是 LifeOS Plugin 中用于周期性回顾过去、规划未来的核心功能集合。这些工作流涵盖了从每日微观规划到年度宏观审视的完整时间跨度，帮助用户系统性地审视已完成工作、评估当前状态，并制定下一步行动计划。\n\n这些工作流分为两大类别：**复盘类工作流**侧重于回顾和分析已完成的工作，而**规划类工作流**则专注于创建变更并应用到 LifeOS 系统中。两者相互配合，形成完整的\"回顾-反思-计划-执行\"闭环。\n\n资料来源：[README.md:15-30]()\n\n## 架构总览\n\n复盘与规划工作流遵循统一的设计模式，每个工作流都通过 LifeOS MCP 工具与 Convex 后端进行交互：\n\n```mermaid\ngraph TD\n    A[用户触发工作流] --> B[获取上下文数据]\n    B --> C[分析评估]\n    C --> D{工作流类型}\n    D -->|复盘类| E[展示分析结果]\n    D -->|规划类| F[执行变更操作]\n    E --> G[生成报告]\n    F --> H[应用变更到LifeOS]\n    H --> G\n    G --> I[更新Daily Note/Weekly Note]\n```\n\n### 核心设计原则\n\n| 原则 | 说明 | 资料来源 |\n|------|------|----------|\n| 上下文优先 | 规划工作流首先调用 `get_planning_context` 获取完整上下文 | [skills/weekly-plan/SKILL.md:1-12]() |\n| 自动执行 | 规划类工作流不询问确认，直接应用变更 | [skills/daily-plan/SKILL.md:24]() |\n| 可组合性 | 各周期的工作流可相互嵌套调用 | [skills/monthly-review/SKILL.md:1-8]() |\n| 数据驱动 | 决策基于实际数据而非主观判断 | [skills/cycle-review/SKILL.md:1-10]() |\n\n## 复盘类工作流\n\n### 周期循环复盘\n\n#### 每日回顾 (Daily Review)\n\n每日回顾嵌入在 `daily-plan` 工作流中，通过获取今日待办任务、日历和习惯数据来进行快速审视。\n\n#### 周期回顾 (Cycle Review)\n\n周期回顾用于审视当前冲刺/周期的完成情况，支持延期项的处理：\n\n```mermaid\ngraph TD\n    A[获取当前Cycle数据] --> B[计算完成率]\n    B --> C{完成率达标?}\n    C -->|是| D[庆祝成就]\n    C -->|否| E[分析延期原因]\n    E --> F{是否滚动到下周期?}\n    F -->|是| G[执行延期操作]\n    F -->|否| H[标记为风险项]\n    G --> I[更新Cycle数据]\n    H --> J[记录风险]\n```\n\n**执行操作**：\n- 延期项自动滚动到下一个周期\n- 未完成项标记为风险项\n- 更新周期元数据\n\n资料来源：[skills/cycle-review/SKILL.md:1-15]()\n\n#### 周回顾 (Weekly Review)\n\n周回顾是最高频的复盘工作流，系统性地审视一周内的工作成果：\n\n| 数据维度 | 获取工具 | 展示内容 |\n|----------|----------|----------|\n| 已完成任务 | `get_tasks` with status=\"done\" | 完成数量、类型分布 |\n| 进行中任务 | `get_todays_tasks` | 当前工作负载 |\n| 周期健康度 | `get_cycles` | Sprint完成率 |\n| 客户状态 | `get_clients` | 关系健康度 |\n| 捕获笔记 | `get_recent_notes` | 思考模式分析 |\n\n资料来源：[skills/weekly-review/SKILL.md:1-12]()\n\n#### 月回顾 (Monthly Review)\n\n月回顾提供更宏观的视角，整合多周数据形成月度洞察：\n\n- **成就总结**：本月重大胜利和完成的工作\n- **项目进展**：各活跃项目的状态\n- **Sprint表现**：跨周期的平均完成率\n- **客户健康度**：各客户关系状态\n- **主题模式**：笔记和完成工作的模式识别\n- **结转项**：滚转到下月的工作\n- **反思**：什么有效、什么无效\n- **下月重点**：下月前三优先级\n\n资料来源：[skills/monthly-review/SKILL.md:1-25]()\n\n#### 年度倡议回顾 (Initiative Review)\n\n年度层面的审视，按类别查看目标进展：\n\n```mermaid\ngraph LR\n    A[年度倡议] --> B[按类别分组]\n    B --> C[各倡议进度]\n    C --> D[偏差分析]\n    D --> E[调整建议]\n```\n\n资料来源：[skills/initiative-review/SKILL.md:1-8]()\n\n### 专项复盘\n\n#### 健康周检视 (Health Weekly)\n\n每周健康数据综合回顾，整合 Oura Ring 的多维度数据：\n\n| 健康维度 | 数据源 | 关键指标 |\n|----------|--------|----------|\n| 睡眠质量 | `get_health_sleep` | 评分、时长、深度/REM平衡 |\n| 活动模式 | `get_health_activity` | 步数均值、活跃天数 |\n| 准备度 | `get_health_readiness` | 评分趋势、压力vs恢复 |\n| 韧性 | `get_health_resilience` | 日级别趋势、贡献因子 |\n| 健身 | `get_health_vo2_max` | 最大摄氧量趋势 |\n\n资料来源：[skills/health-weekly/SKILL.md:1-20]()\n\n#### 客户成功分类 (Customer Success Triage)\n\n客户请求的三级分类体系：\n\n| 分类 | 说明 | 处理方式 |\n|------|------|----------|\n| 新需求 | 全新请求或变更需求 | 创建需求笔记 |\n| 跟进项 | 等待你或团队响应的事项 | 更新现有任务 |\n| 风险/阻塞 | 范围模糊、延期风险、流失风险 | 标记并通知 |\n| 已跟踪 | 已有笔记或任务覆盖 | 关联现有项 |\n\n资料来源：[skills/customer-success-triage/SKILL.md:1-25]()\n\n## 规划类工作流\n\n### 周期规划工作流\n\n规划类工作流是会变更 LifeOS 状态的**变异工作流**，执行后直接修改系统数据，不询问确认。\n\n```mermaid\ngraph TD\n    A[调用 get_planning_context] --> B[构建计划]\n    B --> C{验证计划可行性}\n    C -->|可行| D[调用 apply_planning_patch]\n    C -->|不可行| E[调整计划]\n    E --> C\n    D --> F[执行变更]\n    F --> G[报告结果]\n```\n\n资料来源：[skills/sprint-plan/SKILL.md:1-20]()\n\n#### 日计划 (Daily Plan)\n\n日计划工作流的核心操作：\n\n| 操作类型 | 工具方法 | 说明 |\n|----------|----------|------|\n| 创建任务 | `create_issue` | 新增任务到系统 |\n| 调度任务 | `schedule_issue` | 设置截止日期 |\n| 更新任务 | `update_issue` | 修改状态、优先级、估算 |\n| 加入周期 | `assign_issue_to_current_cycle` | 将工作纳入当前周期 |\n| 设置优先级 | `set_top_priority` | 设置今日Top 3 |\n| 更新周期目标 | `update_cycle_goals` | 变更周期焦点 |\n| 保存日记 | `save_daily_note` | 写入可读的日计划 |\n\n资料来源：[skills/daily-plan/SKILL.md:1-30]()\n\n#### 周计划 (Weekly Plan)\n\n周计划在日计划基础上扩展到整周视角：\n\n**周计划关键决策点**：\n\n1. **更新周期目标**：当周期焦点需要调整时\n2. **分配待办项**：将选定的待办任务纳入当前周期\n3. **跨周调度**：使用 `dueDate` 安排一周的工作\n4. **设置近优先级**：确定近期的首要任务\n5. **保持可执行性**：确保今日计划足够具体可执行\n\n资料来源：[skills/weekly-plan/SKILL.md:1-35]()\n\n#### Sprint计划 (Sprint Plan)\n\nSprint计划专注于当前周期层面的规划：\n\n- 更新周期目标（当焦点需要改变时）\n- 将适当的待办工作拉入当前周期\n- 使用 `dueDate` 安排近期工作\n- 设置首要任务的最高优先级\n- 避免当前周期过载\n\n资料来源：[skills/sprint-plan/SKILL.md:1-25]()\n\n### 规划上下文数据模型\n\n`get_planning_context` 获取的完整上下文结构：\n\n```json\n{\n  \"include\": {\n    \"daily\": true,\n    \"weekly\": true,\n    \"currentCycle\": true,\n    \"backlog\": true,\n    \"habits\": true,\n    \"dailyFields\": true,\n    \"calendar\": true,\n    \"voiceMemos\": true\n  }\n}\n```\n\n| 字段 | 用途 |\n|------|------|\n| daily | 今日任务和日历 |\n| weekly | 本周概览 |\n| currentCycle | 当前Sprint数据 |\n| backlog | 待办池任务 |\n| habits | 习惯追踪 |\n| dailyFields | 每日字段配置 |\n| calendar | 日历事件 |\n| voiceMemos | 语音备忘录 |\n\n## 复盘与规划的协同关系\n\n复盘和规划工作流形成闭环，两者数据互通：\n\n```mermaid\ngraph LR\n    A[周回顾] --> B[识别模式和风险]\n    B --> C[周计划]\n    C --> D[执行]\n    D --> E[日计划/日执行]\n    E --> F{周期结束}\n    F --> G[周期回顾]\n    G --> H[延期决策]\n    H --> I[Sprint计划]\n    I --> D\n    I --> C\n```\n\n### 数据流向\n\n| 复盘输出 | 作为规划输入 |\n|----------|--------------|\n| 已完成任务 | 评估当前周期负载 |\n| 延期项 | Sprint计划待处理 |\n| 完成率 | 调整周期容量 |\n| 模式分析 | 优化计划策略 |\n| 风险识别 | 优先级调整依据 |\n\n## MCP 工具清单\n\n复盘与规划工作流依赖的核心 MCP 工具：\n\n| 工具 | 用途 | 工作流类型 |\n|------|------|------------|\n| `get_planning_context` | 获取完整规划上下文 | 规划 |\n| `apply_planning_patch` | 执行变更操作 | 规划 |\n| `get_tasks` | 获取任务列表 | 复盘/规划 |\n| `get_cycles` | 获取周期数据 | 复盘 |\n| `get_daily_agenda` | 获取每日议程 | 复盘 |\n| `get_monthly_agenda` | 获取月度概览 | 复盘 |\n| `get_initiatives` | 获取年度倡议 | 复盘 |\n| `get_clients` | 获取客户列表 | 复盘 |\n| `get_health_*` | 获取健康数据 | 专项复盘 |\n| `create_issue` | 创建任务 | 规划 |\n| `update_issue` | 更新任务 | 规划 |\n| `schedule_issue` | 调度任务 | 规划 |\n| `save_daily_note` | 保存日记 | 规划 |\n| `save_weekly_note` | 保存周笔记 | 规划 |\n\n资料来源：[AGENTS.md:50-80]()\n\n## 最佳实践\n\n### 执行顺序建议\n\n1. **高频周期先执行**：日计划 → 周计划 → Sprint计划\n2. **复盘为规划提供输入**：先回顾再规划\n3. **专项复盘按需触发**：健康周检视、客户分类等\n4. **自动执行避免中断**：规划类工作流设计为自动执行\n\n### 数据一致性维护\n\n- 规划变更后检查 Daily Note 是否同步更新\n- 周期结束时执行周期回顾，避免延期项丢失\n- 月度回顾时验证所有周期数据的完整性\n\n### 异常处理\n\n| 场景 | 处理方式 |\n|------|----------|\n| 周期过载 | 优先将任务延期到下周期 |\n| 冲突优先级 | 参考 Top Priority 设置 |\n| 上下文不完整 | 记录缺失项，依赖手动补充 |\n\n## 与其他模块的集成\n\n复盘与规划工作流并非孤立存在，它与其他 LifeOS 模块紧密集成：\n\n```mermaid\ngraph TD\n    A[复盘与规划] --> B[PPV人生设计]\n    A --> C[教练模块]\n    A --> D[语音备忘录]\n    A --> E[健康追踪]\n    B --> F[Vision更新触发规划调整]\n    C --> G[教练行动项纳入Sprint]\n    D --> H[语音洞察转化为任务]\n    E --> I[健康数据影响容量评估]\n```\n\n- **PPV人生设计**：愿景变更可能触发周期目标调整\n- **教练模块**：教练行动项可纳入 Sprint 计划\n- **语音备忘录**：语音洞察通过结晶化流程转化为具体任务\n- **健康追踪**：健康数据影响个人容量评估和计划可行性\n\n资料来源：[skills/ppv/SKILL.md:1-30](), [skills/voice-notes/SKILL.md:1-20](), [skills/daily-training-report/SKILL.md:1-15]()\n\n---\n\n<a id='page-project-management'></a>\n\n## 项目与客户管理\n\n### 相关页面\n\n相关主题：[复盘与规划工作流](#page-review-workflows), [人际关系管理](#page-people-relationships)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [skills/project-status/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/project-status/SKILL.md)\n- [skills/client-brief/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/client-brief/SKILL.md)\n- [skills/client-health/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/client-health/SKILL.md)\n- [skills/sprint-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/sprint-plan/SKILL.md)\n- [skills/customer-success-triage/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/customer-success-triage/SKILL.md)\n- [skills/inbox-triage/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/inbox-triage/SKILL.md)\n- [skills/overdue/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/overdue/SKILL.md)\n</details>\n\n# 项目与客户管理\n\n## 概述\n\n项目与客户管理是 LifeOS Plugin 提供的核心功能模块，涵盖从项目状态追踪、冲刺规划到客户关系维护的完整工作流程。该模块通过 MCP（Model Context Protocol）工具与 Convex 后端交互，支持 37 种工作技能，涵盖项目看板、阶段分解、任务统计、阻塞项识别等能力。\n\n资料来源：[README.md:1-37]()\n\n## 核心技能体系\n\n### 技能矩阵\n\n| 技能名称 | 命令 | 功能描述 |\n|---------|------|---------|\n| project-status | `/project-status [项目名]` | 阶段分解、任务统计、阻塞项 |\n| client-brief | `/client-brief \"客户名\"` | 完整客户简报，包含项目与沟通记录 |\n| client-health | `/client-health` | 全客户健康仪表盘 |\n| sprint-plan | `/sprint-plan` | 当前冲刺规划：目标、回溯、截止日期、优先级 |\n| customer-success-triage | `/customer-success-triage \"客户名\"` | 客户请求分类处理 |\n| inbox-triage | `/inbox-triage` | 将笔记处理为可执行任务 |\n| overdue | `/overdue` | 逾期与滑向逾期的项目 |\n\n资料来源：[README.md:42-56]()\n\n## 项目状态管理\n\n### project-status 技能\n\n`project-status` 技能用于深入分析单个项目的健康状况，通过 MCP 工具获取项目的多维度数据。\n\n**工作流程：**\n\n```mermaid\ngraph TD\n    A[输入项目名称] --> B[get_project_workspace]\n    B --> C[收集项目数据]\n    C --> D[分析阶段进度]\n    C --> E[统计任务状态]\n    C --> F[识别阻塞项]\n    D --> G[生成项目状态报告]\n    E --> G\n    F --> G\n```\n\n**输出内容：**\n\n- **阶段分解**：项目各阶段的完成情况\n- **任务统计**：任务总数、进行中、已完成、阻塞数量\n- **阻塞项识别**：明确指出阻碍项目推进的问题\n- **风险预警**：进度滞后或资源不足的警示\n\n资料来源：[README.md:48]()\n\n## 客户管理\n\n### client-brief 技能\n\n`client-brief` 技能提供特定客户的完整视图，帮助快速了解与客户的全部互动情况。\n\n**数据结构：**\n\n```mermaid\ngraph TD\n    A[client-brief 技能] --> B[项目列表]\n    A --> C[最近沟通记录]\n    A --> D[待办任务]\n    A --> E[备注历史]\n    A --> F[健康指标]\n```\n\n**使用方式：**\n\n```bash\n/client-brief \"Acme Corp\"\n```\n\n**核心数据源：**\n\n| 数据类型 | MCP 工具 | 说明 |\n|---------|---------|------|\n| 项目 | get_client_projects | 客户关联的所有项目 |\n| 沟通 | get_beeper_thread_messages | Beeper 聊天记录 |\n| 会议 | get_fathom_meeting, get_granola_meeting | Fathom 和 Granola 会议数据 |\n| 笔记 | get_client_notes | 客户相关笔记 |\n| 任务 | get_client_tasks | 客户相关的开放任务 |\n\n资料来源：[README.md:49]()\n\n### client-health 技能\n\n`client-health` 技能提供跨所有客户的健康仪表盘，便于管理者快速掌握整体客户状况。\n\n**功能特点：**\n\n- 实时汇总所有客户的健康指标\n- 识别需要关注的客户\n- 追踪客户互动频率\n- 预警潜在的客户流失风险\n\n资料来源：[README.md:50]()\n\n## 冲刺规划\n\n### sprint-plan 技能\n\n`sprint-plan` 技能是**变异型工作流**，用于规划当前冲刺周期并直接应用变更到 LifeOS。\n\n**执行步骤：**\n\n1. 调用 `get_planning_context`，包含以下参数：\n   - `include.currentCycle=true`\n   - `include.backlog=true`\n   - `include.weekly=true`\n   - `include.daily=true`\n\n2. 构建冲刺计划：\n   - 更新冲刺目标（当焦点需要调整时）\n   - 从待办事项中拉取合适的工作到当前冲刺\n   - 使用 `dueDate` 安排近期工作\n   - 设置最高优先级\n   - 避免冲刺过载\n\n3. 调用 `apply_planning_patch`，参数：\n   - `mode=\"cycle\"`\n   - `dryRun=false`\n\n**可用操作：**\n\n| 操作 | MCP 工具 | 说明 |\n|-----|---------|------|\n| 创建新工作 | `create_issue` | 在冲刺中创建新任务 |\n| 分配到冲刺 | `assign_issue_to_current_cycle` | 将任务分配到当前冲刺 |\n| 安排任务 | `schedule_issue` | 设置截止日期 |\n| 更新任务 | `update_issue` | 修改状态、优先级、估算值、标题 |\n| 设置优先级 | `set_top_priority` | 立即聚焦的任务 |\n| 更新目标 | `update_cycle_goals` | 冲刺目标调整 |\n| 保存笔记 | `save_weekly_note` / `save_daily_note` | 可读计划文档 |\n\n**执行后报告内容：**\n\n- 当前冲刺目标与容量\n- 分配、创建或安排的任务\n- 最高优先级列表\n- 任何风险或过载警告\n\n资料来源：[skills/sprint-plan/SKILL.md:1-45]()\n\n## 客户成功分类\n\n### customer-success-triage 技能\n\n`customer-success-triage` 技能用于系统性地分类处理客户请求和客户成功工作。\n\n**工作流程：**\n\n```mermaid\ngraph TD\n    A[输入客户名称] --> B[get_client_success_workspace]\n    B --> C[审查工作区数据]\n    C --> D[recentThreads]\n    C --> E[recentMeetings]\n    C --> F[notes]\n    C --> G[openTasks]\n    C --> H[projects]\n    D --> I[需要时深入]\n    E --> I\n    F --> I\n    G --> I\n    I --> J[分类发现]\n    J --> K[生成分类报告]\n```\n\n**分类类别：**\n\n| 类别 | 说明 |\n|-----|------|\n| 新需求 (New Requirements) | 全新请求或变更需求 |\n| 跟进项 (Follow-Ups) | 等待你或团队处理的事项 |\n| 风险/阻塞 (Risks/Blockers) | 范围模糊、逾期工作、交付风险、流失风险 |\n| 已追踪 (Already Tracked) | 已有笔记或任务覆盖的请求 |\n\n**MCP 工具调用顺序：**\n\n1. `get_client_success_workspace` — 获取客户工作区\n2. `get_beeper_thread_messages` — 聊天详情\n3. `get_fathom_meeting` / `get_fathom_transcript` — Fathom 会议详情\n4. `get_granola_meeting` / `get_granola_transcript` — Granola 会议详情\n5. `get_client_notes` — 已有笔记历史\n\n**写入操作策略：**\n\n- 使用 `create_client_note` 或 `update_client_note` 保存持久性账户记忆\n- 仅对执行工作使用 `create_issue` 或 `update_issue`\n- 优先更新现有笔记/任务，避免创建重复项\n- 不删除任何内容\n\n资料来源：[skills/customer-success-triage/SKILL.md:1-50]()\n\n## 收件箱分类\n\n### inbox-triage 技能\n\n`inbox-triage` 技能将捕获的笔记处理为可执行任务、标签和链接。\n\n**执行流程：**\n\n```mermaid\ngraph TD\n    A[获取最近笔记] --> B[获取可用项目]\n    A --> C[获取联系人]\n    B --> D[分析每条笔记]\n    C --> D\n    D --> E{分析结果}\n    E -->|动作项| F[转换为任务]\n    E -->|提及人员| G[链接到人员]\n    E -->|关联项目| H[分配到项目]\n    E -->|需要分类| I[添加标签]\n    F --> J[显示分类列表]\n    G --> J\n    H --> J\n    I --> J\n    J --> K{用户确认}\n    K -->|是| L[执行变更]\n    K -->|否| M[调整建议]\n```\n\n**MCP 工具调用：**\n\n1. `get_recent_notes` — 获取最近 20 条未处理捕获\n2. `get_projects` — 了解可用项目用于分配\n3. `get_people` — 了解联系人用于链接\n\n**分类建议类型：**\n\n| 建议类型 | 说明 |\n|---------|------|\n| 转换为任务 | 如果包含动作项 |\n| 链接到人员 | 如果提及某人 |\n| 链接到项目 | 如果与某项目相关 |\n| 添加标签 | 基于内容建议相关标签 |\n\n**自动模式：**\n\n当 `$ARGUMENTS` 包含 `\"auto\"` 时，自动使用最佳猜测执行处理，无需询问确认。\n\n资料来源：[skills/inbox-triage/SKILL.md:1-45]()\n\n## 逾期追踪\n\n### overdue 技能\n\n`overdue` 技能用于识别和追踪所有逾期及即将逾期的项目。\n\n**功能：**\n\n- 列出所有逾期任务\n- 识别滑向逾期的项目\n- 提供优先级建议\n- 生成逾期报告\n\n资料来源：[README.md:56]()\n\n## 数据流向\n\n### 完整工作流架构\n\n```mermaid\ngraph LR\n    subgraph 输入层\n        A[用户请求] --> B[MCP 工具调用]\n    end\n    \n    subgraph 处理层\n        B --> C[get_planning_context]\n        B --> D[get_client_workspace]\n        B --> E[get_project_workspace]\n        B --> F[get_recent_notes]\n    end\n    \n    subgraph 分析层\n        C --> G[数据聚合]\n        D --> G\n        E --> G\n        F --> G\n    end\n    \n    subgraph 变异层\n        G --> H[apply_planning_patch]\n        H --> I[create_issue]\n        H --> J[update_issue]\n        H --> K[assign_issue_to_current_cycle]\n        H --> L[create_client_note]\n    end\n    \n    subgraph 输出层\n        I --> M[LifeOS 更新]\n        J --> M\n        K --> M\n        L --> M\n        G --> N[报告生成]\n    end\n```\n\n## MCP 工具清单\n\n项目与客户管理相关的核心 MCP 工具：\n\n| 工具名称 | 功能 | 适用场景 |\n|---------|------|---------|\n| `get_client_success_workspace` | 获取客户成功工作区 | 客户请求分类 |\n| `get_beeper_thread_messages` | 获取 Beeper 聊天记录 | 客户沟通详情 |\n| `get_fathom_meeting` | 获取 Fathom 会议 | 会议详情 |\n| `get_fathom_transcript` | 获取 Fathom 转录 | 会议记录 |\n| `get_granola_meeting` | 获取 Granola 会议 | 会议详情 |\n| `get_granola_transcript` | 获取 Granola 转录 | 会议记录 |\n| `get_client_notes` | 获取客户笔记 | 历史记录查看 |\n| `create_client_note` | 创建客户笔记 | 记忆保存 |\n| `update_client_note` | 更新客户笔记 | 记忆维护 |\n| `get_planning_context` | 获取规划上下文 | 冲刺/周/日计划 |\n| `apply_planning_patch` | 应用规划变更 | 变异操作 |\n| `get_recent_notes` | 获取最近笔记 | 收件箱分类 |\n| `get_projects` | 获取项目列表 | 任务分配 |\n| `get_people` | 获取联系人列表 | 人员关联 |\n\n## 最佳实践\n\n### 客户管理\n\n1. **定期客户简报**：使用 `client-brief` 定期了解客户全景\n2. **健康监控**：通过 `client-health` 追踪客户整体状况\n3. **主动分类**：使用 `customer-success-triage` 及时处理客户请求\n\n### 项目执行\n\n1. **冲刺对齐**：确保项目任务与当前冲刺目标一致\n2. **避免过载**：设置合理的冲刺容量\n3. **优先级管理**：使用 `set_top_priority` 明确即时焦点\n\n### 任务处理\n\n1. **及时收件箱清空**：使用 `inbox-triage` 将想法转化为行动\n2. **逾期追踪**：定期检查 `overdue` 任务\n3. **避免重复**：优先更新现有任务而非创建新任务\n\n## 配置要求\n\n### MCP 服务器配置\n\n```json\n{\n  \"mcpServers\": {\n    \"lifeos\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@starascendin/lifeos-mcp@latest\",\n        \"--url\", \"YOUR_CONVEX_URL\",\n        \"--user-id\", \"YOUR_USER_ID\",\n        \"--api-key\", \"YOUR_API_KEY\"\n      ]\n    }\n  }\n}\n```\n\n### 环境变量\n\n| 变量名 | 说明 |\n|-------|------|\n| `LIFEOS_CONVEX_URL` | Convex 应用地址 |\n| `LIFEOS_USER_ID` | 用户 ID |\n| `LIFEOS_API_KEY` | API 密钥 |\n\n资料来源：[README.md:25-45]()\n\n---\n\n<a id='page-voice-notes-workflows'></a>\n\n## 语音笔记工作流\n\n### 相关页面\n\n相关主题：[日常管理工作流](#page-daily-workflows)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [skills/voice-notes/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/voice-notes/SKILL.md)\n- [skills/voice-notes-crystallize/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/voice-notes-crystallize/SKILL.md)\n- [skills/daily-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)\n- [skills/weekly-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/weekly-plan/SKILL.md)\n- [skills/daily-training-report/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-training-report/SKILL.md)\n</details>\n\n# 语音笔记工作流\n\n## 概述\n\n语音笔记工作流是 LifeOS Plugin 中用于探索、分析和保存语音备忘录的综合功能模块。该工作流通过 MCP（Model Context Protocol）工具与 LifeOS 后端交互，支持用户以对话方式回顾、整理和提炼语音记录中的洞察。\n\n语音笔记工作流的核心价值在于将分散的语音记录转化为可执行的知识资产，通过 AI 驱动的分析帮助用户发现语音笔记中的模式、关联和行动项。\n\n---\n\n## 架构设计\n\n### 组件关系\n\n```mermaid\ngraph TD\n    A[用户] -->|语音指令| B[voice-notes 技能]\n    B -->|探索请求| C[MCP 工具集]\n    C --> D[get_voice_memo_labels]\n    C --> E[get_recent_notes]\n    C --> F[get_voice_memos_by_labels]\n    C --> G[get_voice_memos_by_date]\n    C --> H[get_voice_memo]\n    C --> I[search_notes]\n    \n    A -->|结晶保存| I[voice-notes-crystallize 技能]\n    I -->|创建摘要| J[create_ai_convo_summary]\n    \n    K[其他规划技能] -.->|集成| C\n    K -->|include.voiceMemos| B\n```\n\n语音笔记工作流与日常规划、每周计划等技能深度集成，在获取规划上下文时可通过 `include.voiceMemos=true` 参数一并拉取相关语音备忘录。资料来源：[skills/daily-plan/SKILL.md:3-8]()\n\n### MCP 工具矩阵\n\n| 工具名称 | 功能描述 | 返回数据类型 |\n|---------|---------|-------------|\n| `get_voice_memo_labels` | 获取所有语音备忘录的标签/主题 | 标签列表 |\n| `get_recent_notes` | 获取最近 N 条语音记录 | 摘要数组 |\n| `get_voice_memos_by_date` | 按日期范围查询语音记录 | 时间序列数据 |\n| `get_voice_memos_by_labels` | 按标签筛选语音记录 | 分类数据 |\n| `get_voice_memo` | 获取单条语音备忘录的完整信息 | 详细对象（含 AI 提取） |\n| `search_notes` | 全文搜索语音笔记内容 | 搜索结果集 |\n| `create_ai_convo_summary` | 创建 AI 对话结晶摘要 | 摘要 ID |\n\n---\n\n## 工作流程详解\n\n### 探索阶段\n\n语音笔记探索采用渐进式发现模式，从概览到细节逐层深入。资料来源：[skills/voice-notes/SKILL.md:1-30]()\n\n#### 步骤一：了解资源池\n\n系统首先调用 `get_voice_memo_labels` 获取所有可用的主题标签，同时调用 `get_recent_notes` 显示最近 10 条记录。这种双重查询让用户对语音笔记库有初步认知：\n\n```mermaid\ngraph LR\n    A[开始] --> B[获取标签云]\n    B --> C[获取最近笔记]\n    C --> D{用户意图}\n    D -->|查看最近| E[展示时间线]\n    D -->|探索主题| F[按标签聚合]\n    D -->|回溯时段| G[日期范围查询]\n    D -->|深度分析| H[单条笔记详览]\n```\n\n#### 步骤二：多维度探索\n\n根据用户意图，系统提供四种主要探索路径：\n\n**按时间回顾**\n\n调用 `get_voice_memos_by_date`，传入 `startDate` 和 `endDate` 参数。系统将呈现时间线上的主题模式、情感波动和关键要点。资料来源：[skills/voice-notes/SKILL.md:18-20]()\n\n**按主题探索**\n\n调用 `get_voice_memos_by_labels` 筛选特定标签下的所有语音记录。这有助于用户追踪特定项目、会议或生活领域的持续思考。资料来源：[skills/voice-notes/SKILL.md:15-17]()\n\n**全文检索**\n\n当用户有明确搜索目标时，调用 `search_notes` 执行语义或关键词搜索。资料来源：[skills/voice-notes/SKILL.md:21-22]()\n\n**深度分析**\n\n对于单条重要备忘录，调用 `get_voice_memo` 获取包含 AI 提取信息的完整详情。资料来源：[skills/voice-notes/SKILL.md:23-25]()\n\n---\n\n### 对话交互阶段\n\n在探索过程中，技能扮演主动思考伙伴的角色：\n\n- **识别模式**：跨备忘录发现反复出现的主题或矛盾点\n- **连接关联**：将不同时间、不同主题的笔记建立逻辑关联\n- **激活行动项**：挖掘被遗忘但仍有价值的待办事项\n- **协助规划**：帮助用户基于笔记内容制定或调整计划\n\n资料来源：[skills/voice-notes/SKILL.md:26-33]()\n\n---\n\n### 结晶保存阶段\n\n当对话产生有价值的结果时，用户可选择结晶保存。资料来源：[skills/voice-notes-crystallize/SKILL.md:1-50]()\n\n#### 摘要类型分类\n\n系统支持六种摘要类型，用于不同场景：\n\n| 类型 | 适用场景 | 内容特征 |\n|-----|---------|---------|\n| `reflection` | 回顾过往经历或情感 | 感受加工、事件复盘 |\n| `planning` | 制定策略或计划 | 目标分解、行动路径 |\n| `brainstorm` | 创意发散场景 | 想法碰撞、多角度探索 |\n| `journal_review` | 日记/日志回顾 | 时间线梳理、成长轨迹 |\n| `idea_refinement` | 已有想法深化 | 细节打磨、可行性分析 |\n\n#### 结晶数据结构\n\n创建结晶摘要时，系统提取以下核心元素：\n\n```json\n{\n  \"title\": \"生成的描述性标题\",\n  \"summary\": \"2-4 段落的主要洞察和结论\",\n  \"keyInsights\": [\"3-7 条核心领悟\"],\n  \"actionItems\": [\"任务或行动项\"],\n  \"ideas\": [\"新想法或新方向\"],\n  \"tags\": [\"3-5 个分类标签\"],\n  \"summaryType\": \"摘要类型\",\n  \"conversationContext\": \"对话上下文\"\n}\n```\n\n保存成功后返回摘要 ID，用户可通过 `get_ai_convo_summaries` 回顾历史结晶。资料来源：[skills/voice-notes-crystallize/SKILL.md:24-31]()\n\n---\n\n## 与其他技能的集成\n\n### 规划上下文集成\n\n语音笔记可作为规划决策的参考依据。以下技能在获取规划上下文时支持语音备忘录集成：资料来源：[skills/daily-plan/SKILL.md:5-7]()\n\n```mermaid\ngraph TD\n    A[规划技能] -->|include.voiceMemos: true| B[get_planning_context]\n    B --> C[返回语音备忘录数据]\n    C --> D[辅助决策]\n    \n    A -->|daily-plan| E[日计划]\n    A -->|weekly-plan| F[周计划]\n    A -->|sprint-plan| G[冲刺计划]\n```\n\n### 每日训练报告集成\n\n在生成每日训练报告时，系统整合语音笔记中的相关洞察作为参考上下文，帮助用户将语音记录中的健康、训练相关想法纳入日常复盘。资料来源：[skills/daily-training-report/SKILL.md:1-25]()\n\n---\n\n## 使用场景示例\n\n### 场景一：周回顾反思\n\n用户希望回顾过去一周的语音日记：\n1. 调用 `get_voice_memos_by_date`，设置起止日期\n2. 系统展示本周主题和情感趋势\n3. 用户选择特定日期深入查看\n4. 调用 `get_voice_memo` 获取完整 AI 提取内容\n5. 对话式分析后，调用 `voice-notes-crystallize` 保存周回顾\n\n### 场景二：项目追踪\n\n用户想查看某个项目的所有语音讨论：\n1. 调用 `get_voice_memo_labels` 确认项目标签\n2. 调用 `get_voice_memos_by_labels` 筛选项目相关记录\n3. 系统聚合所有相关录音和转录\n4. 帮助用户提取项目决策和下一步行动\n\n---\n\n## 最佳实践\n\n| 建议 | 说明 |\n|-----|-----|\n| 定期结晶 | 对话结束后及时保存有价值的内容，避免洞察流失 |\n| 标签管理 | 录音时添加清晰标签，便于后续按主题探索 |\n| 结合规划 | 在日/周计划时利用语音笔记作为上下文参考 |\n| 行动项追踪 | 从语音笔记中提取的任务应同步到任务管理系统 |\n\n---\n\n## 技术要点\n\n语音笔记工作流依赖以下底层能力：\n\n1. **AI 提取**：每条语音备忘录都经过 AI 处理，提取关键信息、情感标签和行动项\n2. **语义搜索**：支持基于意义的搜索，而非简单的关键词匹配\n3. **上下文关联**：能够将语音笔记与其他 LifeOS 数据（任务、健康、财务等）建立关联\n4. **结晶持久化**：结晶摘要作为 AI 对话总结存储，可跨会话回顾\n\n这些能力共同构成了一个从录制到分析再到知识沉淀的完整闭环。\n\n---\n\n<a id='page-health-integration'></a>\n\n## 健康数据集成 (Oura Ring)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [skills/health-check/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-check/SKILL.md)\n- [skills/health-weekly/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-weekly/SKILL.md)\n- [skills/daily-training-report/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-training-report/SKILL.md)\n- [AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n- [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n</details>\n\n# 健康数据集成 (Oura Ring)\n\n## 概述\n\n健康数据集成是 LifeOS Plugin 提供的核心功能模块之一，通过 MCP（Model Context Protocol）工具与 Oura Ring 智能戒指设备进行深度集成。该模块能够采集用户的睡眠、活动、准备度、压力、心率等多项生理指标，并将其与任务管理、日程规划和习惯追踪等生产力功能无缝结合。\n\nLifeOS 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)\n\n## 数据架构\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                     Oura Ring 设备                          │\n└─────────────────────────┬───────────────────────────────────┘\n                          │ 生理数据同步\n                          ▼\n┌─────────────────────────────────────────────────────────────┐\n│                     Convex 后端平台                          │\n│  ┌─────────┐ ┌──────────┐ ┌──────────┐ ┌─────────────────┐  │\n│  │  睡眠   │ │   活动   │ │  准备度  │ │   心率/压力    │  │\n│  │ Sleep   │ │ Activity │ │ Readiness│ │ HR/Stress/SpO2 │  │\n│  └────┬────┘ └────┬─────┘ └────┬─────┘ └────────┬────────┘  │\n│       └──────────┴────────────┴───────────────┘            │\n│                          │                                  │\n└──────────────────────────┼──────────────────────────────────┘\n                           │ MCP 工具调用\n                           ▼\n┌─────────────────────────────────────────────────────────────┐\n│              LifeOS Plugin Skills 层                         │\n│  ┌──────────────┐ ┌──────────────┐ ┌──────────────────────┐  │\n│  │ health-check│ │health-weekly │ │daily-training-report │  │\n│  └──────────────┘ └──────────────┘ └──────────────────────┘  │\n└─────────────────────────────────────────────────────────────┘\n```\n\n## 核心 MCP 工具清单\n\n### 健康数据获取工具\n\n| 工具名称 | 功能描述 | 数据范围 |\n|---------|---------|---------|\n| `get_health_sleep` | 获取睡眠数据 | 分数、时长、入睡时间、呼吸率、不安周期 |\n| `get_health_activity` | 获取活动数据 | 活动分数、步数、卡路里燃烧 |\n| `get_health_readiness` | 获取准备度数据 | 准备度分数、压力与恢复平衡、体温趋势 |\n| `get_health_stress` | 获取压力与恢复数据 | 压力水平、恢复状态 |\n| `get_health_heart_rate` | 获取心率趋势 | 静息心率、HRV 趋势 |\n| `get_health_workouts` | 获取锻炼历史 | 锻炼类型、时间、强度（优先使用 label 而非 activity） |\n| `get_health_resilience` | 获取恢复力水平 | 日级别恢复力趋势、贡献因素分解（睡眠恢复、日间恢复、压力） |\n| `get_health_vo2_max` | 获取最大摄氧量 | VO2max 估算值（ml/kg/min） |\n| `get_health_cardio_age` | 获取心血管年龄 | 心血管年龄趋势 |\n| `get_health_spo2` | 获取血氧数据 | SpO2 数值、呼吸障碍指数 |\n\n资料来源：[skills/health-weekly/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-weekly/SKILL.md)\n\n## 主要技能模块\n\n### 1. 快速健康检查 (health-check)\n\n快速健康检查模块提供即时的健康数据概览，适合日常快速了解身体状态。\n\n**数据采集范围：**\n\n- 7 天睡眠数据：分数、总睡眠时长趋势、入睡时间一致性、平均呼吸率\n- 7 天活动数据：活动分数、每日步数、活动卡路里\n- 7 天准备度数据：准备度分数、趋势方向（改善/下降/稳定）\n- 7 天心率数据：静息心率趋势、HRV 数据\n- 7 天恢复力数据：当前恢复力级别及趋势\n- 7 天 VO2max 和心血管年龄数据\n\n**输出格式：**\n\n```\n- 整体状态：快速评估（优秀/良好/需要关注）\n- 睡眠：平均分数、总睡眠时长趋势、入睡时间一致性...\n- 活动：平均分数、每日步数、活动卡路里\n- 准备度：平均分数、趋势方向\n- 心率：静息 HR 趋势、HRV\n- 恢复力：当前级别和趋势\n- 健身：VO2max 趋势、心血管年龄与实际年龄对比\n- 洞察：2-3 条基于数据的可操作建议\n```\n\n资料来源：[skills/health-check/SKILL.md:1-37](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-check/SKILL.md)\n\n**参数说明：**\n\n| 参数 | 类型 | 说明 |\n|-----|------|-----|\n| `$ARGUMENTS` | 数字（可选） | 指定回顾天数，默认为 7 天 |\n\n### 2. 每周健康回顾 (health-weekly)\n\n每周健康回顾模块提供更全面的健康数据分析，适用于周末复盘和趋势识别。\n\n**数据采集范围：**\n\n所有数据默认采集 14 天记录，以获得更准确的趋势分析。\n\n| 数据类型 | 采集天数 | 包含指标 |\n|---------|---------|---------|\n| 睡眠 | 14 天 | 分数、时长、入睡时间、呼吸率、深睡/REM 平衡、不安周期 |\n| 活动 | 14 天 | 步数、活动日与休息日对比、卡路里燃烧 |\n| 准备度 | 14 天 | 分数趋势、压力与恢复平衡、体温趋势 |\n| 压力 | 14 天 | 压力与恢复数据 |\n| 锻炼 | 14 天 | 锻炼历史（优先使用 label 显示名称） |\n| 心率 | 14 天 | 心率趋势 |\n| 恢复力 | 14 天 | 日级别恢复力、贡献因素（睡眠恢复、日间恢复、压力） |\n| VO2max | 14 天 | 最大摄氧量估算值（ml/kg/min） |\n| 心血管年龄 | 14 天 | 心血管年龄趋势 |\n| 血氧 | 14 天 | SpO2 数值、呼吸障碍指数 |\n\n**输出结构：**\n\n- **睡眠质量**：周平均分数、最佳/最差夜晚、睡眠时长趋势、深睡/REM 平衡、入睡时间一致性、平均呼吸率\n- **活动模式**：周步数平均、主动日与休息日对比、卡路里燃烧\n- **准备度与恢复**：分数趋势、压力与恢复平衡、体温趋势\n- **恢复力**：日级别趋势（限于 exceptional 级别）、贡献因素分解\n- **健身指标**：VO2max 趋势（ml/kg/min）、心血管年龄趋势、周对比变化\n- **锻炼记录**：锻炼类型、时长、强度\n\n资料来源：[skills/health-weekly/SKILL.md:1-50](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-weekly/SKILL.md)\n\n### 3. 每日训练报告 (daily-training-report)\n\n每日训练报告将健康数据与习惯追踪、任务管理和教练反馈整合，提供全面的个人训练日报。\n\n**数据采集清单：**\n\n1. 昨日习惯：`get_habits_for_date`（昨日日期）\n2. 今日习惯：`get_habits_for_date`（今日日期）\n3. 所有习惯：`get_habits`（连续记录概览）\n4. 睡眠：`get_health_sleep`（days=1）\n5. 准备度：`get_health_readiness`（days=1）\n6. 活动：`get_health_activity`（days=1）\n7. 今日日程：`get_daily_agenda`\n8. 今日任务：`get_todays_tasks`\n9. 年度目标：`get_initiatives`\n10. 教练待办：`get_coaching_action_items`\n\n**报告输出结构：**\n\n```\n**昨日成果**\n- 习惯记分卡：X/Y 完成（列出每项习惯及状态）\n- 连续记录保持或中断（明确指出中断的连续记录）\n- 健康数据：睡眠分数、准备度分数、活动分数\n- 日评分：基于习惯完成率和健康数据\n\n**今日计划**\n- Top 3 优先级（来自日程和置顶任务）\n- 今日习惯安排（含连续计数）\n- 健康建议\n```\n\n资料来源：[skills/daily-training-report/SKILL.md:1-40](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-training-report/SKILL.md)\n\n## 数据流向图\n\n```mermaid\ngraph LR\n    A[Oura Ring] -->|实时同步| B[Convex 后端]\n    B -->|数据存储| C[健康数据表]\n    C -->|MCP 工具| D[health-check]\n    C -->|MCP 工具| E[health-weekly]\n    C -->|MCP 工具| F[daily-training-report]\n    D -->|输出| G[快速概览]\n    E -->|输出| H[详细周报]\n    F -->|输出| I[训练日报]\n    G -->|整合| J[用户决策]\n    H -->|整合| J\n    I -->|整合| J\n```\n\n## 健康指标参考表\n\n| 指标名称 | 单位 | 正常范围参考 | 数据来源 |\n|---------|------|-------------|---------|\n| 睡眠分数 | 分 | 80-100 优秀, 60-80 良好, <60 需改善 | Oura Ring |\n| 准备度分数 | 分 | 80-100 优秀, 60-80 良好, <60 需注意 | Oura Ring |\n| 活动分数 | 分 | 动态目标 | Oura Ring |\n| 静息心率 | bpm | 50-70 成人正常范围 | Oura Ring |\n| HRV | ms | 20-100 正常范围（因人而异） | Oura Ring |\n| VO2max | ml/kg/min | 35-50 成年男性, 25-40 成年女性 | Oura Ring 估算 |\n| SpO2 | % | 95-100 正常 | Oura Ring |\n| 心血管年龄 | 岁 | 与实际年龄对比 | Oura Ring 估算 |\n\n## 使用场景\n\n### 场景一：晨间快速检视\n\n用户在早晨启动工作前，希望快速了解昨夜睡眠质量和今日身体准备状态。\n\n```\n调用：/health-check\n默认回溯：7 天\n输出：简洁的健康仪表板，包含关键指标和洞察\n```\n\n### 场景二：周末健康复盘\n\n用户在周末进行深度健康回顾，分析两周内的趋势变化。\n\n```\n调用：/health-weekly\n回溯天数：14 天\n输出：详细的周健康报告，包含趋势分析和改进建议\n```\n\n### 场景三：训练日报整合\n\n运动员或健身爱好者将健康数据与当日任务、习惯追踪整合。\n\n```\n调用：/daily-training-report\n整合数据：睡眠、准备度、活动 + 习惯 + 日程 + 教练反馈\n输出：全面的个人训练日报\n```\n\n## 配置要求\n\n健康数据集成需要以下环境配置：\n\n| 环境变量 | 说明 | 示例 |\n|---------|------|-----|\n| `LIFEOS_CONVEX_URL` | Convex 部署地址 | `https://your-app.convex.site` |\n| `LIFEOS_USER_ID` | 用户标识 | `your-user-id` |\n| `LIFEOS_API_KEY` | API 密钥 | `your-api-key` |\n\n资料来源：[README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n\n## 与其他模块的集成\n\n健康数据不仅是独立的健康监测功能，还与 LifeOS 的其他核心功能深度集成：\n\n```mermaid\ngraph TD\n    A[健康数据 Oura] --> B[习惯系统]\n    A --> C[任务系统]\n    A --> D[教练系统]\n    A --> E[日程系统]\n    A --> F[PPV 人生设计]\n    B --> G[每日训练报告]\n    C --> G\n    D --> G\n    E --> G\n```\n\n### 集成点说明\n\n| 集成模块 | 集成方式 | 说明 |\n|---------|---------|------|\n| 习惯系统 | `get_habits`, `get_habits_for_date` | 将健康指标与习惯完成度关联分析 |\n| 任务系统 | `get_todays_tasks`, `get_daily_agenda` | 基于健康状态调整当日任务优先级 |\n| 教练系统 | `get_coaching_action_items` | 将健康洞察转化为教练行动项 |\n| 日程系统 | `get_daily_agenda` | 根据准备度分数优化日程安排 |\n| PPV 人生设计 | `get_initiatives` | 将长期健康目标与年度倡议关联 |\n\n## 最佳实践\n\n1. **定期回顾**：建议每周运行一次 `/health-weekly`，识别健康趋势\n2. **数据驱动决策**：根据准备度分数调整高强度任务的安排\n3. **习惯关联**：将健康指标与习惯系统结合，形成完整的自我管理系统\n4. **教练整合**：将健康数据洞察转化为可执行的教练行动项\n5. **连续记录监控**：关注连续记录状态，避免因中断影响长期数据准确性\n\n## 技术限制\n\n- 健康数据回溯天数受 MCP 工具参数限制，默认最大为 14 天\n- VO2max 和心血管年龄为估算值，仅供参考\n- 恢复力数据级别显示限于 `exceptional` 级别\n- 锻炼记录优先使用 `label` 而非 `activity` 字段作为显示名称\n\n---\n\n<a id='page-finance-management'></a>\n\n## 财务管理\n\n### 相关页面\n\n相关主题：[健康数据集成 (Oura Ring)](#page-health-integration)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [skills/finance-overview/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/finance-overview/SKILL.md)\n- [skills/finance-spending/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/finance-spending/SKILL.md)\n- [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n- [AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n</details>\n\n# 财务管理\n\n## 概述\n\n财务管理（Financial Management）是LifeOS插件的核心功能模块之一，为用户提供全面的个人财务可视化和分析能力。该模块通过与Convex后端集成，实时获取用户的财务数据，包括净资产概览、账户余额、交易记录和支出模式分析。\n\n财务管理模块的核心价值在于将分散的财务数据聚合为可操作的洞察，帮助用户了解财务状况、追踪消费习惯、监控净资产趋势。\n\n资料来源：[README.md]()\n\n## 技能清单\n\n| 技能名称 | 用途 |\n|---------|------|\n| `finance-overview` | 净资产摘要、账户余额、净值趋势 |\n| `finance-spending` | 支出分析、消费模式、近期交易 |\n\n资料来源：[README.md](), [AGENTS.md]()\n\n## 架构设计\n\n### 数据流架构\n\n```mermaid\ngraph TD\n    A[用户请求] --> B[Skill 技能层]\n    B --> C{技能类型}\n    C -->|概览| D[finance-overview]\n    C -->|支出| E[finance-spending]\n    D --> F[get_finance_net_worth]\n    D --> G[get_finance_accounts]\n    D --> H[get_finance_snapshots]\n    E --> I[get_finance_daily_spending]\n    E --> J[get_finance_transactions]\n    F --> K[Convex 后端]\n    G --> K\n    H --> K\n    I --> K\n    J --> K\n    K --> L[数据聚合处理]\n    L --> M[美元转换]\n    M --> N[可视化报告]\n```\n\n### MCP工具集成\n\n财务管理的底层由126个MCP工具支撑，其中专门用于财务数据访问的工具包括：\n\n| 工具名称 | 功能描述 |\n|---------|---------|\n| `get_finance_net_worth` | 获取当前净资产和账户分类 |\n| `get_finance_accounts` | 获取所有账户详情 |\n| `get_finance_snapshots` | 获取净资产历史快照 |\n| `get_finance_daily_spending` | 获取每日支出聚合数据 |\n| `get_finance_transactions` | 获取交易记录明细 |\n\n资料来源：[AGENTS.md]()\n\n## finance-overview 技能详解\n\n### 功能描述\n\n`finance-overview` 技能提供完整的财务概览视图，整合净资产、资产配置和负债信息，以仪表盘形式呈现给用户。\n\n### 核心流程\n\n1. 调用 `get_finance_net_worth` 获取当前净资产及账户分类\n2. 调用 `get_finance_accounts` 获取所有账户详细信息\n3. 调用 `get_finance_snapshots` 获取90天净值历史趋势\n4. 聚合数据并转换为美元格式\n5. 生成可视化财务仪表盘\n\n资料来源：[skills/finance-overview/SKILL.md]()\n\n### 输出内容\n\n| 模块 | 描述 |\n|-----|------|\n| **Net Worth** | 当前净资产总额及周期变化 |\n| **Assets** | 资产总计，按账户类型分类（活期存款、储蓄、投资、退休账户） |\n| **Liabilities** | 负债总计，按类型分类（信用卡、贷款） |\n| **Trend** | 过去90天净资产走向（增长/下降/稳定） |\n| **Accounts** | 账户清单，包含名称、类型、当前余额 |\n| **Insights** | 显著变化或规律分析 |\n\n### 数据转换规则\n\n所有从后端获取的金额数据均以**美分为单位**存储，技能层负责将其转换为美元格式并以货币形式展示。\n\n```python\n# 伪代码示例\namount_in_cents = 12345\namount_in_dollars = amount_in_cents / 100\nformatted = f\"${amount_in_dollars:,.2f}\"  # $123.45\n```\n\n资料来源：[skills/finance-overview/SKILL.md]()\n\n### 可选参数\n\n| 参数 | 说明 | 默认值 |\n|-----|------|-------|\n| `$ARGUMENTS` 中的数字 | 覆盖趋势数据天数 | 90天 |\n\n## finance-spending 技能详解\n\n### 功能描述\n\n`finance-spending` 技能专注于消费行为分析，帮助用户识别消费模式、高消费日和异常支出。\n\n### 核心流程\n\n1. 调用 `get_finance_daily_spending` 获取最近30天的每日收入/支出聚合数据\n2. 调用 `get_finance_transactions` 获取最近50笔交易详情\n3. 分析消费模式并识别规律\n4. 生成支出分析报告\n\n资料来源：[skills/finance-spending/SKILL.md]()\n\n### 输出内容\n\n| 模块 | 描述 |\n|-----|------|\n| **Summary** | 周期内总收入、总支出、净收入 |\n| **Daily Average** | 日均支出金额 |\n| **Spending Pattern** | 高消费日识别、消费规律分析 |\n| **Recent Transactions** | 最近交易的显著条目 |\n| **Insights** | 消费趋势、异常活动、改进建议 |\n\n### 可选参数\n\n| 参数 | 说明 | 默认值 |\n|-----|------|-------|\n| `$ARGUMENTS` 中的数字 | 指定分析天数 | 30天 |\n\n## MCP 工具详细规格\n\n### get_finance_net_worth\n\n获取用户的净资产数据，包括资产和负债的分类汇总。\n\n**调用方式：**\n```json\n{\n  \"name\": \"get_finance_net_worth\",\n  \"arguments\": {}\n}\n```\n\n**返回值结构：**\n```json\n{\n  \"totalNetWorth\": 123456789,\n  \"totalAssets\": 150000000,\n  \"totalLiabilities\": 26543211,\n  \"breakdown\": {\n    \"assets\": [...],\n    \"liabilities\": [...]\n  }\n}\n```\n\n> 注意：所有金额以**美分**为单位存储\n\n### get_finance_accounts\n\n获取用户所有关联的金融账户信息。\n\n**调用方式：**\n```json\n{\n  \"name\": \"get_finance_accounts\",\n  \"arguments\": {}\n}\n```\n\n**返回值结构：**\n```json\n{\n  \"accounts\": [\n    {\n      \"id\": \"acc_xxx\",\n      \"name\": \"主要支票账户\",\n      \"type\": \"checking\",\n      \"balance\": 500000\n    }\n  ]\n}\n```\n\n### get_finance_snapshots\n\n获取指定时间范围内的净资产历史快照，用于趋势分析。\n\n**调用方式：**\n```json\n{\n  \"name\": \"get_finance_snapshots\",\n  \"arguments\": {\n    \"days\": 90\n  }\n}\n```\n\n### get_finance_daily_spending\n\n获取每日支出聚合数据，用于消费模式分析。\n\n**调用方式：**\n```json\n{\n  \"name\": \"get_finance_daily_spending\",\n  \"arguments\": {\n    \"days\": 30\n  }\n}\n```\n\n### get_finance_transactions\n\n获取最近的交易记录明细。\n\n**调用方式：**\n```json\n{\n  \"name\": \"get_finance_transactions\",\n  \"arguments\": {\n    \"limit\": 50\n  }\n}\n```\n\n资料来源：[AGENTS.md]()\n\n## 使用示例\n\n### 场景一：查看财务概览\n\n```\n用户输入: /finance-overview\n```\n\n**执行流程：**\n\n```mermaid\nsequenceDiagram\n    participant U as 用户\n    participant S as Skill\n    participant M as MCP Server\n    participant C as Convex\n    \n    U->>S: /finance-overview\n    S->>M: get_finance_net_worth\n    M->>C: 查询净资产\n    C-->>M: 返回数据\n    M-->>S: net_worth 数据\n    S->>M: get_finance_accounts\n    M->>C: 查询账户\n    C-->>M: 账户列表\n    M-->>S: accounts 数据\n    S->>M: get_finance_snapshots\n    M->>C: 查询90天快照\n    C-->>M: 快照历史\n    M-->>S: snapshots 数据\n    S->>S: 数据聚合处理\n    S->>S: 美分→美元转换\n    S-->>U: 财务仪表盘\n```\n\n### 场景二：分析90天消费趋势\n\n```\n用户输入: /finance-spending 90\n```\n\n此命令将分析过去90天的支出数据，而非默认的30天。\n\n### 场景三：与其他技能联动\n\n财务管理可与 `daily-training-report` 技能联动，在每日训练报告中包含财务健康检查：\n\n```mermaid\ngraph LR\n    A[daily-training-report] --> B[财务快照]\n    B --> C{财务状态}\n    C -->|正常| D[纳入报告]\n    C -->|异常| E[预警提示]\n```\n\n资料来源：[skills/daily-training-report/SKILL.md]()\n\n## 数据存储规范\n\n### 单位约定\n\n| 数据类型 | 存储单位 | 显示单位 |\n|---------|---------|---------|\n| 金额 | 美分 (cents) | 美元 (dollars) |\n| 百分比 | 基点或小数 | 百分比 |\n\n### 转换函数\n\n```python\ndef cents_to_dollars(cents: int) -> float:\n    \"\"\"美分支转换为美元\"\"\"\n    return cents / 100\n\ndef format_currency(cents: int) -> str:\n    \"\"\"格式化为货币字符串\"\"\"\n    return f\"${cents_to_dollars(cents):,.2f}\"\n```\n\n## 最佳实践\n\n### 1. 定期查看财务概览\n\n建议用户每周运行一次 `finance-overview` 技能，以监控净资产变化趋势。\n\n### 2. 支出模式识别\n\n利用 `finance-spending` 的消费模式分析功能，识别非必要的开支。\n\n### 3. 参数优化\n\n- 需要快速概览时使用默认参数\n- 需要深度分析时可传入更长的时间范围（如90天或180天）\n\n### 4. 数据整合\n\n财务数据可与习惯追踪、健康数据整合，形成全面的个人生产力报告。\n\n## 扩展能力\n\n财务管理模块未来可能支持：\n\n- 预算设置与追踪\n- 账单提醒\n- 投资组合分析\n- 税务优化建议\n- 多币种支持\n\n---\n\n*本页面最后更新基于 lifeos-plugin 仓库当前版本。*\n\n---\n\n<a id='page-people-relationships'></a>\n\n## 人际关系管理\n\n### 相关页面\n\n相关主题：[项目与客户管理](#page-project-management)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [skills/contact-lookup/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/contact-lookup/SKILL.md)\n- [skills/meeting-prep/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/meeting-prep/SKILL.md)\n- [skills/follow-ups/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/follow-ups/SKILL.md)\n- [skills/relationship-pulse/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/relationship-pulse/SKILL.md)\n- [skills/context-switch/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/context-switch/SKILL.md)\n</details>\n\n# 人际关系管理\n\n## 概述\n\n人际关系管理是 LifeOS Plugin 中的核心功能模块，通过 MCP 工具与 LifeOS 系统集成，提供联系人查询、会议准备、后续跟进、关系健康监测以及快速上下文切换等能力。该模块旨在帮助用户维护和深化与客户、合作伙伴及团队成员的关系，同时确保重要互动不会被遗漏。\n\n人际关系管理功能覆盖了从初次联系到持续维护的完整关系生命周期，支持通过 AI 洞察分析沟通风格和关系状态。资料来源：[README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n\n## 核心技能体系\n\n### 技能概览\n\n| 技能名称 | 命令 | 功能描述 |\n|---------|------|----------|\n| contact-lookup | `/contact-lookup \"姓名\"` | 完整联系人档案，含 AI 洞察 |\n| meeting-prep | `/meeting-prep \"姓名\"` | 会议准备，含完整上下文和讨论要点 |\n| follow-ups | `/follow-ups` | 追踪需要回复的人及客户 |\n| relationship-pulse | `/relationship-pulse` | 检查被忽视的关系 |\n| context-switch | `/context-switch \"客户/项目\"` | 快速加载客户或项目的上下文 |\n\n资料来源：[AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n\n### 架构流程图\n\n```mermaid\ngraph TD\n    A[用户请求] --> B{请求类型}\n    B -->|联系人查询| C[contact-lookup]\n    B -->|会议准备| D[meeting-prep]\n    B -->|跟进追踪| E[follow-ups]\n    B -->|关系健康| F[relationship-pulse]\n    B -->|上下文切换| G[context-switch]\n    \n    C --> H[get_contact_dossier]\n    D --> I[get_planning_context]\n    E --> J[数据聚合]\n    F --> K[关系分析]\n    G --> L[快速加载]\n    \n    H --> M[展示联系人档案]\n    I --> N[展示会议上下文]\n    J --> O[待跟进列表]\n    K --> P[关系状态报告]\n    L --> Q[上下文摘要]\n```\n\n## 联系人档案查询\n\n### 功能说明\n\n`contact-lookup` 技能提供完整的联系人档案查询能力，支持通过姓名进行模糊搜索，返回联系人的全面信息包括个人资料、AI 生成的性格洞察、沟通风格建议以及历史互动记录。\n\n资料来源：[skills/contact-lookup/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/contact-lookup/SKILL.md)\n\n### 工作流程\n\n```mermaid\ngraph LR\n    A[输入: 联系人姓名] --> B[get_contact_dossier]\n    B --> C[返回档案数据]\n    C --> D{数据结构}\n    D -->|人员信息| E[Profile 档案]\n    D -->|AI洞察| F[AI Insights]\n    D -->|消息| G[Beeper Threads]\n    D -->|会议| H[Granola Meetings]\n    D -->|语音| I[Voice Memos]\n    E --> J[格式化展示]\n    F --> J\n    G --> J\n    H --> J\n    I --> J\n```\n\n### 档案展示结构\n\n| 模块 | 内容说明 |\n|------|----------|\n| Profile | 姓名、关系类型、联系方式、个人笔记 |\n| AI Insights | 沟通风格、性格特征、关系维护建议 |\n| Recent Interactions | 按时间排序的语音、会议、消息记录 |\n| Meeting History | Granola 会议及关键要点 |\n| Chat Threads | Beeper 对话线程链接 |\n\n### 使用要求\n\n- 参数：`$ARGUMENTS` 必须包含联系人姓名\n- 工具调用：`get_contact_dossier` with `nameQuery`\n- 无姓名时系统会提示用户输入\n\n## 会议准备\n\n### 功能说明\n\n`meeting-prep` 技能帮助用户在进行会议前全面了解与会者的背景信息，聚合相关项目进展、历史沟通、开放任务等上下文，支持用户带着充分的准备进入会议。\n\n资料来源：[skills/meeting-prep/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/meeting-prep/SKILL.md)\n\n### 准备内容\n\n| 类别 | 内容 |\n|------|------|\n| 联系人档案 | 对方的基本信息和 AI 洞察 |\n| 项目上下文 | 相关项目的当前状态和进展 |\n| 历史沟通 | Beeper 消息和 Granola 会议记录 |\n| 开放任务 | 与对方相关的待处理任务 |\n| 讨论要点 | 基于上下文生成的建议话题 |\n\n### MCP 工具依赖\n\n```mermaid\ngraph TD\n    A[meeting-prep] --> B[get_contact_dossier]\n    A --> C[get_client_success_workspace]\n    A --> D[get_beeper_thread_messages]\n    A --> E[get_granola_meeting]\n    A --> F[get_fathom_meeting]\n    A --> G[get_client_notes]\n    \n    B --> H[基本信息]\n    C --> I[项目与任务]\n    D --> J[聊天记录]\n    E --> K[会议记录]\n    F --> L[Fathom 录制]\n    G --> M[历史笔记]\n```\n\n## 跟进追踪\n\n### 功能说明\n\n`follow-ups` 技能主动识别需要与用户进行后续互动的联系人，确保重要关系不会被忽视。该功能会扫描系统中的互动记录和任务状态，生成需要跟进的人员清单。\n\n资料来源：[skills/follow-ups/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/follow-ups/SKILL.md)\n\n### 追踪范围\n\n| 类型 | 说明 |\n|------|------|\n| 待回复消息 | 对方发送但尚未回复的消息 |\n| 会议后续 | 约定但未完成的后续行动 |\n| 承诺事项 | 承诺但尚未兑现的承诺 |\n| 过期跟进 | 超过预设时间的未跟进记录 |\n\n## 关系健康监测\n\n### 功能说明\n\n`relationship-pulse` 技能通过分析互动频率、响应时间和关系紧密度等指标，识别可能被用户忽视的关系，帮助用户主动维护重要的人际网络。\n\n资料来源：[skills/relationship-pulse/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/relationship-pulse/SKILL.md)\n\n### 健康指标\n\n| 指标 | 定义 | 阈值说明 |\n|------|------|----------|\n| 互动频率 | 单位时间内与联系人的互动次数 | 低于设定值为警示 |\n| 最后互动 | 上次联系距今的时间 | 超过30天为警示 |\n| 响应率 | 消息回复比例 | 低于60%为警示 |\n| 承诺兑现率 | 承诺事项完成比例 | 低于80%为警示 |\n\n## 快速上下文切换\n\n### 功能说明\n\n`context-switch` 技能支持用户在不同客户或项目之间快速切换，加载目标对象的相关信息，减少上下文切换带来的认知负担，提升多任务处理效率。\n\n资料来源：[skills/context-switch/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/context-switch/SKILL.md)\n\n### 上下文内容\n\n| 内容模块 | 说明 |\n|----------|------|\n| 项目状态 | 当前项目的阶段、里程碑、障碍 |\n| 相关任务 | 与该上下文关联的开放任务 |\n| 最近更新 | 最近的活动记录和变更 |\n| 关键人员 | 项目或客户相关的联系人 |\n| 重要文档 | 相关的笔记和文件 |\n\n### 使用场景\n\n```mermaid\ngraph TD\n    A[当前上下文] --> B[调用 context-switch]\n    B --> C[输入: 客户/项目名称]\n    C --> D[加载目标上下文]\n    D --> E[展示快速摘要]\n    E --> F[开始新工作]\n    \n    G[定期切换] --> H[保持全局视野]\n    G --> I[避免信息孤岛]\n```\n\n## MCP 工具集\n\n### 联系人相关工具\n\n| 工具名称 | 功能 | 主要参数 |\n|----------|------|----------|\n| `get_contact_dossier` | 获取完整联系人档案 | `nameQuery` |\n| `get_person_graph` | 获取人物关系图 | `personId` |\n| `get_beeper_thread_messages` | 获取聊天消息 | `threadId` |\n| `get_granola_meeting` | 获取 Granola 会议 | `meetingId` |\n| `get_fathom_meeting` | 获取 Fathom 会议 | `meetingId` |\n\n### 数据模型\n\n```mermaid\nerDiagram\n    CONTACT ||--o{ INTERACTION : has\n    CONTACT ||--o{ PROJECT : related_to\n    CONTACT {\n        string id PK\n        string name\n        string relationshipType\n        string email\n        string phone\n        string notes\n        json aiInsights\n    }\n    INTERACTION {\n        string id PK\n        string contactId FK\n        string type \"message|meeting|voice\"\n        datetime timestamp\n        string summary\n    }\n```\n\n## 最佳实践\n\n### 1. 定期关系维护\n\n- 每周运行一次 `relationship-pulse` 检查被忽视的关系\n- 使用 `follow-ups` 作为每周回顾的一部分\n- 为重要联系人设置定期跟进提醒\n\n### 2. 会议准备流程\n\n- 会议前使用 `meeting-prep` 获取完整上下文\n- 查看对方的 AI 洞察了解沟通偏好\n- 回顾历史互动记录避免重复话题\n\n### 3. 上下文管理\n\n- 在多项目环境中频繁使用 `context-switch`\n- 切换后快速确认上下文正确性\n- 完成项目后主动切换回全局视图\n\n### 4. 联系人数据维护\n\n- 通过 `contact-lookup` 定期审查联系人档案\n- 更新过时信息保持数据准确性\n- 利用 AI Insights 改善沟通方式\n\n## 配置与集成\n\n### MCP 服务配置\n\n```json\n{\n  \"mcpServers\": {\n    \"lifeos\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@starascendin/lifeos-mcp@latest\",\n        \"--url\", \"YOUR_CONVEX_URL\",\n        \"--user-id\", \"YOUR_USER_ID\",\n        \"--api-key\", \"YOUR_API_KEY\"\n      ]\n    }\n  }\n}\n```\n\n### 环境变量配置\n\n| 变量名 | 说明 | 必需 |\n|--------|------|------|\n| `LIFEOS_CONVEX_URL` | Convex 部署地址 | 是 |\n| `LIFEOS_USER_ID` | 用户标识 | 是 |\n| `LIFEOS_API_KEY` | API 认证密钥 | 是 |\n\n资料来源：[README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n\n## 相关技能索引\n\n| 类别 | 技能 | 关联关系 |\n|------|------|----------|\n| 日常流程 | daily-standup | 包含人员互动摘要 |\n| 客户管理 | client-brief | 整合联系人数据 |\n| 客户管理 | client-health | 关系健康指标 |\n| 客户管理 | customer-success-triage | 依赖联系人档案 |\n| 项目管理 | project-status | 包含项目人员信息 |\n\n## 总结\n\n人际关系管理模块构成了 LifeOS Plugin 中维护人际网络的完整解决方案。通过 `contact-lookup`、`meeting-prep`、`follow-ups`、`relationship-pulse` 和 `context-switch` 五个核心技能的协同工作，用户可以实现从联系人信息管理到关系健康监测的全面覆盖。该模块深度集成了 Beeper 消息、Granola 会议、Fathom 录制和语音备忘录等多个数据源，结合 AI 生成的洞察分析，帮助用户建立更有效的人际沟通策略。\n\n---\n\n---\n\n## Doramagic 踩坑日志\n\n项目：starascendin/lifeos-plugin\n\n摘要：发现 8 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：配置坑 - 可能修改宿主 AI 配置。\n\n## 1. 配置坑 · 可能修改宿主 AI 配置\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。\n- 对用户的影响：安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。\n- 建议检查：列出会写入的配置文件、目录和卸载/回滚步骤。\n- 防护动作：涉及宿主配置目录时必须给回滚路径，不能只给安装命令。\n- 证据：capability.host_targets | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | host_targets=mcp_host, claude, claude_code\n\n## 2. 能力坑 · 能力判断依赖假设\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：README/documentation is current enough for a first validation pass.\n- 对用户的影响：假设不成立时，用户拿不到承诺的能力。\n- 建议检查：将假设转成下游验证清单。\n- 防护动作：假设必须转成验证项；没有验证结果前不能写成事实。\n- 证据：capability.assumptions | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | README/documentation is current enough for a first validation pass.\n\n## 3. 维护坑 · 维护活跃度未知\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：未记录 last_activity_observed。\n- 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。\n- 建议检查：补 GitHub 最近 commit、release、issue/PR 响应信号。\n- 防护动作：维护活跃度未知时，推荐强度不能标为高信任。\n- 证据：evidence.maintainer_signals | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | last_activity_observed missing\n\n## 4. 安全/权限坑 · 下游验证发现风险项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：下游已经要求复核，不能在页面中弱化。\n- 建议检查：进入安全/权限治理复核队列。\n- 防护动作：下游风险存在时必须保持 review/recommendation 降级。\n- 证据：downstream_validation.risk_items | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | no_demo; severity=medium\n\n## 5. 安全/权限坑 · 存在安全注意事项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：No sandbox install has been executed yet; downstream must verify before user use.\n- 对用户的影响：用户安装前需要知道权限边界和敏感操作。\n- 建议检查：转成明确权限清单和安全审查提示。\n- 防护动作：安全注意事项必须面向用户前置展示。\n- 证据：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.\n\n## 6. 安全/权限坑 · 存在评分风险\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：风险会影响是否适合普通用户安装。\n- 建议检查：把风险写入边界卡，并确认是否需要人工复核。\n- 防护动作：评分风险必须进入边界卡，不能只作为内部分数。\n- 证据：risks.scoring_risks | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | no_demo; severity=medium\n\n## 7. 维护坑 · issue/PR 响应质量未知\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：issue_or_pr_quality=unknown。\n- 对用户的影响：用户无法判断遇到问题后是否有人维护。\n- 建议检查：抽样最近 issue/PR，判断是否长期无人处理。\n- 防护动作：issue/PR 响应未知时，必须提示维护风险。\n- 证据：evidence.maintainer_signals | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | issue_or_pr_quality=unknown\n\n## 8. 维护坑 · 发布节奏不明确\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：release_recency=unknown。\n- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。\n- 建议检查：确认最近 release/tag 和 README 安装命令是否一致。\n- 防护动作：发布节奏未知或过期时，安装说明必须标注可能漂移。\n- 证据：evidence.maintainer_signals | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | release_recency=unknown\n\n<!-- canonical_name: starascendin/lifeos-plugin; human_manual_source: deepwiki_human_wiki -->\n",
      "markdown_key": "lifeos-plugin",
      "pages": "draft",
      "source_refs": [
        {
          "evidence_id": "github_repo:1156470663",
          "kind": "repo",
          "supports_claim_ids": [
            "claim_identity",
            "claim_distribution",
            "claim_capability"
          ],
          "url": "https://github.com/starascendin/lifeos-plugin"
        },
        {
          "evidence_id": "art_9414d1f5788f4226888c26ef330151e0",
          "kind": "docs",
          "supports_claim_ids": [
            "claim_identity",
            "claim_distribution",
            "claim_capability"
          ],
          "url": "https://github.com/starascendin/lifeos-plugin#readme"
        }
      ],
      "summary": "DeepWiki/Human Wiki 完整输出，末尾追加 Discovery Agent 踩坑日志。",
      "title": "lifeos-plugin 说明书",
      "toc": [
        "https://github.com/starascendin/lifeos-plugin 项目说明书",
        "目录",
        "项目介绍",
        "概述",
        "系统架构",
        "技能体系",
        "MCP 工具集",
        "安装与配置",
        "Doramagic 踩坑日志"
      ]
    }
  },
  "quality_gate": {
    "blocking_gaps": [],
    "category_confidence": "medium",
    "compile_status": "ready_for_review",
    "five_assets_present": true,
    "install_sandbox_verified": true,
    "missing_evidence": [],
    "next_action": "publish to Doramagic.ai project surfaces",
    "prompt_preview_boundary_ok": true,
    "publish_status": "publishable",
    "quick_start_verified": true,
    "repo_clone_verified": false,
    "repo_commit": null,
    "repo_inspection_error": null,
    "repo_inspection_files": [],
    "repo_inspection_verified": false,
    "review_reasons": [
      "community_discussion_evidence_below_public_threshold"
    ],
    "tag_count_ok": true,
    "unsupported_claims": []
  },
  "schema_version": "0.1",
  "user_assets": {
    "ai_context_pack": {
      "asset_id": "ai_context_pack",
      "filename": "AI_CONTEXT_PACK.md",
      "markdown": "# lifeos-plugin - Doramagic AI Context Pack\n\n> 定位：安装前体验与判断资产。它帮助宿主 AI 有一个好的开始，但不代表已经安装、执行或验证目标项目。\n\n## 充分原则\n\n- **充分原则，不是压缩原则**：AI Context Pack 应该充分到让宿主 AI 在开工前理解项目价值、能力边界、使用入口、风险和证据来源；它可以分层组织，但不以最短摘要为目标。\n- **压缩策略**：只压缩噪声和重复内容，不压缩会影响判断和开工质量的上下文。\n\n## 给宿主 AI 的使用方式\n\n你正在读取 Doramagic 为 lifeos-plugin 编译的 AI Context Pack。请把它当作开工前上下文：帮助用户理解适合谁、能做什么、如何开始、哪些必须安装后验证、风险在哪里。不要声称你已经安装、运行或执行了目标项目。\n\n## Claim 消费规则\n\n- **事实来源**：Repo Evidence + Claim/Evidence Graph；Human Wiki 只提供显著性、术语和叙事结构。\n- **事实最低状态**：`supported`\n- `supported`：可以作为项目事实使用，但回答中必须引用 claim_id 和证据路径。\n- `weak`：只能作为低置信度线索，必须要求用户继续核实。\n- `inferred`：只能用于风险提示或待确认问题，不能包装成项目事实。\n- `unverified`：不得作为事实使用，应明确说证据不足。\n- `contradicted`：必须展示冲突来源，不得替用户强行选择一个版本。\n\n## 它最适合谁\n\n- **正在使用 Claude/Codex/Cursor/Gemini 等宿主 AI 的开发者**：README 或插件配置提到多个宿主 AI。 证据：`README.md` Claim：`clm_0004` supported 0.86\n- **希望把专业流程带进宿主 AI 的用户**：仓库包含 Skill 文档。 证据：`skills/blind-spot-finder/SKILL.md`, `skills/capture/SKILL.md`, `skills/client-brief/SKILL.md`, `skills/client-health/SKILL.md` 等 Claim：`clm_0005` supported 0.86\n\n## 它能做什么\n\n- **AI Skill / Agent 指令资产库**（可做安装前预览）：项目包含可被宿主 AI 读取的 Skill 或 Agent 指令文件，可用于把专业流程带入 Claude、Codex、Cursor 等宿主。 证据：`skills/blind-spot-finder/SKILL.md`, `skills/capture/SKILL.md`, `skills/client-brief/SKILL.md`, `skills/client-health/SKILL.md` 等 Claim：`clm_0001` supported 0.86\n- **多宿主安装与分发**（需要安装后验证）：项目包含插件或 marketplace 配置，说明它面向一个或多个 AI 宿主的安装和分发。 证据：`.claude-plugin/plugin.json` Claim：`clm_0002` supported 0.86\n- **命令行启动或安装流程**（需要安装后验证）：项目文档中存在可执行命令，真实使用需要在本地或宿主环境中运行这些命令。 证据：`AGENTS.md`, `README.md` Claim：`clm_0003` supported 0.86\n\n## 怎么开始\n\n- `npm install -g @starascendin/lifeos-mcp` 证据：`README.md` Claim：`clm_0006` supported 0.86\n- `git clone git@github.com:starascendin/lifeos-plugin.git /tmp/lifeos-plugin` 证据：`AGENTS.md` Claim：`clm_0007` supported 0.86\n- `git clone git@github.com:starascendin/lifeos-plugin.git /opt/lifeos-plugin` 证据：`AGENTS.md` Claim：`clm_0008` supported 0.86\n- `git clone git@github.com:starascendin/lifeos-plugin.git /shared/lifeos-plugin` 证据：`AGENTS.md` Claim：`clm_0009` supported 0.86\n\n## 继续前判断卡\n\n- **当前建议**：需要管理员/安全审批\n- **为什么**：继续前可能涉及密钥、账号、外部服务或敏感上下文，建议先经过管理员或安全审批。\n\n### 30 秒判断\n\n- **现在怎么做**：需要管理员/安全审批\n- **最小安全下一步**：先跑 Prompt Preview；若涉及凭证或企业环境，先审批再试装\n- **先别相信**：工具权限边界不能在安装前相信。\n- **继续会触碰**：命令执行、宿主 AI 配置、本地环境或项目文件\n\n### 现在可以相信\n\n- **适合人群线索：正在使用 Claude/Codex/Cursor/Gemini 等宿主 AI 的开发者**（supported）：有 supported claim 或项目证据支撑，但仍不等于真实安装效果。 证据：`README.md` Claim：`clm_0004` supported 0.86\n- **适合人群线索：希望把专业流程带进宿主 AI 的用户**（supported）：有 supported claim 或项目证据支撑，但仍不等于真实安装效果。 证据：`skills/blind-spot-finder/SKILL.md`, `skills/capture/SKILL.md`, `skills/client-brief/SKILL.md`, `skills/client-health/SKILL.md` 等 Claim：`clm_0005` supported 0.86\n- **能力存在：AI Skill / Agent 指令资产库**（supported）：可以相信项目包含这类能力线索；是否适合你的具体任务仍要试用或安装后验证。 证据：`skills/blind-spot-finder/SKILL.md`, `skills/capture/SKILL.md`, `skills/client-brief/SKILL.md`, `skills/client-health/SKILL.md` 等 Claim：`clm_0001` supported 0.86\n- **能力存在：多宿主安装与分发**（supported）：可以相信项目包含这类能力线索；是否适合你的具体任务仍要试用或安装后验证。 证据：`.claude-plugin/plugin.json` Claim：`clm_0002` supported 0.86\n- **能力存在：命令行启动或安装流程**（supported）：可以相信项目包含这类能力线索；是否适合你的具体任务仍要试用或安装后验证。 证据：`AGENTS.md`, `README.md` Claim：`clm_0003` supported 0.86\n- **存在 Quick Start / 安装命令线索**（supported）：可以相信项目文档出现过启动或安装入口；不要因此直接在主力环境运行。 证据：`README.md` Claim：`clm_0006` supported 0.86\n\n### 现在还不能相信\n\n- **工具权限边界不能在安装前相信。**（unverified）：MCP/tool 类项目通常会触碰文件、网络、浏览器或外部 API，必须真实检查权限和日志。\n- **真实输出质量不能在安装前相信。**（unverified）：Prompt Preview 只能展示引导方式，不能证明真实项目中的结果质量。\n- **宿主 AI 版本兼容性不能在安装前相信。**（unverified）：Claude、Cursor、Codex、Gemini 等宿主加载规则和版本差异必须在真实环境验证。\n- **不会污染现有宿主 AI 行为，不能直接相信。**（inferred）：Skill、plugin、AGENTS/CLAUDE/GEMINI 指令可能改变宿主 AI 的默认行为。 证据：`.claude-plugin/plugin.json`, `AGENTS.md`, `skills/blind-spot-finder/SKILL.md`, `skills/capture/SKILL.md` 等\n- **可安全回滚不能默认相信。**（unverified）：除非项目明确提供卸载和恢复说明，否则必须先在隔离环境验证。\n- **真实安装后是否与用户当前宿主 AI 版本兼容？**（unverified）：兼容性只能通过实际宿主环境验证。 证据：`.claude-plugin/plugin.json`\n- **项目输出质量是否满足用户具体任务？**（unverified）：安装前预览只能展示流程和边界，不能替代真实评测。\n- **安装命令是否需要网络、权限或全局写入？**（unverified）：这影响企业环境和个人环境的安装风险。 证据：`README.md`\n\n### 继续会触碰什么\n\n- **命令执行**：包管理器、网络下载、本地插件目录、项目配置或用户主目录。 原因：运行第一条命令就可能产生环境改动；必须先判断是否值得跑。 证据：`AGENTS.md`, `README.md`\n- **宿主 AI 配置**：Claude/Codex/Cursor/Gemini/OpenCode 等宿主的 plugin、Skill 或规则加载配置。 原因：宿主配置会改变 AI 后续工作方式，可能和用户已有规则冲突。 证据：`.claude-plugin/plugin.json`, `AGENTS.md`, `skills/blind-spot-finder/SKILL.md`, `skills/capture/SKILL.md` 等\n- **本地环境或项目文件**：安装结果、插件缓存、项目配置或本地依赖目录。 原因：安装前无法证明写入范围和回滚方式，需要隔离验证。 证据：`.claude-plugin/plugin.json`, `AGENTS.md`, `README.md`\n- **环境变量 / API Key**：项目入口文档明确出现 API key、token、secret 或账号凭证配置。 原因：如果真实安装需要凭证，应先使用测试凭证并经过权限/合规判断。 证据：`.mcp.json`, `AGENTS.md`, `README.md`\n- **宿主 AI 上下文**：AI Context Pack、Prompt Preview、Skill 路由、风险规则和项目事实。 原因：导入上下文会影响宿主 AI 后续判断，必须避免把未验证项包装成事实。\n\n### 最小安全下一步\n\n- **先跑 Prompt Preview**：用安装前交互式试用判断工作方式是否匹配，不需要授权或改环境。（适用：任何项目都适用，尤其是输出质量未知时。）\n- **只在隔离目录或测试账号试装**：避免安装命令污染主力宿主 AI、真实项目或用户主目录。（适用：存在命令执行、插件配置或本地写入线索时。）\n- **先备份宿主 AI 配置**：Skill、plugin、规则文件可能改变 Claude/Cursor/Codex 的默认行为。（适用：存在插件 manifest、Skill 或宿主规则入口时。）\n- **不要使用真实生产凭证**：环境变量/API key 一旦进入宿主或工具链，可能产生账号和合规风险。（适用：出现 API、TOKEN、KEY、SECRET 等环境线索时。）\n- **安装后只验证一个最小任务**：先验证加载、兼容、输出质量和回滚，再决定是否深用。（适用：准备从试用进入真实工作流时。）\n\n### 退出方式\n\n- **保留安装前状态**：记录原始宿主配置和项目状态，后续才能判断是否可恢复。\n- **准备移除宿主 plugin / Skill / 规则入口**：如果试装后行为异常，可以把宿主 AI 恢复到试装前状态。\n- **记录安装命令和写入路径**：没有明确卸载说明时，至少要知道哪些目录或配置需要手动清理。\n- **准备撤销测试 API key 或 token**：测试凭证泄露或误用时，可以快速止损。\n- **如果没有回滚路径，不进入主力环境**：不可回滚是继续前阻断项，不应靠信任或运气继续。\n\n## 哪些只能预览\n\n- 解释项目适合谁和能做什么\n- 基于项目文档演示典型对话流程\n- 帮助用户判断是否值得安装或继续研究\n\n## 哪些必须安装后验证\n\n- 真实安装 Skill、插件或 CLI\n- 执行脚本、修改本地文件或访问外部服务\n- 验证真实输出质量、性能和兼容性\n\n## 边界与风险判断卡\n\n- **把安装前预览误认为真实运行**：用户可能高估项目已经完成的配置、权限和兼容性验证。 处理方式：明确区分 prompt_preview_can_do 与 runtime_required。 Claim：`clm_0010` inferred 0.45\n- **宿主 AI 插件或 Skill 规则冲突**：新规则可能改变用户现有宿主 AI 的工作方式。 处理方式：安装前先检查插件 manifest 和 Skill 文件，必要时隔离测试。 证据：`.claude-plugin/plugin.json` Claim：`clm_0011` supported 0.86\n- **命令执行会修改本地环境**：安装命令可能写入用户主目录、宿主插件目录或项目配置。 处理方式：先在隔离环境或测试账号中运行。 证据：`AGENTS.md`, `README.md` Claim：`clm_0012` supported 0.86\n- **待确认**：真实安装后是否与用户当前宿主 AI 版本兼容？。原因：兼容性只能通过实际宿主环境验证。\n- **待确认**：项目输出质量是否满足用户具体任务？。原因：安装前预览只能展示流程和边界，不能替代真实评测。\n- **待确认**：安装命令是否需要网络、权限或全局写入？。原因：这影响企业环境和个人环境的安装风险。\n\n## 开工前工作上下文\n\n### 加载顺序\n\n- 先读取 how_to_use.host_ai_instruction，建立安装前判断资产的边界。\n- 读取 claim_graph_summary，确认事实来自 Claim/Evidence Graph，而不是 Human Wiki 叙事。\n- 再读取 intended_users、capabilities 和 quick_start_candidates，判断用户是否匹配。\n- 需要执行具体任务时，优先查 role_skill_index，再查 evidence_index。\n- 遇到真实安装、文件修改、网络访问、性能或兼容性问题时，转入 risk_card 和 boundaries.runtime_required。\n\n### 任务路由\n\n- **AI Skill / Agent 指令资产库**：先基于 role_skill_index / evidence_index 帮用户挑选可用角色、Skill 或工作流。 边界：可做安装前 Prompt 体验。 证据：`skills/blind-spot-finder/SKILL.md`, `skills/capture/SKILL.md`, `skills/client-brief/SKILL.md`, `skills/client-health/SKILL.md` 等 Claim：`clm_0001` supported 0.86\n- **多宿主安装与分发**：先说明这是安装后验证能力，再给出安装前检查清单。 边界：必须真实安装或运行后验证。 证据：`.claude-plugin/plugin.json` Claim：`clm_0002` supported 0.86\n- **命令行启动或安装流程**：先说明这是安装后验证能力，再给出安装前检查清单。 边界：必须真实安装或运行后验证。 证据：`AGENTS.md`, `README.md` Claim：`clm_0003` supported 0.86\n\n### 上下文规模\n\n- 文件总数：43\n- 重要文件覆盖：40/43\n- 证据索引条目：43\n- 角色 / Skill 条目：38\n\n### 证据不足时的处理\n\n- **missing_evidence**：说明证据不足，要求用户提供目标文件、README 段落或安装后验证记录；不要补全事实。\n- **out_of_scope_request**：说明该任务超出当前 AI Context Pack 证据范围，并建议用户先查看 Human Manual 或真实安装后验证。\n- **runtime_request**：给出安装前检查清单和命令来源，但不要替用户执行命令或声称已执行。\n- **source_conflict**：同时展示冲突来源，标记为待核实，不要强行选择一个版本。\n\n## Prompt Recipes\n\n### 适配判断\n\n- 目标：判断这个项目是否适合用户当前任务。\n- 预期输出：适配结论、关键理由、证据引用、安装前可预览内容、必须安装后验证内容、下一步建议。\n\n```text\n请基于 lifeos-plugin 的 AI Context Pack，先问我 3 个必要问题，然后判断它是否适合我的任务。回答必须包含：适合谁、能做什么、不能做什么、是否值得安装、证据来自哪里。所有项目事实必须引用 evidence_refs、source_paths 或 claim_id。\n```\n\n### 安装前体验\n\n- 目标：让用户在安装前感受核心工作流，同时避免把预览包装成真实能力或营销承诺。\n- 预期输出：一段带边界标签的体验剧本、安装后验证清单和谨慎建议；不含真实运行承诺或强营销表述。\n\n```text\n请把 lifeos-plugin 当作安装前体验资产，而不是已安装工具或真实运行环境。\n\n请严格输出四段：\n1. 先问我 3 个必要问题。\n2. 给出一段“体验剧本”：用 [安装前可预览]、[必须安装后验证]、[证据不足] 三种标签展示它可能如何引导工作流。\n3. 给出安装后验证清单：列出哪些能力只有真实安装、真实宿主加载、真实项目运行后才能确认。\n4. 给出谨慎建议：只能说“值得继续研究/试装”“先补充信息后再判断”或“不建议继续”，不得替项目背书。\n\n硬性边界：\n- 不要声称已经安装、运行、执行测试、修改文件或产生真实结果。\n- 不要写“自动适配”“确保通过”“完美适配”“强烈建议安装”等承诺性表达。\n- 如果描述安装后的工作方式，必须使用“如果安装成功且宿主正确加载 Skill，它可能会……”这种条件句。\n- 体验剧本只能写成“示例台词/假设流程”：使用“可能会询问/可能会建议/可能会展示”，不要写“已写入、已生成、已通过、正在运行、正在生成”。\n- Prompt Preview 不负责给安装命令；如用户准备试装，只能提示先阅读 Quick Start 和 Risk Card，并在隔离环境验证。\n- 所有项目事实必须来自 supported claim、evidence_refs 或 source_paths；inferred/unverified 只能作风险或待确认项。\n\n```\n\n### 角色 / Skill 选择\n\n- 目标：从项目里的角色或 Skill 中挑选最匹配的资产。\n- 预期输出：候选角色或 Skill 列表，每项包含适用场景、证据路径、风险边界和是否需要安装后验证。\n\n```text\n请读取 role_skill_index，根据我的目标任务推荐 3-5 个最相关的角色或 Skill。每个推荐都要说明适用场景、可能输出、风险边界和 evidence_refs。\n```\n\n### 风险预检\n\n- 目标：安装或引入前识别环境、权限、规则冲突和质量风险。\n- 预期输出：环境、权限、依赖、许可、宿主冲突、质量风险和未知项的检查清单。\n\n```text\n请基于 risk_card、boundaries 和 quick_start_candidates，给我一份安装前风险预检清单。不要替我执行命令，只说明我应该检查什么、为什么检查、失败会有什么影响。\n```\n\n### 宿主 AI 开工指令\n\n- 目标：把项目上下文转成一次对话开始前的宿主 AI 指令。\n- 预期输出：一段边界明确、证据引用明确、适合复制给宿主 AI 的开工前指令。\n\n```text\n请基于 lifeos-plugin 的 AI Context Pack，生成一段我可以粘贴给宿主 AI 的开工前指令。这段指令必须遵守 not_runtime=true，不能声称项目已经安装、运行或产生真实结果。\n```\n\n\n## 角色 / Skill 索引\n\n- 共索引 38 个角色 / Skill / 项目文档条目。\n\n- **blind-spot-finder**（skill）：Multi-model council to find your blind spots, local maxima, and self-deceptions 激活提示：当用户任务与“blind-spot-finder”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/blind-spot-finder/SKILL.md`\n- **capture**（skill）：Quick capture a thought, task, or note with auto-routing based on content 激活提示：当用户任务与“capture”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/capture/SKILL.md`\n- **client-brief**（skill）：Full client briefing with projects, phases, completion stats, and recent communications 激活提示：当用户任务与“client-brief”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/client-brief/SKILL.md`\n- **client-health**（skill）：Show health dashboard across all clients with risk indicators 激活提示：当用户任务与“client-health”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/client-health/SKILL.md`\n- **coach-memory**（skill）：View and manage the AI coach's accumulated knowledge about you 激活提示：当用户任务与“coach-memory”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/coach-memory/SKILL.md`\n- **coaching-action-items**（skill）：Review and manage coaching action items across all coaches 激活提示：当用户任务与“coaching-action-items”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/coaching-action-items/SKILL.md`\n- **coaching-overview**（skill）：Dashboard of coaching profiles, recent sessions, and pending action items 激活提示：当用户任务与“coaching-overview”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/coaching-overview/SKILL.md`\n- **coaching-session-review**（skill）：Review a coaching session's summary, key insights, and action items 激活提示：当用户任务与“coaching-session-review”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/coaching-session-review/SKILL.md`\n- **contact-lookup**（skill）：Full contact dossier with profile, AI insights, meetings, messages, and voice memos 激活提示：当用户任务与“contact-lookup”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/contact-lookup/SKILL.md`\n- **context-switch**（skill）：Quickly load context for a client or project for fast mental context switching 激活提示：当用户任务与“context-switch”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/context-switch/SKILL.md`\n- **customer-success-triage**（skill）：Triage client requests and customer-success work using the client workspace, business chats, Fathom and Granola meetings, notes, and open tasks. Use when reviewing customer asks, checking whether work is already tracked, capturing requirement summaries, or deciding what should become a task. 激活提示：当用户任务与“customer-success-triage”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/customer-success-triage/SKILL.md`\n- **cycle-review**（skill）：Review the current cycle/sprint with progress, incomplete items, and rollover options 激活提示：当用户任务与“cycle-review”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/cycle-review/SKILL.md`\n- **daily-plan**（skill）：Plan the day in LifeOS and apply mutations to due dates, top priorities, current-cycle assignments, and the Daily Note 激活提示：当用户任务与“daily-plan”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/daily-plan/SKILL.md`\n- **daily-standup**（skill）：Get daily standup briefing with agenda, tasks due today, and sprint progress 激活提示：当用户任务与“daily-standup”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/daily-standup/SKILL.md`\n- **daily-training-report**（skill）：Comprehensive daily training report - yesterday's results, today's focus, habit compliance, health data, ADHD focus management 激活提示：当用户任务与“daily-training-report”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/daily-training-report/SKILL.md`\n- **decision-framework**（skill）：Structured multi-model deliberation for big life decisions Denver vs Taiwan, what to build, etc. 激活提示：当用户任务与“decision-framework”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/decision-framework/SKILL.md`\n- **end-of-day**（skill）：Run end-of-day wrap-up with completion summary and tomorrow planning 激活提示：当用户任务与“end-of-day”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/end-of-day/SKILL.md`\n- **finance-overview**（skill）：Financial overview with net worth summary, account balances, and net worth trend 激活提示：当用户任务与“finance-overview”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/finance-overview/SKILL.md`\n- **finance-spending**（skill）：Spending analysis with daily patterns, income vs spending, and recent transactions 激活提示：当用户任务与“finance-spending”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/finance-spending/SKILL.md`\n- **follow-ups**（skill）：Track follow-ups needed with people and clients 激活提示：当用户任务与“follow-ups”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/follow-ups/SKILL.md`\n- **habit-check**（skill）：Daily habit check-in - review today's habits, mark completions, celebrate streaks, flag missed reps 激活提示：当用户任务与“habit-check”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/habit-check/SKILL.md`\n- **health-check**（skill）：Quick health overview with recent Oura Ring scores, trends, and insights 激活提示：当用户任务与“health-check”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/health-check/SKILL.md`\n- **health-weekly**（skill）：Weekly health review with sleep, activity, readiness trends, workouts, and recovery insights 激活提示：当用户任务与“health-weekly”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/health-weekly/SKILL.md`\n- **inbox-triage**（skill）：Process captured notes and triage into actionable tasks, tags, and links 激活提示：当用户任务与“inbox-triage”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/inbox-triage/SKILL.md`\n- **initiative-review**（skill）：Review yearly initiative progress with stats per category and highlight stalled initiatives 激活提示：当用户任务与“initiative-review”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/initiative-review/SKILL.md`\n- **llm-council**（skill）：Run a multi-model LLM Council deliberation with peer review and chairman synthesis Karpathy's 3-stage process 激活提示：当用户任务与“llm-council”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/llm-council/SKILL.md`\n- **meeting-prep**（skill）：Prepare for a meeting with contact dossier, past meetings, recent messages, and open items 激活提示：当用户任务与“meeting-prep”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/meeting-prep/SKILL.md`\n- **monthly-review**（skill）：Run monthly review with accomplishments, project progress, and next month planning 激活提示：当用户任务与“monthly-review”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/monthly-review/SKILL.md`\n- **overdue**（skill）：Show what's overdue or slipping - tasks, projects, and sprint items 激活提示：当用户任务与“overdue”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/overdue/SKILL.md`\n- **ppv**（skill）：Manage the PPV life design system in LifeOS: vision, identity, pillars, existing projects, weekly actions, reflections, and adjustments 激活提示：当用户任务与“ppv”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/ppv/SKILL.md`\n- **project-status**（skill）：Project status report with phases, task breakdown, blockers, and urgent items 激活提示：当用户任务与“project-status”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/project-status/SKILL.md`\n- **relationship-pulse**（skill）：Check on neglected relationships and suggest reconnection actions 激活提示：当用户任务与“relationship-pulse”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/relationship-pulse/SKILL.md`\n- **screentime-report**（skill）：Screen time analysis with usage patterns, top time-sink apps, social media alerts, and category breakdown 激活提示：当用户任务与“screentime-report”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/screentime-report/SKILL.md`\n- **sprint-plan**（skill）：Plan the current sprint/current cycle and apply mutations to cycle goals, task assignments, priorities, and due dates 激活提示：当用户任务与“sprint-plan”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/sprint-plan/SKILL.md`\n- **voice-notes-crystallize**（skill）：Save a crystallized summary of AI conversation about voice notes - preserve insights, plans, and ideas 激活提示：当用户任务与“voice-notes-crystallize”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/voice-notes-crystallize/SKILL.md`\n- **voice-notes**（skill）：Explore and work with voice notes interactively - review, analyze, and discuss your recorded thoughts 激活提示：当用户任务与“voice-notes”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/voice-notes/SKILL.md`\n- **weekly-plan**（skill）：Plan the week in LifeOS and apply mutations to due dates, current cycle goals, cycle assignments, priorities, and weekly/daily notes 激活提示：当用户任务与“weekly-plan”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/weekly-plan/SKILL.md`\n- **weekly-review**（skill）：Run weekly review with completed work, in-progress items, sprint health, and blockers 激活提示：当用户任务与“weekly-review”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/weekly-review/SKILL.md`\n\n## 证据索引\n\n- 共索引 43 条证据。\n\n- **Setting Up Agents with LifeOS**（documentation）：How to give any AI agent access to your LifeOS data and workflows. 证据：`AGENTS.md`\n- **LifeOS Plugin**（documentation）：Universal skills and MCP integration for LifeOS — your personal productivity OS powered by Convex. 证据：`README.md`\n- **Step 1: Gather Context**（skill_instruction）：Use multiple AI models to find what I'm NOT seeing. This is about the unknown unknowns. 证据：`skills/blind-spot-finder/SKILL.md`\n- **Skill**（skill_instruction）：Quick capture a thought, task, or note. $ARGUMENTS contains what to capture. 证据：`skills/capture/SKILL.md`\n- **Skill**（skill_instruction）：Get a full client briefing. $ARGUMENTS should be the client name or ID. 证据：`skills/client-brief/SKILL.md`\n- **Skill**（skill_instruction）：Show health dashboard across all clients. Use the LifeOS MCP tools: 证据：`skills/client-health/SKILL.md`\n- **Skill**（skill_instruction）：Show me the coach's working memory. Use the LifeOS MCP tools: 证据：`skills/coach-memory/SKILL.md`\n- **Skill**（skill_instruction）：Review my coaching action items. Use the LifeOS MCP tools: 证据：`skills/coaching-action-items/SKILL.md`\n- **Skill**（skill_instruction）：Show me a coaching dashboard. Use the LifeOS MCP tools: 证据：`skills/coaching-overview/SKILL.md`\n- **Skill**（skill_instruction）：Review a coaching session in depth. Use the LifeOS MCP tools: 证据：`skills/coaching-session-review/SKILL.md`\n- **Skill**（skill_instruction）：Look up everything about a contact. $ARGUMENTS should be a person's name. 证据：`skills/contact-lookup/SKILL.md`\n- **Skill**（skill_instruction）：Quickly load context for a client or project. $ARGUMENTS should be the client or project name. 证据：`skills/context-switch/SKILL.md`\n- **Skill**（skill_instruction）：Triage customer-success work. $ARGUMENTS should contain the client name or ID, plus an optional focus area. 证据：`skills/customer-success-triage/SKILL.md`\n- **Skill**（skill_instruction）：Review my current cycle/sprint. Use the LifeOS MCP tools: 证据：`skills/cycle-review/SKILL.md`\n- **Skill**（skill_instruction）：Plan my day in LifeOS and apply the resulting changes. This is a mutating workflow. 证据：`skills/daily-plan/SKILL.md`\n- **Skill**（skill_instruction）：Get my daily standup briefing. Use the LifeOS MCP tools to gather: 证据：`skills/daily-standup/SKILL.md`\n- **Skill**（skill_instruction）：Generate a comprehensive daily training report. This is your personal trainer's daily briefing. 证据：`skills/daily-training-report/SKILL.md`\n- **Step 1: Define the Decision**（skill_instruction）：Help me think through a big life decision using structured deliberation and multiple AI perspectives. 证据：`skills/decision-framework/SKILL.md`\n- **Skill**（skill_instruction）：Run my end-of-day wrap-up. Use the LifeOS MCP tools: 证据：`skills/end-of-day/SKILL.md`\n- **Skill**（skill_instruction）：Give me a financial overview. Use the LifeOS MCP tools: 证据：`skills/finance-overview/SKILL.md`\n- **Skill**（skill_instruction）：Analyze my spending patterns. Use the LifeOS MCP tools: 证据：`skills/finance-spending/SKILL.md`\n- **Skill**（skill_instruction）：Track follow-ups needed with people and clients. Use the LifeOS MCP tools: 证据：`skills/follow-ups/SKILL.md`\n- **Skill**（skill_instruction）：Run a daily habit check-in. Use the LifeOS MCP tools to: 证据：`skills/habit-check/SKILL.md`\n- **Skill**（skill_instruction）：Give me a quick health overview. Use the LifeOS MCP tools to gather Oura Ring data: 证据：`skills/health-check/SKILL.md`\n- **Skill**（skill_instruction）：Run a weekly health review. Use the LifeOS MCP tools: 证据：`skills/health-weekly/SKILL.md`\n- **Skill**（skill_instruction）：Process captured notes and triage into actionable items. Use the LifeOS MCP tools: 证据：`skills/inbox-triage/SKILL.md`\n- **Skill**（skill_instruction）：Review my yearly initiative progress. Use the LifeOS MCP tools: 证据：`skills/initiative-review/SKILL.md`\n- **Step 1: Get the Question**（skill_instruction）：Run a full LLM Council deliberation on a question or topic. Multiple AI models answer independently, then anonymously peer-review each other's responses, and finally a chairman synthesizes the best answer. 证据：`skills/llm-council/SKILL.md`\n- **Skill**（skill_instruction）：Prepare for a meeting with someone. $ARGUMENTS should be the person's name. 证据：`skills/meeting-prep/SKILL.md`\n- **Skill**（skill_instruction）：Run my monthly review. Use the LifeOS MCP tools: 证据：`skills/monthly-review/SKILL.md`\n- **Skill**（skill_instruction）：Show what's overdue or slipping. Use the LifeOS MCP tools: 证据：`skills/overdue/SKILL.md`\n- **Skill**（skill_instruction）：Manage my PPV life design system. This is a mutating workflow when the request implies creating, updating, linking, completing, reflecting, or adjusting. 证据：`skills/ppv/SKILL.md`\n- **Skill**（skill_instruction）：Get project status. $ARGUMENTS should be a project key like \"ACME\" or project name. 证据：`skills/project-status/SKILL.md`\n- **Skill**（skill_instruction）：Check on neglected relationships. Use the LifeOS MCP tools: 证据：`skills/relationship-pulse/SKILL.md`\n- **Skill**（skill_instruction）：Generate a screen time report. Use the LifeOS MCP tools to gather data: 证据：`skills/screentime-report/SKILL.md`\n- **Skill**（skill_instruction）：Help me plan my sprint/current cycle in LifeOS and apply the resulting changes. This is a mutating workflow. 证据：`skills/sprint-plan/SKILL.md`\n- **Skill**（skill_instruction）：Save a crystallized summary of our conversation about voice notes. Use the LifeOS MCP tools. 证据：`skills/voice-notes-crystallize/SKILL.md`\n- **Skill**（skill_instruction）：Explore and work with my voice notes interactively. Use the LifeOS MCP tools. 证据：`skills/voice-notes/SKILL.md`\n- **Skill**（skill_instruction）：Plan my week in LifeOS and apply the resulting changes. This is a mutating workflow. 证据：`skills/weekly-plan/SKILL.md`\n- **Skill**（skill_instruction）：Run my weekly review. Use the LifeOS MCP tools to gather: 证据：`skills/weekly-review/SKILL.md`\n- **Plugin**（structured_config）：{ \"name\": \"lifeos\", \"description\": \"LifeOS productivity suite - project management, contacts, agendas, PPV life design, health Oura , finance, and workflow automation via MCP\", \"version\": \"1.2.0\", \"author\": { \"name\": \"starascendin\" }, \"repository\": \"https://github.com/starascendin/lifeos-plugin\", \"keywords\": \"lifeos\", \"productivity\", \"project-management\", \"life-design\", \"mcp\" } 证据：`.claude-plugin/plugin.json`\n- **.Mcp**（structured_config）：{ \"mcpServers\": { \"lifeos\": { \"command\": \"npx\", \"args\": \"@starascendin/lifeos-mcp@latest\", \"--url\", \"${LIFEOS CONVEX URL}\", \"--user-id\", \"${LIFEOS USER ID}\", \"--api-key\", \"${LIFEOS API KEY}\" } } } 证据：`.mcp.json`\n- **.Mcp.Json**（source_file）：{ \"mcpServers\": { \"lifeos\": { \"command\": \"npx\", \"args\": \"@starascendin/lifeos-mcp@latest\", \"--url\", \"https://YOUR APP.convex.site\", \"--user-id\", \"YOUR USER ID\", \"--api-key\", \"YOUR API KEY\" } } } 证据：`.mcp.json.example`\n\n## 宿主 AI 必须遵守的规则\n\n- **把本资产当作开工前上下文，而不是运行环境。**：AI Context Pack 只包含证据化项目理解，不包含目标项目的可执行状态。 证据：`AGENTS.md`, `README.md`, `skills/blind-spot-finder/SKILL.md`\n- **回答用户时区分可预览内容与必须安装后才能验证的内容。**：安装前体验的消费者价值来自降低误装和误判，而不是伪装成真实运行。 证据：`AGENTS.md`, `README.md`, `skills/blind-spot-finder/SKILL.md`\n\n## 用户开工前应该回答的问题\n\n- 你准备在哪个宿主 AI 或本地环境中使用它？\n- 你只是想先体验工作流，还是准备真实安装？\n- 你最在意的是安装成本、输出质量、还是和现有规则的冲突？\n\n## 验收标准\n\n- 所有能力声明都能回指到 evidence_refs 中的文件路径。\n- AI_CONTEXT_PACK.md 没有把预览包装成真实运行。\n- 用户能在 3 分钟内看懂适合谁、能做什么、如何开始和风险边界。\n\n---\n\n## Doramagic Context Augmentation\n\n下面内容用于强化 Repomix/AI Context Pack 主体。Human Manual 只提供阅读骨架；踩坑日志会被转成宿主 AI 必须遵守的工作约束。\n\n## Human Manual 骨架\n\n使用规则：这里只是项目阅读路线和显著性信号，不是事实权威。具体事实仍必须回到 repo evidence / Claim Graph。\n\n宿主 AI 硬性规则：\n- 不得把页标题、章节顺序、摘要或 importance 当作项目事实证据。\n- 解释 Human Manual 骨架时，必须明确说它只是阅读路线/显著性信号。\n- 能力、安装、兼容性、运行状态和风险判断必须引用 repo evidence、source path 或 Claim Graph。\n\n- **项目介绍**：importance `high`\n  - source_paths: README.md, AGENTS.md\n- **安装与配置**：importance `high`\n  - source_paths: README.md, .mcp.json.example\n- **MCP 服务器架构**：importance `high`\n  - source_paths: AGENTS.md, .mcp.json, .mcp.json.example\n- **日常管理工作流**：importance `high`\n  - source_paths: skills/daily-standup/SKILL.md, skills/daily-plan/SKILL.md, skills/end-of-day/SKILL.md, skills/capture/SKILL.md\n- **复盘与规划工作流**：importance `high`\n  - source_paths: skills/weekly-review/SKILL.md, skills/weekly-plan/SKILL.md, skills/monthly-review/SKILL.md, skills/cycle-review/SKILL.md, skills/initiative-review/SKILL.md\n- **项目与客户管理**：importance `high`\n  - source_paths: skills/project-status/SKILL.md, skills/client-brief/SKILL.md, skills/client-health/SKILL.md, skills/sprint-plan/SKILL.md, skills/customer-success-triage/SKILL.md\n- **语音笔记工作流**：importance `medium`\n  - source_paths: skills/voice-notes/SKILL.md, skills/voice-notes-crystallize/SKILL.md\n- **健康数据集成 (Oura Ring)**：importance `medium`\n  - source_paths: skills/health-check/SKILL.md, skills/health-weekly/SKILL.md, skills/screentime-report/SKILL.md\n\n## Repo Inspection Evidence / 源码检查证据\n\n- repo_clone_verified: false\n- repo_inspection_verified: false\n- repo_commit: `unknown`\n\n宿主 AI 硬性规则：\n- 没有 repo_clone_verified=true 时，不得声称已经读过源码。\n- 没有 repo_inspection_verified=true 时，不得把 README/docs/package 文件判断写成事实。\n- 没有 quick_start_verified=true 时，不得声称 Quick Start 已跑通。\n\n## Doramagic Pitfall Constraints / 踩坑约束\n\n这些规则来自 Doramagic 发现、验证或编译过程中的项目专属坑点。宿主 AI 必须把它们当作工作约束，而不是普通说明文字。\n\n### Constraint 1: 可能修改宿主 AI 配置\n\n- Trigger: 项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。\n- Host AI rule: 列出会写入的配置文件、目录和卸载/回滚步骤。\n- Why it matters: 安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。\n- Evidence: capability.host_targets | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | host_targets=mcp_host, claude, claude_code\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 2: 能力判断依赖假设\n\n- Trigger: README/documentation is current enough for a first validation pass.\n- Host AI rule: 将假设转成下游验证清单。\n- Why it matters: 假设不成立时，用户拿不到承诺的能力。\n- Evidence: capability.assumptions | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | README/documentation is current enough for a first validation pass.\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 3: 维护活跃度未知\n\n- Trigger: 未记录 last_activity_observed。\n- Host AI rule: 补 GitHub 最近 commit、release、issue/PR 响应信号。\n- Why it matters: 新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。\n- Evidence: evidence.maintainer_signals | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | last_activity_observed missing\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 4: 下游验证发现风险项\n\n- Trigger: no_demo\n- Host AI rule: 进入安全/权限治理复核队列。\n- Why it matters: 下游已经要求复核，不能在页面中弱化。\n- Evidence: downstream_validation.risk_items | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | no_demo; severity=medium\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 5: 存在安全注意事项\n\n- Trigger: No sandbox install has been executed yet; downstream must verify before user use.\n- Host AI rule: 转成明确权限清单和安全审查提示。\n- Why it matters: 用户安装前需要知道权限边界和敏感操作。\n- Evidence: 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.\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 6: 存在评分风险\n\n- Trigger: no_demo\n- Host AI rule: 把风险写入边界卡，并确认是否需要人工复核。\n- Why it matters: 风险会影响是否适合普通用户安装。\n- Evidence: risks.scoring_risks | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | no_demo; severity=medium\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 7: issue/PR 响应质量未知\n\n- Trigger: issue_or_pr_quality=unknown。\n- Host AI rule: 抽样最近 issue/PR，判断是否长期无人处理。\n- Why it matters: 用户无法判断遇到问题后是否有人维护。\n- Evidence: evidence.maintainer_signals | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | issue_or_pr_quality=unknown\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 8: 发布节奏不明确\n\n- Trigger: release_recency=unknown。\n- Host AI rule: 确认最近 release/tag 和 README 安装命令是否一致。\n- Why it matters: 安装命令和文档可能落后于代码，用户踩坑概率升高。\n- Evidence: evidence.maintainer_signals | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | release_recency=unknown\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n",
      "summary": "给宿主 AI 的上下文和工作边界。",
      "title": "AI Context Pack / 带给我的 AI"
    },
    "boundary_risk_card": {
      "asset_id": "boundary_risk_card",
      "filename": "BOUNDARY_RISK_CARD.md",
      "markdown": "# Boundary & Risk Card / 安装前决策卡\n\n项目：starascendin/lifeos-plugin\n\n## Doramagic 试用结论\n\n当前结论：可以进入发布前推荐检查；首次使用仍应从最小权限、临时目录和可回滚配置开始。\n\n## 用户现在可以做\n\n- 可以先阅读 Human Manual，理解项目目的和主要工作流。\n- 可以复制 Prompt Preview 做安装前体验；这只验证交互感，不代表真实运行。\n- 可以把官方 Quick Start 命令放到隔离环境中验证，不要直接进主力环境。\n\n## 现在不要做\n\n- 不要把 Prompt Preview 当成项目实际运行结果。\n- 不要把 metadata-only validation 当成沙箱安装验证。\n- 不要把未验证能力写成“已支持、已跑通、可放心安装”。\n- 不要在首次试用时交出生产数据、私人文件、真实密钥或主力配置目录。\n\n## 安装前检查\n\n- 宿主 AI 是否匹配：mcp_host, claude, claude_code\n- 官方安装入口状态：已发现官方入口\n- 是否在临时目录、临时宿主或容器中验证：必须是\n- 是否能回滚配置改动：必须能\n- 是否需要 API Key、网络访问、读写文件或修改宿主配置：未确认前按高风险处理\n- 是否记录了安装命令、实际输出和失败日志：必须记录\n\n## 当前阻塞项\n\n- review_required: community_discussion_evidence_below_public_threshold\n\n## 项目专属踩坑\n\n- 可能修改宿主 AI 配置（medium）：安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。 建议检查：列出会写入的配置文件、目录和卸载/回滚步骤。\n- 能力判断依赖假设（medium）：假设不成立时，用户拿不到承诺的能力。 建议检查：将假设转成下游验证清单。\n- 维护活跃度未知（medium）：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。 建议检查：补 GitHub 最近 commit、release、issue/PR 响应信号。\n- 下游验证发现风险项（medium）：下游已经要求复核，不能在页面中弱化。 建议检查：进入安全/权限治理复核队列。\n- 存在安全注意事项（medium）：用户安装前需要知道权限边界和敏感操作。 建议检查：转成明确权限清单和安全审查提示。\n\n## 风险与权限提示\n\n- no_demo: medium\n\n## 证据缺口\n\n- 暂未发现结构化证据缺口。\n",
      "summary": "安装、权限、验证和推荐前风险。",
      "title": "Boundary & Risk Card / 边界与风险卡"
    },
    "human_manual": {
      "asset_id": "human_manual",
      "filename": "HUMAN_MANUAL.md",
      "markdown": "# https://github.com/starascendin/lifeos-plugin 项目说明书\n\n生成时间：2026-05-16 08:40:49 UTC\n\n## 目录\n\n- [项目介绍](#page-introduction)\n- [安装与配置](#page-installation)\n- [MCP 服务器架构](#page-mcp-server)\n- [日常管理工作流](#page-daily-workflows)\n- [复盘与规划工作流](#page-review-workflows)\n- [项目与客户管理](#page-project-management)\n- [语音笔记工作流](#page-voice-notes-workflows)\n- [健康数据集成 (Oura Ring)](#page-health-integration)\n- [财务管理](#page-finance-management)\n- [人际关系管理](#page-people-relationships)\n\n<a id='page-introduction'></a>\n\n## 项目介绍\n\n### 相关页面\n\n相关主题：[安装与配置](#page-installation), [MCP 服务器架构](#page-mcp-server)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n- [AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n- [skills/daily-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)\n- [skills/weekly-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/weekly-plan/SKILL.md)\n- [skills/sprint-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/sprint-plan/SKILL.md)\n- [skills/ppv/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/ppv/SKILL.md)\n- [skills/health-weekly/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-weekly/SKILL.md)\n</details>\n\n# 项目介绍\n\n## 概述\n\nLifeOS Plugin 是一个面向 AI 代理的通用技能与 MCP（Model Context Protocol）集成框架，专为 [LifeOS](https://github.com/starascendin/lifeos-plugin) 个人生产力操作系统设计。该系统由 Convex 驱动，提供 37 种工作流技能，涵盖项目管理、联系人管理、日程安排、语音笔记、健康追踪（Oura Ring）、财务管理、人生教练、人生方向规划等多个领域。\n\n资料来源：[README.md:1-6]()\n\n### 核心定位\n\n| 维度 | 说明 |\n|------|------|\n| **目标用户** | 使用 AI 代理（如 Claude Code、OpenCode）的个人用户 |\n| **技术基础** | Convex 后端 + MCP 协议 |\n| **技能数量** | 37 种工作流技能 + 126 个 MCP 工具 + 28 个 MCP 提示词 |\n| **数据整合** | 项目、任务、周期、阶段、联系人、会议、健康、财务、习惯等 |\n\n资料来源：[README.md:1-10]()\n\n---\n\n## 系统架构\n\n### 技术栈概览\n\n```mermaid\ngraph TD\n    subgraph \"AI 代理层\"\n        A[Claude Code]\n        B[OpenCode]\n    end\n    \n    subgraph \"插件层\"\n        C[LifeOS Plugin Skills]\n        D[MCP Server]\n    end\n    \n    subgraph \"后端服务层\"\n        E[Convex Backend]\n        F[External APIs<br/>Oura Ring, Fathom, Granola, etc.]\n    end\n    \n    A --> C\n    B --> C\n    A --> D\n    B --> D\n    C --> E\n    D --> E\n    E --> F\n    \n    style A fill:#e1f5fe\n    style B fill:#e1f5fe\n    style E fill:#c8e6c9\n```\n\n### 技能调用方式\n\nLifeOS Plugin 支持两种调用方式：\n\n1. **Skill 技能调用**：通过 `/skill-name` 命令直接调用\n2. **MCP 协议调用**：通过 MCP 客户端调用对应工具或提示词\n\n资料来源：[README.md:56-70]()\n\n---\n\n## 技能体系\n\n### 日常管理工作流\n\n| 技能名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| daily-standup | `/daily-standup` | 晨间简报，包含日程、任务和冲刺进度 |\n| daily-plan | `/daily-plan` | 规划今日工作，设置截止日期、优先级、周期分配和每日笔记 |\n| end-of-day | `/end-of-day` | 日终总结，完成情况汇总和明日规划 |\n| capture | `/capture \"想法\"` | 快速捕获想法、任务或笔记，自动路由 |\n\n资料来源：[README.md:38-45]()\n\n**daily-plan 工作流程**：\n\n```mermaid\ngraph TD\n    A[调用 get_planning_context] --> B[构建今日计划]\n    B --> C[选择 Top 3 任务]\n    C --> D[设置截止日期]\n    D --> E[分配周期任务]\n    E --> F[应用规划补丁<br/>apply_planning_patch]\n    F --> G[报告结果]\n    \n    style A fill:#fff3e0\n    style F fill:#c8e6c9\n```\n\n资料来源：[skills/daily-plan/SKILL.md:1-25]()\n\n### 回顾与规划技能\n\n| 技能名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| weekly-review | `/weekly-review` | 回顾本周完成的工作、进行中的项目和冲刺健康度 |\n| weekly-plan | `/weekly-plan` | 规划本周工作，设置当前周期、截止日期、优先级 |\n| monthly-review | `/monthly-review` | 月度回顾，成就、项目进展和下月规划 |\n| cycle-review | `/cycle-review` | 冲刺回顾，包含延期处理选项 |\n| initiative-review | `/initiative-review 2026` | 年度目标按类别回顾 |\n| sprint-plan | `/sprint-plan` | 规划当前冲刺，设置周期目标、任务分配、优先级 |\n\n资料来源：[README.md:46-58]()\n\n**sprint-plan 工作流程**：\n\n```mermaid\ngraph TD\n    A[获取规划上下文] --> B[更新周期目标]\n    B --> C[从待办中拉取任务]\n    C --> D[设置截止日期和优先级]\n    D --> E[应用规划补丁<br/>mode=cycle] --> F[报告结果]\n    \n    style E fill:#c8e6c9\n```\n\n资料来源：[skills/sprint-plan/SKILL.md:1-30]()\n\n### 项目与客户管理\n\n| 技能名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| project-status | `/project-status ACME` | 按阶段分解项目，统计任务和阻塞项 |\n| client-brief | `/client-brief \"Acme Corp\"` | 完整客户简报，包含项目和问题 |\n| client-health | `/client-health` | 所有客户健康度仪表盘 |\n| customer-success-triage | `/customer-success-triage \"Acme Corp\"` | 分拣客户请求，审查聊天、会议、笔记和任务 |\n\n资料来源：[README.md:59-64]()\n\n**customer-success-triage 工作流程**：\n\n```mermaid\ngraph TD\n    A[调用 get_client_success_workspace] --> B[审查工作区]\n    B --> C{需要深入了解?}\n    C -->|聊天| D[获取 Beeper 消息]\n    C -->|会议| E[获取 Fathom/Granola 详情]\n    C -->|笔记| F[获取客户笔记历史]\n    C -->|无需| G[分类整理发现]\n    D --> G\n    E --> G\n    F --> G\n    G --> H[分类结果]\n    \n    style A fill:#fff3e0\n    style H fill:#c8e6c9\n```\n\n资料来源：[skills/customer-success-triage/SKILL.md:1-35]()\n\n### 人际关系与沟通\n\n| 技能名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| contact-lookup | `/contact-lookup \"John\"` | 完整联系人档案，包含 AI 洞察 |\n| meeting-prep | `/meeting-prep \"John\"` | 准备会议，获取完整上下文和讨论要点 |\n| follow-ups | `/follow-ups` | 追踪需要跟进的人员和客户 |\n| relationship-pulse | `/relationship-pulse` | 检查被忽视的关系 |\n| context-switch | `/context-switch \"Acme\"` | 快速加载客户或项目上下文 |\n\n资料来源：[README.md:65-70]()\n\n### 健康追踪\n\n| 技能名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| health-check | `/health-check` | 快速 Oura 健康概览：分数和趋势 |\n| health-weekly | `/health-weekly` | 周健康回顾，包含睡眠、活动、恢复和锻炼洞察 |\n| screentime-report | `/screentime-report` | 屏幕时间分析和顶部应用 |\n| habit-check | `/habit-check` | 每日习惯签到、连续天数追踪和完成情况 |\n| daily-training-report | `/daily-training-report` | 综合训练日报 |\n\n资料来源：[README.md:72-78]()\n\n**health-weekly 数据来源**：\n\n| 数据类型 | MCP 工具 | 数据范围 |\n|----------|----------|----------|\n| 睡眠数据 | `get_health_sleep` | 14天 |\n| 活动数据 | `get_health_activity` | 14天 |\n| 准备度数据 | `get_health_readiness` | 14天 |\n| 压力数据 | `get_health_stress` | 14天 |\n| 锻炼历史 | `get_health_workouts` | 14天 |\n| 心率趋势 | `get_health_heart_rate` | 14天 |\n| 恢复力数据 | `get_health_resilience` | 14天 |\n| VO2 Max | `get_health_vo2_max` | 14天 |\n| 心血管年龄 | `get_health_cardio_age` | 14天 |\n| 血氧数据 | `get_health_spo2` | 14天 |\n\n资料来源：[skills/health-weekly/SKILL.md:1-40]()\n\n### 财务管理\n\n| 技能名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| finance-overview | `/finance-overview` | 净资产、账户概览和趋势 |\n| finance-spending | `/finance-spending` | 支出分析和消费模式 |\n\n资料来源：[README.md:79-81]()\n\n### PPV 人生设计系统\n\nPPV（Purpose, Principles, Vision）是一套人生设计系统，整合愿景、身份、支柱和行动计划。\n\n| 技能名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| ppv | `/ppv` | 管理 PPV 愿景、身份、支柱、项目链接、周行动、反思和调整 |\n\n资料来源：[README.md:96-98]()\n\n**PPV 工作流程**：\n\n```mermaid\ngraph TD\n    A[获取 PPV 工作区] --> B{有活跃愿景?}\n    B -->|无| C[创建新愿景]\n    B -->|有| D[使用活跃愿景图]\n    C --> D\n    D --> E{用户请求类型?}\n    E -->|愿景编辑| F[upsert_ppv_vision]\n    E -->|身份编辑| G[upsert_ppv_identity]\n    E -->|支柱管理| H[创建/更新/删除支柱]\n    E -->|行动执行| I[创建/更新/删除周行动]\n    E -->|反思| J[创建反思和调整]\n    F --> K[更新图谱缓存]\n    G --> K\n    H --> K\n    I --> K\n    J --> K\n    \n    style A fill:#fff3e0\n    style K fill:#c8e6c9\n```\n\n资料来源：[skills/ppv/SKILL.md:1-50]()\n\n### 其他工具技能\n\n| 技能名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| inbox-triage | `/inbox-triage` | 将笔记处理为任务 |\n| overdue | `/overdue` | 逾期和延误项目 |\n| voice-notes | `/voice-notes` | 交互式备忘录探索 |\n| voice-notes-crystallize | `/voice-notes-crystallize` | 保存对话洞察 |\n| coaching-overview | `/coaching-overview` | 教练档案、会议和行动项目 |\n| coaching-action-items | `/coaching-action-items` | 管理教练行动项目 |\n| coaching-session-review | `/coaching-session-review` | 回顾教练会议洞察 |\n| coach-memory | `/coach-memory` | 查看 AI 教练的累积知识 |\n| llm-council | `/llm-council` | 多模型委员会决策 |\n| blind-spot-finder | `/blind-spot-finder` | 多模型盲点发现 |\n\n资料来源：[README.md:82-95]()\n\n---\n\n## MCP 工具集\n\n### 工具覆盖范围\n\n系统提供 **126 个 MCP 工具**，支持以下领域的完整 CRUD 操作：\n\n| 领域 | 覆盖内容 |\n|------|----------|\n| 项目管理 | 项目、任务/问题、周期、阶段 |\n| 联系人 | 人员/联系人 |\n| 内容管理 | 笔记、语音备忘录 |\n| 通讯 | AI 对话摘要、Beeper 线程、Granola 会议 |\n| 目标追踪 | 举措（Initiatives） |\n| 健康数据 | Oura Ring：睡眠、活动、准备度、压力、SpO2、心率、锻炼 |\n| 财务管理 | 账户、净资产、交易、快照、每日支出 |\n| 习惯追踪 | 习惯记录和完成情况 |\n| 屏幕时间 | 应用使用分析 |\n| 教练 | 教练档案和行动项目 |\n| PPV | 人生设计系统全模块 |\n\n资料来源：[AGENTS.md:50-54]()\n\n### MCP 提示词\n\n提供 **28 个 MCP 提示词**，功能与技能相同，但通过 MCP 协议暴露，可被任何 MCP 客户端调用。\n\n---\n\n## 安装与配置\n\n### 前置要求\n\n使用 LifeOS Plugin 需要准备三个凭证：\n\n| 变量名 | 描述 | 获取位置 |\n|--------|------|----------|\n| `LIFEOS_CONVEX_URL` | Convex 部署 URL（`.convex.site`） | Convex 仪表盘 |\n| `LIFEOS_USER_ID` | LifeOS 用户 ID | Convex 仪表盘 > Users 表 |\n| `LIFEOS_API_KEY` | API 认证密钥 | LifeOS 设置中生成 |\n\n资料来源：[README.md:55-66]()\n\n### Claude Code 安装\n\n```bash\nclaude plugin add github:starascendin/lifeos-plugin\n```\n\n设置环境变量：\n\n```bash\nexport LIFEOS_CONVEX_URL=https://your-app.convex.site\nexport LIFEOS_USER_ID=your-user-id\nexport LIFEOS_API_KEY=your-api-key\n```\n\n资料来源：[README.md:15-28]()\n\n### OpenCode 安装\n\n```bash\n# 方式一：复制\ncp -r skills/ .claude/skills/lifeos/\n\n# 方式二：符号链接\nln -s /path/to/lifeos-plugin/skills .claude/skills/lifeos\n```\n\n资料来源：[README.md:21-27]()\n\n### 手动 MCP 配置\n\n```json\n{\n  \"mcpServers\": {\n    \"lifeos\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@starascendin/lifeos-mcp@latest\",\n        \"--url\", \"YOUR_CONVEX_URL\",\n        \"--user-id\", \"YOUR_USER_ID\",\n        \"--api-key\", \"YOUR_API_KEY\"\n      ]\n    }\n  }\n}\n```\n\n或使用环境变量：\n\n```bash\nexport LIFEOS_CONVEX_URL=https://your-app.convex.site\nexport LIFEOS_USER_ID=your-user-id\nexport LIFEOS_API_KEY=your-api-key\n```\n\n资料来源：[README.md:33-50]()\n\n---\n\n## 变更高效工作流\n\n### 变更高效技能\n\n以下技能为**变更高效工作流**，调用时会直接修改 LifeOS 数据，无需确认：\n\n| 技能名称 | 变更高效操作 |\n|----------|--------------|\n| daily-plan | 创建问题、调度任务、分配周期、设置优先级、更新周期目标、保存每日笔记 |\n| weekly-plan | 创建问题、调度任务、分配周期、设置优先级、更新周期目标、保存周笔记 |\n| sprint-plan | 创建问题、分配周期任务、调度任务、设置优先级、更新周期目标 |\n| ppv | 创建/更新愿景、身份、支柱、周行动、反思、调整 |\n\n**重要提示**：这些技能会自动应用变更高效，用户不应在调用后要求确认。\n\n资料来源：[skills/daily-plan/SKILL.md:28-35]()\n\n### 变更高效原则\n\n1. **立即应用**：调用 `apply_planning_patch` 时使用 `dryRun=false`\n2. **直接操作**：使用 `create_issue`、`update_issue`、`schedule_issue` 等工具\n3. **报告结果**：操作完成后报告所有变更摘要\n\n---\n\n## 更新维护\n\n### 更新插件仓库\n\n```bash\ncd /path/to/lifeos-plugin && git pull\n```\n\n### 更新 MCP 服务器\n\nMCP 服务器会自动随 `npx @latest` 更新，或在 `.mcp.json` 中固定版本：\n\n```json\n\"@starascendin/lifeos-mcp@0.7.0\"\n```\n\n资料来源：[README.md:68-75]()\n\n---\n\n## 总结\n\nLifeOS Plugin 将复杂的个人生产力系统封装为 AI 代理可直接调用的技能和工作流。通过 37 种技能、126 个 MCP 工具和 28 个 MCP 提示词，用户可以让 AI 代理帮助管理日常任务、项目、联系人、健康、财务乃至人生规划，实现真正个性化的 AI 辅助生活管理系统。\n\n---\n\n<a id='page-installation'></a>\n\n## 安装与配置\n\n### 相关页面\n\n相关主题：[项目介绍](#page-introduction), [MCP 服务器架构](#page-mcp-server)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n</details>\n\n# 安装与配置\n\n本文档介绍 **lifeos-plugin** 的完整安装与配置流程。该插件为 Claude Code、OpenCode 等 AI 编程助手提供 37 个 Universal Skills，并集成了 126 个 MCP 工具，用于连接 LifeOS 个人生产力操作系统。\n\n## 环境要求\n\n| 组件 | 版本要求 | 说明 |\n|------|---------|------|\n| Node.js | ≥ 18.x | 用于运行 npx 命令 |\n| npm/yarn | 最新稳定版 | 包管理器 |\n| Convex 账户 | 有效订阅 | LifeOS 后端服务 |\n| AI 助手 | Claude Code 或 OpenCode | 作为插件宿主 |\n\n## 环境变量配置\n\n在开始安装之前，需要准备以下环境变量。这些变量用于连接 LifeOS 的 Convex 后端服务。\n\n### 必需的环境变量\n\n```bash\n# Convex 部署 URL\nexport LIFEOS_CONVEX_URL=https://your-app.convex.site\n\n# LifeOS 用户 ID\nexport LIFEOS_USER_ID=your-user-id\n\n# Convex API 密钥\nexport LIFEOS_API_KEY=your-api-key\n```\n\n### 配置说明\n\n| 变量名 | 用途 | 获取方式 |\n|--------|------|----------|\n| `LIFEOS_CONVEX_URL` | Convex 项目的访问地址 | Convex Dashboard → 项目设置 → 部署 URL |\n| `LIFEOS_USER_ID` | 用户唯一标识符 | LifeOS 应用内用户设置 |\n| `LIFEOS_API_KEY` | API 认证密钥 | Convex Dashboard → API Keys |\n\n资料来源：[README.md:1-6]()\n\n## Claude Code 安装\n\nClaude Code 是 Anthropic 官方提供的命令行工具，支持通过插件机制扩展功能。\n\n### 安装命令\n\n```bash\nclaude plugin add github:starascendin/lifeos-plugin\n```\n\n### 安装后配置\n\n1. 确保环境变量已正确设置\n2. 重启 Claude Code 会话以加载插件\n3. 验证安装：运行 `/help` 或任意 LifeOS skill（如 `/daily-plan`）\n\n资料来源：[README.md:26-29]()\n\n## OpenCode 安装\n\nOpenCode 支持原生读取 `.claude/skills/` 目录，需要将 skills 目录复制或符号链接到正确位置。\n\n### 方式一：复制（推荐用于独立使用）\n\n```bash\ncp -r skills/ .claude/skills/lifeos/\n```\n\n### 方式二：符号链接（推荐用于开发或同步更新）\n\n```bash\nln -s /path/to/lifeos-plugin/skills .claude/skills/lifeos\n```\n\n### 链接结构示意\n\n```mermaid\ngraph LR\n    A[lifeos-plugin<br/>skills/] -->|ln -s| B[.claude/skills/lifeos]\n    B -->|引用| A\n```\n\n资料来源：[README.md:33-42]()\n\n## MCP 服务器配置\n\nlifeos-plugin 通过 MCP (Model Context Protocol) 协议提供服务。配置 MCP 服务器有三种方式：\n\n### 方式一：MCP 配置文件（JSON）\n\n在 AI 助手的 MCP 配置文件中添加以下内容：\n\n```json\n{\n  \"mcpServers\": {\n    \"lifeos\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@starascendin/lifeos-mcp@latest\",\n        \"--url\", \"YOUR_CONVEX_URL\",\n        \"--user-id\", \"YOUR_USER_ID\",\n        \"--api-key\", \"YOUR_API_KEY\"\n      ]\n    }\n  }\n}\n```\n\n### 方式二：环境变量（推荐）\n\n将环境变量写入 shell 配置文件（如 `~/.bashrc`、`~/.zshrc` 或 `~/.config/fish/config.fish`）：\n\n```bash\n# ~/.zshrc 或 ~/.bashrc\nexport LIFEOS_CONVEX_URL=https://your-app.convex.site\nexport LIFEOS_USER_ID=your-user-id\nexport LIFEOS_API_KEY=your-api-key\n```\n\n然后重新加载配置：\n\n```bash\nsource ~/.zshrc  # 或 source ~/.bashrc\n```\n\n### 方式三：项目级配置\n\n在项目根目录创建 `.env` 文件（需确保 `.gitignore` 包含此文件）：\n\n```bash\nLIFEOS_CONVEX_URL=https://your-app.convex.site\nLIFEOS_USER_ID=your-user-id\nLIFEOS_API_KEY=your-api-key\n```\n\n资料来源：[README.md:45-60]()\n\n## 手动安装\n\n对于不支持插件机制的 AI 助手，可以采用手动安装方式：\n\n### 安装步骤\n\n| 步骤 | 操作 | 说明 |\n|------|------|------|\n| 1 | 复制 skills 目录 | 将 `skills/` 目录复制到 AI 助手的 skills 位置 |\n| 2 | 配置 MCP 服务器 | 设置环境变量或 MCP 配置文件 |\n| 3 | 验证连接 | 运行一个 skill 验证 MCP 连接 |\n\n### 目录结构要求\n\n```\nyour-agent/\n├── skills/\n│   ├── lifeos/           # 复制或链接自 lifeos-plugin\n│   │   ├── daily-plan/\n│   │   ├── weekly-plan/\n│   │   ├── sprint-plan/\n│   │   ├── ppv/\n│   │   └── ... (共37个skills)\n│   └── ...\n```\n\n## 插件更新\n\n### 更新插件仓库\n\n```bash\n# 进入插件目录\ncd /path/to/lifeos-plugin\n\n# 拉取最新代码\ngit pull\n```\n\n### 更新 MCP 服务器\n\nMCP 服务器默认使用 `@latest` 标签，会自动更新。如需固定版本：\n\n```json\n{\n  \"mcpServers\": {\n    \"lifeos\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@starascendin/lifeos-mcp@0.7.0\",  // 固定版本号\n        \"--url\", \"YOUR_CONVEX_URL\",\n        \"--user-id\", \"YOUR_USER_ID\",\n        \"--api-key\", \"YOUR_API_KEY\"\n      ]\n    }\n  }\n}\n```\n\n资料来源：[README.md:107-116]()\n\n## 配置验证\n\n安装完成后，可以通过以下方式验证配置是否正确：\n\n### 验证 MCP 连接\n\n在 AI 助手中运行以下命令之一：\n\n| Skill 名称 | 命令 | 验证内容 |\n|------------|------|---------|\n| 健康检查 | `/health-check` | MCP 连接、Oura Ring 数据 |\n| 日常计划 | `/daily-plan` | 计划上下文、任务数据 |\n| 联系查询 | `/contact-lookup \"测试用户\"` | 联系人数据 |\n\n### 预期输出\n\n如果配置正确，应该能看到：\n- 当前周期的任务列表\n- 本周的每日计划\n- 健康/财务/习惯等数据摘要\n\n如果出现连接错误，请检查：\n1. 环境变量是否正确设置\n2. Convex URL 是否可访问\n3. API Key 是否有效且未过期\n\n## 故障排除\n\n| 问题 | 可能原因 | 解决方案 |\n|------|---------|---------|\n| MCP 服务器无法启动 | npx 未安装或版本过低 | 安装 Node.js 18+ |\n| 认证失败 | API Key 无效 | 在 Convex Dashboard 重新生成 |\n| 插件命令未识别 | Claude Code 版本过低 | 更新到最新版本 |\n| Skills 未显示 | 路径配置错误 | 检查 `.claude/skills/` 目录结构 |\n\n## 快速开始流程\n\n```mermaid\ngraph TD\n    A[准备 Convex 凭据] --> B[设置环境变量]\n    B --> C{选择安装方式}\n    C -->|Claude Code| D[运行 plugin add 命令]\n    C -->|OpenCode| E[复制或链接 skills 目录]\n    C -->|手动安装| F[复制 skills + 配置 MCP]\n    D --> G[重启 AI 助手]\n    E --> G\n    F --> G\n    G --> H[验证安装 - 运行任意 Skill]\n```\n\n按照上述流程完成配置后，即可使用全部 37 个 Universal Skills 和 126 个 MCP 工具。\n\n---\n\n<a id='page-mcp-server'></a>\n\n## MCP 服务器架构\n\n### 相关页面\n\n相关主题：[项目介绍](#page-introduction), [安装与配置](#page-installation)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n- [AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n- [.mcp.json.example](https://github.com/starascendin/lifeos-plugin/blob/main/.mcp.json.example)\n- [skills/daily-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)\n- [skills/weekly-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/weekly-plan/SKILL.md)\n- [skills/sprint-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/sprint-plan/SKILL.md)\n</details>\n\n# MCP 服务器架构\n\n本文档介绍 LifeOS Plugin 中 MCP（Model Context Protocol）服务器的架构设计、配置方式以及工具生态。\n\n## 概述\n\nMCP 服务器是 LifeOS Plugin 的核心基础设施，它作为 AI Agent 与 LifeOS 后端服务之间的桥梁，通过标准化的协议实现双向通信。服务器采用 MCP 协议暴露 126 个工具（Tools）和 28 个提示（Prompts），使各类 AI 客户端（如 Claude Code、OpenCode 等）能够访问和操作 LifeOS 中的数据与工作流程。\n\n资料来源：[AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n\n## 系统架构\n\n### 整体架构图\n\n```mermaid\ngraph TD\n    subgraph \"AI 客户端层\"\n        A[\"Claude Code / OpenCode\"]\n        B[\"其他 MCP 兼容客户端\"]\n    end\n    \n    subgraph \"MCP 服务器层\"\n        C[\"@starascendin/lifeos-mcp\"]\n    end\n    \n    subgraph \"LifeOS 后端\"\n        D[\"Convex 部署\"]\n        E[\"数据存储\"]\n        F[\"业务逻辑\"]\n    end\n    \n    A --> C\n    B --> C\n    C --> D\n    D --> E\n    D --> F\n    \n    G[\"环境变量配置\"] -.-> C\n```\n\n### 组件说明\n\n| 组件 | 描述 | 技术实现 |\n|------|------|----------|\n| MCP 服务器 | 核心协议转换层 | Node.js (npx @starascendin/lifeos-mcp) |\n| Convex 后端 | 数据存储与业务逻辑 | Convex 平台 |\n| MCP 客户端 | AI Agent 集成 | Claude Code、OpenCode 等 |\n| 认证层 | API 身份验证 | API Key + User ID |\n\n## 快速启动\n\n### 安装命令\n\n通过 Claude Code 安装插件：\n\n```bash\nclaude plugin add github:starascendin/lifeos-plugin\n```\n\n资料来源：[README.md:27](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L27)\n\n### 环境变量配置\n\n配置三个必需的环境变量以启用 MCP 服务器认证：\n\n```bash\nexport LIFEOS_CONVEX_URL=https://your-app.convex.site\nexport LIFEOS_USER_ID=your-user-id\nexport LIFEOS_API_KEY=your-api-key\n```\n\n资料来源：[README.md:1-8](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L1-L8)\n\n### MCP 服务器配置文件\n\n在项目根目录创建 `.mcp.json` 文件：\n\n```json\n{\n  \"mcpServers\": {\n    \"lifeos\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@starascendin/lifeos-mcp@latest\",\n        \"--url\", \"YOUR_CONVEX_URL\",\n        \"--user-id\", \"YOUR_USER_ID\",\n        \"--api-key\", \"YOUR_API_KEY\"\n      ]\n    }\n  }\n}\n```\n\n资料来源：[README.md:52-65](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L52-L65)\n\n## MCP 工具生态\n\n### 工具分类总览\n\nMCP 服务器提供 126 个工具，分为以下主要类别：\n\n| 类别 | 工具数量 | 主要功能 |\n|------|----------|----------|\n| 项目管理 | ~20+ | 项目的创建、读取、更新、删除 |\n| 任务/事项 | ~20+ | 任务的 CRUD 操作、状态变更 |\n| 周期管理 | ~10+ | 冲刺/周期的规划与追踪 |\n| 客户管理 | ~10+ | 客户信息、健康度评估 |\n| 人员/联系人 | ~10+ | 联系人的完整资料查询 |\n| 笔记 | ~10+ | 笔记的创建与关联 |\n| 语音备忘录 | ~10+ | 语音转录、标签分类 |\n| 健康数据 | ~15+ | Oura Ring 数据集成 |\n| 财务管理 | ~10+ | 账户、净值、交易记录 |\n| 习惯追踪 | ~5+ | 习惯完成率、连续天数 |\n| 屏幕时间 | ~3+ | 应用使用分析 |\n| 教练系统 | ~10+ | 教练档案、会话、行动项 |\n| PPV 生活设计 | ~10+ | 愿景、身份、支柱管理 |\n\n资料来源：[AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n\n### 核心规划工具\n\nMCP 服务器提供了强大的规划工具集，用于支持各类规划工作流：\n\n#### 1. 规划上下文获取工具\n\n`get_planning_context` 是最核心的上下文获取工具，支持丰富的筛选参数：\n\n```javascript\nget_planning_context({\n  date?: string,           // 指定日期\n  weekStartDate?: string,  // 周起始日期\n  include: {\n    daily: boolean,        // 每日视图数据\n    weekly: boolean,       // 每周视图数据\n    currentCycle: boolean,  // 当前冲刺/周期数据\n    backlog: boolean,      // 待办事项池\n    habits: boolean,       // 习惯数据\n    dailyFields: boolean,   // 每日字段配置\n    calendar: boolean,      // 日历事件\n    voiceMemos: boolean     // 语音备忘录\n  }\n})\n```\n\n资料来源：[skills/daily-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)\n\n#### 2. 规划变更应用工具\n\n`apply_planning_patch` 是用于执行变更的核心工具：\n\n| 操作类型 | 方法 | 用途 |\n|----------|------|------|\n| 创建任务 | `create_issue` | 新建工作项 |\n| 调度任务 | `schedule_issue` | 设置截止日期 |\n| 更新任务 | `update_issue` | 修改状态、优先级、估算 |\n| 周期分配 | `assign_issue_to_current_cycle` | 将任务分配到当前周期 |\n| 优先级设置 | `set_top_priority` | 设置今日 Top 3 |\n| 周期目标更新 | `update_cycle_goals` | 更新冲刺目标 |\n| 每日笔记保存 | `save_daily_note` | 保存每日议程笔记 |\n| 周笔记保存 | `save_weekly_note` | 保存每周计划笔记 |\n| 评论添加 | `add_issue_comment` | 添加规划说明 |\n\n资料来源：[skills/daily-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)\n\n### 健康数据集成工具\n\nOura Ring 健康数据的完整集成：\n\n| 健康指标 | 工具方法 | 数据范围 |\n|----------|----------|----------|\n| 睡眠数据 | `get_health_sleep` | 得分、时长、入睡时间、呼吸率 |\n| 活动数据 | `get_health_activity` | 步数、卡路里、活动天数 |\n| 就绪度 | `get_health_readiness` | 得分趋势、压力与恢复平衡 |\n| 压力数据 | `get_health_stress` | 压力水平、日间恢复 |\n| 心率 | `get_health_heart_rate` | 心率趋势 |\n| 韧性 | `get_health_resilience` | 韧性水平及其贡献因素 |\n| VO2 Max | `get_health_vo2_max` | 有氧能力估计 |\n| 心血管年龄 | `get_health_cardio_age` | 心血管健康评估 |\n| 血氧 | `get_health_spo2` | SpO2、呼吸障碍指数 |\n| 锻炼记录 | `get_health_workouts` | 锻炼历史记录 |\n\n资料来源：[skills/health-weekly/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-weekly/SKILL.md)\n\n### PPV 生活设计工具\n\nPPV（Purpose, Principles, Vision）是一套完整的人生设计系统：\n\n| 操作 | 工具方法 | 描述 |\n|------|----------|------|\n| 获取工作空间 | `get_ppv_workspace` | 获取完整的 PPV 数据结构 |\n| 获取愿景图谱 | `get_active_vision_graph` | 获取活跃愿景的关联图 |\n| 创建/更新愿景 | `upsert_ppv_vision` | 愿景应该是生动的、情感的、有方向性的 |\n| 创建/更新身份 | `upsert_ppv_identity` | 核心身份、信念、行为 |\n| 创建/更新支柱 | `create_ppv_pillar` / `update_ppv_pillar` / `delete_ppv_pillar` | 支柱是持续运行的系统 |\n| 每周行动管理 | `create_ppv_weekly_action` / `update_ppv_weekly_action` / `delete_ppv_weekly_action` | 小而具体的行动 |\n| 反思记录 | `create_ppv_reflection` | 每周能量、阻力、一致性、动力 |\n| 调整记录 | `create_ppv_adjustment` | 根据反思调整身份、支柱、项目、行动 |\n\n资料来源：[skills/ppv/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/ppv/SKILL.md)\n\n## MCP 提示（Prompts）\n\n除了 126 个工具外，MCP 服务器还暴露了 28 个提示，这些提示封装了完整的工作流逻辑：\n\n### 每日工作流提示\n\n| 提示名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| `daily-standup` | `/daily-standup` | 晨会简报，包含议程、任务、冲刺进度 |\n| `daily-plan` | `/daily-plan` | 今日计划，设置截止日期、优先级、周期分配 |\n| `end-of-day` | `/end-of-day` | 每日收尾，完成总结与明日计划 |\n| `capture` | `/capture \"内容\"` | 快速捕获想法、任务或笔记，自动路由 |\n\n资料来源：[README.md:17-23](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L17-L23)\n\n### 回顾与计划提示\n\n| 提示名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| `weekly-review` | `/weekly-review` | 完成工作、进行中项、冲刺健康度 |\n| `weekly-plan` | `/weekly-plan` | 周计划，设置周期、截止日期、优先级 |\n| `monthly-review` | `/monthly-review` | 月度成就、项目进度、下月规划 |\n| `cycle-review` | `/cycle-review` | 冲刺回顾，包含延续选项 |\n| `initiative-review` | `/initiative-review 2026` | 年度目标分类查看 |\n\n资料来源：[README.md:24-35](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L24-L35)\n\n### 客户与项目管理提示\n\n| 提示名称 | 命令 | 功能描述 |\n|----------|------|----------|\n| `project-status` | `/project-status ACME` | 阶段分解、任务统计、阻塞项 |\n| `client-brief` | `/client-brief \"Acme Corp\"` | 客户项目、沟通、健康度 |\n| `client-health` | `/client-health` | 全客户健康度仪表盘 |\n| `sprint-plan` | `/sprint-plan` | 周期计划：目标、回溯、截止日期、优先级 |\n| `customer-success-triage` | `/customer-success-triage \"Acme Corp\"` | 使用聊天、会议、笔记、开放任务进行分类 |\n\n资料来源：[README.md:36-46](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L36-L46)\n\n## 工作流集成\n\n### 技能与 MCP 工具的关系\n\nSkills（技能）是对 MCP 工具的高级封装，每个 Skill 通常会组合使用多个 MCP 工具来完成复杂任务：\n\n```mermaid\ngraph LR\n    A[\"Skill 调用\"] --> B[\"get_planning_context\"]\n    A --> C[\"业务逻辑处理\"]\n    A --> D[\"apply_planning_patch\"]\n    A --> E[\"其他数据工具\"]\n    \n    B --> F[\"获取 LifeOS 数据\"]\n    D --> G[\"写入 LifeOS 数据\"]\n    E --> F\n    E --> G\n```\n\n### 典型规划工作流\n\n以 `daily-plan` 为例，展示 MCP 工具的典型使用模式：\n\n```mermaid\nsequenceDiagram\n    participant S as Skill\n    participant MCP as MCP Server\n    participant LifeOS as Convex Backend\n    \n    S->>MCP: get_planning_context()\n    MCP->>LifeOS: 查询规划上下文数据\n    LifeOS-->>MCP: 返回每日/每周/周期/待办数据\n    MCP-->>S: 完整上下文对象\n    \n    S->>S: 分析数据，构建日计划\n    Note over S: 选取 Top 3<br/>安排任务调度<br/>调整周期分配\n    \n    S->>MCP: apply_planning_patch(mode=\"day\")\n    Note over MCP: create_issue<br/>schedule_issue<br/>set_top_priority<br/>save_daily_note\n    MCP->>LifeOS: 执行变更操作\n    LifeOS-->>MCP: 确认变更\n    MCP-->>S: 返回变更结果\n```\n\n资料来源：[skills/daily-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)\n\n## 图谱查询工具\n\nMCP 服务器提供了强大的图谱查询功能，用于理解实体之间的关系：\n\n| 工具方法 | 用途 |\n|----------|------|\n| `get_active_vision_graph` | 获取活跃或选定愿景的统一图谱，包含 PPV 节点及关联的项目、事项、语音备忘录 |\n| `get_project_graph` | 以项目为中心的图谱邻域 |\n| `get_initiative_graph` | 以倡议为中心的图谱邻域 |\n| `get_person_graph` | 关系/联系人上下文图谱 |\n| `get_voice_memo_graph` | 以语音备忘录为中心的图谱邻域 |\n| `get_unified_life_graph` | 整体系统分析或导出（重量级操作） |\n\n资料来源：[skills/ppv/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/ppv/SKILL.md)\n\n## 客户端集成\n\n### Claude Code 集成\n\nClaude Code 通过插件机制直接集成 MCP 服务器：\n\n```bash\n# 安装插件（自动配置 MCP 服务器和技能）\nclaude plugin add github:starascendin/lifeos-plugin\n```\n\n安装后，Claude Code 自动获得：\n- 37 个技能（Skills）\n- 126 个 MCP 工具\n- 28 个 MCP 提示\n\n资料来源：[README.md:27-30](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L27-L30)\n\n### OpenCode 集成\n\nOpenCode 原生读取 `.claude/skills/` 目录：\n\n```bash\n# 方式 A：复制技能目录\ncp -r skills/ .claude/skills/lifeos/\n\n# 方式 B：符号链接（推荐，便于更新）\nln -s /path/to/lifeos-plugin/skills .claude/skills/lifeos\n```\n\n资料来源：[README.md:35-44](https://github.com/starascendin/lifeos-plugin/blob/main/README.md#L35-L44)\n\n## 更新维护\n\n### 插件更新\n\n```bash\n# 更新插件仓库\ncd /path/to/lifeos-plugin && git pull\n\n# MCP 服务器自动更新（使用 npx @latest）\n# 或在 .mcp.json 中锁定版本\n```\n\n资料来源：[AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n\n## 总结\n\nMCP 服务器架构是 LifeOS Plugin 的核心通信层，它通过 MCP 协议标准化的接口，将 LifeOS 的全部功能暴露给各类 AI 客户端。架构设计的关键特点包括：\n\n1. **标准化协议**：采用 MCP 协议，确保与多种 AI 客户端的兼容性\n2. **丰富的工具集**：126 个工具覆盖项目管理、健康数据、财务、习惯等全生活领域\n3. **封装的工作流**：28 个提示封装了完整的规划、回顾、管理流程\n4. **灵活的认证**：基于环境变量的 API Key + User ID 认证机制\n5. **图谱能力**：支持实体间关系的图谱查询，便于理解复杂关联\n\n---\n\n<a id='page-daily-workflows'></a>\n\n## 日常管理工作流\n\n### 相关页面\n\n相关主题：[复盘与规划工作流](#page-review-workflows)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [skills/daily-standup/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-standup/SKILL.md)\n- [skills/daily-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)\n- [skills/end-of-day/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/end-of-day/SKILL.md)\n- [skills/capture/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/capture/SKILL.md)\n- [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n- [AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n</details>\n\n# 日常管理工作流\n\n## 概述\n\n日常管理工作流是 LifeOS Plugin 为个人生产力管理提供的核心技能集合，涵盖从每日晨会到日终复盘的完整工作周期。这些工作流通过 MCP（Model Context Protocol）工具与 Convex 后端交互，实现任务的查看、创建、更新和调度操作。四个核心技能共同构成了一个闭环的每日生产力管理系统，帮助用户高效规划一天、跟踪进度并在一天结束时进行总结反思。\n\n## 核心技能架构\n\nLifeOS Plugin 的日常管理工作流包含四个相互关联的技能，每个技能针对工作日的不同阶段：\n\n| 技能名称 | 功能描述 | 工作流类型 |\n|---------|---------|-----------|\n| `daily-standup` | 晨间简报，包含议程、任务和迭代进度 | 只读查询 |\n| `daily-plan` | 规划今日工作，修改截止日期、优先级、周期分配和每日笔记 | 变异操作 |\n| `end-of-day` | 日终总结，包含完成情况汇总和明日计划 | 变异操作 |\n| `capture` | 快速捕获想法、任务或笔记，自动路由到适当位置 | 变异操作 |\n\n资料来源：[README.md:14-25]()\n\n### 技能调用流程图\n\n```mermaid\ngraph TD\n    A[开始新的一天] --> B[daily-standup<br/>晨间简报]\n    B --> C{查看任务和进度}\n    C --> D[daily-plan<br/>今日规划]\n    D --> E{捕获临时想法}\n    E --> F[capture<br/>快速捕获]\n    F --> G[执行工作]\n    G --> H[end-of-day<br/>日终复盘]\n    H --> I[结束一天<br/>进入明日循环]\n```\n\n## 晨间简报（daily-standup）\n\n### 功能说明\n\n`daily-standup` 技能提供每日的站立会议式简报，帮助用户快速了解当天的任务概览和迭代进度。该技能通过调用 LifeOS MCP 工具收集当日议程、任务列表、逾期任务和当前迭代周期信息，并以结构化格式呈现。\n\n资料来源：[skills/daily-standup/SKILL.md:1-7]()\n\n### 使用的 MCP 工具\n\n| MCP 工具 | 用途 |\n|---------|-----|\n| `get_daily_agenda` | 获取今日议程，包含今日截止的任务和日历事件 |\n| `get_todays_tasks` | 获取今日任务列表 |\n| `get_overdue_tasks` | 获取已逾期的开放任务 |\n| `get_current_cycle` | 获取当前迭代周期进度和统计 |\n\n资料来源：[skills/daily-standup/SKILL.md:8-11]()\n\n### 输出格式\n\n晨间简报的输出包含以下五个核心部分：\n\n1. **Today's Focus** — 今日重点关注的 3 项事务\n2. **Tasks Due** — 今日截止的任务列表，含优先级标记\n3. **Overdue** — 需要立即处理的逾期任务\n4. **Sprint Progress** — 迭代完成百分比和关键统计\n5. **Calendar** — 今日会议或事件安排\n\n该技能支持通过 `$ARGUMENTS` 参数指定特定日期，默认为当天日期。\n\n## 今日规划（daily-plan）\n\n### 功能说明\n\n`daily-plan` 是日常管理工作流中的核心变异技能，用于在获取规划上下文后对 LifeOS 进行实际的变更操作。这是一个完全自动化的变异工作流，执行后不会请求用户确认。\n\n资料来源：[skills/daily-plan/SKILL.md:1-5]()\n\n### 工作流程\n\n```mermaid\ngraph TD\n    A[调用 get_planning_context] --> B[收集规划上下文]\n    B --> C[构建今日计划]\n    C --> D{创建/调度/分配任务}\n    C --> E{设置优先级}\n    C --> F{更新周期目标}\n    C --> G{保存每日笔记}\n    D --> H[apply_planning_patch<br/>dryRun=false]\n    E --> H\n    F --> H\n    G --> H\n    H --> I[报告变更结果]\n```\n\n### 规划上下文参数\n\n调用 `get_planning_context` 时使用的参数配置：\n\n| 参数 | 值 | 说明 |\n|-----|-----|-----|\n| `date` | `$ARGUMENTS` 或当天 | 规划日期 |\n| `include.daily` | `true` | 包含每日信息 |\n| `include.weekly` | `true` | 包含周度信息 |\n| `include.currentCycle` | `true` | 包含当前迭代周期 |\n| `include.backlog` | `true` | 包含待办列表 |\n| `include.habits` | `true` | 包含习惯追踪 |\n| `include.dailyFields` | `true` | 包含每日字段 |\n| `include.calendar` | `true` | 包含日历事件 |\n| `include.voiceMemos` | `true` | 包含语音备忘录 |\n\n资料来源：[skills/daily-plan/SKILL.md:8-18]()\n\n### 支持的变异操作\n\n通过 `apply_planning_patch` 的 `mode=\"day\"` 可以执行以下操作：\n\n| 操作类型 | MCP 工具 | 用途 |\n|---------|---------|-----|\n| 创建任务 | `create_issue` | 创建新的任务记录 |\n| 调度任务 | `schedule_issue` | 设置任务截止日期 |\n| 更新任务 | `update_issue` | 修改任务状态、优先级、估算和标题 |\n| 分配周期 | `assign_issue_to_current_cycle` | 将任务分配到当前活跃迭代 |\n| 设置优先级 | `set_top_priority` | 设置今日 Top 3 优先级 |\n| 更新周期目标 | `update_cycle_goals` | 修改活跃迭代的目标 |\n| 保存每日笔记 | `save_daily_note` | 写入最终可读的日计划到议程笔记 |\n| 添加任务评论 | `add_issue_comment` | 添加规划理由到任务 |\n\n资料来源：[skills/daily-plan/SKILL.md:24-35]()\n\n### 规划原则\n\n规划今日工作时需要遵循以下原则：\n\n- 从规划上下文中选取今日最重要的 3 项事务\n- 通过设置 `dueDate` 来安排任务的执行时间\n- 将相关的待办工作拉入当前活跃迭代周期\n- 如果计划改变了迭代焦点，需同步更新当前迭代目标\n- 根据今日日历和当前迭代的工作负载保持计划现实可行\n\n资料来源：[skills/daily-plan/SKILL.md:13-21]()\n\n## 日终复盘（end-of-day）\n\n### 功能说明\n\n`end-of-day` 技能用于日终收尾，包含今日完成情况汇总和明日规划。这是一个变异工作流，会对 LifeOS 进行实际的记录和更新操作。\n\n资料来源：[README.md:18-19]()\n\n### 核心功能\n\n1. **完成情况汇总** — 总结当日完成的任务和未完成的工作\n2. **明日计划准备** — 为第二天的工作做好初步规划\n3. **更新迭代状态** — 记录迭代进度和任何变更\n\n## 快速捕获（capture）\n\n### 功能说明\n\n`capture` 技能提供了一种快速记录想法、任务或笔记的方式，并具备自动路由到适当位置的能力。这对于在执行工作过程中快速捕获灵感或临时任务特别有用。\n\n资料来源：[README.md:21-22]()\n\n### 自动路由机制\n\n捕获的内容会根据类型自动路由到不同的目的地：\n\n| 内容类型 | 路由目标 |\n|---------|---------|\n| 临时想法 | 笔记系统或语音备忘录 |\n| 待办任务 | 自动创建为 Issue 或添加到待办列表 |\n| 会议要点 | 关联到相关项目或联系人 |\n| 客户信息 | 客户端工作区笔记 |\n\n### 使用场景\n\n- 在专注工作时突然出现的想法\n- 会议中快速记录的要点\n- 客户沟通时的新需求或反馈\n- 任何需要稍后处理但不应打断当前流程的信息\n\n## 集成与配置\n\n### MCP 服务器配置\n\n日常管理工作流依赖于 LifeOS MCP 服务器的正常运行。配置方式有两种：\n\n**方式一：MCP 服务器配置（JSON）**\n\n```json\n{\n  \"mcpServers\": {\n    \"lifeos\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@starascendin/lifeos-mcp@latest\",\n        \"--url\", \"YOUR_CONVEX_URL\",\n        \"--user-id\", \"YOUR_USER_ID\",\n        \"--api-key\", \"YOUR_API_KEY\"\n      ]\n    }\n  }\n}\n```\n\n资料来源：[README.md:52-63]()\n\n**方式二：环境变量配置**\n\n```bash\nexport LIFEOS_CONVEX_URL=https://your-app.convex.site\nexport LIFEOS_USER_ID=your-user-id\nexport LIFEOS_API_KEY=your-api-key\n```\n\n资料来源：[README.md:37-40]()\n\n### Claude Code 集成\n\n```bash\nclaude plugin add github:starascendin/lifeos-plugin\n```\n\n### OpenCode 集成\n\nOpenCode 原生读取 `.claude/skills/` 目录，复制或符号链接 skills 目录：\n\n```bash\n# 复制方式\ncp -r skills/ .claude/skills/lifeos/\n\n# 符号链接方式\nln -s /path/to/lifeos-plugin/skills .claude/skills/lifeos\n```\n\n资料来源：[README.md:43-50]()\n\n## 与其他工作流的协同\n\n日常管理工作流并非孤立存在，它们与 LifeOS Plugin 提供的其他工作流形成完整的生产力管理系统：\n\n```mermaid\ngraph LR\n    subgraph 日常管理\n        A[daily-standup] --> B[daily-plan]\n        B --> C[end-of-day]\n        C --> D[capture]\n    end\n    \n    subgraph 规划类工作流\n        E[weekly-plan] --> A\n        C --> F[sprint-plan]\n    end\n    \n    subgraph 周期性回顾\n        A --> G[weekly-review]\n        C --> H[monthly-review]\n        H --> I[cycle-review]\n    end\n    \n    subgraph 专业领域\n        A --> J[health-weekly]\n        A --> K[daily-training-report]\n        D --> L[voice-notes]\n    end\n```\n\n### 规划类工作流的关联\n\n| 关联关系 | 说明 |\n|---------|-----|\n| weekly-plan → daily-plan | 周计划为日计划提供上下文 |\n| sprint-plan → daily-plan | 迭代计划指导每日任务分配 |\n| daily-plan → weekly-plan | 日计划执行情况影响周计划调整 |\n\n`sprint-plan` 技能提供了迭代周期的规划能力，与 `daily-plan` 的 `include.currentCycle` 参数紧密相关。两者共享 `get_planning_context` 和 `apply_planning_patch` 工具。\n\n资料来源：[skills/sprint-plan/SKILL.md:1-20]()\n\n### 健康与习惯追踪的关联\n\n`daily-standup` 可以结合 `daily-training-report` 提供更全面的晨间简报：\n\n| 数据来源 | 技能 | 展示内容 |\n|---------|-----|---------|\n| Oura Ring | `health-weekly` | 睡眠评分、活动趋势、恢复状态 |\n| 习惯追踪 | `daily-training-report` | 习惯完成率、连续天数 |\n| 日历整合 | `daily-standup` | 会议安排、时间块 |\n\n资料来源：[skills/daily-training-report/SKILL.md:1-25]()\n\n## 最佳实践\n\n### 晨间简报使用建议\n\n1. 每天工作开始时首先运行 `daily-standup`\n2. 根据逾期任务的数量决定是否需要立即处理\n3. 将 sprint 进度作为当日工作节奏的参考\n4. 使用 `$ARGUMENTS` 指定特定日期查看历史记录\n\n### 今日规划执行策略\n\n1. 规划前先完成晨间简报获取完整上下文\n2. 遵循\"一次只做一件事\"原则设置 Top 3 优先级\n3. 将模糊的想法通过 `capture` 记录后再继续规划\n4. 规划变更后及时更新迭代目标保持一致性\n5. 使用 `save_daily_note` 生成可读的日计划存档\n\n### 日终复盘建议\n\n1. 记录完成的任务和实际花费的时间\n2. 识别未完成任务的原因（阻塞、估计偏差、优先级变更）\n3. 为次日准备 1-3 个明确的优先任务\n4. 积累数据为周期性回顾提供依据\n\n## 相关资源\n\n- **完整技能列表**: [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n- **MCP 工具参考**: [AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n- **迭代规划**: [sprint-plan 技能](https://github.com/starascendin/lifeos-plugin/blob/main/skills/sprint-plan/SKILL.md)\n- **周度规划**: [weekly-plan 技能](https://github.com/starascendin/lifeos-plugin/blob/main/skills/weekly-plan/SKILL.md)\n- **语音笔记**: [voice-notes 技能](https://github.com/starascendin/lifeos-plugin/blob/main/skills/voice-notes/SKILL.md)\n- **健康追踪**: [health-weekly 技能](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-weekly/SKILL.md)\n\n---\n\n<a id='page-review-workflows'></a>\n\n## 复盘与规划工作流\n\n### 相关页面\n\n相关主题：[日常管理工作流](#page-daily-workflows), [项目与客户管理](#page-project-management)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [skills/weekly-review/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/weekly-review/SKILL.md)\n- [skills/weekly-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/weekly-plan/SKILL.md)\n- [skills/monthly-review/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/monthly-review/SKILL.md)\n- [skills/cycle-review/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/cycle-review/SKILL.md)\n- [skills/initiative-review/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/initiative-review/SKILL.md)\n</details>\n\n# 复盘与规划工作流\n\n## 概述\n\n复盘与规划工作流是 LifeOS Plugin 中用于周期性回顾过去、规划未来的核心功能集合。这些工作流涵盖了从每日微观规划到年度宏观审视的完整时间跨度，帮助用户系统性地审视已完成工作、评估当前状态，并制定下一步行动计划。\n\n这些工作流分为两大类别：**复盘类工作流**侧重于回顾和分析已完成的工作，而**规划类工作流**则专注于创建变更并应用到 LifeOS 系统中。两者相互配合，形成完整的\"回顾-反思-计划-执行\"闭环。\n\n资料来源：[README.md:15-30]()\n\n## 架构总览\n\n复盘与规划工作流遵循统一的设计模式，每个工作流都通过 LifeOS MCP 工具与 Convex 后端进行交互：\n\n```mermaid\ngraph TD\n    A[用户触发工作流] --> B[获取上下文数据]\n    B --> C[分析评估]\n    C --> D{工作流类型}\n    D -->|复盘类| E[展示分析结果]\n    D -->|规划类| F[执行变更操作]\n    E --> G[生成报告]\n    F --> H[应用变更到LifeOS]\n    H --> G\n    G --> I[更新Daily Note/Weekly Note]\n```\n\n### 核心设计原则\n\n| 原则 | 说明 | 资料来源 |\n|------|------|----------|\n| 上下文优先 | 规划工作流首先调用 `get_planning_context` 获取完整上下文 | [skills/weekly-plan/SKILL.md:1-12]() |\n| 自动执行 | 规划类工作流不询问确认，直接应用变更 | [skills/daily-plan/SKILL.md:24]() |\n| 可组合性 | 各周期的工作流可相互嵌套调用 | [skills/monthly-review/SKILL.md:1-8]() |\n| 数据驱动 | 决策基于实际数据而非主观判断 | [skills/cycle-review/SKILL.md:1-10]() |\n\n## 复盘类工作流\n\n### 周期循环复盘\n\n#### 每日回顾 (Daily Review)\n\n每日回顾嵌入在 `daily-plan` 工作流中，通过获取今日待办任务、日历和习惯数据来进行快速审视。\n\n#### 周期回顾 (Cycle Review)\n\n周期回顾用于审视当前冲刺/周期的完成情况，支持延期项的处理：\n\n```mermaid\ngraph TD\n    A[获取当前Cycle数据] --> B[计算完成率]\n    B --> C{完成率达标?}\n    C -->|是| D[庆祝成就]\n    C -->|否| E[分析延期原因]\n    E --> F{是否滚动到下周期?}\n    F -->|是| G[执行延期操作]\n    F -->|否| H[标记为风险项]\n    G --> I[更新Cycle数据]\n    H --> J[记录风险]\n```\n\n**执行操作**：\n- 延期项自动滚动到下一个周期\n- 未完成项标记为风险项\n- 更新周期元数据\n\n资料来源：[skills/cycle-review/SKILL.md:1-15]()\n\n#### 周回顾 (Weekly Review)\n\n周回顾是最高频的复盘工作流，系统性地审视一周内的工作成果：\n\n| 数据维度 | 获取工具 | 展示内容 |\n|----------|----------|----------|\n| 已完成任务 | `get_tasks` with status=\"done\" | 完成数量、类型分布 |\n| 进行中任务 | `get_todays_tasks` | 当前工作负载 |\n| 周期健康度 | `get_cycles` | Sprint完成率 |\n| 客户状态 | `get_clients` | 关系健康度 |\n| 捕获笔记 | `get_recent_notes` | 思考模式分析 |\n\n资料来源：[skills/weekly-review/SKILL.md:1-12]()\n\n#### 月回顾 (Monthly Review)\n\n月回顾提供更宏观的视角，整合多周数据形成月度洞察：\n\n- **成就总结**：本月重大胜利和完成的工作\n- **项目进展**：各活跃项目的状态\n- **Sprint表现**：跨周期的平均完成率\n- **客户健康度**：各客户关系状态\n- **主题模式**：笔记和完成工作的模式识别\n- **结转项**：滚转到下月的工作\n- **反思**：什么有效、什么无效\n- **下月重点**：下月前三优先级\n\n资料来源：[skills/monthly-review/SKILL.md:1-25]()\n\n#### 年度倡议回顾 (Initiative Review)\n\n年度层面的审视，按类别查看目标进展：\n\n```mermaid\ngraph LR\n    A[年度倡议] --> B[按类别分组]\n    B --> C[各倡议进度]\n    C --> D[偏差分析]\n    D --> E[调整建议]\n```\n\n资料来源：[skills/initiative-review/SKILL.md:1-8]()\n\n### 专项复盘\n\n#### 健康周检视 (Health Weekly)\n\n每周健康数据综合回顾，整合 Oura Ring 的多维度数据：\n\n| 健康维度 | 数据源 | 关键指标 |\n|----------|--------|----------|\n| 睡眠质量 | `get_health_sleep` | 评分、时长、深度/REM平衡 |\n| 活动模式 | `get_health_activity` | 步数均值、活跃天数 |\n| 准备度 | `get_health_readiness` | 评分趋势、压力vs恢复 |\n| 韧性 | `get_health_resilience` | 日级别趋势、贡献因子 |\n| 健身 | `get_health_vo2_max` | 最大摄氧量趋势 |\n\n资料来源：[skills/health-weekly/SKILL.md:1-20]()\n\n#### 客户成功分类 (Customer Success Triage)\n\n客户请求的三级分类体系：\n\n| 分类 | 说明 | 处理方式 |\n|------|------|----------|\n| 新需求 | 全新请求或变更需求 | 创建需求笔记 |\n| 跟进项 | 等待你或团队响应的事项 | 更新现有任务 |\n| 风险/阻塞 | 范围模糊、延期风险、流失风险 | 标记并通知 |\n| 已跟踪 | 已有笔记或任务覆盖 | 关联现有项 |\n\n资料来源：[skills/customer-success-triage/SKILL.md:1-25]()\n\n## 规划类工作流\n\n### 周期规划工作流\n\n规划类工作流是会变更 LifeOS 状态的**变异工作流**，执行后直接修改系统数据，不询问确认。\n\n```mermaid\ngraph TD\n    A[调用 get_planning_context] --> B[构建计划]\n    B --> C{验证计划可行性}\n    C -->|可行| D[调用 apply_planning_patch]\n    C -->|不可行| E[调整计划]\n    E --> C\n    D --> F[执行变更]\n    F --> G[报告结果]\n```\n\n资料来源：[skills/sprint-plan/SKILL.md:1-20]()\n\n#### 日计划 (Daily Plan)\n\n日计划工作流的核心操作：\n\n| 操作类型 | 工具方法 | 说明 |\n|----------|----------|------|\n| 创建任务 | `create_issue` | 新增任务到系统 |\n| 调度任务 | `schedule_issue` | 设置截止日期 |\n| 更新任务 | `update_issue` | 修改状态、优先级、估算 |\n| 加入周期 | `assign_issue_to_current_cycle` | 将工作纳入当前周期 |\n| 设置优先级 | `set_top_priority` | 设置今日Top 3 |\n| 更新周期目标 | `update_cycle_goals` | 变更周期焦点 |\n| 保存日记 | `save_daily_note` | 写入可读的日计划 |\n\n资料来源：[skills/daily-plan/SKILL.md:1-30]()\n\n#### 周计划 (Weekly Plan)\n\n周计划在日计划基础上扩展到整周视角：\n\n**周计划关键决策点**：\n\n1. **更新周期目标**：当周期焦点需要调整时\n2. **分配待办项**：将选定的待办任务纳入当前周期\n3. **跨周调度**：使用 `dueDate` 安排一周的工作\n4. **设置近优先级**：确定近期的首要任务\n5. **保持可执行性**：确保今日计划足够具体可执行\n\n资料来源：[skills/weekly-plan/SKILL.md:1-35]()\n\n#### Sprint计划 (Sprint Plan)\n\nSprint计划专注于当前周期层面的规划：\n\n- 更新周期目标（当焦点需要改变时）\n- 将适当的待办工作拉入当前周期\n- 使用 `dueDate` 安排近期工作\n- 设置首要任务的最高优先级\n- 避免当前周期过载\n\n资料来源：[skills/sprint-plan/SKILL.md:1-25]()\n\n### 规划上下文数据模型\n\n`get_planning_context` 获取的完整上下文结构：\n\n```json\n{\n  \"include\": {\n    \"daily\": true,\n    \"weekly\": true,\n    \"currentCycle\": true,\n    \"backlog\": true,\n    \"habits\": true,\n    \"dailyFields\": true,\n    \"calendar\": true,\n    \"voiceMemos\": true\n  }\n}\n```\n\n| 字段 | 用途 |\n|------|------|\n| daily | 今日任务和日历 |\n| weekly | 本周概览 |\n| currentCycle | 当前Sprint数据 |\n| backlog | 待办池任务 |\n| habits | 习惯追踪 |\n| dailyFields | 每日字段配置 |\n| calendar | 日历事件 |\n| voiceMemos | 语音备忘录 |\n\n## 复盘与规划的协同关系\n\n复盘和规划工作流形成闭环，两者数据互通：\n\n```mermaid\ngraph LR\n    A[周回顾] --> B[识别模式和风险]\n    B --> C[周计划]\n    C --> D[执行]\n    D --> E[日计划/日执行]\n    E --> F{周期结束}\n    F --> G[周期回顾]\n    G --> H[延期决策]\n    H --> I[Sprint计划]\n    I --> D\n    I --> C\n```\n\n### 数据流向\n\n| 复盘输出 | 作为规划输入 |\n|----------|--------------|\n| 已完成任务 | 评估当前周期负载 |\n| 延期项 | Sprint计划待处理 |\n| 完成率 | 调整周期容量 |\n| 模式分析 | 优化计划策略 |\n| 风险识别 | 优先级调整依据 |\n\n## MCP 工具清单\n\n复盘与规划工作流依赖的核心 MCP 工具：\n\n| 工具 | 用途 | 工作流类型 |\n|------|------|------------|\n| `get_planning_context` | 获取完整规划上下文 | 规划 |\n| `apply_planning_patch` | 执行变更操作 | 规划 |\n| `get_tasks` | 获取任务列表 | 复盘/规划 |\n| `get_cycles` | 获取周期数据 | 复盘 |\n| `get_daily_agenda` | 获取每日议程 | 复盘 |\n| `get_monthly_agenda` | 获取月度概览 | 复盘 |\n| `get_initiatives` | 获取年度倡议 | 复盘 |\n| `get_clients` | 获取客户列表 | 复盘 |\n| `get_health_*` | 获取健康数据 | 专项复盘 |\n| `create_issue` | 创建任务 | 规划 |\n| `update_issue` | 更新任务 | 规划 |\n| `schedule_issue` | 调度任务 | 规划 |\n| `save_daily_note` | 保存日记 | 规划 |\n| `save_weekly_note` | 保存周笔记 | 规划 |\n\n资料来源：[AGENTS.md:50-80]()\n\n## 最佳实践\n\n### 执行顺序建议\n\n1. **高频周期先执行**：日计划 → 周计划 → Sprint计划\n2. **复盘为规划提供输入**：先回顾再规划\n3. **专项复盘按需触发**：健康周检视、客户分类等\n4. **自动执行避免中断**：规划类工作流设计为自动执行\n\n### 数据一致性维护\n\n- 规划变更后检查 Daily Note 是否同步更新\n- 周期结束时执行周期回顾，避免延期项丢失\n- 月度回顾时验证所有周期数据的完整性\n\n### 异常处理\n\n| 场景 | 处理方式 |\n|------|----------|\n| 周期过载 | 优先将任务延期到下周期 |\n| 冲突优先级 | 参考 Top Priority 设置 |\n| 上下文不完整 | 记录缺失项，依赖手动补充 |\n\n## 与其他模块的集成\n\n复盘与规划工作流并非孤立存在，它与其他 LifeOS 模块紧密集成：\n\n```mermaid\ngraph TD\n    A[复盘与规划] --> B[PPV人生设计]\n    A --> C[教练模块]\n    A --> D[语音备忘录]\n    A --> E[健康追踪]\n    B --> F[Vision更新触发规划调整]\n    C --> G[教练行动项纳入Sprint]\n    D --> H[语音洞察转化为任务]\n    E --> I[健康数据影响容量评估]\n```\n\n- **PPV人生设计**：愿景变更可能触发周期目标调整\n- **教练模块**：教练行动项可纳入 Sprint 计划\n- **语音备忘录**：语音洞察通过结晶化流程转化为具体任务\n- **健康追踪**：健康数据影响个人容量评估和计划可行性\n\n资料来源：[skills/ppv/SKILL.md:1-30](), [skills/voice-notes/SKILL.md:1-20](), [skills/daily-training-report/SKILL.md:1-15]()\n\n---\n\n<a id='page-project-management'></a>\n\n## 项目与客户管理\n\n### 相关页面\n\n相关主题：[复盘与规划工作流](#page-review-workflows), [人际关系管理](#page-people-relationships)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [skills/project-status/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/project-status/SKILL.md)\n- [skills/client-brief/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/client-brief/SKILL.md)\n- [skills/client-health/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/client-health/SKILL.md)\n- [skills/sprint-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/sprint-plan/SKILL.md)\n- [skills/customer-success-triage/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/customer-success-triage/SKILL.md)\n- [skills/inbox-triage/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/inbox-triage/SKILL.md)\n- [skills/overdue/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/overdue/SKILL.md)\n</details>\n\n# 项目与客户管理\n\n## 概述\n\n项目与客户管理是 LifeOS Plugin 提供的核心功能模块，涵盖从项目状态追踪、冲刺规划到客户关系维护的完整工作流程。该模块通过 MCP（Model Context Protocol）工具与 Convex 后端交互，支持 37 种工作技能，涵盖项目看板、阶段分解、任务统计、阻塞项识别等能力。\n\n资料来源：[README.md:1-37]()\n\n## 核心技能体系\n\n### 技能矩阵\n\n| 技能名称 | 命令 | 功能描述 |\n|---------|------|---------|\n| project-status | `/project-status [项目名]` | 阶段分解、任务统计、阻塞项 |\n| client-brief | `/client-brief \"客户名\"` | 完整客户简报，包含项目与沟通记录 |\n| client-health | `/client-health` | 全客户健康仪表盘 |\n| sprint-plan | `/sprint-plan` | 当前冲刺规划：目标、回溯、截止日期、优先级 |\n| customer-success-triage | `/customer-success-triage \"客户名\"` | 客户请求分类处理 |\n| inbox-triage | `/inbox-triage` | 将笔记处理为可执行任务 |\n| overdue | `/overdue` | 逾期与滑向逾期的项目 |\n\n资料来源：[README.md:42-56]()\n\n## 项目状态管理\n\n### project-status 技能\n\n`project-status` 技能用于深入分析单个项目的健康状况，通过 MCP 工具获取项目的多维度数据。\n\n**工作流程：**\n\n```mermaid\ngraph TD\n    A[输入项目名称] --> B[get_project_workspace]\n    B --> C[收集项目数据]\n    C --> D[分析阶段进度]\n    C --> E[统计任务状态]\n    C --> F[识别阻塞项]\n    D --> G[生成项目状态报告]\n    E --> G\n    F --> G\n```\n\n**输出内容：**\n\n- **阶段分解**：项目各阶段的完成情况\n- **任务统计**：任务总数、进行中、已完成、阻塞数量\n- **阻塞项识别**：明确指出阻碍项目推进的问题\n- **风险预警**：进度滞后或资源不足的警示\n\n资料来源：[README.md:48]()\n\n## 客户管理\n\n### client-brief 技能\n\n`client-brief` 技能提供特定客户的完整视图，帮助快速了解与客户的全部互动情况。\n\n**数据结构：**\n\n```mermaid\ngraph TD\n    A[client-brief 技能] --> B[项目列表]\n    A --> C[最近沟通记录]\n    A --> D[待办任务]\n    A --> E[备注历史]\n    A --> F[健康指标]\n```\n\n**使用方式：**\n\n```bash\n/client-brief \"Acme Corp\"\n```\n\n**核心数据源：**\n\n| 数据类型 | MCP 工具 | 说明 |\n|---------|---------|------|\n| 项目 | get_client_projects | 客户关联的所有项目 |\n| 沟通 | get_beeper_thread_messages | Beeper 聊天记录 |\n| 会议 | get_fathom_meeting, get_granola_meeting | Fathom 和 Granola 会议数据 |\n| 笔记 | get_client_notes | 客户相关笔记 |\n| 任务 | get_client_tasks | 客户相关的开放任务 |\n\n资料来源：[README.md:49]()\n\n### client-health 技能\n\n`client-health` 技能提供跨所有客户的健康仪表盘，便于管理者快速掌握整体客户状况。\n\n**功能特点：**\n\n- 实时汇总所有客户的健康指标\n- 识别需要关注的客户\n- 追踪客户互动频率\n- 预警潜在的客户流失风险\n\n资料来源：[README.md:50]()\n\n## 冲刺规划\n\n### sprint-plan 技能\n\n`sprint-plan` 技能是**变异型工作流**，用于规划当前冲刺周期并直接应用变更到 LifeOS。\n\n**执行步骤：**\n\n1. 调用 `get_planning_context`，包含以下参数：\n   - `include.currentCycle=true`\n   - `include.backlog=true`\n   - `include.weekly=true`\n   - `include.daily=true`\n\n2. 构建冲刺计划：\n   - 更新冲刺目标（当焦点需要调整时）\n   - 从待办事项中拉取合适的工作到当前冲刺\n   - 使用 `dueDate` 安排近期工作\n   - 设置最高优先级\n   - 避免冲刺过载\n\n3. 调用 `apply_planning_patch`，参数：\n   - `mode=\"cycle\"`\n   - `dryRun=false`\n\n**可用操作：**\n\n| 操作 | MCP 工具 | 说明 |\n|-----|---------|------|\n| 创建新工作 | `create_issue` | 在冲刺中创建新任务 |\n| 分配到冲刺 | `assign_issue_to_current_cycle` | 将任务分配到当前冲刺 |\n| 安排任务 | `schedule_issue` | 设置截止日期 |\n| 更新任务 | `update_issue` | 修改状态、优先级、估算值、标题 |\n| 设置优先级 | `set_top_priority` | 立即聚焦的任务 |\n| 更新目标 | `update_cycle_goals` | 冲刺目标调整 |\n| 保存笔记 | `save_weekly_note` / `save_daily_note` | 可读计划文档 |\n\n**执行后报告内容：**\n\n- 当前冲刺目标与容量\n- 分配、创建或安排的任务\n- 最高优先级列表\n- 任何风险或过载警告\n\n资料来源：[skills/sprint-plan/SKILL.md:1-45]()\n\n## 客户成功分类\n\n### customer-success-triage 技能\n\n`customer-success-triage` 技能用于系统性地分类处理客户请求和客户成功工作。\n\n**工作流程：**\n\n```mermaid\ngraph TD\n    A[输入客户名称] --> B[get_client_success_workspace]\n    B --> C[审查工作区数据]\n    C --> D[recentThreads]\n    C --> E[recentMeetings]\n    C --> F[notes]\n    C --> G[openTasks]\n    C --> H[projects]\n    D --> I[需要时深入]\n    E --> I\n    F --> I\n    G --> I\n    I --> J[分类发现]\n    J --> K[生成分类报告]\n```\n\n**分类类别：**\n\n| 类别 | 说明 |\n|-----|------|\n| 新需求 (New Requirements) | 全新请求或变更需求 |\n| 跟进项 (Follow-Ups) | 等待你或团队处理的事项 |\n| 风险/阻塞 (Risks/Blockers) | 范围模糊、逾期工作、交付风险、流失风险 |\n| 已追踪 (Already Tracked) | 已有笔记或任务覆盖的请求 |\n\n**MCP 工具调用顺序：**\n\n1. `get_client_success_workspace` — 获取客户工作区\n2. `get_beeper_thread_messages` — 聊天详情\n3. `get_fathom_meeting` / `get_fathom_transcript` — Fathom 会议详情\n4. `get_granola_meeting` / `get_granola_transcript` — Granola 会议详情\n5. `get_client_notes` — 已有笔记历史\n\n**写入操作策略：**\n\n- 使用 `create_client_note` 或 `update_client_note` 保存持久性账户记忆\n- 仅对执行工作使用 `create_issue` 或 `update_issue`\n- 优先更新现有笔记/任务，避免创建重复项\n- 不删除任何内容\n\n资料来源：[skills/customer-success-triage/SKILL.md:1-50]()\n\n## 收件箱分类\n\n### inbox-triage 技能\n\n`inbox-triage` 技能将捕获的笔记处理为可执行任务、标签和链接。\n\n**执行流程：**\n\n```mermaid\ngraph TD\n    A[获取最近笔记] --> B[获取可用项目]\n    A --> C[获取联系人]\n    B --> D[分析每条笔记]\n    C --> D\n    D --> E{分析结果}\n    E -->|动作项| F[转换为任务]\n    E -->|提及人员| G[链接到人员]\n    E -->|关联项目| H[分配到项目]\n    E -->|需要分类| I[添加标签]\n    F --> J[显示分类列表]\n    G --> J\n    H --> J\n    I --> J\n    J --> K{用户确认}\n    K -->|是| L[执行变更]\n    K -->|否| M[调整建议]\n```\n\n**MCP 工具调用：**\n\n1. `get_recent_notes` — 获取最近 20 条未处理捕获\n2. `get_projects` — 了解可用项目用于分配\n3. `get_people` — 了解联系人用于链接\n\n**分类建议类型：**\n\n| 建议类型 | 说明 |\n|---------|------|\n| 转换为任务 | 如果包含动作项 |\n| 链接到人员 | 如果提及某人 |\n| 链接到项目 | 如果与某项目相关 |\n| 添加标签 | 基于内容建议相关标签 |\n\n**自动模式：**\n\n当 `$ARGUMENTS` 包含 `\"auto\"` 时，自动使用最佳猜测执行处理，无需询问确认。\n\n资料来源：[skills/inbox-triage/SKILL.md:1-45]()\n\n## 逾期追踪\n\n### overdue 技能\n\n`overdue` 技能用于识别和追踪所有逾期及即将逾期的项目。\n\n**功能：**\n\n- 列出所有逾期任务\n- 识别滑向逾期的项目\n- 提供优先级建议\n- 生成逾期报告\n\n资料来源：[README.md:56]()\n\n## 数据流向\n\n### 完整工作流架构\n\n```mermaid\ngraph LR\n    subgraph 输入层\n        A[用户请求] --> B[MCP 工具调用]\n    end\n    \n    subgraph 处理层\n        B --> C[get_planning_context]\n        B --> D[get_client_workspace]\n        B --> E[get_project_workspace]\n        B --> F[get_recent_notes]\n    end\n    \n    subgraph 分析层\n        C --> G[数据聚合]\n        D --> G\n        E --> G\n        F --> G\n    end\n    \n    subgraph 变异层\n        G --> H[apply_planning_patch]\n        H --> I[create_issue]\n        H --> J[update_issue]\n        H --> K[assign_issue_to_current_cycle]\n        H --> L[create_client_note]\n    end\n    \n    subgraph 输出层\n        I --> M[LifeOS 更新]\n        J --> M\n        K --> M\n        L --> M\n        G --> N[报告生成]\n    end\n```\n\n## MCP 工具清单\n\n项目与客户管理相关的核心 MCP 工具：\n\n| 工具名称 | 功能 | 适用场景 |\n|---------|------|---------|\n| `get_client_success_workspace` | 获取客户成功工作区 | 客户请求分类 |\n| `get_beeper_thread_messages` | 获取 Beeper 聊天记录 | 客户沟通详情 |\n| `get_fathom_meeting` | 获取 Fathom 会议 | 会议详情 |\n| `get_fathom_transcript` | 获取 Fathom 转录 | 会议记录 |\n| `get_granola_meeting` | 获取 Granola 会议 | 会议详情 |\n| `get_granola_transcript` | 获取 Granola 转录 | 会议记录 |\n| `get_client_notes` | 获取客户笔记 | 历史记录查看 |\n| `create_client_note` | 创建客户笔记 | 记忆保存 |\n| `update_client_note` | 更新客户笔记 | 记忆维护 |\n| `get_planning_context` | 获取规划上下文 | 冲刺/周/日计划 |\n| `apply_planning_patch` | 应用规划变更 | 变异操作 |\n| `get_recent_notes` | 获取最近笔记 | 收件箱分类 |\n| `get_projects` | 获取项目列表 | 任务分配 |\n| `get_people` | 获取联系人列表 | 人员关联 |\n\n## 最佳实践\n\n### 客户管理\n\n1. **定期客户简报**：使用 `client-brief` 定期了解客户全景\n2. **健康监控**：通过 `client-health` 追踪客户整体状况\n3. **主动分类**：使用 `customer-success-triage` 及时处理客户请求\n\n### 项目执行\n\n1. **冲刺对齐**：确保项目任务与当前冲刺目标一致\n2. **避免过载**：设置合理的冲刺容量\n3. **优先级管理**：使用 `set_top_priority` 明确即时焦点\n\n### 任务处理\n\n1. **及时收件箱清空**：使用 `inbox-triage` 将想法转化为行动\n2. **逾期追踪**：定期检查 `overdue` 任务\n3. **避免重复**：优先更新现有任务而非创建新任务\n\n## 配置要求\n\n### MCP 服务器配置\n\n```json\n{\n  \"mcpServers\": {\n    \"lifeos\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@starascendin/lifeos-mcp@latest\",\n        \"--url\", \"YOUR_CONVEX_URL\",\n        \"--user-id\", \"YOUR_USER_ID\",\n        \"--api-key\", \"YOUR_API_KEY\"\n      ]\n    }\n  }\n}\n```\n\n### 环境变量\n\n| 变量名 | 说明 |\n|-------|------|\n| `LIFEOS_CONVEX_URL` | Convex 应用地址 |\n| `LIFEOS_USER_ID` | 用户 ID |\n| `LIFEOS_API_KEY` | API 密钥 |\n\n资料来源：[README.md:25-45]()\n\n---\n\n<a id='page-voice-notes-workflows'></a>\n\n## 语音笔记工作流\n\n### 相关页面\n\n相关主题：[日常管理工作流](#page-daily-workflows)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [skills/voice-notes/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/voice-notes/SKILL.md)\n- [skills/voice-notes-crystallize/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/voice-notes-crystallize/SKILL.md)\n- [skills/daily-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-plan/SKILL.md)\n- [skills/weekly-plan/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/weekly-plan/SKILL.md)\n- [skills/daily-training-report/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-training-report/SKILL.md)\n</details>\n\n# 语音笔记工作流\n\n## 概述\n\n语音笔记工作流是 LifeOS Plugin 中用于探索、分析和保存语音备忘录的综合功能模块。该工作流通过 MCP（Model Context Protocol）工具与 LifeOS 后端交互，支持用户以对话方式回顾、整理和提炼语音记录中的洞察。\n\n语音笔记工作流的核心价值在于将分散的语音记录转化为可执行的知识资产，通过 AI 驱动的分析帮助用户发现语音笔记中的模式、关联和行动项。\n\n---\n\n## 架构设计\n\n### 组件关系\n\n```mermaid\ngraph TD\n    A[用户] -->|语音指令| B[voice-notes 技能]\n    B -->|探索请求| C[MCP 工具集]\n    C --> D[get_voice_memo_labels]\n    C --> E[get_recent_notes]\n    C --> F[get_voice_memos_by_labels]\n    C --> G[get_voice_memos_by_date]\n    C --> H[get_voice_memo]\n    C --> I[search_notes]\n    \n    A -->|结晶保存| I[voice-notes-crystallize 技能]\n    I -->|创建摘要| J[create_ai_convo_summary]\n    \n    K[其他规划技能] -.->|集成| C\n    K -->|include.voiceMemos| B\n```\n\n语音笔记工作流与日常规划、每周计划等技能深度集成，在获取规划上下文时可通过 `include.voiceMemos=true` 参数一并拉取相关语音备忘录。资料来源：[skills/daily-plan/SKILL.md:3-8]()\n\n### MCP 工具矩阵\n\n| 工具名称 | 功能描述 | 返回数据类型 |\n|---------|---------|-------------|\n| `get_voice_memo_labels` | 获取所有语音备忘录的标签/主题 | 标签列表 |\n| `get_recent_notes` | 获取最近 N 条语音记录 | 摘要数组 |\n| `get_voice_memos_by_date` | 按日期范围查询语音记录 | 时间序列数据 |\n| `get_voice_memos_by_labels` | 按标签筛选语音记录 | 分类数据 |\n| `get_voice_memo` | 获取单条语音备忘录的完整信息 | 详细对象（含 AI 提取） |\n| `search_notes` | 全文搜索语音笔记内容 | 搜索结果集 |\n| `create_ai_convo_summary` | 创建 AI 对话结晶摘要 | 摘要 ID |\n\n---\n\n## 工作流程详解\n\n### 探索阶段\n\n语音笔记探索采用渐进式发现模式，从概览到细节逐层深入。资料来源：[skills/voice-notes/SKILL.md:1-30]()\n\n#### 步骤一：了解资源池\n\n系统首先调用 `get_voice_memo_labels` 获取所有可用的主题标签，同时调用 `get_recent_notes` 显示最近 10 条记录。这种双重查询让用户对语音笔记库有初步认知：\n\n```mermaid\ngraph LR\n    A[开始] --> B[获取标签云]\n    B --> C[获取最近笔记]\n    C --> D{用户意图}\n    D -->|查看最近| E[展示时间线]\n    D -->|探索主题| F[按标签聚合]\n    D -->|回溯时段| G[日期范围查询]\n    D -->|深度分析| H[单条笔记详览]\n```\n\n#### 步骤二：多维度探索\n\n根据用户意图，系统提供四种主要探索路径：\n\n**按时间回顾**\n\n调用 `get_voice_memos_by_date`，传入 `startDate` 和 `endDate` 参数。系统将呈现时间线上的主题模式、情感波动和关键要点。资料来源：[skills/voice-notes/SKILL.md:18-20]()\n\n**按主题探索**\n\n调用 `get_voice_memos_by_labels` 筛选特定标签下的所有语音记录。这有助于用户追踪特定项目、会议或生活领域的持续思考。资料来源：[skills/voice-notes/SKILL.md:15-17]()\n\n**全文检索**\n\n当用户有明确搜索目标时，调用 `search_notes` 执行语义或关键词搜索。资料来源：[skills/voice-notes/SKILL.md:21-22]()\n\n**深度分析**\n\n对于单条重要备忘录，调用 `get_voice_memo` 获取包含 AI 提取信息的完整详情。资料来源：[skills/voice-notes/SKILL.md:23-25]()\n\n---\n\n### 对话交互阶段\n\n在探索过程中，技能扮演主动思考伙伴的角色：\n\n- **识别模式**：跨备忘录发现反复出现的主题或矛盾点\n- **连接关联**：将不同时间、不同主题的笔记建立逻辑关联\n- **激活行动项**：挖掘被遗忘但仍有价值的待办事项\n- **协助规划**：帮助用户基于笔记内容制定或调整计划\n\n资料来源：[skills/voice-notes/SKILL.md:26-33]()\n\n---\n\n### 结晶保存阶段\n\n当对话产生有价值的结果时，用户可选择结晶保存。资料来源：[skills/voice-notes-crystallize/SKILL.md:1-50]()\n\n#### 摘要类型分类\n\n系统支持六种摘要类型，用于不同场景：\n\n| 类型 | 适用场景 | 内容特征 |\n|-----|---------|---------|\n| `reflection` | 回顾过往经历或情感 | 感受加工、事件复盘 |\n| `planning` | 制定策略或计划 | 目标分解、行动路径 |\n| `brainstorm` | 创意发散场景 | 想法碰撞、多角度探索 |\n| `journal_review` | 日记/日志回顾 | 时间线梳理、成长轨迹 |\n| `idea_refinement` | 已有想法深化 | 细节打磨、可行性分析 |\n\n#### 结晶数据结构\n\n创建结晶摘要时，系统提取以下核心元素：\n\n```json\n{\n  \"title\": \"生成的描述性标题\",\n  \"summary\": \"2-4 段落的主要洞察和结论\",\n  \"keyInsights\": [\"3-7 条核心领悟\"],\n  \"actionItems\": [\"任务或行动项\"],\n  \"ideas\": [\"新想法或新方向\"],\n  \"tags\": [\"3-5 个分类标签\"],\n  \"summaryType\": \"摘要类型\",\n  \"conversationContext\": \"对话上下文\"\n}\n```\n\n保存成功后返回摘要 ID，用户可通过 `get_ai_convo_summaries` 回顾历史结晶。资料来源：[skills/voice-notes-crystallize/SKILL.md:24-31]()\n\n---\n\n## 与其他技能的集成\n\n### 规划上下文集成\n\n语音笔记可作为规划决策的参考依据。以下技能在获取规划上下文时支持语音备忘录集成：资料来源：[skills/daily-plan/SKILL.md:5-7]()\n\n```mermaid\ngraph TD\n    A[规划技能] -->|include.voiceMemos: true| B[get_planning_context]\n    B --> C[返回语音备忘录数据]\n    C --> D[辅助决策]\n    \n    A -->|daily-plan| E[日计划]\n    A -->|weekly-plan| F[周计划]\n    A -->|sprint-plan| G[冲刺计划]\n```\n\n### 每日训练报告集成\n\n在生成每日训练报告时，系统整合语音笔记中的相关洞察作为参考上下文，帮助用户将语音记录中的健康、训练相关想法纳入日常复盘。资料来源：[skills/daily-training-report/SKILL.md:1-25]()\n\n---\n\n## 使用场景示例\n\n### 场景一：周回顾反思\n\n用户希望回顾过去一周的语音日记：\n1. 调用 `get_voice_memos_by_date`，设置起止日期\n2. 系统展示本周主题和情感趋势\n3. 用户选择特定日期深入查看\n4. 调用 `get_voice_memo` 获取完整 AI 提取内容\n5. 对话式分析后，调用 `voice-notes-crystallize` 保存周回顾\n\n### 场景二：项目追踪\n\n用户想查看某个项目的所有语音讨论：\n1. 调用 `get_voice_memo_labels` 确认项目标签\n2. 调用 `get_voice_memos_by_labels` 筛选项目相关记录\n3. 系统聚合所有相关录音和转录\n4. 帮助用户提取项目决策和下一步行动\n\n---\n\n## 最佳实践\n\n| 建议 | 说明 |\n|-----|-----|\n| 定期结晶 | 对话结束后及时保存有价值的内容，避免洞察流失 |\n| 标签管理 | 录音时添加清晰标签，便于后续按主题探索 |\n| 结合规划 | 在日/周计划时利用语音笔记作为上下文参考 |\n| 行动项追踪 | 从语音笔记中提取的任务应同步到任务管理系统 |\n\n---\n\n## 技术要点\n\n语音笔记工作流依赖以下底层能力：\n\n1. **AI 提取**：每条语音备忘录都经过 AI 处理，提取关键信息、情感标签和行动项\n2. **语义搜索**：支持基于意义的搜索，而非简单的关键词匹配\n3. **上下文关联**：能够将语音笔记与其他 LifeOS 数据（任务、健康、财务等）建立关联\n4. **结晶持久化**：结晶摘要作为 AI 对话总结存储，可跨会话回顾\n\n这些能力共同构成了一个从录制到分析再到知识沉淀的完整闭环。\n\n---\n\n<a id='page-health-integration'></a>\n\n## 健康数据集成 (Oura Ring)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [skills/health-check/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-check/SKILL.md)\n- [skills/health-weekly/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-weekly/SKILL.md)\n- [skills/daily-training-report/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-training-report/SKILL.md)\n- [AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n- [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n</details>\n\n# 健康数据集成 (Oura Ring)\n\n## 概述\n\n健康数据集成是 LifeOS Plugin 提供的核心功能模块之一，通过 MCP（Model Context Protocol）工具与 Oura Ring 智能戒指设备进行深度集成。该模块能够采集用户的睡眠、活动、准备度、压力、心率等多项生理指标，并将其与任务管理、日程规划和习惯追踪等生产力功能无缝结合。\n\nLifeOS 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)\n\n## 数据架构\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                     Oura Ring 设备                          │\n└─────────────────────────┬───────────────────────────────────┘\n                          │ 生理数据同步\n                          ▼\n┌─────────────────────────────────────────────────────────────┐\n│                     Convex 后端平台                          │\n│  ┌─────────┐ ┌──────────┐ ┌──────────┐ ┌─────────────────┐  │\n│  │  睡眠   │ │   活动   │ │  准备度  │ │   心率/压力    │  │\n│  │ Sleep   │ │ Activity │ │ Readiness│ │ HR/Stress/SpO2 │  │\n│  └────┬────┘ └────┬─────┘ └────┬─────┘ └────────┬────────┘  │\n│       └──────────┴────────────┴───────────────┘            │\n│                          │                                  │\n└──────────────────────────┼──────────────────────────────────┘\n                           │ MCP 工具调用\n                           ▼\n┌─────────────────────────────────────────────────────────────┐\n│              LifeOS Plugin Skills 层                         │\n│  ┌──────────────┐ ┌──────────────┐ ┌──────────────────────┐  │\n│  │ health-check│ │health-weekly │ │daily-training-report │  │\n│  └──────────────┘ └──────────────┘ └──────────────────────┘  │\n└─────────────────────────────────────────────────────────────┘\n```\n\n## 核心 MCP 工具清单\n\n### 健康数据获取工具\n\n| 工具名称 | 功能描述 | 数据范围 |\n|---------|---------|---------|\n| `get_health_sleep` | 获取睡眠数据 | 分数、时长、入睡时间、呼吸率、不安周期 |\n| `get_health_activity` | 获取活动数据 | 活动分数、步数、卡路里燃烧 |\n| `get_health_readiness` | 获取准备度数据 | 准备度分数、压力与恢复平衡、体温趋势 |\n| `get_health_stress` | 获取压力与恢复数据 | 压力水平、恢复状态 |\n| `get_health_heart_rate` | 获取心率趋势 | 静息心率、HRV 趋势 |\n| `get_health_workouts` | 获取锻炼历史 | 锻炼类型、时间、强度（优先使用 label 而非 activity） |\n| `get_health_resilience` | 获取恢复力水平 | 日级别恢复力趋势、贡献因素分解（睡眠恢复、日间恢复、压力） |\n| `get_health_vo2_max` | 获取最大摄氧量 | VO2max 估算值（ml/kg/min） |\n| `get_health_cardio_age` | 获取心血管年龄 | 心血管年龄趋势 |\n| `get_health_spo2` | 获取血氧数据 | SpO2 数值、呼吸障碍指数 |\n\n资料来源：[skills/health-weekly/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-weekly/SKILL.md)\n\n## 主要技能模块\n\n### 1. 快速健康检查 (health-check)\n\n快速健康检查模块提供即时的健康数据概览，适合日常快速了解身体状态。\n\n**数据采集范围：**\n\n- 7 天睡眠数据：分数、总睡眠时长趋势、入睡时间一致性、平均呼吸率\n- 7 天活动数据：活动分数、每日步数、活动卡路里\n- 7 天准备度数据：准备度分数、趋势方向（改善/下降/稳定）\n- 7 天心率数据：静息心率趋势、HRV 数据\n- 7 天恢复力数据：当前恢复力级别及趋势\n- 7 天 VO2max 和心血管年龄数据\n\n**输出格式：**\n\n```\n- 整体状态：快速评估（优秀/良好/需要关注）\n- 睡眠：平均分数、总睡眠时长趋势、入睡时间一致性...\n- 活动：平均分数、每日步数、活动卡路里\n- 准备度：平均分数、趋势方向\n- 心率：静息 HR 趋势、HRV\n- 恢复力：当前级别和趋势\n- 健身：VO2max 趋势、心血管年龄与实际年龄对比\n- 洞察：2-3 条基于数据的可操作建议\n```\n\n资料来源：[skills/health-check/SKILL.md:1-37](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-check/SKILL.md)\n\n**参数说明：**\n\n| 参数 | 类型 | 说明 |\n|-----|------|-----|\n| `$ARGUMENTS` | 数字（可选） | 指定回顾天数，默认为 7 天 |\n\n### 2. 每周健康回顾 (health-weekly)\n\n每周健康回顾模块提供更全面的健康数据分析，适用于周末复盘和趋势识别。\n\n**数据采集范围：**\n\n所有数据默认采集 14 天记录，以获得更准确的趋势分析。\n\n| 数据类型 | 采集天数 | 包含指标 |\n|---------|---------|---------|\n| 睡眠 | 14 天 | 分数、时长、入睡时间、呼吸率、深睡/REM 平衡、不安周期 |\n| 活动 | 14 天 | 步数、活动日与休息日对比、卡路里燃烧 |\n| 准备度 | 14 天 | 分数趋势、压力与恢复平衡、体温趋势 |\n| 压力 | 14 天 | 压力与恢复数据 |\n| 锻炼 | 14 天 | 锻炼历史（优先使用 label 显示名称） |\n| 心率 | 14 天 | 心率趋势 |\n| 恢复力 | 14 天 | 日级别恢复力、贡献因素（睡眠恢复、日间恢复、压力） |\n| VO2max | 14 天 | 最大摄氧量估算值（ml/kg/min） |\n| 心血管年龄 | 14 天 | 心血管年龄趋势 |\n| 血氧 | 14 天 | SpO2 数值、呼吸障碍指数 |\n\n**输出结构：**\n\n- **睡眠质量**：周平均分数、最佳/最差夜晚、睡眠时长趋势、深睡/REM 平衡、入睡时间一致性、平均呼吸率\n- **活动模式**：周步数平均、主动日与休息日对比、卡路里燃烧\n- **准备度与恢复**：分数趋势、压力与恢复平衡、体温趋势\n- **恢复力**：日级别趋势（限于 exceptional 级别）、贡献因素分解\n- **健身指标**：VO2max 趋势（ml/kg/min）、心血管年龄趋势、周对比变化\n- **锻炼记录**：锻炼类型、时长、强度\n\n资料来源：[skills/health-weekly/SKILL.md:1-50](https://github.com/starascendin/lifeos-plugin/blob/main/skills/health-weekly/SKILL.md)\n\n### 3. 每日训练报告 (daily-training-report)\n\n每日训练报告将健康数据与习惯追踪、任务管理和教练反馈整合，提供全面的个人训练日报。\n\n**数据采集清单：**\n\n1. 昨日习惯：`get_habits_for_date`（昨日日期）\n2. 今日习惯：`get_habits_for_date`（今日日期）\n3. 所有习惯：`get_habits`（连续记录概览）\n4. 睡眠：`get_health_sleep`（days=1）\n5. 准备度：`get_health_readiness`（days=1）\n6. 活动：`get_health_activity`（days=1）\n7. 今日日程：`get_daily_agenda`\n8. 今日任务：`get_todays_tasks`\n9. 年度目标：`get_initiatives`\n10. 教练待办：`get_coaching_action_items`\n\n**报告输出结构：**\n\n```\n**昨日成果**\n- 习惯记分卡：X/Y 完成（列出每项习惯及状态）\n- 连续记录保持或中断（明确指出中断的连续记录）\n- 健康数据：睡眠分数、准备度分数、活动分数\n- 日评分：基于习惯完成率和健康数据\n\n**今日计划**\n- Top 3 优先级（来自日程和置顶任务）\n- 今日习惯安排（含连续计数）\n- 健康建议\n```\n\n资料来源：[skills/daily-training-report/SKILL.md:1-40](https://github.com/starascendin/lifeos-plugin/blob/main/skills/daily-training-report/SKILL.md)\n\n## 数据流向图\n\n```mermaid\ngraph LR\n    A[Oura Ring] -->|实时同步| B[Convex 后端]\n    B -->|数据存储| C[健康数据表]\n    C -->|MCP 工具| D[health-check]\n    C -->|MCP 工具| E[health-weekly]\n    C -->|MCP 工具| F[daily-training-report]\n    D -->|输出| G[快速概览]\n    E -->|输出| H[详细周报]\n    F -->|输出| I[训练日报]\n    G -->|整合| J[用户决策]\n    H -->|整合| J\n    I -->|整合| J\n```\n\n## 健康指标参考表\n\n| 指标名称 | 单位 | 正常范围参考 | 数据来源 |\n|---------|------|-------------|---------|\n| 睡眠分数 | 分 | 80-100 优秀, 60-80 良好, <60 需改善 | Oura Ring |\n| 准备度分数 | 分 | 80-100 优秀, 60-80 良好, <60 需注意 | Oura Ring |\n| 活动分数 | 分 | 动态目标 | Oura Ring |\n| 静息心率 | bpm | 50-70 成人正常范围 | Oura Ring |\n| HRV | ms | 20-100 正常范围（因人而异） | Oura Ring |\n| VO2max | ml/kg/min | 35-50 成年男性, 25-40 成年女性 | Oura Ring 估算 |\n| SpO2 | % | 95-100 正常 | Oura Ring |\n| 心血管年龄 | 岁 | 与实际年龄对比 | Oura Ring 估算 |\n\n## 使用场景\n\n### 场景一：晨间快速检视\n\n用户在早晨启动工作前，希望快速了解昨夜睡眠质量和今日身体准备状态。\n\n```\n调用：/health-check\n默认回溯：7 天\n输出：简洁的健康仪表板，包含关键指标和洞察\n```\n\n### 场景二：周末健康复盘\n\n用户在周末进行深度健康回顾，分析两周内的趋势变化。\n\n```\n调用：/health-weekly\n回溯天数：14 天\n输出：详细的周健康报告，包含趋势分析和改进建议\n```\n\n### 场景三：训练日报整合\n\n运动员或健身爱好者将健康数据与当日任务、习惯追踪整合。\n\n```\n调用：/daily-training-report\n整合数据：睡眠、准备度、活动 + 习惯 + 日程 + 教练反馈\n输出：全面的个人训练日报\n```\n\n## 配置要求\n\n健康数据集成需要以下环境配置：\n\n| 环境变量 | 说明 | 示例 |\n|---------|------|-----|\n| `LIFEOS_CONVEX_URL` | Convex 部署地址 | `https://your-app.convex.site` |\n| `LIFEOS_USER_ID` | 用户标识 | `your-user-id` |\n| `LIFEOS_API_KEY` | API 密钥 | `your-api-key` |\n\n资料来源：[README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n\n## 与其他模块的集成\n\n健康数据不仅是独立的健康监测功能，还与 LifeOS 的其他核心功能深度集成：\n\n```mermaid\ngraph TD\n    A[健康数据 Oura] --> B[习惯系统]\n    A --> C[任务系统]\n    A --> D[教练系统]\n    A --> E[日程系统]\n    A --> F[PPV 人生设计]\n    B --> G[每日训练报告]\n    C --> G\n    D --> G\n    E --> G\n```\n\n### 集成点说明\n\n| 集成模块 | 集成方式 | 说明 |\n|---------|---------|------|\n| 习惯系统 | `get_habits`, `get_habits_for_date` | 将健康指标与习惯完成度关联分析 |\n| 任务系统 | `get_todays_tasks`, `get_daily_agenda` | 基于健康状态调整当日任务优先级 |\n| 教练系统 | `get_coaching_action_items` | 将健康洞察转化为教练行动项 |\n| 日程系统 | `get_daily_agenda` | 根据准备度分数优化日程安排 |\n| PPV 人生设计 | `get_initiatives` | 将长期健康目标与年度倡议关联 |\n\n## 最佳实践\n\n1. **定期回顾**：建议每周运行一次 `/health-weekly`，识别健康趋势\n2. **数据驱动决策**：根据准备度分数调整高强度任务的安排\n3. **习惯关联**：将健康指标与习惯系统结合，形成完整的自我管理系统\n4. **教练整合**：将健康数据洞察转化为可执行的教练行动项\n5. **连续记录监控**：关注连续记录状态，避免因中断影响长期数据准确性\n\n## 技术限制\n\n- 健康数据回溯天数受 MCP 工具参数限制，默认最大为 14 天\n- VO2max 和心血管年龄为估算值，仅供参考\n- 恢复力数据级别显示限于 `exceptional` 级别\n- 锻炼记录优先使用 `label` 而非 `activity` 字段作为显示名称\n\n---\n\n<a id='page-finance-management'></a>\n\n## 财务管理\n\n### 相关页面\n\n相关主题：[健康数据集成 (Oura Ring)](#page-health-integration)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [skills/finance-overview/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/finance-overview/SKILL.md)\n- [skills/finance-spending/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/finance-spending/SKILL.md)\n- [README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n- [AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n</details>\n\n# 财务管理\n\n## 概述\n\n财务管理（Financial Management）是LifeOS插件的核心功能模块之一，为用户提供全面的个人财务可视化和分析能力。该模块通过与Convex后端集成，实时获取用户的财务数据，包括净资产概览、账户余额、交易记录和支出模式分析。\n\n财务管理模块的核心价值在于将分散的财务数据聚合为可操作的洞察，帮助用户了解财务状况、追踪消费习惯、监控净资产趋势。\n\n资料来源：[README.md]()\n\n## 技能清单\n\n| 技能名称 | 用途 |\n|---------|------|\n| `finance-overview` | 净资产摘要、账户余额、净值趋势 |\n| `finance-spending` | 支出分析、消费模式、近期交易 |\n\n资料来源：[README.md](), [AGENTS.md]()\n\n## 架构设计\n\n### 数据流架构\n\n```mermaid\ngraph TD\n    A[用户请求] --> B[Skill 技能层]\n    B --> C{技能类型}\n    C -->|概览| D[finance-overview]\n    C -->|支出| E[finance-spending]\n    D --> F[get_finance_net_worth]\n    D --> G[get_finance_accounts]\n    D --> H[get_finance_snapshots]\n    E --> I[get_finance_daily_spending]\n    E --> J[get_finance_transactions]\n    F --> K[Convex 后端]\n    G --> K\n    H --> K\n    I --> K\n    J --> K\n    K --> L[数据聚合处理]\n    L --> M[美元转换]\n    M --> N[可视化报告]\n```\n\n### MCP工具集成\n\n财务管理的底层由126个MCP工具支撑，其中专门用于财务数据访问的工具包括：\n\n| 工具名称 | 功能描述 |\n|---------|---------|\n| `get_finance_net_worth` | 获取当前净资产和账户分类 |\n| `get_finance_accounts` | 获取所有账户详情 |\n| `get_finance_snapshots` | 获取净资产历史快照 |\n| `get_finance_daily_spending` | 获取每日支出聚合数据 |\n| `get_finance_transactions` | 获取交易记录明细 |\n\n资料来源：[AGENTS.md]()\n\n## finance-overview 技能详解\n\n### 功能描述\n\n`finance-overview` 技能提供完整的财务概览视图，整合净资产、资产配置和负债信息，以仪表盘形式呈现给用户。\n\n### 核心流程\n\n1. 调用 `get_finance_net_worth` 获取当前净资产及账户分类\n2. 调用 `get_finance_accounts` 获取所有账户详细信息\n3. 调用 `get_finance_snapshots` 获取90天净值历史趋势\n4. 聚合数据并转换为美元格式\n5. 生成可视化财务仪表盘\n\n资料来源：[skills/finance-overview/SKILL.md]()\n\n### 输出内容\n\n| 模块 | 描述 |\n|-----|------|\n| **Net Worth** | 当前净资产总额及周期变化 |\n| **Assets** | 资产总计，按账户类型分类（活期存款、储蓄、投资、退休账户） |\n| **Liabilities** | 负债总计，按类型分类（信用卡、贷款） |\n| **Trend** | 过去90天净资产走向（增长/下降/稳定） |\n| **Accounts** | 账户清单，包含名称、类型、当前余额 |\n| **Insights** | 显著变化或规律分析 |\n\n### 数据转换规则\n\n所有从后端获取的金额数据均以**美分为单位**存储，技能层负责将其转换为美元格式并以货币形式展示。\n\n```python\n# 伪代码示例\namount_in_cents = 12345\namount_in_dollars = amount_in_cents / 100\nformatted = f\"${amount_in_dollars:,.2f}\"  # $123.45\n```\n\n资料来源：[skills/finance-overview/SKILL.md]()\n\n### 可选参数\n\n| 参数 | 说明 | 默认值 |\n|-----|------|-------|\n| `$ARGUMENTS` 中的数字 | 覆盖趋势数据天数 | 90天 |\n\n## finance-spending 技能详解\n\n### 功能描述\n\n`finance-spending` 技能专注于消费行为分析，帮助用户识别消费模式、高消费日和异常支出。\n\n### 核心流程\n\n1. 调用 `get_finance_daily_spending` 获取最近30天的每日收入/支出聚合数据\n2. 调用 `get_finance_transactions` 获取最近50笔交易详情\n3. 分析消费模式并识别规律\n4. 生成支出分析报告\n\n资料来源：[skills/finance-spending/SKILL.md]()\n\n### 输出内容\n\n| 模块 | 描述 |\n|-----|------|\n| **Summary** | 周期内总收入、总支出、净收入 |\n| **Daily Average** | 日均支出金额 |\n| **Spending Pattern** | 高消费日识别、消费规律分析 |\n| **Recent Transactions** | 最近交易的显著条目 |\n| **Insights** | 消费趋势、异常活动、改进建议 |\n\n### 可选参数\n\n| 参数 | 说明 | 默认值 |\n|-----|------|-------|\n| `$ARGUMENTS` 中的数字 | 指定分析天数 | 30天 |\n\n## MCP 工具详细规格\n\n### get_finance_net_worth\n\n获取用户的净资产数据，包括资产和负债的分类汇总。\n\n**调用方式：**\n```json\n{\n  \"name\": \"get_finance_net_worth\",\n  \"arguments\": {}\n}\n```\n\n**返回值结构：**\n```json\n{\n  \"totalNetWorth\": 123456789,\n  \"totalAssets\": 150000000,\n  \"totalLiabilities\": 26543211,\n  \"breakdown\": {\n    \"assets\": [...],\n    \"liabilities\": [...]\n  }\n}\n```\n\n> 注意：所有金额以**美分**为单位存储\n\n### get_finance_accounts\n\n获取用户所有关联的金融账户信息。\n\n**调用方式：**\n```json\n{\n  \"name\": \"get_finance_accounts\",\n  \"arguments\": {}\n}\n```\n\n**返回值结构：**\n```json\n{\n  \"accounts\": [\n    {\n      \"id\": \"acc_xxx\",\n      \"name\": \"主要支票账户\",\n      \"type\": \"checking\",\n      \"balance\": 500000\n    }\n  ]\n}\n```\n\n### get_finance_snapshots\n\n获取指定时间范围内的净资产历史快照，用于趋势分析。\n\n**调用方式：**\n```json\n{\n  \"name\": \"get_finance_snapshots\",\n  \"arguments\": {\n    \"days\": 90\n  }\n}\n```\n\n### get_finance_daily_spending\n\n获取每日支出聚合数据，用于消费模式分析。\n\n**调用方式：**\n```json\n{\n  \"name\": \"get_finance_daily_spending\",\n  \"arguments\": {\n    \"days\": 30\n  }\n}\n```\n\n### get_finance_transactions\n\n获取最近的交易记录明细。\n\n**调用方式：**\n```json\n{\n  \"name\": \"get_finance_transactions\",\n  \"arguments\": {\n    \"limit\": 50\n  }\n}\n```\n\n资料来源：[AGENTS.md]()\n\n## 使用示例\n\n### 场景一：查看财务概览\n\n```\n用户输入: /finance-overview\n```\n\n**执行流程：**\n\n```mermaid\nsequenceDiagram\n    participant U as 用户\n    participant S as Skill\n    participant M as MCP Server\n    participant C as Convex\n    \n    U->>S: /finance-overview\n    S->>M: get_finance_net_worth\n    M->>C: 查询净资产\n    C-->>M: 返回数据\n    M-->>S: net_worth 数据\n    S->>M: get_finance_accounts\n    M->>C: 查询账户\n    C-->>M: 账户列表\n    M-->>S: accounts 数据\n    S->>M: get_finance_snapshots\n    M->>C: 查询90天快照\n    C-->>M: 快照历史\n    M-->>S: snapshots 数据\n    S->>S: 数据聚合处理\n    S->>S: 美分→美元转换\n    S-->>U: 财务仪表盘\n```\n\n### 场景二：分析90天消费趋势\n\n```\n用户输入: /finance-spending 90\n```\n\n此命令将分析过去90天的支出数据，而非默认的30天。\n\n### 场景三：与其他技能联动\n\n财务管理可与 `daily-training-report` 技能联动，在每日训练报告中包含财务健康检查：\n\n```mermaid\ngraph LR\n    A[daily-training-report] --> B[财务快照]\n    B --> C{财务状态}\n    C -->|正常| D[纳入报告]\n    C -->|异常| E[预警提示]\n```\n\n资料来源：[skills/daily-training-report/SKILL.md]()\n\n## 数据存储规范\n\n### 单位约定\n\n| 数据类型 | 存储单位 | 显示单位 |\n|---------|---------|---------|\n| 金额 | 美分 (cents) | 美元 (dollars) |\n| 百分比 | 基点或小数 | 百分比 |\n\n### 转换函数\n\n```python\ndef cents_to_dollars(cents: int) -> float:\n    \"\"\"美分支转换为美元\"\"\"\n    return cents / 100\n\ndef format_currency(cents: int) -> str:\n    \"\"\"格式化为货币字符串\"\"\"\n    return f\"${cents_to_dollars(cents):,.2f}\"\n```\n\n## 最佳实践\n\n### 1. 定期查看财务概览\n\n建议用户每周运行一次 `finance-overview` 技能，以监控净资产变化趋势。\n\n### 2. 支出模式识别\n\n利用 `finance-spending` 的消费模式分析功能，识别非必要的开支。\n\n### 3. 参数优化\n\n- 需要快速概览时使用默认参数\n- 需要深度分析时可传入更长的时间范围（如90天或180天）\n\n### 4. 数据整合\n\n财务数据可与习惯追踪、健康数据整合，形成全面的个人生产力报告。\n\n## 扩展能力\n\n财务管理模块未来可能支持：\n\n- 预算设置与追踪\n- 账单提醒\n- 投资组合分析\n- 税务优化建议\n- 多币种支持\n\n---\n\n*本页面最后更新基于 lifeos-plugin 仓库当前版本。*\n\n---\n\n<a id='page-people-relationships'></a>\n\n## 人际关系管理\n\n### 相关页面\n\n相关主题：[项目与客户管理](#page-project-management)\n\n<details>\n<summary>相关源码文件</summary>\n\n以下源码文件用于生成本页说明：\n\n- [skills/contact-lookup/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/contact-lookup/SKILL.md)\n- [skills/meeting-prep/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/meeting-prep/SKILL.md)\n- [skills/follow-ups/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/follow-ups/SKILL.md)\n- [skills/relationship-pulse/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/relationship-pulse/SKILL.md)\n- [skills/context-switch/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/context-switch/SKILL.md)\n</details>\n\n# 人际关系管理\n\n## 概述\n\n人际关系管理是 LifeOS Plugin 中的核心功能模块，通过 MCP 工具与 LifeOS 系统集成，提供联系人查询、会议准备、后续跟进、关系健康监测以及快速上下文切换等能力。该模块旨在帮助用户维护和深化与客户、合作伙伴及团队成员的关系，同时确保重要互动不会被遗漏。\n\n人际关系管理功能覆盖了从初次联系到持续维护的完整关系生命周期，支持通过 AI 洞察分析沟通风格和关系状态。资料来源：[README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n\n## 核心技能体系\n\n### 技能概览\n\n| 技能名称 | 命令 | 功能描述 |\n|---------|------|----------|\n| contact-lookup | `/contact-lookup \"姓名\"` | 完整联系人档案，含 AI 洞察 |\n| meeting-prep | `/meeting-prep \"姓名\"` | 会议准备，含完整上下文和讨论要点 |\n| follow-ups | `/follow-ups` | 追踪需要回复的人及客户 |\n| relationship-pulse | `/relationship-pulse` | 检查被忽视的关系 |\n| context-switch | `/context-switch \"客户/项目\"` | 快速加载客户或项目的上下文 |\n\n资料来源：[AGENTS.md](https://github.com/starascendin/lifeos-plugin/blob/main/AGENTS.md)\n\n### 架构流程图\n\n```mermaid\ngraph TD\n    A[用户请求] --> B{请求类型}\n    B -->|联系人查询| C[contact-lookup]\n    B -->|会议准备| D[meeting-prep]\n    B -->|跟进追踪| E[follow-ups]\n    B -->|关系健康| F[relationship-pulse]\n    B -->|上下文切换| G[context-switch]\n    \n    C --> H[get_contact_dossier]\n    D --> I[get_planning_context]\n    E --> J[数据聚合]\n    F --> K[关系分析]\n    G --> L[快速加载]\n    \n    H --> M[展示联系人档案]\n    I --> N[展示会议上下文]\n    J --> O[待跟进列表]\n    K --> P[关系状态报告]\n    L --> Q[上下文摘要]\n```\n\n## 联系人档案查询\n\n### 功能说明\n\n`contact-lookup` 技能提供完整的联系人档案查询能力，支持通过姓名进行模糊搜索，返回联系人的全面信息包括个人资料、AI 生成的性格洞察、沟通风格建议以及历史互动记录。\n\n资料来源：[skills/contact-lookup/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/contact-lookup/SKILL.md)\n\n### 工作流程\n\n```mermaid\ngraph LR\n    A[输入: 联系人姓名] --> B[get_contact_dossier]\n    B --> C[返回档案数据]\n    C --> D{数据结构}\n    D -->|人员信息| E[Profile 档案]\n    D -->|AI洞察| F[AI Insights]\n    D -->|消息| G[Beeper Threads]\n    D -->|会议| H[Granola Meetings]\n    D -->|语音| I[Voice Memos]\n    E --> J[格式化展示]\n    F --> J\n    G --> J\n    H --> J\n    I --> J\n```\n\n### 档案展示结构\n\n| 模块 | 内容说明 |\n|------|----------|\n| Profile | 姓名、关系类型、联系方式、个人笔记 |\n| AI Insights | 沟通风格、性格特征、关系维护建议 |\n| Recent Interactions | 按时间排序的语音、会议、消息记录 |\n| Meeting History | Granola 会议及关键要点 |\n| Chat Threads | Beeper 对话线程链接 |\n\n### 使用要求\n\n- 参数：`$ARGUMENTS` 必须包含联系人姓名\n- 工具调用：`get_contact_dossier` with `nameQuery`\n- 无姓名时系统会提示用户输入\n\n## 会议准备\n\n### 功能说明\n\n`meeting-prep` 技能帮助用户在进行会议前全面了解与会者的背景信息，聚合相关项目进展、历史沟通、开放任务等上下文，支持用户带着充分的准备进入会议。\n\n资料来源：[skills/meeting-prep/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/meeting-prep/SKILL.md)\n\n### 准备内容\n\n| 类别 | 内容 |\n|------|------|\n| 联系人档案 | 对方的基本信息和 AI 洞察 |\n| 项目上下文 | 相关项目的当前状态和进展 |\n| 历史沟通 | Beeper 消息和 Granola 会议记录 |\n| 开放任务 | 与对方相关的待处理任务 |\n| 讨论要点 | 基于上下文生成的建议话题 |\n\n### MCP 工具依赖\n\n```mermaid\ngraph TD\n    A[meeting-prep] --> B[get_contact_dossier]\n    A --> C[get_client_success_workspace]\n    A --> D[get_beeper_thread_messages]\n    A --> E[get_granola_meeting]\n    A --> F[get_fathom_meeting]\n    A --> G[get_client_notes]\n    \n    B --> H[基本信息]\n    C --> I[项目与任务]\n    D --> J[聊天记录]\n    E --> K[会议记录]\n    F --> L[Fathom 录制]\n    G --> M[历史笔记]\n```\n\n## 跟进追踪\n\n### 功能说明\n\n`follow-ups` 技能主动识别需要与用户进行后续互动的联系人，确保重要关系不会被忽视。该功能会扫描系统中的互动记录和任务状态，生成需要跟进的人员清单。\n\n资料来源：[skills/follow-ups/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/follow-ups/SKILL.md)\n\n### 追踪范围\n\n| 类型 | 说明 |\n|------|------|\n| 待回复消息 | 对方发送但尚未回复的消息 |\n| 会议后续 | 约定但未完成的后续行动 |\n| 承诺事项 | 承诺但尚未兑现的承诺 |\n| 过期跟进 | 超过预设时间的未跟进记录 |\n\n## 关系健康监测\n\n### 功能说明\n\n`relationship-pulse` 技能通过分析互动频率、响应时间和关系紧密度等指标，识别可能被用户忽视的关系，帮助用户主动维护重要的人际网络。\n\n资料来源：[skills/relationship-pulse/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/relationship-pulse/SKILL.md)\n\n### 健康指标\n\n| 指标 | 定义 | 阈值说明 |\n|------|------|----------|\n| 互动频率 | 单位时间内与联系人的互动次数 | 低于设定值为警示 |\n| 最后互动 | 上次联系距今的时间 | 超过30天为警示 |\n| 响应率 | 消息回复比例 | 低于60%为警示 |\n| 承诺兑现率 | 承诺事项完成比例 | 低于80%为警示 |\n\n## 快速上下文切换\n\n### 功能说明\n\n`context-switch` 技能支持用户在不同客户或项目之间快速切换，加载目标对象的相关信息，减少上下文切换带来的认知负担，提升多任务处理效率。\n\n资料来源：[skills/context-switch/SKILL.md](https://github.com/starascendin/lifeos-plugin/blob/main/skills/context-switch/SKILL.md)\n\n### 上下文内容\n\n| 内容模块 | 说明 |\n|----------|------|\n| 项目状态 | 当前项目的阶段、里程碑、障碍 |\n| 相关任务 | 与该上下文关联的开放任务 |\n| 最近更新 | 最近的活动记录和变更 |\n| 关键人员 | 项目或客户相关的联系人 |\n| 重要文档 | 相关的笔记和文件 |\n\n### 使用场景\n\n```mermaid\ngraph TD\n    A[当前上下文] --> B[调用 context-switch]\n    B --> C[输入: 客户/项目名称]\n    C --> D[加载目标上下文]\n    D --> E[展示快速摘要]\n    E --> F[开始新工作]\n    \n    G[定期切换] --> H[保持全局视野]\n    G --> I[避免信息孤岛]\n```\n\n## MCP 工具集\n\n### 联系人相关工具\n\n| 工具名称 | 功能 | 主要参数 |\n|----------|------|----------|\n| `get_contact_dossier` | 获取完整联系人档案 | `nameQuery` |\n| `get_person_graph` | 获取人物关系图 | `personId` |\n| `get_beeper_thread_messages` | 获取聊天消息 | `threadId` |\n| `get_granola_meeting` | 获取 Granola 会议 | `meetingId` |\n| `get_fathom_meeting` | 获取 Fathom 会议 | `meetingId` |\n\n### 数据模型\n\n```mermaid\nerDiagram\n    CONTACT ||--o{ INTERACTION : has\n    CONTACT ||--o{ PROJECT : related_to\n    CONTACT {\n        string id PK\n        string name\n        string relationshipType\n        string email\n        string phone\n        string notes\n        json aiInsights\n    }\n    INTERACTION {\n        string id PK\n        string contactId FK\n        string type \"message|meeting|voice\"\n        datetime timestamp\n        string summary\n    }\n```\n\n## 最佳实践\n\n### 1. 定期关系维护\n\n- 每周运行一次 `relationship-pulse` 检查被忽视的关系\n- 使用 `follow-ups` 作为每周回顾的一部分\n- 为重要联系人设置定期跟进提醒\n\n### 2. 会议准备流程\n\n- 会议前使用 `meeting-prep` 获取完整上下文\n- 查看对方的 AI 洞察了解沟通偏好\n- 回顾历史互动记录避免重复话题\n\n### 3. 上下文管理\n\n- 在多项目环境中频繁使用 `context-switch`\n- 切换后快速确认上下文正确性\n- 完成项目后主动切换回全局视图\n\n### 4. 联系人数据维护\n\n- 通过 `contact-lookup` 定期审查联系人档案\n- 更新过时信息保持数据准确性\n- 利用 AI Insights 改善沟通方式\n\n## 配置与集成\n\n### MCP 服务配置\n\n```json\n{\n  \"mcpServers\": {\n    \"lifeos\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@starascendin/lifeos-mcp@latest\",\n        \"--url\", \"YOUR_CONVEX_URL\",\n        \"--user-id\", \"YOUR_USER_ID\",\n        \"--api-key\", \"YOUR_API_KEY\"\n      ]\n    }\n  }\n}\n```\n\n### 环境变量配置\n\n| 变量名 | 说明 | 必需 |\n|--------|------|------|\n| `LIFEOS_CONVEX_URL` | Convex 部署地址 | 是 |\n| `LIFEOS_USER_ID` | 用户标识 | 是 |\n| `LIFEOS_API_KEY` | API 认证密钥 | 是 |\n\n资料来源：[README.md](https://github.com/starascendin/lifeos-plugin/blob/main/README.md)\n\n## 相关技能索引\n\n| 类别 | 技能 | 关联关系 |\n|------|------|----------|\n| 日常流程 | daily-standup | 包含人员互动摘要 |\n| 客户管理 | client-brief | 整合联系人数据 |\n| 客户管理 | client-health | 关系健康指标 |\n| 客户管理 | customer-success-triage | 依赖联系人档案 |\n| 项目管理 | project-status | 包含项目人员信息 |\n\n## 总结\n\n人际关系管理模块构成了 LifeOS Plugin 中维护人际网络的完整解决方案。通过 `contact-lookup`、`meeting-prep`、`follow-ups`、`relationship-pulse` 和 `context-switch` 五个核心技能的协同工作，用户可以实现从联系人信息管理到关系健康监测的全面覆盖。该模块深度集成了 Beeper 消息、Granola 会议、Fathom 录制和语音备忘录等多个数据源，结合 AI 生成的洞察分析，帮助用户建立更有效的人际沟通策略。\n\n---\n\n---\n\n## Doramagic 踩坑日志\n\n项目：starascendin/lifeos-plugin\n\n摘要：发现 8 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：配置坑 - 可能修改宿主 AI 配置。\n\n## 1. 配置坑 · 可能修改宿主 AI 配置\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。\n- 对用户的影响：安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。\n- 建议检查：列出会写入的配置文件、目录和卸载/回滚步骤。\n- 防护动作：涉及宿主配置目录时必须给回滚路径，不能只给安装命令。\n- 证据：capability.host_targets | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | host_targets=mcp_host, claude, claude_code\n\n## 2. 能力坑 · 能力判断依赖假设\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：README/documentation is current enough for a first validation pass.\n- 对用户的影响：假设不成立时，用户拿不到承诺的能力。\n- 建议检查：将假设转成下游验证清单。\n- 防护动作：假设必须转成验证项；没有验证结果前不能写成事实。\n- 证据：capability.assumptions | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | README/documentation is current enough for a first validation pass.\n\n## 3. 维护坑 · 维护活跃度未知\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：未记录 last_activity_observed。\n- 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。\n- 建议检查：补 GitHub 最近 commit、release、issue/PR 响应信号。\n- 防护动作：维护活跃度未知时，推荐强度不能标为高信任。\n- 证据：evidence.maintainer_signals | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | last_activity_observed missing\n\n## 4. 安全/权限坑 · 下游验证发现风险项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：下游已经要求复核，不能在页面中弱化。\n- 建议检查：进入安全/权限治理复核队列。\n- 防护动作：下游风险存在时必须保持 review/recommendation 降级。\n- 证据：downstream_validation.risk_items | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | no_demo; severity=medium\n\n## 5. 安全/权限坑 · 存在安全注意事项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：No sandbox install has been executed yet; downstream must verify before user use.\n- 对用户的影响：用户安装前需要知道权限边界和敏感操作。\n- 建议检查：转成明确权限清单和安全审查提示。\n- 防护动作：安全注意事项必须面向用户前置展示。\n- 证据：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.\n\n## 6. 安全/权限坑 · 存在评分风险\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：风险会影响是否适合普通用户安装。\n- 建议检查：把风险写入边界卡，并确认是否需要人工复核。\n- 防护动作：评分风险必须进入边界卡，不能只作为内部分数。\n- 证据：risks.scoring_risks | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | no_demo; severity=medium\n\n## 7. 维护坑 · issue/PR 响应质量未知\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：issue_or_pr_quality=unknown。\n- 对用户的影响：用户无法判断遇到问题后是否有人维护。\n- 建议检查：抽样最近 issue/PR，判断是否长期无人处理。\n- 防护动作：issue/PR 响应未知时，必须提示维护风险。\n- 证据：evidence.maintainer_signals | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | issue_or_pr_quality=unknown\n\n## 8. 维护坑 · 发布节奏不明确\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：release_recency=unknown。\n- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。\n- 建议检查：确认最近 release/tag 和 README 安装命令是否一致。\n- 防护动作：发布节奏未知或过期时，安装说明必须标注可能漂移。\n- 证据：evidence.maintainer_signals | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | release_recency=unknown\n\n<!-- canonical_name: starascendin/lifeos-plugin; human_manual_source: deepwiki_human_wiki -->\n",
      "summary": "DeepWiki/Human Wiki 完整输出，末尾追加 Discovery Agent 踩坑日志。",
      "title": "Human Manual / 人类版说明书"
    },
    "pitfall_log": {
      "asset_id": "pitfall_log",
      "filename": "PITFALL_LOG.md",
      "markdown": "# Pitfall Log / 踩坑日志\n\n项目：starascendin/lifeos-plugin\n\n摘要：发现 8 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：配置坑 - 可能修改宿主 AI 配置。\n\n## 1. 配置坑 · 可能修改宿主 AI 配置\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。\n- 对用户的影响：安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。\n- 建议检查：列出会写入的配置文件、目录和卸载/回滚步骤。\n- 防护动作：涉及宿主配置目录时必须给回滚路径，不能只给安装命令。\n- 证据：capability.host_targets | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | host_targets=mcp_host, claude, claude_code\n\n## 2. 能力坑 · 能力判断依赖假设\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：README/documentation is current enough for a first validation pass.\n- 对用户的影响：假设不成立时，用户拿不到承诺的能力。\n- 建议检查：将假设转成下游验证清单。\n- 防护动作：假设必须转成验证项；没有验证结果前不能写成事实。\n- 证据：capability.assumptions | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | README/documentation is current enough for a first validation pass.\n\n## 3. 维护坑 · 维护活跃度未知\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：未记录 last_activity_observed。\n- 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。\n- 建议检查：补 GitHub 最近 commit、release、issue/PR 响应信号。\n- 防护动作：维护活跃度未知时，推荐强度不能标为高信任。\n- 证据：evidence.maintainer_signals | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | last_activity_observed missing\n\n## 4. 安全/权限坑 · 下游验证发现风险项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：下游已经要求复核，不能在页面中弱化。\n- 建议检查：进入安全/权限治理复核队列。\n- 防护动作：下游风险存在时必须保持 review/recommendation 降级。\n- 证据：downstream_validation.risk_items | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | no_demo; severity=medium\n\n## 5. 安全/权限坑 · 存在安全注意事项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：No sandbox install has been executed yet; downstream must verify before user use.\n- 对用户的影响：用户安装前需要知道权限边界和敏感操作。\n- 建议检查：转成明确权限清单和安全审查提示。\n- 防护动作：安全注意事项必须面向用户前置展示。\n- 证据：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.\n\n## 6. 安全/权限坑 · 存在评分风险\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：风险会影响是否适合普通用户安装。\n- 建议检查：把风险写入边界卡，并确认是否需要人工复核。\n- 防护动作：评分风险必须进入边界卡，不能只作为内部分数。\n- 证据：risks.scoring_risks | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | no_demo; severity=medium\n\n## 7. 维护坑 · issue/PR 响应质量未知\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：issue_or_pr_quality=unknown。\n- 对用户的影响：用户无法判断遇到问题后是否有人维护。\n- 建议检查：抽样最近 issue/PR，判断是否长期无人处理。\n- 防护动作：issue/PR 响应未知时，必须提示维护风险。\n- 证据：evidence.maintainer_signals | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | issue_or_pr_quality=unknown\n\n## 8. 维护坑 · 发布节奏不明确\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：release_recency=unknown。\n- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。\n- 建议检查：确认最近 release/tag 和 README 安装命令是否一致。\n- 防护动作：发布节奏未知或过期时，安装说明必须标注可能漂移。\n- 证据：evidence.maintainer_signals | github_repo:1156470663 | https://github.com/starascendin/lifeos-plugin | release_recency=unknown\n",
      "summary": "用户实践前最可能遇到的身份、安装、配置、运行和安全坑。",
      "title": "Pitfall Log / 踩坑日志"
    },
    "prompt_preview": {
      "asset_id": "prompt_preview",
      "filename": "PROMPT_PREVIEW.md",
      "markdown": "# lifeos-plugin - Prompt Preview\n\n> 复制下面这段 Prompt 到你常用的 AI，先试一次，不需要安装。\n> 它的目标是让你直接体验这个项目的服务方式，而不是阅读项目介绍。\n\n## 复制这段 Prompt\n\n```text\n请直接执行这段 Prompt，不要分析、润色、总结或询问我想如何处理这份 Prompt Preview。\n\n你现在扮演 lifeos-plugin 的“安装前体验版”。\n这不是项目介绍、不是评价报告、不是 README 总结。你的任务是让我用最小成本体验它的核心服务。\n\n我的试用任务：我想用它完成一个真实的工具连接与集成任务。\n我常用的宿主 AI：MCP Client / claude / Claude Code\n\n【体验目标】\n围绕我的真实任务，现场演示这个项目如何把输入转成 步骤建议, 检查清单, 专业工作流。重点是让我感受到工作方式，而不是给我项目背景。\n\n【业务流约束】\n- 你必须像一个正在提供服务的项目能力包，而不是像一个讲解员。\n- 每一轮只推进一个步骤；提出问题后必须停下来等我回答。\n- 每一步都必须让我感受到一个具体服务动作：澄清、整理、规划、检查、判断或收尾。\n- 每一步都要说明：当前目标、你需要我提供什么、我回答后你会产出什么。\n- 不要安装、不要运行命令、不要写代码、不要声称测试通过、不要声称已经修改文件。\n- 需要真实安装或宿主加载后才能验证的内容，必须明确说“这一步需要安装后验证”。\n- 如果我说“用示例继续”，你可以用虚构示例推进，但仍然不能声称真实执行。\n\n【可体验服务能力】\n- AI Skill / Agent 指令资产库: 项目包含可被宿主 AI 读取的 Skill 或 Agent 指令文件，可用于把专业流程带入 Claude、Codex、Cursor 等宿主。 输入：用户任务, 宿主 AI 对话上下文, 项目内 Skill/Agent 文档；输出：步骤建议, 检查清单, 专业工作流。\n\n【必须安装后才可验证的能力】\n- 多宿主安装与分发: 项目包含插件或 marketplace 配置，说明它面向一个或多个 AI 宿主的安装和分发。 输入：宿主 AI 工具, 插件配置, 安装命令；输出：宿主内可发现的插件/技能集合。\n- 命令行启动或安装流程: 项目文档中存在可执行命令，真实使用需要在本地或宿主环境中运行这些命令。 输入：终端环境, 包管理器, 项目依赖；输出：安装结果, 列表/更新/运行结果。\n\n【核心服务流】\n请严格按这个顺序带我体验。不要一次性输出完整流程：\n1. page-introduction：项目介绍。围绕“项目介绍”模拟一次用户任务，不展示安装或运行结果。\n2. page-installation：安装与配置。围绕“安装与配置”模拟一次用户任务，不展示安装或运行结果。\n3. page-mcp-server：MCP 服务器架构。围绕“MCP 服务器架构”模拟一次用户任务，不展示安装或运行结果。\n4. page-daily-workflows：日常管理工作流。围绕“日常管理工作流”模拟一次用户任务，不展示安装或运行结果。\n5. page-review-workflows：复盘与规划工作流。围绕“复盘与规划工作流”模拟一次用户任务，不展示安装或运行结果。\n\n【核心能力体验剧本】\n每一步都必须按“输入 -> 服务动作 -> 中间产物”执行。不要只说流程名：\n1. page-introduction\n输入：用户提供的“项目介绍”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n2. page-installation\n输入：用户提供的“安装与配置”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n3. page-mcp-server\n输入：用户提供的“MCP 服务器架构”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n4. page-daily-workflows\n输入：用户提供的“日常管理工作流”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n5. page-review-workflows\n输入：用户提供的“复盘与规划工作流”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n【项目服务规则】\n这些规则决定你如何服务用户。不要解释规则本身，而要在每一步执行时遵守：\n- 先确认用户任务、输入材料和成功标准，再模拟项目能力。\n- 每一步都必须形成可检查的小产物，并等待用户确认后再继续。\n- 凡是需要安装、调用工具或访问外部服务的能力，都必须标记为安装后验证。\n\n【每一步的服务约束】\n- Step 1 / page-introduction：Step 1 必须围绕“项目介绍”形成一个小中间产物，并等待用户确认。\n- Step 2 / page-installation：Step 2 必须围绕“安装与配置”形成一个小中间产物，并等待用户确认。\n- Step 3 / page-mcp-server：Step 3 必须围绕“MCP 服务器架构”形成一个小中间产物，并等待用户确认。\n- Step 4 / page-daily-workflows：Step 4 必须围绕“日常管理工作流”形成一个小中间产物，并等待用户确认。\n- Step 5 / page-review-workflows：Step 5 必须围绕“复盘与规划工作流”形成一个小中间产物，并等待用户确认。\n\n【边界与风险】\n- 不要声称已经安装、运行、调用 API、读写本地文件或完成真实任务。\n- 安装前预览只能展示工作方式，不能证明兼容性、性能或输出质量。\n- 涉及安装、插件加载、工具调用或外部服务的能力必须安装后验证。\n\n【可追溯依据】\n这些路径只用于你内部校验或在我追问“依据是什么”时简要引用。不要在首次回复主动展开：\n- https://github.com/starascendin/lifeos-plugin\n- https://github.com/starascendin/lifeos-plugin#readme\n- skills/blind-spot-finder/SKILL.md\n- skills/capture/SKILL.md\n- skills/client-brief/SKILL.md\n- skills/client-health/SKILL.md\n- skills/coach-memory/SKILL.md\n- skills/coaching-action-items/SKILL.md\n- skills/coaching-overview/SKILL.md\n- skills/coaching-session-review/SKILL.md\n- skills/contact-lookup/SKILL.md\n- skills/context-switch/SKILL.md\n\n【首次问题规则】\n- 首次三问必须先确认用户目标、成功标准和边界，不要提前进入工具、安装或实现细节。\n- 如果后续需要技术条件、文件路径或运行环境，必须等用户确认目标后再追问。\n\n首次回复必须只输出下面 4 个部分：\n1. 体验开始：用 1 句话说明你将带我体验 lifeos-plugin 的核心服务。\n2. 当前步骤：明确进入 Step 1，并说明这一步要解决什么。\n3. 你会如何服务我：说明你会先改变我完成任务的哪个动作。\n4. 只问我 3 个问题，然后停下等待回答。\n\n首次回复禁止输出：后续完整流程、证据清单、安装命令、项目评价、营销文案、已经安装或运行的说法。\n\nStep 1 / brainstorming 的二轮协议：\n- 我回答首次三问后，你仍然停留在 Step 1 / brainstorming，不要进入 Step 2。\n- 第二次回复必须产出 6 个部分：澄清后的任务定义、成功标准、边界条件、\n  2-3 个可选方案、每个方案的权衡、推荐方案。\n- 第二次回复最后必须问我是否确认推荐方案；只有我明确确认后，才能进入下一步。\n- 第二次回复禁止输出 git worktree、代码计划、测试文件、命令或真实执行结果。\n\n后续对话规则：\n- 我回答后，你先完成当前步骤的中间产物并等待确认；只有我确认后，才能进入下一步。\n- 每一步都要生成一个小的中间产物，例如澄清后的目标、计划草案、测试意图、验证清单或继续/停止判断。\n- 所有演示都写成“我会建议/我会引导/这一步会形成”，不要写成已经真实执行。\n- 不要声称已经测试通过、文件已修改、命令已运行或结果已产生。\n- 如果某个能力必须安装后验证，请直接说“这一步需要安装后验证”。\n- 如果证据不足，请明确说“证据不足”，不要补事实。\n```\n",
      "summary": "不安装项目也能感受能力节奏的安全试用 Prompt。",
      "title": "Prompt Preview / 安装前试用 Prompt"
    },
    "quick_start": {
      "asset_id": "quick_start",
      "filename": "QUICK_START.md",
      "markdown": "# Quick Start / 官方入口\n\n项目：starascendin/lifeos-plugin\n\n## 官方安装入口\n\n### Node.js / npm · 官方安装入口\n\n```bash\nnpm install -g @starascendin/lifeos-mcp\n```\n\n来源：https://github.com/starascendin/lifeos-plugin#readme\n\n## 来源\n\n- repo: https://github.com/starascendin/lifeos-plugin\n- docs: https://github.com/starascendin/lifeos-plugin#readme\n",
      "summary": "从项目官方 README 或安装文档提取的开工入口。",
      "title": "Quick Start / 官方入口"
    }
  },
  "validation_id": "dval_2b869867bfa14bf0a0a6e55815a364d2"
}