把任务，设计成难忘的经历。

一套帮助你设计 RPG 任务的 Skill。把故事、玩法、节奏与反馈连在一起，打磨从初次接触到任务落幕的完整体验，再整理成团队能用的流程和制作文档。

有项目资料时，先读懂已有规则；只有一个点子时，也可以从标明假设的草案开始。不同项目的引擎能力和资源各有不同，Skill 会以你提供的资料为准。项目私有资料只保存在你的项目中。

可以帮你做什么

• 了解项目：用 $quest-understand 整理可用玩法、任务规则和待确认问题，方便后续设计。
• 构思任务：用 $quest-design 想清人物的矛盾、玩家能做的事和选择的后果，并比较不同制作成本的方案。
• 检查与修改：用 $quest-review 找出具体场景中的问题，解释原因并给出修改建议。线性、慢节奏或没有战斗本身不算缺陷。
• 准备文档：按需生成任务简报、流程、实现规格、制作需求或评审记录，不必每次填写全套模板。
• 核对文档引用：可选的 quest-package.json 把任务、步骤、需求和测试关联起来。用 quest-package-validate <path> 检查重复编号、失效引用和不可达节点。它不是引擎配置。

0.2.2 更新

• 十个 Skill 入口统一采用更自然的表达：先讲玩家遇到什么、要做什么、体验怎样变化，再补实现规则。
• 新增设计表达示例，改写任务简报模板，减少术语堆叠和不必要的表格。
• 中文、英文、日文介绍同步更新；网站支持语言下拉切换，并改善手机端与问答排版。
• 已安装旧版时，运行下方的 update 命令即可获取新版 Skill。安装命令和配置校验接口保持兼容。

安装

使用 npx

需要 Node.js 20 或更高版本及 npm，无需全局安装：

# 安装全部 Skill；已有目录会跳过
npx --yes --package=game-quest-designer-skills@latest -- game-quest-designer-skills install

# 更新已安装的本套 Skill
npx --yes --package=game-quest-designer-skills@latest -- game-quest-designer-skills update

安装指定 Skill 时，在命令末尾添加名称，例如：

npx --yes --package=game-quest-designer-skills@latest -- game-quest-designer-skills install quest-design quest-review

更新会替换对应 Skill 目录，不合并个人修改；旧目录会备份到安装目录同级的 .quest-skill-backups/。可添加 --dry-run 预览操作，或使用 --dest PATH 指定安装目录。

让 Agent 安装

把下面这句话直接发给 Codex 或其他支持安装 Skill 的 Agent：

请安装这个仓库中的全部 Skill：https://github.com/cloud-oc/GameQuestDesignerSkill

使用方式

仓库源码统一位于 skills/；手动安装时，将其中的 game-quest-designer/ 和需要的 quest-*/ 目录并列复制到你的 Skill 目录（Codex 通常为 ~/.codex/skills/）。每个目录都有自己的 SKILL.md 和 UI 元数据；仅放在本仓库中不代表已安装。不要把专项目录嵌套在总入口目录内。总入口使用 $game-quest-designer，各专项能力可以单独安装、独立调用。

| 调用 | 适用工作 | |---|---| | $game-quest-designer | 自动选择并组合任务设计能力 | | $quest-understand | 任务系统理解、能力画像与状态模型 | | $quest-design | 原创任务、核心体验与任务定义 | | $quest-flow | 剧情到玩法的映射、分支与流程设计 | | $quest-spec | 条件、目标、状态、动作与实现规格 | | $quest-prototype | 逻辑原型、异常路径与恢复验证 | | $quest-review | 叙事体验评审或配置审查 | | $quest-requirements | 制作需求、演出需求与跨任务复用 | | $quest-collab | 程序、关卡、演出、界面团队交接 | | $quest-docs | 任务文档读取、整理与同步 |

使用 $game-quest-designer，读取我提供的任务系统说明和已有案例，
建立这个项目自己的任务策划工作流。缺失信息先标出来，不要假定系统支持。

也可以直接请求：

• “根据这个剧本大纲完成任务定义、流程架构和逻辑原型。”
• “把任务流程转成 Quest/Target、领取条件和动作的实现规格，并标出缺少的 schema。”
• “按声明式规范检查这份配置，找出不可靠条件和应移到 Sandbox 的表现。”
• “根据这段剧本，输出剧情流、玩家体验流和任务逻辑流，并标出系统缺口。”
• “根据这个区域和可用玩法设计一个独立任务，控制新增制作需求。”
• “合并这三个任务里的 NPC、动作和演出需求，保留来源和复用待核对项。”
• “评审这个任务的动机、跑腿感和逻辑死锁，并给出修订稿。”

例如：$quest-design 设计一条以调查为主的村落支线，复用已有 NPC 和场景；$quest-review 检查这个任务是否会因提前取得道具而无法推进。历史 +命令 可作为总入口的意图别名理解，但它们不是独立注册的 Skill。

Skill 会按需要读取参考文件。你提供的项目模板优先；没有模板时使用最小可读结构。只有掌握真实配置格式且用户要求时才输出机器配置，设计走查不等于引擎测试。

完整交付可以让相关专项 Skill 复制各自的 assets/*-template.md。模板中的任务、节拍、需求和测试 ID 用于跨产物追溯；不适用字段应删除，不应为了填表扩大范围。

开发文档中设想的云文档适配器、同步脚本和解析器不被伪装成已实现能力；当前 Skill 会优先使用运行环境中真实可用的文档工具，并对覆盖、批量同步等操作保留明确授权边界。

维护与验证

安装器和任务包校验器使用 Node.js 标准库，无第三方运行依赖。运行 npm test 验证安装、更新、备份、内容链接、模板分发和任务包校验；运行 npm pack --dry-run 检查分发文件。npx 负责取得指定版本的安装器，安装器本身只操作随包分发的 Skill，不执行 Git 拉取。

自动构建与发布

• 任意 push 或 pull request 会运行 Node.js 20/24 验证，随后自动生成 npm .tgz，作为 GitHub Actions 构建产物保留 14 天。
• 本地运行 npm run build 也会先经 prepack 自动执行全部测试，再生成 tarball；npm publish 同样不能绕过该门禁。
• 推送与 package.json 版本一致的 v* 标签时，publish.yml 会通过 npm Trusted Publishing 自动发布。先用 npm version patch --no-git-tag-version 更新版本，再运行 npm run build:site 和 npm test；提交生成页面后创建同版本标签并推送。

首次自动发布前，需要在 npm 包 game-quest-designer-skills 的 Settings → Trusted Publisher 中添加 GitHub Actions：组织/用户填 cloud-oc，仓库填 GameQuestDesignerSkill，工作流文件填 publish.yml，并允许直接执行 npm publish。该账户级设置只需一次；未配置时构建仍会成功，但标签发布会因无法认证而失败。发布工作流使用 OIDC，不需要在 GitHub 保存长期 NPM_TOKEN。

业务方法覆盖 RPG 制作中的具体问题：玩家动机与信息揭示、选择后果与分支成本、共享 NPC 和世界状态、目标计数与奖励结算、存档/重入恢复，以及配置验收与试玩观察。相关细节按需加载到任务设计、流程、规格和验证能力中。

所有判断应对应项目资料或明确的设计假设；新增方法和验收场景不等于已经完成实际游戏或独立模型验证。

工程目录

skills/   可独立安装的十个 Skill
bin/      npm 安装器与中立校验器
test/     Node.js 结构、安装和校验测试
evals/    可独立执行的行为评测案例
site/     GitHub Pages 使用网站
assets/   仓库级品牌资源

总入口为 SKILL.md，独立能力的方法维护在 skills/*/SKILL.md。总入口内的 references/ 保留为仅安装总入口时的基础方法。行为回归场景见 evals/scenarios.md。可使用 skill-creator 自带的 quick_validate.py 分别校验 skills/ 下的十个目录；结构检查不等于模型行为和游戏运行验证。

许可证沿用仓库的 Apache-2.0。

网站与文案维护

网站提供中文、英文和日文。语言链接会保留当前章节；每个语言版本都有独立 URL，刷新或分享链接时仍是所选语言。

修改 site/locales/ 中的对应文案后，运行 npm run build:site 生成三个静态页面，再运行 npm test。布局共用 site/build.mjs 和 CSS；页面正文不依赖 JavaScript。提交时一起提交生成的 HTML，测试会检查它们是否与文案一致。

Skill 的写作原则是先说明玩家遇到什么、要做什么、做完改变什么，再展开条件和制作细节。具体写法见设计表达与示例。