Community研究与数据分析github.com

ejklock/research-artifacts

将研究结果整理、格式化并索引为符合OKF规范的知识包——带有日期、来源且仅可追加的记录,记录决策背后的外部证据(技术评估、库比较、行业实践调研)。

research-artifacts 是什么?

该技能“Research Artifacts”定义了一种将研究结果组织、格式化和索引的标准化方法,使其成为符合OKF(开放知识格式)规范的知识包。它特别适用于记录技术评估、库比较和行业实践调研等场景,确保每条研究记录都包含日期、来源,并以仅可追加的方式存储,从而提供决策外部证据的“快照”。该技能与`deep-research`(负责证据采集与交叉验证)和`living-docs`(维护最终决策和问题记录)协同工作。其核心价值在于通过强制使用主要来源、标注供应商利益冲突、区分推断与事实、设定置信水平等方式,强制建立严格的源纪律,并构建从研究到决策再到问题的完整可追溯链条。用户通过`living-docs guide`命令,根据具体任务加载相应的详细规则和模板,如`research-report`、`research-index`或`rules`。该技能本身是一个轻量级路由,不内联规则,所有详细指导都通过主题进行渐进式披露。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ejklock/living-docs-skill/tree/HEAD/skills/research-artifacts

Installed? Explore more 研究与数据分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

研究制品

研究记录决策背后的外部证据:技术评估、库比较、行业实践调研。研究是带有日期、来源且仅可追加的——它是某个时间点上证据所呈现内容的快照,而非动态演变的观点。

本技能定义了研究如何被组织、格式化和索引。deep-research技能定义了如何采集和交叉验证研究;living-docs拥有它所驱动的决策和问题记录。三者相互组合。研究制品是OKF概念——请参见okf-knowledge-format技能以了解此处使用的前置元数据/保留文件规则。


使用此技能(渐进式披露)

本SKILL.md是一个精简存根——一个触发器加上一个任务到主题的路由器。living-docsCLI包含完整的研究规则、源纪律、结构和可追溯链,并以渐进方式披露它们。在撰写任何内容之前,请为你的任务加载主题:

  • living-docs guide --list —— 发现每个主题。
  • living-docs guide <topic> --skill research-artifacts —— 加载该主题。

管道输出默认是缩小的JSON(机器默认);使用--plain获取人类可读文本,使用--json强制输出JSON。主题包括:rules, structure, research-report, research-index, research-general-references, about。

此存根是一个纯路由器(ADR 0017):仅触发并指向主题——它不内联任何规则。源纪律以及研究→决策→问题链都是主题,在开始撰写前通过guide rules --skill research-artifacts / guide structure --skill research-artifacts加载。


何时调用

  • 将研究会话的输出记录到docs/research/ —— living-docs guide research-report --skill research-artifacts。
  • 结构化或索引研究笔记(docs/research/NNNN-<slug>.md + 索引列表 + 通用汇总)—— 获取模板使用living-docs guide research-index --skill research-artifacts / guide research-general-references --skill research-artifacts,获取布局规则使用guide structure --skill research-artifacts。
  • 对草稿强制执行源纪律(主要来源、供应商利益冲突标记、推断与事实标签、置信水平、抓取失败注释)—— living-docs guide rules --skill research-artifacts。
  • 构建研究→决策→问题可追溯链(一个被接受的推荐必须到达ADR,然后到达living-docs中的问题)—— living-docs guide structure --skill research-artifacts。

相关技能