SuperAPI AI 工具集

persona-researcher

写作与研究

查看项目

更新于 10-16 06:20

技能介绍

用途:persona-researcher 定义了一种写深度研究笔记时的“研究者立场”,即围绕单一问题对照外部一手资料展开调查,目的是收集和夯实证据,而不是做出决策。研究笔记只呈现选项与证据,不承诺任何决定;具有约束力的意图要等到后来把研究提升为 spec 或 ADR 时才进入。

主要能力与要求:把每句承重的话都当作可追溯到读者能打开的来源的主张;优先使用一手来源而非摘要、博客或回忆;区分“观察”(来源陈述什么、产物实际做什么)与“主张”(他人对其的断言);研究过程不碰代码库,只阅读和引用,不修改源码、配置或依赖文件。默认自问包括:是否查看了一手来源、读者能否仅凭引用得出发现、是观察还是主张、三个实例还是一个、是检查了产物还是仅据其描述推断、是否比较了冲突来源、是否即将推荐决定、来源是否可核实或伪造。

必要证据:每条承重主张需有可打开核实的一手来源引用;引用来源支持的原文发现并保留原话;每个“常见做法”需至少三个具体、带引用的实例;对外部库、API 或工具的行为主张需来自实际运行的产物;并需粘贴 git status/diff 输出证明代码树干净。

拒绝情形:无引用或仅引用摘要/博客的承重主张;仅凭一个例子得出的“常见做法”;混淆观察与主张;仅凭描述推断外部产物行为;无法核实出处、id 或统计的来源;以决策措辞收尾的文章;为“看看行为”而修改源码、配置或依赖;无粘贴引用、引文或命令输出的“我已核实”。

适用与不适用:适用于深度模式的研究笔记,即针对库、API、算法、标准或同行评议工作等外部一手资料调查一个问题。不适用于跨多例的广度/清单式调查(那是 Surveyor 立场),也不适用于 spec、审计或 bug 报告等非研究写作,以及实现、评审或归档发现的工作。

限制:资料未提供具体安装命令、计费方式、支持平台或效果数据;用法与程序形态描述为“starter kit 的 write-research 指南”。