Person Research（人物生平深度研究）

对历史人物或现代人物产出一份结构化、可核验、史实与轶事/伪作严格分离的深度研究文档。核心原则：史实板块必须依据权威史料，逐条标注出处与来源等级；轶事、名言、传闻类内容强制标注真伪属性，避免读者混淆传说与真实历史。

> 按量付费：本 skill 内置 billing/ 模块，支持把「人物生平深度研究」包装成一个按次计费的服务端点（支付宝 AI 付 Machine Pay / aipay）。未付费调用返回 402 + Payment-Needed，付费后携带 Payment-Proof 即可取得资源并触发履约回执。详见文末「按量付费 / API 调用付费」章节与 billing/README.md。

目的

对历史人物或现代人物产出一份结构化、可核验、史实与轶事/伪作严格分离的深度研究文档。核心原则：史实板块必须依据权威史料，逐条标注出处与来源等级；轶事、名言、传闻类内容强制标注真伪属性，避免读者混淆传说与真实历史。

工作流程

1. 确认研究对象与口径：确认人物姓名、生卒范围（在世人物截至当前时间）、产出方案（方案 A 完整版 / 方案 B 轻量化版，见下文）。用户未指定时默认方案 A。
2. 史料调研：优先以时间线串联。严格按"信源分级"取信，一手优先；年表、关系图每个条目必须同时给出来源等级 [A/B/C/待考] 与具体出处（如《明史·卷XX》《孙中山全集·卷X》），仅标等级不标出处视为不合格。交叉验证，孤证存疑。
   - 分人物类型的检索引导（务必执行，防遗漏支线事件）：
   • 当代公众人物 / 企业家 / 艺人 / 网红：除"生平和主业时间线"外，必须额外专项检索以下类别并纳入相应板块——①标志性公开冲突 / 论战 / 公开决裂（如与同行、媒体、意见领袖的互撕，相关对象进"人物关系·政敌与冲突对象"）；②维权 / 消费者事件 / 产品质量风波；③法律纠纷 / 诉讼 / 监管处罚 / 税务举报；④重大舆论翻车 / 争议言论。这类事件有海量报道，属可核验史实，应进年表（关键事件）＋争议板块（甲），不得遗漏。
   • 历史人物：重点检索"生卒之争、死因之谜、事件真伪之辩、身后评价分歧"，并核查正史本传与出土 / 档案材料。
   • 文人或思想家：重点检索"核心观念形成节点、立场转变、著作系年、后世思想流变"。
3. 纪年与年龄换算：年表以"公元"为主列，年号 / 干支列于次列并核对换算；跨农历 / 公历的年末年初事件注明所属历法；年龄口径全表一致并注明依据。
4. 按板块撰写：依"输出结构"逐板块撰写。详细产出格式（表格列定义、ASCII 曲线、基本信息卡、名言语录等模板）见 references/output-templates.md，撰写前先读取该文件。
5. 核验与收尾（含成稿自检闭环，硬性）：先按"全局总规则 7 成稿自检闭环"逐项核对，再检查每条史实是否带来源等级 + 具体出处、轶事与名言是否带强制提示与真伪标签、关键事件是否加粗、纪年换算是否一致。最后附"史料来源与参考书目"。自检不过关不得交付。

全局总规则（适用于所有板块，优先级高于板块细则）

1. 史实与轶事分离：年表、速记曲线、人物关系、时代背景、思想脉络、成就与影响、争议与悬案等板块，必须以权威史料为依据，禁止民间传说、野史、网络传言、私自想象混入。传闻/伪作不进年表与史实板块，集中到"轶事或演义""名言与语录"并明确标注。
2. 信源分级（四级）与逐条溯源：
   - 一级 [A]：正史、档案、出土文献、本人一手文献（文集、书信、日记、口述、碑刻）。
   - 二级 [B]：学术专著、权威论文、专业出版社著作。
   - 三级 [C]：正规出版的通俗读物、权威百科（须交叉验证）。
   - 存疑 [待考]：网络、传闻、孤证、来源不明，不得当作定论，单独标出。
   - 硬性要求：每个史实条目末尾标注 [等级] 并写明具体出处（典籍名 + 卷次 / 篇名 / 档案号）。只写"据史料记载"而不给出处，视为不合格。
3. 事实 ≠ 观点：涉及评价的内容，明确区分"事实陈述"与"个人观点"，观点不作为史实引用。
4. 叙事中立：不预先贴"好人 / 坏人"标签，兼顾成就与不足、正面与负面；客观书写其局限、错误与决策失误。
5. 原文保真：引用人物原文保留原貌，不随意改写、曲解原意；区分"原文摘录"与"后人解读"。
6. 纪年与年龄口径统一：年表"公元"为主列，年号 / 干支次之并核对；农历 / 公历跨年事件注明；年龄口径全表一致（默认周岁：事件年份 − 出生年份，生日未过按上一年计；农历人物可用虚岁但须全表一致并注明）。
7. 成稿自检闭环（防遗漏标志性事件，最高优先级收尾步骤）：成稿后必须做一次"知名事件反查"——通过检索或已知常识，列出该人物"最广为人知 / 最具标志性的 N 件公众事件、争议、公开冲突、维权事件、论战、法律纠纷"，逐条核对是否已在年表、争议（甲）、人物关系等板块体现；凡属可核验史实却遗漏的，补入年表（关键事件）＋争议（甲）或关系图后方可交付。此步骤专治"主线叙事完整但漏掉标志性支线事件"的遗漏，不可省略。

输出结构

方案 A：完整版（默认，学术向推荐）

〇、基本信息卡（速查）
一、完整年表
二、人生速记曲线
三、人物关系图
四、时代背景
五、思想脉络与关键抉择
六、成就与影响（6.1 本人成果 / 6.2 当世影响 / 6.3 后世影响 / 6.4 后人研究）
七、争议与悬案（史实层面）+ 评价史流变（价值判断层面）
八、轶事或演义（限流 + 强制标注）
九、名言与语录（真伪标注）
十、同时代参照系（含"异同与高下之争"）
十一、遗迹与文物（可选）
十二、名词注释表（可选）
十三、史料来源与参考书目（初级/进阶分级）

方案 B：轻量化版（快速人物介绍）

〇、基本信息卡
一、完整年表
二、人生速记曲线
三、人物关系图
四、时代背景
五、成就与影响 + 评价与争议（合并）
六、轶事或演义

各板块要求

〇、基本信息卡（速查，文档开篇）

一句话 + 速查表，字段：姓名 / 字号 / 谥号·庙号（如有）/ 生卒 / 朝代或时期 / 民族 / 籍贯 / 葬地 / 核心身份。便于快速定位，不展开论证。

一、完整年表

• 表格列：公元 | 年号·干支 | 年龄 | 地点 | 事件 | 出处。重大 / 关键事件加粗；每个事件标 [等级] + 具体出处（如《孙中山全集·卷一》）。
• 时间跨度：出生 → 去世（在世人物至当前时间）。存疑事件不混入正文，表后单列"存疑事件"小节标 [待考]。
• 所有时间、地点、事件均须有可靠史料，禁止传说或想象。纪年换算统一（见全局规则 6）。

二、人生速记曲线

• 缩进 + 连线的 ASCII 图示呈现人生起落（模板见 references/output-templates.md），每节点附一句话说明改变。
• 转折点筛选规则：入选须至少满足——① 改变方向（职业 / 立场 / 关系网络）；② 持久影响自我认知；③ 本人事后回顾的文字证据，三者之一。
• 节点分类标签：【机遇】【挫折】【转折点】【高峰】【低谷】。每条标来源等级 + 出处。

三、人物关系图

• 分组：家人（父母、配偶、子女）、师长与提携者、同道与友人、政敌与冲突对象。
• 每组表格列：人物 | 关系 | 生卒 | 关键节点（关联事件）| 出处。标注关系强弱（核心加粗 / 次要常规）与关系变化（如"早年为师友、后期反目"）。
• 每条标出处；推测性关系标 [待考]，不得凭推测建立连线。

四、时代背景

• 所处时代的格局与重大历史潮流（社会、政治、经济、文化大环境 + 同期重大事件），当时主流思潮、制度、社会风气，时代带来的机遇与约束。
• 作用：解释"为什么他在这个时间点做出这个选择"，避免孤立看待个人。

五、思想脉络与关键抉择

• 核心观念形成期（受谁 / 什么事件影响）；思想明显转变节点及触发因素；重大抉择面前的思考逻辑与内在矛盾；言行之间的张力。
• 来源要求：须有本人文字或可靠同时代观察支撑；推测性内容标注"推测"及依据；每条标来源等级 + 出处。

六、成就与影响

• 6.1 本人成果：著作、书籍、书信、日记、作品、思想、发明、创造、奖项。
• 6.2 当世影响 / 6.3 后世影响 / 6.4 后人研究（须注明作者、时间、立场）。
• 区分原文摘录与后人解读；所有材料真实可靠，标来源等级 + 出处。

七、争议与悬案 + 评价史流变

本板块分两部分，二者必须分清：

（甲）争议与悬案（史实层面）——集中讨论有分歧、有冲突的事实问题，与年表"禁止传闻"互补（传闻不进年表，集中在此）：
- 条目格式：争议点 | 各方观点（含依据与来源）| 主流结论。
- 历史人物常见类型：生年 / 卒年之争、死因之谜、事件真伪之辩（如某起义是否由其主导、某文是否亲笔）。
- 当代 / 公众人物必含类型：① 公开冲突 / 舆论论战 / 与他人的公开决裂（须列对立人物及时间线）；② 维权事件 / 产品质量 / 消费者风波；③ 法律纠纷 / 诉讼 / 监管处罚 / 税务或财务举报；④ 重大争议言论或翻车事件。此类事件有海量媒体报道，属可核验史实，应同时进年表（关键事件）与争议（甲），不得遗漏；各方观点须标来源等级与出处，无定论者保持开放。

（乙）评价史流变（价值判断层面）——强调评价如何随时代变化：
- 流变阶段：同时代人怎么看 → 官修史书定论（如正史本传论赞）→ 后世各时代重新评价 → 现代学界共识。
- 必须标注评价者的身份、时间、立场；不得把不同时代、不同立场的话混在一起当作"客观评价"。

八、轶事或演义

• 收录趣事，可含历史记载、后人杜撰或以讹传讹，重在趣味性与戏剧性。
• 开篇强制提示："以下内容包含非信史材料，仅供了解人物在民间叙事中的形象，不可作为史实引用。"
• 每条强制分类标注：[有历史记载] / [民间传说] / [文学演义·后人杜撰] / [以讹传讹，来源不明]。
• 数量限制：不超过总输出 10%–15%。

九、名言与语录（新增）

• 单列板块，与轶事同等需要真伪标注，且需求量大。
• 条目格式：引文 | 真伪属性 | 出处。
• 确有出处原话：注明典籍 / 著作 / 演讲出处（如《建国方略·自序》《在黄埔军校开学典礼演说》）。
• 托名伪作：明确标 [托名伪作]，说明常见伪托情形，提示不可当真。
• 引文保留原貌，不擅改；白话转述须注明"意译"。

十、同时代参照系（含异同与高下之争）

• 选取同领域、同时期、面临相似处境的 2–3 个人物，简要对比相似起点下各自选择与结果，并点明"异同与高下之争"（不同立场的评价分歧）。
• 目的：避免孤立评价，放进可比坐标理解独特性与局限性。来源等级要求同第五板块。

十一、遗迹与文物（可选）

• 表格列：类型 | 名称 | 地点 | 备注（收藏/开放情况）。含画像 / 照片、故居、墓地、纪念馆、手稿原件收藏地等。
• 出处等级多为 [C]，标注信息来源（官网 / 文博机构）。

十二、名词注释表（可选）

• 表格列：名词 | 通俗解释 | 时代背景。解释涉及的古官职、机构、地名、典章制度，降低阅读门槛。

十三、史料来源与参考书目（初级 / 进阶分级）

• 分列一手史料与二手史料；按"初级（通识入门）/ 进阶（学术专著、原始文献）"分级推荐，便于不同读者取用。
• 提示哪些可信度高、哪些存疑。

产出格式

各板块的 Markdown 模板、年表样式、ASCII 人生曲线、基本信息卡、名言语录等，严格依照 references/output-templates.md 产出（模板以"苏轼年表 / 人生曲线速记 / 人物关系表"三张参考样式图为基准，并扩展新增板块）。

交付约定

• 文件名统一为「人物名 + 研究.md」：如 苏轼研究.md、孙中山研究.md、罗永浩研究.md。不使用"人物研究""生平梳理"等冗余后缀。
• 默认输出到用户指定的工作目录；未指定时，放在当前对话的工作区目录。
• 现代 / 在世人物：原模板中"朝代 / 谥号·庙号 / 葬地"等字段替换为"时期 / 在世状态"；"名词注释""遗迹文物"等可选板块按实际保留或精简（如以"主要著作与影像"替代"遗迹文物"）。
• 每份文档结尾附"成稿说明"：标注信息截止时间、主要信源类型占比、存疑待核事项。

按量付费 / API 调用付费（支付宝 AI 付 · Machine Pay）

> Pay Skill 元信息（平台审核依据）
> - 触发词：帮我研究 XX、做一份 XX 的人物研究、整理 XX 的生平年表/人生曲线/人物关系图、person research、人物深度研究
> - 输入参数：--name(人物姓名) / --schema(方案 A 完整版 / 方案 B 轻量版) / --input(可选补充线索)；或通过上层自然语言指定研究对象与口径
> - 单次价格：¥1.00 / 次调用（页面展示参考标价 ¥2.99 为套餐说明）
> - 依赖安装：纯提示词 + 工作流驱动，无需额外 Python 依赖；付费接入依赖见下方「本地运行计费端点」
> - 调用流程：确认研究对象与口径 → 史料调研（信源分级 + 逐条溯源）→ 按 13 板块撰写 → 成稿自检闭环；付费版额外经 person_research_paid.py 走 402 协议

本 skill 可作为一个按次计费的服务端点对外提供「人物生平深度研究」能力。任何智能体（调用方）访问该端点时：

1. 未携带 Payment-Proof → 服务端返回 HTTP 402 + Payment-Needed 头（含 out_trade_no / amount / seller_signature / service_id 等账单字段）。
2. 携带 Payment-Proof → 服务端调用 alipay.aipay.agent.payment.verify 验付 → 生成资源 → 调用 alipay.aipay.agent.fulfillment.confirm 履约确认 → 返回资源 + Payment-Validation 头。

定价

• 单次 API 调用实收：¥1.00 / 次。该值写入 billing/a2m_server.py 的 amount 字段，即未付费调用时 402 响应中返回的 amount（调用方实际支付金额）。
• SkillHub 页面展示参考标价：¥2.99（套餐 / 标价说明，用于页面展示；实际按次扣费以 ¥1.00 为准）。
• 调价方式：直接改 a2m_server.py 第 184 行 amount 后重新打包发布即可。

本地运行计费端点

pip install alipay-sdk cryptography
cp billing/config.example.json billing/config.json   # 填入 app_id / 私钥 / 公钥 / seller_id / service_id
python billing/a2m_server.py --config billing/config.json --port 5000
# 自测：curl -i http://localhost:5000/a2m/person-research/resource  -> 402 + Payment-Needed

• 沙箱联调：config.json 中 gateway 保持沙箱地址、service_id 必须为 api_mock_service_id，不花真实资金。
• 生产上线：gateway 改为 https://openapi.alipay.com/gateway.do，service_id 替换为服务市场真实 serviceId，并完成商户签约（需你本人在浏览器用真实支付宝账号操作）。
• 资源（resource）默认返回「服务示例」JSON；生产环境请将 billing/a2m_server.py 的 generate_service_resource() 替换为真实调用本 skill 流水线的逻辑（即基于传入人物名，产出一份结构化研究文档并落盘为「人物名 + 研究.md」）。

> 详细契约与端到端沙箱联调步骤见 billing/README.md。

Resources

scripts/

• person_research_paid.py — Pay Skill 买家侧 402 客户端（probe / pay / complete 子命令），对接创作者部署的 billing/a2m_server.py 资源端点。

billing/（按量付费模块）

• a2m_server.py — 标准库 http.server 实现的 402 协议服务端
• order_repository.py — SQLite 订单仓储
• config.example.json — 配置模板
• README.md — 支付宝 AI 付接入与联调指南

references/

• output-templates.md — 各板块 Markdown 模板、年表样式、ASCII 人生曲线、基本信息卡、名言语录等（撰写前先读取）