SuperAPI AI 工具集

research

智能体与模型

查看项目

更新于 10-16 03:25

技能介绍

Research 是 davidlee/doctrine 项目中的一个技能,定位为设计前的研究轮次。当某个切片(slice)已经划定范围但尚未设计时,运行该轮次并持久化其证据产物。

用途

设计前的研究轮次会产出一份持久化的证据产物 research.md,供后续阶段引用,而不是重新推导。该产物由两条只读线程(治理适用性;代码地图)加上跨线程综合组成,由编排智能体组装成一份文档。

产物位置与生命周期

产物位于 .doctrine/slice/NNN/research/,直接放在切片文件夹中,并在原地被 gitignore。运行时层级为一次性工作证据;持久化发现会在切片关闭时收集。

运行方式

命令为:doctrine slice research <id>。在轮次开始时运行它(它会创建 research 文件夹并标记陈旧基线 baseline.toml),并在每次消费该产物时再次运行以检查新鲜度。该命令是建议性的,绝不是门禁:漂移输出只是提示刷新,命令始终成功。标志和机制详见 CLI 的帮助。

产物 research.md

强制骨架;刷新轮次会原地修订各节,额外节可自由格式:

  • 头部 — 生产者(谁/什么运行了每条线程)、基线指针。
  • 验证图例 — 下文所述的 ✓ 纪律。
  • 线程 1 — 治理适用性 — 约束性限制;已检查但不适用并说明理由;修订候选。
  • 线程 2 — 代码地图 — 热点(可能变更的文件)、引用事实、命名先例。
  • 跨线程发现 — 线程交汇或冲突之处;通常是最有价值的节。
  • 设计输入增量 — 本研究对预期设计带来的改变。

与之并列的还有:raw/<thread>.md(线程的逐字输出)和 baseline.toml(由该动词标记)。

引用形式

  • 治理声明引用持久化实体 id。
  • 代码声明引用 file:line。
  • 未引用的声明按定义不可验证。

验证纪律

  • ✓ = 该声明由消费智能体独立验证(对引用位置进行 grep 或读取)。未标记 = 研究者声明:已引用,未检查。
  • 设计和计划只能承载 ✓ 行,或在使用点验证的行。
  • 验证是非对称的 — 验证你所依赖的内容(每个承载声明约一次 grep),而非全部。

运行轮次

启动项目的研究智能体,每条线程一个,只读;将每条线程的 stdout 捕获到 research/raw/<thread>.md — 切勿将批量输出内联到对话中。

研究智能体是什么(命令、模型、期望)由项目定义 — 参见项目治理文档的 Research agents 节。Doctrine 不附带运行器。

优雅降级:如果项目未定义研究智能体,自行运行线程,或跳过轮次并在产物头部说明。

研究者从不写文件或记忆。编排智能体将 raw/ 提炼为精选产物 — 文档指向 raw 以获取批量内容。

提示职责

每条线程提示必须要求:

  • 上述引用形式;
  • 结构化的不适用形式(每个被驳回的权威均被命名,并说明理由);
  • 输出已符合产物的节形状;
  • 无前言(廉价模型会添加前言;汇编器会剥离它)。

谁调用此技能

在此单一来源;调用技能仅携带简短的建议性指针:

  • /slice — 在划定范围后,在 /design 之前运行轮次。
  • /design — 消费产物;线程 1 代替大部分治理扫描;设计断言引用 research.md。
  • /plan — 检查陈旧建议;从线程 2 热点地图起草选择器。
  • /phase-plan — 检查建议;在漂移时,仅刷新受影响的节,然后重新标记基线。