用途
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 — 每个维度将变成什么的解剖