115 lines
3.3 KiB
Markdown
115 lines
3.3 KiB
Markdown
# Worker Skill 格式
|
||
|
||
> **文档层级：Worker / 声明契约格式（非系统架构）。**
|
||
> 上下文编译原则见 [`architecture.md`](./architecture.md)、[`context-assembly.md`](./context-assembly.md)。
|
||
> **现行包落地**见 [`skills/dialogue/world-simulator/README.md`](../skills/dialogue/world-simulator/README.md)。
|
||
|
||
## 1. 定位（现行：声明驱动）
|
||
|
||
**默认包 `world-simulator`：**
|
||
|
||
```text
|
||
play 时执行契约 = accept 后的 设计.worker集 某条 workers[]（实例 Worker 声明）
|
||
可选模板 = worker-templates/{ref}.yaml（design 缺省合并默认值）
|
||
磁盘 SKILL.md = 仅创作阶段必要 worker（现：design-flow / design-step / opening-generator）
|
||
技能正文 = modules/{id}/prompt.md（由 design-step 注入，不是独立 worker）
|
||
```
|
||
|
||
编排器 `run_worker(id)` → Runtime 校验 id ∈ Worker 声明 → 从 **Worker 集条目**（+ 可选模板合并）拼 prompt → 写声明的 `outputs`。
|
||
|
||
**不要**为每个 play ref 预置 `workers/narrator/SKILL.md`；实例差异写在 Worker 集里。
|
||
|
||
规格见 `docs/tag-blackboard.md`、`docs/context-assembly.md`、`skills/dialogue/world-simulator/worker-templates/`。
|
||
|
||
---
|
||
|
||
## 2. 创作阶段 Worker（磁盘 SKILL.md）
|
||
|
||
仅包内 **design 专用** worker 用磁盘文件：
|
||
|
||
```text
|
||
skills/dialogue/world-simulator/
|
||
├── orchestrator.md
|
||
├── modules/{id}/prompt.md # 能力切片（非 SKILL.md）
|
||
├── worker-templates/ # 可选模板，非执行文件
|
||
└── workers/
|
||
├── design-flow/SKILL.md
|
||
├── design-step/SKILL.md
|
||
└── opening-generator/SKILL.md
|
||
```
|
||
|
||
- 目录名 = worker id。
|
||
- 文件名固定 **`SKILL.md`**。
|
||
|
||
旧 `design-intake` / `design-core` / `design-fixed` / `design-worker` / `design-refine` **已移除**。
|
||
|
||
---
|
||
|
||
## 3. Design Worker Frontmatter（示例）
|
||
|
||
```yaml
|
||
---
|
||
id: design-step
|
||
skill: world-simulator
|
||
name: 创作 · 执行能力步
|
||
stage: design
|
||
inputTags:
|
||
- "用户.需求"
|
||
- "设计.创作流程"
|
||
outputTags:
|
||
- "设计.worker集.草稿"
|
||
inputMerge: latest
|
||
---
|
||
```
|
||
|
||
| 字段 | 用途 |
|
||
|------|------|
|
||
| `id` | worker id |
|
||
| `skill` | 所属包 name |
|
||
| `inputTags` / `outputTags` | 黑板读写白名单 |
|
||
| `contextSegments` | 可选；上下拼接 |
|
||
|
||
### 3.1 contextSegments
|
||
|
||
见 `docs/context-assembly.md`。
|
||
|
||
---
|
||
|
||
## 4. 实例声明字段（写入 `设计.worker集`）
|
||
|
||
`refine` 能力 / design 收口产出的每条 worker：
|
||
|
||
```yaml
|
||
workers:
|
||
- ref: narrator # 能力库 id；null = gap
|
||
role: transcription
|
||
duty: …
|
||
when: …
|
||
rationale: …
|
||
context:
|
||
static: [设计.worker集]
|
||
dynamic: [运行.本轮.裁决]
|
||
outputs: [输出.用户展示]
|
||
presentation:
|
||
tone: …
|
||
```
|
||
|
||
未写全的 `context`/`outputs` 可由 `worker-templates/{ref}.yaml` 合并。
|
||
|
||
---
|
||
|
||
## 5. 执行要点
|
||
|
||
- Agent **不**指定 inputTags；读 Worker 声明 / 模板。
|
||
- `ref: null` + `gap`：声明了职责但无模板 / SKILL，需补声明或 temp worker。
|
||
- 验收：design-flow / design-step 默认需用户确认；play 中间 worker 可 `no_confirmation`。
|
||
|
||
## 相关
|
||
|
||
| 文档 | 关系 |
|
||
|------|------|
|
||
| `creation-playbook.md` | 创作流 |
|
||
| `world-simulator-modules.md` | 能力 / 编排器清单 |
|
||
| `worker-declaration.ts` | Runtime 声明校验 |
|
||
| `worker-templates/README.md` | 可选模板 |
|