返回全部 Skills

local-build-reminder

开发工具

提醒用户:在从本地分支运行 OMC 并编辑 TypeScript 后,需要重建 OMC。当 AI 检测到它(或用户)刚刚在 OMC 开发安装中更改了 src/**/*.ts 文件时,会自动触发此提醒。

1

下载量

AI SkillHub 能力展示图

安装方式

命令行安装

在项目根目录执行以下命令,完成 Skill 安装。

npx bzskills add Yeachan-Heo/oh-my-claudecode --skill local-build-reminder

skill.md

name: local-build-reminder
description: 提醒用户:在从本地分支运行 OMC 并编辑 TypeScript 后,需要重建 OMC。当 AI 检测到它(或用户)刚刚在 OMC 开发安装中更改了 src/**/*.ts 文件时,会自动触发此提醒。
level: 1

本地构建提醒

OMC 分支开发的常驻提醒。 当 OMC 以本地模式运行(HUD 显示 [OMC#X.Y.ZL] 带有 L 后缀)时,Claude Code 加载的是 dist/ 下的编译后 JavaScript——而非 src/ 下的 TypeScript 源文件。对 .ts 文件的编辑在 npm run build 重新生成 dist/ 之前不会影响运行中的插件。

何时调用此技能

AI 应在 以下任一情况 发生时提及此提醒:

  1. 用户(或 AI 本身)刚刚在此仓库中编辑了 src/**/*.ts
  2. 用户询问"为什么我的修改没有生效?"/"我编辑了 X,但表现还是相同"——这发生在 TS 编辑之后。
  3. 用户将要重启 Claude Code,而工作树中有未经构建的 TS 编辑。
  4. 用户运行了一个 OMC 命令,并期望其行为与某个 TS 编辑相关联。

如何表述

先给出一个清晰的句子,然后紧跟确切的命令。不需要在每一轮对话中都重复提醒——每个"TS 编辑回合"提醒一次即可。示例:

提醒一下:你刚编辑了 src/...。请在重启 Claude Code 之前运行 npm run build——否则 dist/ 不会反映你的修改。

如果连续编辑了多个 TS 文件,只需在最后提醒一次即可。

何时不要提醒

  • 用户只编辑了 .mjs / .cjs / .md / .json——这些文件直接从磁盘加载,无需构建。
  • 用户正在使用一个未在本地运行 OMC 的 Claude Code 会话(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/、包通过符号链接/联接点访问、或任意祖先为符号链接/联接点。

当在 OMC 分支仓库自身内部运行时,AI 默认处于本地模式——此提醒始终适用。