game

为英雄创作「觉醒技能」时使用——通过觉醒石（item_awaken_stone，抽奖发放）替换/插入/新增英雄技能槽的强化版技能。处理范围包括 src/vscripts/modules/awaken/ 的配置表与替换算法、game/scripts/npc/npc_abilities_custom_awaken.txt 的觉醒技能 KV、对应 Lua/TSTL 实现、game/scripts/npc/npc_abilities_override.txt 的关联差分，以及 addon_schinese.txt/addon_english.txt 的文案。当用户说「加一个觉醒技能」「给 XX 做觉醒」「觉醒后 XX 强化」「觉醒技能等级关联/自动触发/加魔免」等时触发。

本地化文件（addon_schinese/addon_english）格式与同步规范。用于新增/维护本地化键、对齐、注释、HTML 标签与变量占位符一致性检查。 Use when adding or modifying entries in addon_schinese.txt or addon_english.txt.

从零自制一个全新自定义物品时使用——BaseClass 为 item_datadriven 或 item_lua 的非克隆物品（含多材料合成神器）。核心是「item_datadriven 整体 KV 化 vs item_lua + item_apply_modifiers 共享 hub」选型，以及合成配方/ID 分配惯例。区别于 clone-item（继承原版数值倍率克隆）。当用户说「做一个新物品」「合成神器」「这个物品属性会不会卡顿」「item_lua 还是 item_datadriven」等时触发。

生成 Steam Workshop 中英文更新日志。支持手动、PR、Issue（含 checklist 进度）。 版本号：用户指定 > release PR 大版本 > Steam 递增补丁字母。 用户确认后可写回 open PR（UTF-8 无 BOM）。 **创建 PR 时必须调用本 skill 生成 Release Note 段，不要手写。** Use when creating a pull request to generate Steam Workshop release notes.

从零自制一个全新自定义技能时使用——BaseClass 为 ability_datadriven / ability_lua / TS @registerAbility 的非继承技能。核心是「DataDriven vs Lua vs TS」实现选型（含性能取舍）与通用技法库（被动 intrinsic modifier、autocast 自动触发、施法监听、special_bonus 关联、加魔免）。区别于 clone-ability（继承原版差分克隆）与 awaken-ability（觉醒石替换槽位）。当用户说「写一个新技能」「自制技能」「这个技能用 datadriven/lua/ts 怎么写」「纯属性加成技能」「自动触发/施法监听技法」等时触发。

基于 bot（英雄_BOT.csv）与玩家（英雄_玩家.csv）出装统计 CSV（列：物品,英雄,Average 时长_秒,胜率,事件数,Average 金钱）， 按装备在 src/vscripts/ai/build-item/item-tier-config.ts 的 canonical tier 过滤数据， 为 src/vscripts/ai/build-item/hero-build-config.ts / hero-build-config-template.ts 的候选池生成扩充建议： bot 数据优先、玩家数据补充、同英雄模板兜底，目标每个 tier 候选数至少 8 件（最佳区间 8~10，不超过 12）。 与用户确认后执行编辑并校验 tier 一致性。

为指定 Dota 物品编写 bot AI 使用规则（ItemSpec），让 bot 在合适时机自动使用该战斗物品。 原版物品、克隆物品统一在 src/vscripts/ai/item/specs/ 下登记一个文件（升级链 + 使用逻辑相同的 多个物品合并为一个文件）。读取物品 KV 判断 behavior/cast range，与用户确认条件后写入并注册。 区别于购买/出售决策（见 bot-item-build skill）和购买后立即消耗的永久消耗品（见 src/vscripts/ai/item/consume-item.ts，不走这套框架）。 适用场景：用户说"让 bot 会用 XX 物品"、"给 bot 写 YY 的战斗使用逻辑"等。

创建功能分支、commit、push 并发起 Pull Request 的完整工作流。当用户说"创建PR"、"create pr"、"提个PR"、"发 pull request"，或实现完成需要发起代码审查时触发。

把某个技能/物品加入"随机重触发"黑名单（蝴蝶效应、多重施法 Multicast）， 避免会导致机制冲突、崩溃或体验问题的技能被随机再次触发。 当用户说"XX 加入蝴蝶黑名单"「多重施法别选中 XX」「这个技能不该被蝴蝶/多重触发」等时触发。

为指定 Dota 技能编写 bot AI 施法规则（AbilitySpec），让 bot 在合适时机自动施放该技能。 无论是原版技能、自定义技能还是 lottery 抽到的技能，统一在 src/vscripts/ai/ability/specs/ 下登记一个文件。读取 docs/reference 中该技能的 KV 自动判断目标方向，与用户确认条件后写入并注册。 适用场景：用户说"让 bot 会用 XX 技能"、"给 bot 写 YY 的施法逻辑"等。

Dota 版本更新时，以 docs/reference 中官方技能 KV 为骨架维护 game/scripts/npc/npc_abilities_override.txt：仅写差分，引擎合并缺失键。 按 P1 删同值 → P2 差分与 MaxLevel 扩展 → P3 注释校验 的优先级逐技能处理。

Routes Dota 2 custom game documentation: prefer ModDota (community-maintained, searchable API indexes) for vscripts, game events, Panorama JS API, and Panorama events; fall back to Valve Developer Wiki when ModDota is insufficient (concepts, DataDriven KV depth, modifier Actions); use robincode.cn when checking what changed in a recent official Dota 2 update (API/engine diffs). Use when you need to look up a specific Dota 2 API, event name, modifier binding, or recent API change, or when the user asks where to find modding documentation.

Create or update a custom upgraded clone of a vanilla Dota item. Copies item KV from docs/reference items.txt into npc_items_clone.txt, creates recipe, boosts stats ~x2, and writes localization. Supports lookup by Chinese name or system name. Interactive menus for ambiguous decisions.

Create or fix a custom KV ability that inherits from a vanilla Dota ability (BaseClass = original ability name). Supports ability lookup by Chinese name or hero-ability format. Merges vanilla KV with override extras. Syncs keys on update. Handles innate and regular abilities. Interactive menus for ambiguous decisions.

在 Dota 自定义平衡中新增或替换英雄天赋（尤其是把通用天赋改为技能联动天赋）时使用。处理范围包括 game/scripts/npc/npc_abilities_override.txt 的天赋定义与技能挂接、game/scripts/npc/npc_heroes_custom.txt 的 Ability10-17 与 Bot.Build 档位联动、以及 game/resource/addon_schinese.txt 和 addon_english.txt 的天赋文案同步。

Capture-correction workflow: record valuable learnings from the current conversation into CLAUDE.md or the relevant SKILL.md so the same mistake never recurs. Reviews conversation for corrections, new conventions, and doc-reality mismatches; proposes targeted updates confirmed by user before writing. TRIGGER whenever the user corrects Claude's approach or rejects an action — signals like "不对", "不要这样", "应该是", "错了", "其实是", "no, do X instead", "that's wrong" — and the correction reflects a reusable convention rather than a one-off. Also use when a doc-vs-code discrepancy is found, or the user supplies a convention Claude could not infer.

校验 game/scripts/npc/npc_heroes_custom.txt 的 Bot.Build： 天赋名须逐字存在于合并后 Ability10-17 且档位正确（27=10-other / 28=15-other / 29=20-other / 30=25-other）； 技能名须在合并后 Ability 槽位内；加点次数 ≤ MaxLevel；大招间隔 ≥ 6（典型 6/12/18/24）； 仅 17/19/21/22 留空。 Use when a hero's Bot.Build in npc_heroes_custom.txt is modified, or after update-abilities-override completes for a hero.

基于主动/被动技能统计 CSV（列：技能,等级维度,胜率,事件数），复盘抽奖池 Tier 分布。 读取 src/vscripts/modules/lottery/lottery-abilities.ts 当前池形状， 对照目标占比（T5 4–5% / T4 13–15% / T3 21–23% / T2 33–36% / T1 24–27%）， 结合胜率与事件数为每条技能生成调整建议（升/降档、加强/削弱、移除、询问用户）， 写入 plan 并与用户确认后执行池结构调整。数值加强/削弱类交给 update-abilities-override 接手。

Updates only inline // comments in KV files using Dota 2 vanilla AbilityValues from docs/reference/<latest-version>, without changing quoted gameplay numbers. Use when the user invokes /comment, asks to sync reference comments, or to refresh 7.xx baseline annotations after specifying scope (files, item or ability names).

Windy10v10AI 的 VScripts API 调用规范与工作流（ApiClient、重试机制、Analytics 事件采集与发送模式）。