研究制品
研究记录决策背后的外部证据:技术评估、库比较、行业实践调研。研究是带有日期、来源且仅可追加的——它是某个时间点上证据所呈现内容的快照,而非动态演变的观点。
本技能定义了研究如何被组织、格式化和索引。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。