关于 local-build-reminder
面向本地 OMC fork 开发者的 Claude Code 技能，会提醒 TypeScript 修改后重新构建 JavaScript，并说明哪些文件需要构建。
主要功能
- 01识别本地 OMC 开发情境
- 02在修改 TypeScript 后提醒构建
- 03列出需要构建的文件类型
- 04提供自动构建设置建议
适用场景
- 01在本地 OMC 中应用 TypeScript 修改
- 02排查修改未生效的原因
- 03修改后准备重启 Claude Code
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/local-build-reminder确认已加载。
详细介绍
本地构建提醒
OMC 分支开发的常驻提醒。 当 OMC 以本地模式运行时（HUD 显示带有 L 后缀的 [OMC#X.Y.ZL]），Claude Code 会从 dist/ 加载编译后的 JavaScript，而不是从 src/ 加载 TypeScript 源码。对 .ts 文件的编辑不会影响正在运行的插件，直到 npm run build 重新生成 dist/。
何时触发此技能
发生以下任一情况时，AI 都应提及此提醒：
- 用户（或 AI 自己）刚刚编辑了此仓库中的
src/**/*.ts。 - 用户在编辑 TS 后询问“为什么我的更改不起作用？”／“我编辑了 X，但效果还是一样”。
- 用户准备重启 Claude Code，且工作树中有 TS 编辑，但尚未重新构建。
- 用户运行 OMC 命令，并期待与 TS 编辑相关的新行为。
该怎么说
用一句清晰的话提醒，然后给出确切命令。不要每轮都重复提醒——每轮 TS 编辑提醒一次就够了。例如：
提醒：你编辑了
src/...。重启 Claude Code 前请运行npm run build，否则dist/不会反映这些更改。
如果连续编辑了多个 TS 文件，只需在最后提醒一次。
何时不提醒
- 用户只编辑了
.mjs／.cjs／.md／.json——这些文件会直接从磁盘加载，无需构建。 - 用户当前的 Claude Code 会话并非在本地运行 OMC（HUD 中没有
L）。 - 后台已经在运行
tsc --watch／npm run dev:full——这些命令会在保存时自动重新构建。 - 用户刚刚提出了无关问题；不要生硬地在离题回复中加入提醒。
文件类型速查表
| 路径 | 重启后会应用编辑吗？ | 需要构建吗？ |
|---|---|---|
src/**/*.ts | 仅在构建后 | 是 |
templates/hooks/**/*.mjs | 是 | 否 |
scripts/**/*.mjs / *.cjs | 是 | 否 |
skills/**/SKILL.md | 是 | 否 |
agents/**/*.md | 是 | 否 |
commands/**/*.md | 是 | 否 |
.claude-plugin/plugin.json | 是（重启 Claude 时） | 否 |
docs/**/*.md | 仅外观 | 否 |
免手动操作开发的一键设置
如果用户频繁迭代，并且厌倦了记住构建，可以建议：
npm run dev:full
这会并行运行 tsc --watch 和所有桥接构建器——每次保存都会在一秒内触发重新构建，因此之后只需重启 Claude Code。
检测信号——AI 如何判断处于“本地模式”
HUD 中的 [OMC#X.Y.ZL] 后缀是可见提示。从程序角度看，检测逻辑位于 src/lib/version.ts::isRuntimePackageLocal()，以下任一情况都会触发：包根目录下存在 .git/、包根目录下存在 src/、通过符号链接／junction 到达该包，或任一祖先目录是符号链接／junction。
在 OMC 分支仓库内部运行时，AI 必然处于本地模式——始终适用此提醒。