145 lines
4.5 KiB
Markdown
145 lines
4.5 KiB
Markdown
# Skill 设计指南（包格式薄层）
|
||
|
||
> **文档层级：Skill 包格式薄层（非系统架构）。**
|
||
> 运行内核见 [`architecture.md`](./architecture.md)；创作方法见下。
|
||
> **现行磁盘布局**见 [`skills/dialogue/world-simulator/README.md`](../skills/dialogue/world-simulator/README.md)。
|
||
|
||
**创作方法（三大步、表、自检、正推）** 的权威文档是：
|
||
|
||
→ **[`design-orchestrator-guide.md`](./design-orchestrator-guide.md)**
|
||
|
||
能力 / 编排器清单：
|
||
|
||
→ **[`world-simulator-modules.md`](./world-simulator-modules.md)**
|
||
|
||
本文只保留：**如何在仓库里建包、Worker 集弱结构示例、与旧概念对照**。不要在本文重复长方法文。
|
||
|
||
格式字段见 `orchestrator-skill-format.md`、`worker-skill-format.md`；上下文见 `context-assembly.md`。
|
||
|
||
**设计顺序（概念）：**
|
||
|
||
```text
|
||
1. 用户选配方 → design-flow 排出近期 设计.创作流程
|
||
2. 反复 design-step（modules 能力切片）→ 收成 设计.worker集 JSON
|
||
3. 需要时合并 worker-templates 默认契约（仅 design 缺省）
|
||
4. 用户验收 → 用户手动进 play
|
||
5. play：按声明调度；表维护/副作用边沿触发
|
||
```
|
||
|
||
---
|
||
|
||
## 0. 设计.worker集
|
||
|
||
### 0.1 定位
|
||
|
||
旧 **交互范式 / run_skill 清单 / 美学纲领** 合并为单一 tag：**`设计.worker集`（JSON）**。
|
||
|
||
| 旧概念 | 新做法 |
|
||
|--------|--------|
|
||
| `设计.交互范式` | `interaction`（站位、系统扮演、输出与轮转） |
|
||
| `设计.run_skill清单` | `workers` + 数据依赖 / 表副作用 |
|
||
| `设计.美学纲领` | 转述 presentation **或** 常驻上下文；叙事指南 ≠ 文风 |
|
||
|
||
Worker 集不是闭集枚举，也不是逐步管道。方法见 `design-orchestrator-guide.md`。
|
||
|
||
### 0.2 design-flow / design-step
|
||
|
||
与用户对话，经编排器能力编排与逐步执行，增量更新草稿，accept 后即实例规格。进 play **由用户手动决定**。
|
||
|
||
旧名 `design-intake` 仅作兼容别名出现在部分代码注释中，**磁盘上已不存在**。
|
||
|
||
### 0.3 弱结构示例（JSON）
|
||
|
||
```json
|
||
{
|
||
"version": 1,
|
||
"interaction": {
|
||
"user_stance": "单角代入",
|
||
"system_role": "世界执行并给出可读叙事",
|
||
"output": "输出.用户展示 + 可折叠状态表",
|
||
"turn_shape": "对话回合"
|
||
},
|
||
"experience_check": {
|
||
"user_relation": "…",
|
||
"focus": "…",
|
||
"satisfaction_source": "…"
|
||
},
|
||
"workers": [
|
||
{
|
||
"ref": "world-simulator",
|
||
"duty": "世界推进与裁决",
|
||
"rationale": "删掉则无本轮世界结果",
|
||
"acceptance": "continue"
|
||
},
|
||
{
|
||
"ref": "narrator",
|
||
"duty": "组装用户可见回复",
|
||
"rationale": "核心产出干巴，需要可读终稿",
|
||
"acceptance": "review"
|
||
}
|
||
],
|
||
"resident_context": [
|
||
{
|
||
"id": "tone",
|
||
"position": "static",
|
||
"content": "文风示例",
|
||
"mount": ["narrator"]
|
||
}
|
||
],
|
||
"tables": {
|
||
"schemas": [],
|
||
"side_effects": [
|
||
{
|
||
"id": "affinity-romance",
|
||
"field": "好感",
|
||
"op": "gte",
|
||
"value": 60,
|
||
"mode": "once",
|
||
"action": {
|
||
"type": "write_tag",
|
||
"tag": "上下文.角色态度",
|
||
"content": "恋爱模式"
|
||
}
|
||
}
|
||
]
|
||
},
|
||
"narrative_guide": "",
|
||
"core_premises": [],
|
||
"input_protocol": {
|
||
"parens": "() 元要求",
|
||
"quotes": "\"\" 角色对白",
|
||
"bare": "无包裹视为事实陈述"
|
||
},
|
||
"design_end": {
|
||
"opening": "optional"
|
||
}
|
||
}
|
||
```
|
||
|
||
`presentation` 主要挂转述类；裁决类不挂展示美学。包级共性可写 `shared-context.md`。
|
||
|
||
### 0.4 编辑与重 roll
|
||
|
||
见 `run-snapshot.md`。
|
||
**创作**：按创作单位验收后删交互留产物。固定上下文相关名称是 **可向用户询问的示例话题**（非填空表）；宜先钉纲领类 tag 再写 worker（挂载复用），见 `design-orchestrator-guide.md` §6。
|
||
**Run** 验收点（`acceptance: review`）：接受后压缩过程 tag。
|
||
`acceptance: continue` 的中间 worker 可连跑；面向用户的可读停点由 Worker 集声明。
|
||
|
||
---
|
||
|
||
## 1. 暂停与用户
|
||
|
||
边界 tool 即暂停（`ask_user`、`review_artifact` 等）。策略写在 manifest **验收策略**，不是「第几步必须停」。
|
||
Play 默认不对每轮终稿强制 accept。详见 `design-orchestrator-guide.md` §0、§7。
|
||
|
||
---
|
||
|
||
## 2. 相关
|
||
|
||
| 文档 | 关系 |
|
||
|------|------|
|
||
| **design-orchestrator-guide.md** | ★ 方法 |
|
||
| creation-playbook.md | 流程概念 |
|
||
| orchestrator-skill-format.md | manifest |
|
||
| worker-skill-format.md | 磁盘 SKILL（声明驱动演进中） |
|