SuperAPI AI 工具集

research

写作与研究

查看项目

更新于 10-16 06:16

技能介绍

用途:对现有代码库进行客观调研,产出与发现简报(brief)意图无关的事实性结论。主智能体读取简报、生成中立问题,队友只调查代码;队友全程看不到简报、工单或用户目标,最后由主智能体独家编写 research.md。

主要能力与流程:

  • 第1阶段 计划与派发:从对话上下文读取简报,识别涉及的代码范围簇(模块、目录、子系统),为每个范围生成事实性问题;按范围用 TaskCreate 建任务,并用 Agent 以 subagent_type: "codebase-researcher" 及名称 researcher-{scope-slug} 派发队友。任务描述只含问题与范围边界。
  • 第2阶段 收集与迭代:按“波次”推进,一个波次全部队友通过 SendMessage 返回结论后才评估是否有未答或新暴露的范围,再派发下一波。队友空闲通知不算结论。
  • 第3阶段 汇总与落盘:将结论写入 design-docs/NN-name.research.md,按范围簇而非队友组织,保留具体文件路径、函数名与行号,显式标注矛盾与缺口,不注入观点或建议。
  • 第4阶段 关闭:按名称要求每位队友关闭;会话结束时团队目录自动清除。

使用前提:需启用 agent teams,在设置中加入 {"env":{"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS":"1"}} 并重启会话;否则应立即停止并告知用户。队友还需交互式会话;在 claude -p 下命名派发会作为普通子智能体运行,波次仍可用,但结论以子智能体结果而非 SendMessage 返回。若会话无 Task 工具,可跳过 TaskCreate,把任务描述块放进派发提示中。

问题生成规则:只问事实,不要求评估或判断。允许动词为 document、identify、describe、trace、characterize、examine、list、map;禁止 should、must、improve、fix、optimize、enhance、refactor、recommend、suggest、better、needs to。问题类型覆盖结构、逻辑、集成、模式四类,需至少覆盖三类。需经偏差校验:扫描规范性用语、做意图遮蔽测试、做平衡检查。

限制与约束:简报只能在第3阶段全部波次完成后写盘,否则破坏信息屏障;任务描述只含问题与范围;派发提示可含上下文(项目名、范围、只读调研角色),不得含意图;research.md 由主智能体独家撰写,队友只读不写。若对话或磁盘均无简报,需询问用户是否先运行 discovery。用户批准 research.md 后,可提供“是否进入 alignment 技能”。具体价格、平台与效果资料暂未提供。