前言¶
《七日杀》（7 Days to Die）的 Mod 大多靠 XML 补丁改 buffs.xml、items.xml 等配置。原版词条多、XPath 写法细，Buff 的 passive_effect、triggered_effect 又必须和 Data\Config 里已有定义对齐。单靠记忆或通用编程助手，很容易写出原版不存在的标签或枚举，进游戏才在日志里报错。
下面介绍 SkillHub 上的 7DaysToDieSkill（@user_10330f97/7daytodie）。它把「先读玩家本机安装目录、再查原版、只写 Modlet」写进 Agent 技能说明，适合已经会用 Cursor、Claude Code 等带 Skills 的客户端、又要稳定产出 XML Mod 的开发者。
这是什么¶
7DaysToDieSkill 是一份面向 Agent 的《七日杀》XML Mod 制作技能文档（通用 SKILL.md 格式），版本 1.0.0，来源为 SkillHub community，分类 life-service，坐标 @user_10330f97/7daytodie。SkillHub 页面标注作者为 Niko妮可（发布者 ID：user_10330f97）。标签 requires_api_key=false，安装后不需要额外 API Key。
它解决的核心问题是：在对话里做 Buff、物品、配方等 Mod 时，强制 Agent 从当前玩家的 $GameRoot（游戏根目录）读取 Data\Config 与 Localization.txt，禁止凭空发明 XML 词条，并默认只往 Mods\你的Mod名\Config 写 Modlet，而不是改原版文件。
核心功能¶
以下能力均来自技能包内 SKILL.md，安装后由 Agent 按文档执行。
原版文件定位¶
- 用
$GameRoot表示游戏根目录，从工作区、用户提供路径或 Steam 库确认，不写死盘符。 - 校验目录是否有效：检查
Data\Config与7DaysToDie_Data\Managed是否存在。 - 列出常用原版 XML：
buffs.xml、items.xml、blocks.xml、recipes.xml、loot.xml、progression.xml、entityclasses.xml、entitygroups.xml、traders.xml、Localization.txt。 - 提供 PowerShell 示例：在
Data\Config\*.xml中搜索passive_effect、trigger、ModifyCVar等是否出现过。
XML 制作硬性规范¶
- 禁止自创词条：标签名、属性名、枚举、
action、trigger、requirement、passive_effect name等须在原版 XML 中先查到。 - 工作流：需求 → 定位原版文件 → 搜索并复制写法 → 只改必要数值 → 写入 Modlet → 检查 XPath 与格式。
- 不直接修改
Data\Config下原版文件。
Buff 系统开发规范¶
- 以
$GameRoot\Data\Config\buffs.xml及其中注释为权威来源。 - 规范
effect_group、passive_effect、triggered_effect、requirement的写法，并附带搜索命令示例。
Modlet 标准结构¶
- 推荐目录：
ModInfo.xml+Config\（buffs.xml、items.xml等）。 - 提供
ModInfo.xml模板与 XPath 补丁示例（append、set等），并强调模板中的每个词条仍须在原版中确认。
本地化¶
- 原版路径：
$GameRoot\Data\Config\Localization.txt（CSV 表头与列顺序固定）。 - Modlet 侧在
Config\Localization.txt补充与name_key、description_key等一致的翻译行，不直接改原版翻译文件。
原版 DLL 与最佳实践¶
- 客户端托管程序集：
$GameRoot\7DaysToDie_Data\Managed（如Assembly-CSharp.dll）。 - 专用服务器（若存在）：
$GameRoot\7DaysToDieServer_Data\Managed。 - 说明 ILSpy、dnSpyEx、dotPeek 等只读反编译原则，并给出搜索优先级、交付前检查清单。
安装与启用¶
SkillHub 抓取资料显示：评分 100000，下载 851 次（页面数据会变动，以 SkillHub 为准）。
1、安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可按 SkillHub 安装说明 执行完整安装或仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装 7DaysToDieSkill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
skillhub install 7daytodie --namespace user_10330f97 --dir ~/.cursor/skills/
也可将下面提示词发给 Agent，让其按官方安装文档处理：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_10330f97/7daytodie`。
常见 skills 目录（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装或更新 skills 后，按你所用客户端的要求重启或刷新 Agent，使技能生效。
典型用法¶
技能本身不包含独立可执行脚本，典型用法是：在对话中描述 Mod 需求，并提供或确认 $GameRoot，由 Agent 读取本机 Data\Config 后输出 Modlet。
示例对话方向（需你本机确有对应安装目录）：
- 说明目标，例如：「给某原版 Buff 追加
RunSpeed的base_add，持续 10 秒。」 - 提供游戏根目录，或让 Agent 从当前工作区 / Steam 库解析
$GameRoot。 - Agent 按技能要求先
Select-String搜索buffs.xml中是否已有RunSpeed、onSelfBuffStart等，再生成Mods\ExampleMod\Config\buffs.xml的 XPath 补丁与ModInfo.xml。 - 若涉及显示名，同步生成
Config\Localization.txt中与 key 一致的 CSV 行。
技能文档中的 Modlet 补丁骨架如下（实际 name 与数值须以你查到的原版为准）：
<?xml version="1.0" encoding="UTF-8"?>
<configs>
<append xpath="/buffs">
<buff name="exampleBuff">
<stack_type value="ignore"/>
<duration value="10"/>
<effect_group>
<passive_effect name="RunSpeed" operation="base_add" value="0.1"/>
</effect_group>
</buff>
</append>
</configs>
适用场景与注意¶
适合谁
- 用 AI Agent 写《七日杀》XML Modlet，希望减少「自创词条」和误改原版配置。
- 需要在 Buff、物品、配方、本地化等多文件联动时，有一套固定检索与交付检查清单。
限制与注意
- 技能约束 Agent 行为，不能替代你在本机安装游戏、把 Mod 放进
Mods并自行进游戏或看服务器日志验证。 - 文档中的 PowerShell 示例面向 Windows 常见安装路径；Linux 上若通过 Steam 运行，仍需你确认
$GameRoot与路径分隔方式是否与示例一致。 - 涉及 DLL 反编译时，技能要求只读分析；复杂逻辑若 XML 无法表达，需你自行评估是否做 C# Mod，技能默认优先 XML。
- SkillHub 统计中的「安装」次数可能与各客户端本地安装不同步，以你是否把包装进 Agent skills 目录为准。
结尾¶
7DaysToDieSkill 把《七日杀》Mod 开发里最容易出错的环节——对照原版 Config、只写 Modlet、本地化与 Buff 规范——固化成 Agent 技能说明，适合和 SkillHub 分发流程一起用。无需 API Key，装好即可在支持 Skills 的客户端里启用。
- SkillHub 页面：https://www.skillhub.cn/skills/user_10330f97/7daytodie
- API 坐标页：https://api.skillhub.cn/user_10330f97/7daytodie
