writing-agent/docs/worker-skill-format.md

Worker Skill 格式

文档层级：Worker / 声明契约格式（非系统架构）。
上下文编译原则见 architecture.md、context-assembly.md。

1. 定位（现行：声明驱动）

默认包 world-simulator：

play 时执行契约 = accept 后的 设计.worker集 某条 workers[]（实例 Worker 声明）
可选模板       = worker-templates/{ref}.yaml（design-intake 合并默认值）
磁盘 SKILL.md  = 仅创建阶段必要 worker（现：design-intake）

总管 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 用磁盘文件：

skills/dialogue/world-simulator/
├── orchestrator.md
├── worker-templates/          # 可选模板，非执行文件
└── workers/
    └── design-intake/SKILL.md

• 目录名 = worker id。
• 文件名固定 SKILL.md。

---

3. Design Worker Frontmatter（示例）

---
id: design-intake
skill: world-simulator
name: 实例设计 · Worker 集
stage: design
inputTags:
  - "用户.需求"
outputTags:
  - "设计.worker集"
  - "设计.worker集.草稿"
inputMerge: latest
---

字段	用途
id	worker id
skill	所属包 name
inputTags / outputTags	黑板读写白名单
contextSegments	可选；上下拼接

3.1 contextSegments

见 docs/context-assembly.md。

---

4. 实例声明字段（写入 设计.worker集）

design-intake 产出的每条 worker：

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-intake 默认 user_confirmed；play 中间 worker 可 no_confirmation。

相关

文档	关系
creation-playbook.md	创作流
worker-declaration.ts	Runtime 声明校验
worker-templates/README.md	可选模板