SuperAPI AI 工具集

case-research

写作与研究

查看项目

更新于 10-19 16:17

技能介绍

用途

case-research 是商业案例写作流程中的研究技能。它面向“决策点”收集证据:把公开来源(年报、SEC 文件、新闻稿、监管文件、媒体报道)与私人访谈转录稿结合,整理成结构化证据包,供后续案例写作技能 case-business-case 直接消费。

主要能力

  • 决策点界定:优先使用作者已有的决策陈述;若决策不清晰,会检查已有材料并检索少量相关来源,提出候选决策及其证据与缺口,待作者选定后再展开完整研究。
  • 来源规划:需要公众反应时检索同期媒体;material facts 可能变化时,检查最后一个来源与决策时点之间的变化。随后列出相关公开来源类别与转录稿清单。
  • 来源摄入:公开来源放入 case-<slug>/research/sources/public/<source-id>/,转录稿放入 case-<slug>/research/sources/private/<interview-id>/。使用私人材料前检查 permission_status,pending 状态的材料不使用。
  • 完整证据包(六个文件,位于 case-<slug>/research/):timeline.md(时间线,含 Mermaid 时间轴与 Markdown 表格)、cast.md(人物角色、动机、关系,含 Mermaid 图)、financials.md(提取并归一化的财务表格与数字,附来源)、quotes-by-theme.md(按主题标记的逐字引语,含说话人、来源、页码)、exhibit-candidates.md(建议的图表及源数据与草稿)、extraction-log.md(提取了什么、来自哪里、缺口、OCR 问题、难以辨认页面)。
  • 精简模式:作者不需要六文件包时,在获得私人材料使用许可后,可产出 research/manual-evidence-brief.md,包含确认的决策、精确来源路径与页码或章节、备选方案论据与缺口。
  • 核实标记:对来自二手来源、未经佐证的重要主张标 [VERIFY],由作者确认后才能被下游使用。
  • 就绪门槛:依据 internal/intake.yaml 与配置中的 teaching_tension、contrast_set,应用相关门槛检查;记录开篇张力与叙述实际可溯源的论据。
  • 状态更新:在 internal/state.json 追加历史记录(含产物与 [VERIFY] 数量);通过门槛时设置 stage 与 next_skill 为 case-business-case;未通过或仍有阻塞时标记 partial 或 blocked。
  • 阅读格式:每个 Markdown 文件生成同名 HTML 与 PDF 副本并列出路径。
  • 披露:按案例文件夹约定,在 internal/disclosure.md 追加本次输入、输出、AI 与人工贡献、已做检查与待检查项。

使用方式

输入包括:作者的决策点陈述或探索主题与范围、公开来源清单(URL 或 PDF)、访谈转录稿或录音、当前的 internal/state.json 与 internal/intake.yaml。开始时读取状态文件并检查阻塞项;若有阻塞,记录 blocked 历史后停止。研究流程依次为:决策点与范围、来源规划、来源摄入、证据包生成、核实标记、就绪门槛检查、状态更新、阅读格式生成、披露记录。技能完成时按 pipeline-flow 说明下一技能并尝试在同一轮运行 next_skill。

适用场景

案例需要决策点证据;作者已有访谈转录稿或希望收集公开来源;已有证据包需要刷新;作者已有可信文档,只需要可溯源的最小证据简报用于叙述起草。

限制

不撰写案例叙述或教学笔记分析;不为读者翻译引语,证据包保留来源语言原文;来源缺失数字时标 [MISSING],不编造;缺失声音记为 [MISSING] 与缺口,不用已发表教学案例、后续访谈或人物素描重建引语;保留原始来源,匿名化交由 case-disguise 处理;不编辑其他技能输出或共享全局文件;不以 HTML 或 PDF 作为来源编辑,需从 Markdown 重新生成;不应把探索性候选决策当作已定结论;公开与私人来源需分别打 [PUBLIC]/[PRIVATE] 标签;不应把所有主张都标 [VERIFY];不应在就绪门槛未通过时移交叙述写作。