SuperAPI AI 工具集

create-research

编程与开发

查看项目

更新于 10-31 09:23

技能介绍

用途

create-research 用于回答某个任务关于代码“当前实际如何工作”的研究问题,并把答案保存为一个研究文件。它被定位为一张地图,而不是一份提案:不包含建议、不包含修复、不包含批评。

主要能力

  • 从用户处或用户指定的问题文件中获取研究问题。
  • 在开始其他操作前,完整阅读用户提到的任何文件。
  • 将问题拆分为若干领域,并使用 Explore 智能体并行调研(两到六个,按领域分组,而不是每个问题一个)。
  • 要求每个智能体提供 file:line 证据。
  • 核对文档将依赖的智能体结论:亲自打开被引用的行。智能体的摘要是主张,不是证据。
  • 使用 references/research-template.md 将正文写入临时文件,然后创建产物。

使用方式

  1. 获取问题:来自用户,或来自用户指定的问题文件。先完整阅读用户提到的任何文件。
  2. 不要读取任务的工单或计划。研究描述的是代码;想要变更的工单会使其产生偏见。任务目录中较早的研究产物可以读取。
  3. 将问题拆分为领域,并用 Explore 智能体并行调研(两到六个,按领域分组,而不是每个问题一个)。要求每个智能体提供 file:line 证据。
  4. 核对文档将依赖的智能体结论:亲自打开被引用的行。
  5. 使用 references/research-template.md 将正文写入临时文件,然后创建产物:
node "${CLAUDE_SKILL_DIR}/scripts/artifact.mjs" create \
  --task <task> --kind research --slug <slug> --title "<question>" --author <your seat> --body /tmp/research-body.md
# prints .ork/tasks/<task>/NN-research-<slug>.md
  1. 回复路径和未决问题,然后停止。

规则

  • 描述,绝不规定:不出现“should”、不出现“we could”、不出现 diff 块。
  • 每条发现都引用 path:line 或行范围。
  • 说明一个列表是完整的还是样本。
  • 未决问题是关于尚未追踪的内容(“X 如何到达 Y?”),而不是关于要构建什么。

相关

  • /ork:iterate-research 根据评论修订它。
  • /ork:create-plan 接下来读取它。

限制

资料未提供关于收费、价格、平台支持范围或效果保证的信息。