Files

为可重复技能补充参数校验与展示，统一配方、编排器和执行单元术语。

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-07-30 17:59:20 +08:00

4.5 KiB

Raw Permalink Blame History

Skill 设计指南（包格式薄层）

文档层级：Skill 包格式薄层（非系统架构）。
运行内核见 architecture.md；创作方法见下。
现行磁盘布局见 skills/dialogue/world-simulator/README.md。

创作方法（三大步、表、自检、正推） 的权威文档是：

→ design-orchestrator-guide.md

能力 / 编排器清单：

→ world-simulator-modules.md

本文只保留：如何在仓库里建包、Worker 集弱结构示例、与旧概念对照。不要在本文重复长方法文。

格式字段见 orchestrator-skill-format.md、worker-skill-format.md；上下文见 context-assembly.md。

设计顺序（概念）：

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）

{
  "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（声明驱动演进中）

4.5 KiB Raw Permalink Blame History Unescape Escape