mcpField
P
person-dossier

person-dossier

github.com/joelhooks生产力6535 次安装1 天前更新
代码仓库

关于 person-dossier

Person Dossier 是用于根据授权来源创建或更新人物关系档案的工作流技能,适合需要整理邮件、会议和互动脉络的研究与规划任务。它要求标注证据来源,并区分已核实与推断内容。

主要功能

  1. 01汇总邮件与会议记录
  2. 02整理主题、项目和交易
  3. 03维护互动时间线与待办
  4. 04标注来源及信息可信度

适用场景

  1. 01为策略讨论准备人物背景
  2. 02跟进关系或机会事项
  3. 03更新人物档案中的互动与待办

MCP 相关

该技能要求通过 MCP 参数进行私密查询,并遵循受范围约束的原始证据访问凭证规则。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/joelhooks/joelclaw --skill person-dossier

安装后在 Claude Code 中输入/person-dossier确认已加载。

附带文件agents/openai.yamlassets/small-logo.svg

详细介绍

人物档案

在请求进行关系研究时,创建或更新人物档案。偶然提及某人不代表请求创建人物档案。仅使用相关且经过授权的来源。

触发条件

相关请求包括:

  • 策略或规划讨论
  • 后续决策
  • 关系背景问题
  • 商机/交易/房产讨论

输出路径

  • Vault/Resources/<Person Name> - Dossier.md

必需章节

  1. 所有邮件线程
  2. 讨论的关键主题
  3. 提及的项目
  4. 提及的房产或交易
  5. 互动时间线
  6. 未结事项的当前状态

工作流

1. 验证运行时和身份验证
secrets status
secrets lease front_api_token --ttl 15m

如果密钥服务不可用:

secrets serve &
2. 解析标识符

收集:

  • 主要姓名
  • 已知邮箱
  • 别名/用户名

将这些信息用作所有来源的查询输入。

3. 提取 Front 线程(主要来源)
joelclaw email inbox -q "<person name>" -n 200
joelclaw email inbox -q "from:<email-or-handle>" -n 200

读取每个匹配的对话:

joelclaw email read --id <cnv_id>
4. 提取 Granola 会议

列出合适时间范围内的会议:

granola meetings --range this_week
granola meetings --range this_month

对于每个候选会议 ID:

使用 recall 和当前的 session-search 合约。将私密查询保留在结构化 MCP 参数中。原始证据需要范围绑定的 evidenceDrilldownReceipt;缺少投影并不代表可以访问原始数据。

5. 提取基于 Brain 的回忆上下文

使用 recall 和当前的 session-search 合约。将私密查询保留在结构化 MCP 参数中。原始证据需要范围绑定的 evidenceDrilldownReceipt;缺少投影并不代表可以访问原始数据。

6. 提取事件时间线背景
joelclaw events --hours 720 --count 200
joelclaw events --prefix meeting --hours 720 --count 200
7. 规范化提取的数据

根据证据填充以下类别:

  • 邮件线程:主题、对话 ID、参与者、最近活动日期
  • 主题:反复讨论的主题
  • 项目:具名计划
  • 房产/交易:资产、商机、交易
  • 时间线:按渠道记录的带日期互动条目
  • 未结事项:负责人、状态、截止日期、下一步
8. 创建或更新人物档案 Markdown

如果文件不存在:根据模板创建。

如果文件存在:原位更新。

更新规则:

  • 追加新的时间线条目,不删除旧条目
  • 按稳定键去重(channel + source_id + date + summary)
  • 合并未结事项的状态更新,而不是创建重复条目
  • 为每项重要声明保留 Verified 和 Inferred 标签
  • 刷新 Last Updated 时间戳
9. 记录证据和置信度

每个章节都必须标明来源:

  • Verified from Front thread
  • Verified from Granola meeting
  • Inferred from Brain-backed recall/event context

绝不可将推断内容表述为已验证内容。

10. 阻塞情况处理

如果遇到阻塞:

  1. 记录确切的技术错误文本
  2. 尝试使用经授权的事件元数据或限定范围的回忆;不得绕过转录内容访问要求
  3. 生成注明明确缺项的受阻档案
  4. 包含下次运行所需的确切命令

不得静默生成不完整内容。

人物档案模板

# <Person Name> - Dossier

## Identity
- Name: <name>
- Emails: <email1>, <email2>
- Aliases: <alias1>, <alias2>
- Last Updated: YYYY-MM-DD

## 1. All Email Threads with <Person Name>
- Thread: <subject>
  - Conversation ID: <cnv_id>
  - Last activity: YYYY-MM-DD
  - Evidence: Verified from Front thread

## 2. Key Topics Discussed
- <topic> (Verified/Inferred)

## 3. Projects Mentioned
- <project> (Verified/Inferred)

## 4. Properties or Deals Referenced
- <item> (Verified/Inferred)

## 5. Timeline of Interactions
- YYYY-MM-DD | <channel> | <summary> | <source_id>

## 6. Current Status of Open Items
- Item: <description>
  - Owner: system owner | other person | unknown
  - Status: open | blocked | closed
  - Next step: <text>
  - Due: YYYY-MM-DD | unknown
  - Evidence: <source>

## Evidence Index
- Front conversation IDs: <list>
- Granola meeting IDs: <list>
- Memory queries: <list>
- Event windows: <list>

## Blockers
- <none or error text>

快速构建命令集

使用 recall 和当前的 session-search 合约。将私密查询保留在结构化 MCP 参数中。原始证据需要范围绑定的 evidenceDrilldownReceipt;缺少投影并不代表可以访问原始数据。

质量标准

  • 不得捏造事实
  • 未结事项必须始终包含负责人
  • 尽可能在时间线中使用具体日期
  • 明确区分已验证内容和推断内容

评论

支持 Markdown