前言¶

做 Roguelike、生存建造或开放世界原型时，关卡、地形和掉落往往不能全靠手摆。程序化生成（procedural generation）用紧凑规则和种子产出内容，但实现里很容易踩坑：全局随机数导致不可复现、噪声场相关、房间未连通却直接交给玩家。把噪声、种子 RNG、地牢布局、加权表等约定写进 Skill，可以让 AI Agent 按同一套纪律生成并校验，而不是每次即兴写一段「看起来像 procgen」的代码。

下面介绍 SkillHub 上的 Proceduralgen（坐标 @user_3c6cb52e/procedural-gen-sh-u2lq35），以及如何在本地安装并让 Agent 读取其中的流程与模式。

这是什么¶

Proceduralgen 是社区发布的 Agent Skill（版本 1.0.0，来源 community，发布者 user_3c6cb52e）。SkillHub 分类为 dev-programming；包内 SKILL.md 元数据标注分类为「游戏开发」，并声明适用于 Claude Code、Codex、Hermes Agent、OpenClaw、QClaw、WorkBuddy 等框架。

官方简介强调：帮助 AI Agent 高效完成 Proceduralgen 相关任务。包内正文进一步定位为：从紧凑规则与种子生成关卡、地形与掉落；核心是 确定性——同一种子应复现同一世界，便于调试与分享种子。技能覆盖噪声、种子 RNG、地牢布局、加权表等算法思路；Roguelike、生存建造等类型可在此基础上组合使用。

许可证为 Apache-2.0；homepage / repository 指向 GitHub 用户页 https://github.com/1991513ccie-png。SkillHub 页面显示作者为 Breeze。标签 requires_api_key=false，安装与使用不依赖额外 API Key。

核心功能¶

以下内容均来自已安装包中的 SKILL.md，为 Agent 提供的可执行指导，而非独立运行时库。

适用与边界¶

• 适合：生成地图、地牢、地形高度图、物品掉落等不宜手搓的内容；需要 由种子可复现 的结果（调试、每日挑战、可分享世界）；按权重随机（掉落稀有度、生成表）。
• 不适合：在引擎里把结果「画」到瓦片层——应配合 godot-tilemap 或 unity-tilemap-2d；在生成图上做 AI 寻路——用 game-ai；需要严格手调节奏的主线关卡——用 level-design（与 procgen 互补）。

核心工作流（五步）¶

1. 统一随机源：创建单一种子 RNG 实例并贯穿传递，生成代码中不使用全局/静态随机。
2. 按内容选技法：连续地形/高度图用噪声；离散房间走廊用空间划分或基于 agent 的雕刻；带稀有度的结果用加权表。
3. 先写入纯数据结构：生成阶段只填充 int[][] 或字典等，与渲染解耦，再由单独 pass 绘制。
4. 交付前校验：可达性、出生点安全、出口路径等；失败则拒绝或修复，不把坏图交给玩家。
5. 固定种子调参：单种子观察参数影响，再批量扫种子看分布而非只看一张「幸运图」。

文档中的模式示例¶

技能内嵌可复现的代码片段，供 Agent 改写进项目：

• 种子 RNG（Python random.Random(seed)；并说明 Godot RandomNumberGenerator、Unity System.Random / InitState 等等价做法）。
• 分形噪声 fBm：多 octave 叠加、lacunarity/gain、归一化与 pow 重分布塑形。
• 加权掉落表：按权重累计抽样；说明权重不必加和为 100，并提及 pity/袋子系统（正文指向 references/dungeon-generation.md）。
• 房间+走廊地牢草图：非重叠房间放置、L 形走廊连接；完整 BSP、连通性检查等写在引用文档中。

常见陷阱清单¶

技能明确列出：全局 RNG、相关噪声场、octave 未归一化、未做连通性检查、无界放置死循环、生成链路混入帧时间等非确定输入等。

引用与关联技能¶

正文提到 references/noise.md、references/dungeon-generation.md 及 godot-tilemap、unity-tilemap-2d、game-ai、level-design、roguelike、survival-crafting 等关联技能名。当前 SkillHub 下载包内仅含 SKILL.md 与 _meta.json，未包含上述 references/ 目录；若 Agent 需要细节，需自行补充资料或向发布者确认完整包内容。

安装与启用¶

SkillHub 页面给出的安装提示为：根据 SkillHub 安装说明 安装坐标 @user_3c6cb52e/procedural-gen-sh-u2lq35。

1. 安装 SkillHub CLI（若尚未安装）¶

command -v skillhub && skillhub --version

未安装时可执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅 CLI：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2. 安装 Proceduralgen¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。

skillhub install procedural-gen-sh-u2lq35 --namespace user_3c6cb52e --dir <你的 Agent skills 目录>

常用路径示例（来自官方安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下 .agents/skills/

也可先搜索确认坐标：

skillhub search procedural-gen

3. 让 Agent 加载技能¶

将 Skill 目录放入对应路径后，按你所用客户端的规则启用 Skills（多数环境需重启或刷新技能列表）。之后在与生成地图、地形、掉落或种子复现相关的任务中，Agent 应优先遵循 SKILL.md 中的工作流与模式，而不是临时编造 procgen 片段。

典型用法¶

下列用法与官方页面及包内文档一致，可在对话中直接复现。

方式一：页面提示词（交给 AI 安装）

向 Agent 发送：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_3c6cb52e/procedural-gen-sh-u2lq35`。

方式二：本地 CLI 安装后下达生成任务

安装完成后，用自然语言描述需求即可，例如：「用固定种子生成可复现的 2D 地牢网格，先只做数据层并做 spawn 到出口的 flood-fill 连通性检查」。Agent 应按技能中的五步流程选用噪声/房间/加权表模式，并避免全局 RNG。

方式三：对照内嵌模式改语言或引擎

若项目使用 Godot 或 Unity，可要求 Agent 将 SKILL.md 中的 Python 示例映射到文中给出的引擎 API（如 RandomNumberGenerator、System.Random、Perlin/FastNoiseLite 等），并坚持「单种子实例贯穿传递」。

适用场景与注意¶

适合谁

• 用 AI 辅助游戏或工具原型、需要 procgen 纪律的团队或个人开发者。
• 希望 Agent 在 Roguelike、生存建造、程序化关卡/loot 等任务上输出可复现、可校验方案的场景。

平台与数据

• SkillHub 统计（抓取资料）：评分 100000，下载 1167 次，安装计数 0（以页面统计为准，仅反映商店侧数据）。
• 无需 API Key；适合离线阅读 SKILL.md 指导编码，实际噪声库仍依赖你项目选用的第三方实现（文档建议使用 FastNoiseLite、opensimplex、Unity 数学库等，而非自写梯度噪声）。

限制

• 商店简介与正文较简略处，以包内 SKILL.md 为准；引用 markdown 若未随包分发，扩展章节需自行补齐。
• 技能指导「生成与校验」，不负责引擎瓦片绘制或游戏 AI 寻路，需按文档切换到对应技能。
• api.skillhub.cn 上对技能元数据的直接 HTTP 访问可能返回 405，日常以 SkillHub 页面与 skillhub install 为准。

结尾¶

Proceduralgen 把程序化生成里最关键的一条线——种子确定性、数据结构先于渲染、生成后校验——以及噪声、fBm、加权表、房间走廊等模式写进标准 SKILL.md，方便在 Cursor、Codex、Claude Code 等环境中统一 Agent 行为。若你正在做可分享种子或批量关卡/loot 的工具链，可以按上文命令装入本地 skills 目录再开任务。

• SkillHub 页面：https://www.skillhub.cn/skills/user_3c6cb52e/procedural-gen-sh-u2lq35
• API 坐标页：https://api.skillhub.cn/user_3c6cb52e/procedural-gen-sh-u2lq35
• 安装说明：https://skillhub.cn/install/skillhub.md