用途
create-research 用于回答某个任务关于代码“当前实际如何工作”的研究问题,并把答案保存为一个研究文件。它被定位为一张地图,而不是一份提案:不包含建议、不包含修复、不包含批评。
主要能力
- 从用户处或用户指定的问题文件中获取研究问题。
- 在开始其他操作前,完整阅读用户提到的任何文件。
- 将问题拆分为若干领域,并使用 Explore 智能体并行调研(两到六个,按领域分组,而不是每个问题一个)。
- 要求每个智能体提供 file:line 证据。
- 核对文档将依赖的智能体结论:亲自打开被引用的行。智能体的摘要是主张,不是证据。
- 使用 references/research-template.md 将正文写入临时文件,然后创建产物。
使用方式
- 获取问题:来自用户,或来自用户指定的问题文件。先完整阅读用户提到的任何文件。
- 不要读取任务的工单或计划。研究描述的是代码;想要变更的工单会使其产生偏见。任务目录中较早的研究产物可以读取。
- 将问题拆分为领域,并用 Explore 智能体并行调研(两到六个,按领域分组,而不是每个问题一个)。要求每个智能体提供 file:line 证据。
- 核对文档将依赖的智能体结论:亲自打开被引用的行。
- 使用 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
- 回复路径和未决问题,然后停止。
规则
- 描述,绝不规定:不出现“should”、不出现“we could”、不出现 diff 块。
- 每条发现都引用 path:line 或行范围。
- 说明一个列表是完整的还是样本。
- 未决问题是关于尚未追踪的内容(“X 如何到达 Y?”),而不是关于要构建什么。
相关
- /ork:iterate-research 根据评论修订它。
- /ork:create-plan 接下来读取它。
限制
资料未提供关于收费、价格、平台支持范围或效果保证的信息。