用途：bmad-update 用于更新项目本地 BMAD 安装、处理 CIS 缺少模块定义（src/module.yaml）导致的安装失败，以及在项目获得授权后清理已弃用的 BMAD 模块。这是 Hermes 配置本地的维护技能，不是上游 BMAD 命令，不适用于 Android 功能实现。
保护现有工作：先检查 Git 状态、_bmad/_config/manifest.yaml、已配置工具、自定义覆盖项和 npm dist-tags；除非另有要求，保留原发布通道。认证并 fetch origin，编辑前比较 HEAD 与 origin/main。仅对干净检出执行快进；脏检出应从 fetch 到的 origin/main 创建隔离 worktree，绝不 reset、stash、clean、pull 或覆盖现有工作。在 WSL 上，若 Linux Git 缺少凭据，可尝试已认证的 Windows Git/gh，并在权威检出中运行 Windows Git fetch；不要修改其他 Hermes 配置或应用/后端源码。不要用 uninstall --yes 做选择性移除，它会删除全部 BMAD 组件。
CIS 兼容缓解：若安装因 CIS main 缺少 src/module.yaml 失败，检查上游标签并确认所选标签含所需模块定义。测试过的回退是 BMAD 6.12.1-next.0 配 CIS v0.3.2（commit 97298b22fee1c7e482710d3a8414adb5cfccccd9），但不保证仍是最新。使用 --action update --pin cis=v0.3.2，不要用 quick-update——该安装器版本的 quick-update 仍会解析 main。保留已配置工具与其他模块，验证 manifest 记录 CIS 版本 v0.3.2 和 channel: pinned。测试调用（TARGET 替换为隔离检出）： npx --yes bmad-method@6.12.1-next.0 install --directory "$TARGET" --action update --pin cis=v0.3.2 --no-shims --yes 仅在确需删除弃用别名时使用 --no-shims。安装成功不等于自定义值被保留，需检查配置变更。
授权移除弃用项：仅在本项目被要求或授权时移除模块。保留名为 cis 的支持模块，其 npmPackage 为 bmad-creative-intelligence-suite，不得用子串匹配误删。移除精确名为 bmad-creative-intelligence-suite 的旧模块及其 _bmad/bmad-creative-intelligence-suite/ 目录；移除精确的 wds 模块注册与 _bmad/wds/ 目录。删除前从 _bmad/_config/skill-manifest.csv 按 module == wds 精确筛选 WDS 所属技能，只删这些项目本地技能目录，不含无关技能与 Hermes 记忆。移除 WDS 专属项目配置与代理注册，保留无关覆盖项，尤其是 CIS 列表型设置。保留 _bmad-output/、设计产物、项目历史、受支持的 bmad-ux 及应用/后端文件；不要抹除已编写产物中的历史引用。通过安装器以明确的模块集重新生成配置与目录，测试保留集为 --modules bmm,bmb,cis,tea,bmad-loop（core 隐式），应按实际安装调整，不要静默丢弃其他模块。
验证与交付：检查最终 diff 是否含无关变更与配置回归；阅读安装器警告，区分保留的旧组件与已完成的移除。存在时运行 python3 tests/validate_project.py 及可用的 BMAD 配置检查；如实报告结果与跳过项，缺少 Deno 不算通过 Deno 检查，源码级测试不是 Android 运行时/构建证据。报告准确 worktree、分支、版本、剩余警告及提交/推送状态；不要把变更合并进脏的权威检出。收到发布请求时，提交/推送前先验证并审查范围内变更，未解决的高严重缺陷阻止发布。仅技能请求可用 skill_manage 安装到当前 Hermes 配置并验证语法/发现，不要顺带发布无关的待提交改动。若工具审批超时，不要通过其他工具重试被阻止的操作，应如实说明未执行的验证。