SuperAPI AI 工具集

dimension-surfacing

智能体与模型

查看项目

更新于 10-15 09:41

技能介绍

用途

Dimension Surfacing 用于从“grain”中提取并行的领域维度。所谓 grain,是指表面简短、但隐含范围包含多个独立领域的密集提示。该技能的目标是命名这些领域,使它们能够作为并行任务被组合分派。

什么是“维度”

维度是 grain 所隐含的一条工作轴线,它与其他轴线不同,满足以下条件:

  • 分配给维度 A 的子代理可以独立于维度 B 的代理执行(执行时无交叉耦合)。
  • 维度 A 所需的领域专业知识与维度 B 不同(不同的代理类型、知识库、成功标准)。
  • 如果从“coliseum”中移除维度 A,用户的 grain 将部分未被处理。

维度不是:

  • 单一领域内的子步骤(那是序列,不是维度)。
  • 对另一个维度的改写(那是冗余)。
  • grain 并未实际请求的锦上添花(那是范围蔓延)。

使用方式

步骤 1:字面阅读 grain

  • 如果从编排器调用,读取 grain-context.md 并从“literal surface”部分提取逐字 grain。
  • 如果直接调用,将参数视为 grain。

分析前不要转述。转述会抹除维度。

步骤 2:生成候选维度集

通过以下每个视角阅读 grain,并从每次遍历中捕获候选维度。一个维度可能来自一个视角;强的维度会从多个视角涌现。

视角 对 grain 提出的问题
领域 这涉及哪些不同的知识领域?(例如法律、安全、设计、基础设施、内容、本体论)
利益相关者 涉及哪些人的视角?(例如用户、操作者、审计者、贡献者、下游消费者)
时间跨度 哪些内容跨越不同的时间尺度?(例如即时执行、中期架构、长期治理)
底层层次 它跨越哪些技术/材料层?(例如数据模型、API、UI、部署、可观测性)
失败模式 哪些不同的失败模式需要分别缓解?(例如正确性、延迟、安全、人体工学)
禁止动作 grain 对什么说了“不”,这个“不”通过否定命名了什么维度?

将每个候选维度写为:<短名称> — <一句话描述> — <所需专业知识类型>。

步骤 3:为独立性剪枝

对于每对候选维度,问:维度 A 上的子代理能否在不等待维度 B 的情况下完成工作?

  • 如果能 → 两者都保留。
  • 如果不能,且依赖是真实的 → 合并为一个包含两者的维度,或拆分为序列(这意味着其中之一不是对等维度,而是下游步骤)。
  • 如果它们共享相同的专业知识和相同的成功标准 → 合并为一个。

目标维度数量:3–7。超过 7 通常意味着视角遍历的输出未经剪枝就被保留。少于 3 通常意味着维度被过早合并——重新检查。

步骤 4:编写产物

在工作目录中写入 phase-1-dimensions.md。所需结构:

# Phase 1 — Dimensions surfaced

## Grain (verbatim)

> <quoted grain>

## Dimensions

### D1 — <name>

- **Description**: <one sentence>
- **Expertise required**: <named domain>
- **Why independent**: <one sentence on why this can dispatch in parallel>
- **Implicit success criterion**: <one sentence>

### D2 — <name>

…

## Pruning log

- Candidates considered: <list>
- Merged: <which into which, why>
- Dropped: <which, why>

## Lens coverage

- Domain lens: <which dimensions emerged from this lens>
- Stakeholder lens: …
- Time-horizon lens: …
- Substrate-layer lens: …
- Failure-mode lens: …
- Forbidden-moves lens: …

步骤 5:门控标准自检

返回前验证:

  • 每个维度可独立执行(执行时无交叉耦合)。
  • 没有维度是另一个的改写。
  • 维度集整体覆盖 grain 的隐含范围。
  • 维度数量在 [3, 7] 内,或已为超出该范围写出理由。
  • 每个维度命名了所需的专业知识类型。

如果任何检查失败,在生成最终产物前迭代。

适用场景

  • 用户提示表面简短但明显隐含多个独立领域时。
  • 需要将复杂提示拆解为可并行分派的独立子任务时。
  • 作为编排流程的第一阶段,为后续并行代理分配提供维度定义时。

限制

  • 最常见的失败是“维度即任务分解”——将单一领域拆分为步骤序列并称之为“维度”。维度是轴线,不是步骤。如果候选维度可以排序为单一工作流,则得到的是序列,不是 coliseum。
  • 目标维度数量为 3–7;超出范围需提供理由。
  • 分析前不得转述 grain,否则会抹除维度。

参考材料

  • references/parallel-dimensions.md — 提示的多轴阅读
  • references/assignment-anatomy.md — 每个维度将变成什么的解剖