mcpField
G
game-improvement-loop

game-improvement-loop

github.com/gil-1开发059 次安装10 周前更新
代码仓库

关于 game-improvement-loop

game-improvement-loop 是通过证据和试玩迭代改进游戏的技能,面向使用 Agent 开展游戏开发的团队。它要求先确认改进方向,再实施、按时试玩并记录玩家体验证据。

主要功能

  1. 01编写规格或代码前先确认方向
  2. 02按顺序开展改进周期
  3. 03根据交付证据选择试玩目标
  4. 04记录证据与周期结论
  5. 05提供子 Agent 协作指引

适用场景

  1. 01改进游戏面向玩家的行为
  2. 02在目标运行环境中测试改动
  3. 03将试玩发现带入下一周期

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/gil-1/skills --skill game-improvement-loop

安装后在 Claude Code 中输入/game-improvement-loop确认已加载。

详细介绍

游戏改进循环

通过简短的证据循环改进这款游戏。以玩家体验为核心,并根据游戏类型、平台、操控方式和设计承诺调整循环。

默认设置

  • 循环次数:3 次,除非用户另有说明。
  • 游玩测试:每个循环 30 分钟,除非用户另有说明。
  • 日志:.scratch/game-improvement-loop/<YYYY-MM-DD>-<goal-slug>/cycle-N.md。

除非用户同意,否则不要缩短用户要求的或默认的游玩测试。如果无法进行完整的游玩测试,请将该循环标记为未完成。

启动关卡

编写 PRD 或代码之前:

  1. 阅读与玩家可见行为相关的本地规则、文档、过往游玩测试、工单/PRD 和代码路径。
  2. 仅在有助于实现用户要求的目标时,才研究外部参考资料。
  3. 返回简洁的方向概要:
    • 对玩家的承诺
    • 要改进的行为
    • 建议方向及主要备选方案
    • 可能涉及的数据/状态需求
    • 主要玩家角色
    • 可观察的游玩测试迹象
    • 循环次数和游玩测试时长
  4. 等待用户确认。

获得确认后,除非遇到阻碍或方向变得不可行,否则继续完成所有循环。

循环

  1. 明确假设:承诺、设计押注、可观察迹象。
  2. 调研:代码、文档、过往游玩测试、有用的外部来源。
  3. 使用 to-spec 编写规格:假设、玩家角色、体验、非目标、验收标准、测试/游玩测试计划。
  4. 实施本轮循环。如果规格已指向可直接实施的工单,则使用 handle-tickets,并记录其 PR、分支、检查项、阻碍因素和 Codex 结果。否则使用 implement 开展聚焦于工单规模的工作,然后在存在 PR 时运行 review-fix 和 codex-pr-review。保持切片纵向完整且可游玩。
  5. 根据交付证据选择游玩测试目标:交付工作树、预览 URL、已合并的默认分支,或因等待合并而受阻的目标。在目标运行环境中按要求时长进行游玩测试。条件允许时,优先使用干净会话、有代表性的视口/设备,以及现有自动化测试框架。
  6. 记录证据:方法、运行环境/构建版本/URL、视口/设备、会话 ID、开始/结束时间、时长、输入数量、对话记录/日志/截图路径、状态污染风险,以及至少 5 个与玩家体验相关的时刻。
  7. 给出判定:validated、mixed、invalidated 或 incomplete。
  8. 将影响最大的不足作为下一轮循环的种子。

子 Agent

仅当子 Agent 能显著助力工作,且任务可以清晰拆分时才使用。循环需按顺序进行,因为每轮循环都会为下一轮提供种子。

在单个循环内并行处理互相独立的工作:代码库调研、设计参考资料、测试/工具检查、素材审查,或涉及互不重叠文件的有限范围实施工作。

工作者任务说明必须包含方向、循环编号、玩家角色、日志路径、工单/PRD 预期、可能涉及的模块、验证命令、游玩测试时长、工作树有未提交更改时的警告,以及必要的交接内容。

循环日志

# Cycle N: <goal>

## Approved Direction
## Persona
## Hypothesis
## Research
## PRD
## Implementation
## Verification
## Playtest Evidence
## Observations
## Verdict
## Next Seed
## Blockers Or Fallbacks

结束

总结各循环、PRD/工单、PR、工作树或预览目标、检查项、游玩测试证据、判定、阻碍因素,以及下一项最佳改进。若有任何循环未完成,请明确说明。

评论

支持 Markdown