القائمة
约束 trpg-workbench 中所有结构化资产的格式、命名、字段和版本管理规范。当创建或修改任何资产文件时必须加载本 skill，包括：新建 NPC/怪物/场景/地点/线索等任意类型资产、编写 frontmatter 字段、处理 AssetRevision、设计资产字段结构，或讨论资产存储格式时。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
管理 trpg-workbench 的版本发布流程。当用户说"发版"、"打 tag"、"release"、 "发布 vX.Y.Z"、"准备新版本"、"更新 changelog"、"写 release notes"、 "CI 失败重跑"、"重新触发"、"删除 tag" 时必须加载本 skill。 本 skill 由 agent 全程操作：生成 changelog → 润色 → 写入文件 → commit → push → 用 gh CLI 触发 GitHub Actions workflow。用户只需在各步骤确认内容即可。
在新机器上从零搭建 trpg-workbench 开发环境的完整步骤指南。当在新电脑上克隆项目、遇到环境初始化问题、或需要重建开发工作空间时必须加载本 skill。包括：安装 Node.js/pnpm/Rust/Python/Tauri CLI、处理 macOS 常见 pip 限制、venv 创建、前后端依赖安装、验证后端启动，以及已知坑点的解决方案。
约束 trpg-workbench 前端的布局结构、组件选型、状态管理和数据请求规范。当实现或讨论任何前端相关功能时必须加载本 skill，包括：页面布局设计、新建 React 组件、选择 UI 组件库、实现编辑器功能、管理全局状态、调用后端 API、设计 Agent 面板交互，或任何涉及前端技术选型的讨论。
约束 trpg-workbench 中知识库文档（PDF/CHM）的导入、TOC 与 ingest 预览、切块、向量化、索引与检索。实现或讨论 Knowledge Library、ingest、TOC、`knowledge_documents` 相关 API 时必须加载本 skill。
约束 trpg-workbench 项目的整体架构决策、技术选型和仓库结构规范。当讨论或实现任何涉及技术选型、架构分层、数据模型、目录结构、通信方式、数据库方案、前后端划分的问题时，必须加载本 skill。包括但不限于：新建模块、引入新依赖、设计服务间通信、讨论存储方案、规划仓库结构，或任何"用什么技术"的决策。
约束 trpg-workbench 中所有 AI Agent 的职责边界、调度规则和 Workflow 设计模式。当实现或讨论任何 Agent 相关功能时必须加载本 skill，包括：新建 Agent、设计 Agent 间协作、实现 Workflow、处理用户创作请求的路由、Director Agent 调度逻辑、Consistency/Rules/Skill Agent 的工具化委托，或任何"让 AI 做某件事"的功能设计。
| name | asset-schema-authoring |
| description | 约束 trpg-workbench 中所有结构化资产的格式、命名、字段和版本管理规范。当创建或修改任何资产文件时必须加载本 skill，包括：新建 NPC/怪物/场景/地点/线索等任意类型资产、编写 frontmatter 字段、处理 AssetRevision、设计资产字段结构，或讨论资产存储格式时。 |
本 skill 约束 trpg-workbench 中所有结构化资产的创建、格式、命名和版本管理规范。每次生成或修改资产时都必须遵守本 skill。
每个资产是一个单文件：{slug}.md，包含 YAML frontmatter + Markdown body。
---
type: npc
name: Arthur Hale
slug: mayor-arthur
status: draft
version: 3
summary: 镇长，表面亲和，实则掩盖旧案
---
# Arthur Hale
## 概述
温和可靠的镇长，掩盖十五年前的失踪案...
文件系统是真相源，SQLite 是可重建的缓存索引。
.md 文件中.md 文件（frontmatter + body），然后触发 sync 更新缓存type 字段决定，不由目录决定{type}/ 目录type → 诊断错误（IDE Problems 风格）M30 更新：内置类型从 10 种精简为 6 种。已废弃
location、branch、timeline、map_brief、lore_note（已有此类型的旧资产继续可读，但 AI 不再创建这些类型）。
| type 值 | 惯例目录 | 说明 |
|---|---|---|
outline | outlines/ | 整体故事框架，含世界背景和分支结局（原 outline + lore_note + branch 合并） |
stage | stages/ | 故事单元（幕），含事件序列和 NPC 出场（原 stage + timeline 合并） |
npc | npcs/ | 玩家会直接交互的人物角色 |
monster | monsters/ | 玩家的威胁来源（怪物/异常实体/敌人） |
map | maps/ | 地点网络和连接路径（原 location + map_brief 合并） |
clue | clues/ | 可被玩家发现的关键信息载体 |
{custom} | {custom}s/ | 用户在 RuleSet 中注册的自定义类型 |
每种内置类型的完整规范（范围说明 + 必要信息 + Markdown 模板）位于：
apps/backend/app/prompts/asset_types/{type_key}.txt
新建资产时，Director 会先调用 get_asset_type_spec(type_key) 工具获取完整规范，再编写 content_md。
格式：{slug}.md（不含 type 前缀）
示例：
mayor-arthur.md → 放在 npcs/ 下
deep-one-elder.md → 放在 monsters/ 下
act1-village-arrival.md → 放在 stages/ 下
arkham-town.md → 放在 maps/ 下
slug 规范：
- 连接---
type: string # 对应上方 type 值
name: string # 显示名称，可用中文
slug: string # 文件名中的 slug 部分
status: draft | review | final
version: integer # 从 1 开始，每次落盘递增
summary: string # 一两句话摘要，供 Director Agent 决策时快速读取
---
---
type: npc
name: Arthur Hale
slug: mayor-arthur
status: draft
version: 1
summary: 镇长，表面亲和，实则掩盖旧案，是核心对抗势力之一
role: 镇长
public_persona: 温和可靠
hidden_truth: 掩盖十五年前的失踪案
motivation:
- 维持秩序
- 保护名誉
relationships:
- target: doctor-elsa
type: alliance
note: 共谋隐瞒旧案
appearance_brief: 中年，衣着体面，神色疲惫
dialogue_style: 克制、官方、绕弯子
secrets:
- 知道失踪案真相
- 与 Elsa 有旧约
---
---
type: monster
name: 深海长老
slug: deep-one-elder
status: draft
version: 1
summary: 深海长老，认知污染型威胁，不直接杀伤但会摧毁理智
concept: 克苏鲁神话深海种族的高阶个体
behavior_pattern: 潜伏、引导、精神污染，不直接攻击
threat_type: cognitive_corruption
threat_level: lethal
abilities:
- telepathy
- shape_shifting
- fear_aura
---
---
type: stage
name: 第一幕：抵达村庄
slug: act1-village-arrival
status: draft
version: 1
summary: 玩家抵达小镇，初步感受压抑氛围，获得第一条线索
act: 1
mood: 压抑、雨天、村民警惕
objectives:
- 建立背景氛围
- 引入第一条线索
key_npcs:
- mayor-arthur
- innkeeper-tom
key_locations:
- village-square
- inn
clues_available:
- missing-persons-poster
---
M30 起
location和map_brief合并为map类型，描述地点网络和连接路径。
---
type: map
name: 废弃灯塔区域
slug: old-lighthouse-area
status: draft
version: 1
summary: 海崖边废弃灯塔及周边地点，藏有推进主线的隐秘线索
description_brief: 建于1890年代，海崖边，长期废弃，海鸟聚集
atmosphere: 荒凉、潮湿、隐约有腐烂气息
accessible_in_stages:
- act2-cliffside
hidden_elements:
- 地下密室入口
- 旧日记碎页
danger_level: moderate
---
每次落盘都要创建一份 revision 快照文件，保存在 .trpg/revisions/{slug}/v{N}.md。
快照文件是资产文件的完整副本（包含 frontmatter + body），不是 diff。
revision 约束：
version 从 1 开始，每次递增change_summary 和 source_type 记录在 AssetRevisionORM 中（缓存索引）source_type 必须标明来源：agent（AI 生成）或 user（用户手动编辑）资产之间相互引用时，使用 slug 引用（不再使用 {type}_{slug_underscored} 格式的 asset_id）。
# 正确
key_npcs:
- mayor-arthur
- innkeeper-tom
# 错误
key_npcs:
- 镇长Arthur
- npc-mayor-arthur.md
NPC 关系网中的 target 字段也使用 slug：
relationships:
- target: doctor-elsa
type: alliance
note: 共谋隐瞒旧案
frontmatter 之后的 Markdown body 应有固定的标题结构。
在 body 中可以用 [[slug]] 或 [[slug|显示文字]] 引用其他资产：
[[mayor-arthur]] 在此场景中首次亮相。
可前往 [[old-mansion|老宅]] 调查线索。
[[slug]] 引用也会出现在 useAssetRelations 的 outgoing 列表中key_npcs、key_locations 等）来声明关系；[[双链]] 用于 body 中自然语言叙述时的顺带引用# {名称}
## 概述
（一两句话，和 frontmatter summary 保持一致）
## 外在形象
## 动机
## 秘密
## 关系网
## 与玩家的互动建议
# {名称}
## 概念与来源
## 外形描述
## 行为模式
## 威胁表现
## 规则适配建议
# {名称}
## 场景概述
## 氛围描述
## 可用线索
## 关键 NPC 行为
## 分支出口
.md 文件type 或 summary 字段禁止在内置数据、seed 数据、帮助文档、UI 文案、skill 文档中直接引用任何受版权保护的具体 TRPG 品牌名称或规则系统名称。
具体禁止事项：
seed.py）、Prompt Profile、帮助文档、UI 占位文字中出现"COC"、"Call of Cthulhu"、"克苏鲁的呼唤"、"D&D"、"Dungeons & Dragons"等受商标/版权保护的游戏系统名称允许的做法：
背景说明：
TRPG Workbench 是通用创作工具，不依附于任何特定 TRPG 规则系统。内置示例和默认配置应使用风格描述，避免隐含对特定商业产品的背书或侵权风险。