随从部队设计师 - AI技能包

[size=6][b]Retinues Troop Designer[/b][/size]
[i]一套用于在 Retinues 中构建与重新平衡兵种树的 AI 提示词包。[/i]

[b]v1.1.0[/b] —— 自动检测你的游戏、你的模组和你的设置，然后询问你想要做什么。

[line]

[size=5][b]首先请阅读：这不是一个模组[/b][/size]

此压缩包中的任何内容都不会放入你的 [b]Modules[/b] 文件夹。这里没有任何东西会更改游戏。

这是一套给 [b]AI 编程助手[/b]（Cursor、Claude Code、GitHub Copilot、ChatGPT、Claude）的指令。它教会助手 Retinues 用于导入与导出的确切 XML 契约，使其能够正确地编辑你导出的兵种文件，而不是靠猜测。然后你在游戏内通过 Retinues 自带的 Library 页面重新导入该文件。

可以把它想象成一名翻译，在“我想要一条五阶库赛特弓骑兵兵种线”和一份有效的 Retinues XML 文件之间进行转换。

[line]

[size=5][b]1.1.0 中新增的内容[/b][/size]

[list]
[][b]启动时自动检测。[/b] 技能一经激活，助手就会从 [b]Documents\Retinues\[/b] 和 Retinues 的 [b]debug.log[/b] 启动块中盘点你的机器环境：Bannerlord 版本、Retinues 版本、每个已激活模组及其加载顺序（护甲包、大修、War Sails……）、你真实的 [b]settings.ini[/b]、现有的导出文件以及战役快照。它会显示一个简短的摘要，然后询问你想要做什么。[/]
[][b]你说了算。[/b] 你可以提供自己的设置、模组列表或路径，它们会覆盖检测结果。缺少文件系统访问权限永远不会构成阻碍——助手会标记这一缺口，并用你提供的内容继续工作。[/]
[][b]版本矩阵。[/b] Retinues 1.x 与 2.x、Bannerlord 1.2 / 1.3 / 1.4、有无 War Sails——均会被检测并处理。在 1.x 上，它会引导你（使用游戏内编辑器、迁移），而不是假装手动编辑一个由模组自有的格式。[/]
[][b]更丰富的格式覆盖。[/b] [b]<Entry>[/b] CDATA 负载、[b]WFaction[/b] 包装器，以及模组本身使用的确切 [b]settings.ini[/b] / [b]debug.log[/b] 解析规则。[/]
[/list]

[line]

[size=5][b]为什么你需要它[/b][/size]

Retinues 可以将你的兵种导出为 XML 并重新导入。这是一扇强大的门，但也很容易一头撞上去。手动编辑该文件，或将其交给一个从未见过该格式的 AI，会以如下方式失败，而且[b]完全不会给你任何错误信息[/b]：

[list]
[]拼错的属性名会被静默跳过。你的改动根本不会发生。[/]
[]版本属性不恰好是 [b]1.0[/b] 的负载会被整体丢弃，且没有任何警告。[/]
[]在你的模组集合中不存在的物品 ID 会留空该装备槽位。[/]
[]像扈从、民兵和商队这样的名册是[b]按位置[/b]匹配的，而不是按名称。重排它们，你就会悄无声息地改写错误的兵种。[/]
[]超过每阶预算的技能会在导入后被钳制，然后游戏内编辑器会拒绝再次提升它们。[/]
[]一棵树中出现两个根节点，或升级路径中出现循环，树就会被悄悄重塑。[/]
[/list]

这个包把所有内容都编码其中：阶级算术、每项技能上限、总技能预算、改变这些预算的信条加成、12 槽装备编码、坐骑阶级门槛、重量与价值限制，以及导入前要运行的一份完整验证清单。

它是通过阅读模组源码写成的，而不是靠维基猜测。

[line]

[size=5][b]它强制执行的习性[/b][/size]

[b]1. 先检测，后询问。[/b] 在有文件系统访问权限时，助手会先查看你的机器，再询问你。只有在摘要之后才会询问信条（战役状态）和设计意图。

[b]2. 它始终基于真实的导出文件工作。[/b] 助手被指示拒绝从零开始凭空编造 Retinues 文件。你在游戏内导出，把文件交给它，它编辑那个文件。仅此一点就能消除大多数格式错误。

[b]3. 它读取你的设置，而非默认值。[/b] 你的限制位于 [b]Documents\Retinues\settings.ini[/b]，而预设会一次性移动其中若干项。助手会读取你的文件，并依据你的数值进行验证。它还会询问你已解锁哪些信条，因为 Iron Discipline、Steadfast Soldiers 和 Masters at Arms 会提高技能上限——而一个忽略它们的验证器会把一棵完全合法的兵种树标记为损坏。

[b]4. 它扫描真正处于激活状态的模组。[/b] Retinues 启动日志是活动加载顺序（包括模组管理器启动）的首要真相来源。[b]LauncherData.xml[/b] 和 [b]Modules\[/b] 文件夹是交叉校验。一个文件夹只能证明某模组已安装，不能证明其已激活。每个模组物品都会报告其来源模组。

[line]

[size=5][b]压缩包中包含什么[/b][/size]

[list]
[][b]cursor-skill/[/b] —— 一个 Cursor Agent Skill。分为一个简短核心加五个参考文件（格式、导入语义、约束、模组发现、[b]环境自动检测[/b]），因此只有核心会占用你的上下文窗口，细节按需读取。当有 Retinues 导出文件打开时，它会自行激活。[/]
[][b]system-prompt/[/b] —— 同样的知识，整合为一个文件，你可以粘贴到任何地方：Claude Code、Copilot、ChatGPT、Claude，或任何聊天窗口。[/]
[][b]README.md[/b] —— 按工具划分的安装与使用方法。[/]
[/list]

选一个即可。它们覆盖的内容相同。

[line]

[size=5][b]需求[/b][/size]

[list]
[]推荐使用 [b]Retinues 2.x[/b] 以获得完整的 XML 编辑能力，并需要一个进行中的战役。[/]
[]一个接受系统提示词的 AI 助手。由于技能格式和文件系统访问，Cursor 能获得最佳体验。[/]
[/list]

要检查你的版本，请打开你的一个导出文件：对于 2.x，根元素必须是 [b]<Retinues v="1" ...>[/b]。如果是 [b]<RetinuesTroops>[/b] 或 [b]<Troops>[/b]，则你是 1.x——该包会检测到这一点并引导你，而不是写入一个由模组自有的格式。

[line]

[size=5][b]安装[/b][/size]

[b]Cursor[/b] —— 将 [b]retinues-troop-trees[/b] 文件夹复制到以下任一位置：
[list]
[][b]%USERPROFILE%\.cursor\skills\[/b] 使其在每个项目中可用[/]
[][b]<your project>\.cursor\skills\[/b] 使其随仓库共享[/]
[/list]
就这样。无需配置。

[b]Claude Code[/b] —— 将系统提示词文件的内容复制到你的项目的 [b]CLAUDE.md[/b] 中。

[b]GitHub Copilot[/b] —— 将其保存为 [b].github/copilot-instructions.md[/b]。

[b]ChatGPT、Claude 或任何聊天[/b] —— 将其作为自定义指令或项目指令粘贴，或直接作为你的第一条消息粘贴，然后附上你的导出文件。

[line]

[size=5][b]如何使用[/b][/size]

[list=1]
[]调用该技能（或粘贴系统提示词）。在有文件系统访问权限时，它会[b]自动检测[/b]你的环境，并在询问你想要什么之前显示一个简短摘要。[/]
[]在游戏内，在世界地图上，打开 [b]Troop Editor[/b]（默认热键 [b]R[/b]），进入 [b]Library[/b]，然后导出你的阵营。文件会落在 [b]Documents\Retinues\Exports\[/b]。如果你已有导出文件，可跳过此步。[/]
[][b]备份你的存档[/b]，并保留该导出文件的一份未改动副本。[/]
[]告诉助手你想要什么。例如：[i]“为我构建一条用于基础名册的五阶库赛特弓骑兵兵种线，并相应重做我的扈从。我的信条是 Iron Discipline 和 Masters at Arms。”[/i][/]
[]在它写入任何 XML [b]之前[/b]审阅它提出的计划，然后阅读它的验证表。[/]
[]将编辑后的文件放回 [b]Documents\Retinues\Exports\[/b]，并从 Library 页面导入它。[/]
[/list]

定居点新兵和志愿者可能需要一到两个游戏日才能反映新的定义。这是正常的。

[line]

[size=5][b]导入能做什么与不能做什么[/b][/size]

在你规划一棵树之前值得了解，因为该模组的导入并非一张白纸。

[b]可以：[/b]
[list]
[]重新平衡现有兵种的技能、装备和外观[/]
[]为基础和精英树增加深度或新分支——缺失的节点会为你克隆[/]
[]重塑一棵树，每个兵种最多四条升级路径[/]
[]重命名兵种[/]
[/list]

[b]不可以：[/b]
[list]
[]添加全新的扈从、民兵或商队条目。请先在游戏内解锁，然后再次导出[/]
[]更改哪个兵种是阵营根节点[/]
[/list]

该包会教导助手告诉你需要哪个游戏内步骤，而不是生成一个会静默失效的文件。

[line]

[size=5][b]安全[/b][/size]

导入会[b]覆盖[/b]现有的兵种定义。每次都要备份你的存档。保留你的原始导出文件。

如果结果看起来不对，[b]Documents\Retinues\Logs\debug.log[/b] 会记录未解析的物品 ID 和被跳过的节点——并且每次启动时，都会记录你完整的游戏 / 模组 / 设置摘要。该包包含一张症状到原因对照表，你的助手可以据此进行诊断。

[line]

[size=5][b]鸣谢与许可[/b][/size]

[b]Retinues[/b] 模组由 [b]bolaft[/b] 制作。这是一份非官方配套资源，与模组作者无隶属关系。请不要把 Retinues 的 bug 报告给我，也不要向 bolaft 报告提示词包的问题。

提示词包由 [b]SunHeisty[/b] 制作，以 MIT 许可证发布。使用它、修改它、将其并入你自己的指南或翻译中。署名表示感谢，但非强制要求。