botmux 3.16.0 → 3.17.0

package/dist/skills/customization-bundle.js

@@ -0,0 +1,214 @@
+import { SUPPORTED_LOCALES } from '../i18n/types.js';
+import { readCustomizationState, readSkillOverrideBody, replaceState, MAX_SKILL_BODY_BYTES, MAX_PROMPT_OVERRIDE_BYTES, } from '../services/customization-store.js';
+import { validateFragmentOverride } from './prompt-fragments.js';
+export const BUNDLE_KIND = 'botmux-customization-bundle';
+export const BUNDLE_SCHEMA_VERSION = 1;
+// ─── Export ──────────────────────────────────────────────────────────────────
+/** Build a portable bundle from the current on-disk customization state.
+ *  Skill bodies are inlined by reading their .md files. */
+export function exportBundle(opts = {}) {
+    const state = readCustomizationState();
+    const bundle = {
+        schemaVersion: BUNDLE_SCHEMA_VERSION,
+        kind: BUNDLE_KIND,
+    };
+    if (opts.name)
+        bundle.name = opts.name;
+    if (opts.createdAt)
+        bundle.createdAt = opts.createdAt;
+    if (state.promptOverrides && Object.keys(state.promptOverrides).length) {
+        bundle.promptOverrides = state.promptOverrides;
+    }
+    if (state.conditionalLines && Object.keys(state.conditionalLines).length) {
+        bundle.conditionalLines = state.conditionalLines;
+    }
+    if (state.builtinSkills && Object.keys(state.builtinSkills).length) {
+        const skills = {};
+        for (const [name, ov] of Object.entries(state.builtinSkills)) {
+            const entry = {};
+            if (ov.body !== undefined) {
+                const body = readSkillOverrideBody(name);
+                if (typeof body === 'string')
+                    entry.body = body; // inline the full text
+            }
+            if (ov.disabled)
+                entry.disabled = true;
+            if (entry.body !== undefined || entry.disabled)
+                skills[name] = entry;
+        }
+        if (Object.keys(skills).length)
+            bundle.builtinSkills = skills;
+    }
+    return bundle;
+}
+// ─── Parse / validate ────────────────────────────────────────────────────────
+export class BundleError extends Error {
+}
+/** Parse + validate raw JSON text into a CustomizationBundle. Throws
+ *  BundleError with a human message on any structural problem. */
+export function parseBundle(rawJson) {
+    let parsed;
+    try {
+        parsed = JSON.parse(rawJson);
+    }
+    catch {
+        throw new BundleError('不是合法的 JSON');
+    }
+    if (!parsed || typeof parsed !== 'object')
+        throw new BundleError('bundle 必须是一个 JSON 对象');
+    const r = parsed;
+    if (r.kind !== BUNDLE_KIND)
+        throw new BundleError(`kind 必须是 "${BUNDLE_KIND}"`);
+    if (r.schemaVersion !== BUNDLE_SCHEMA_VERSION)
+        throw new BundleError(`不支持的 schemaVersion（期望 ${BUNDLE_SCHEMA_VERSION}）`);
+    const out = { schemaVersion: BUNDLE_SCHEMA_VERSION, kind: BUNDLE_KIND };
+    if (typeof r.name === 'string')
+        out.name = r.name.slice(0, 200);
+    if (typeof r.createdAt === 'string')
+        out.createdAt = r.createdAt;
+    if (r.promptOverrides && typeof r.promptOverrides === 'object') {
+        const po = {};
+        for (const [loc, map] of Object.entries(r.promptOverrides)) {
+            if (!SUPPORTED_LOCALES.includes(loc))
+                continue;
+            if (!map || typeof map !== 'object')
+                continue;
+            const clean = {};
+            for (const [k, v] of Object.entries(map)) {
+                if (typeof v !== 'string' || !k)
+                    continue;
+                if (Buffer.byteLength(v, 'utf-8') > MAX_PROMPT_OVERRIDE_BYTES) {
+                    throw new BundleError(`prompt 覆盖过大：${k} (${loc})`);
+                }
+                // Enforce placeholder contracts on import too, so a bundle can't smuggle
+                // in a broken {count}/{names} template.
+                const err = validateFragmentOverride(k, v);
+                if (err)
+                    throw new BundleError(`${k} (${loc})：${err}`);
+                clean[k] = v;
+            }
+            if (Object.keys(clean).length)
+                po[loc] = clean;
+        }
+        if (Object.keys(po).length)
+            out.promptOverrides = po;
+    }
+    if (r.conditionalLines && typeof r.conditionalLines === 'object') {
+        const cl = {};
+        for (const [k, v] of Object.entries(r.conditionalLines)) {
+            if (typeof v === 'boolean' && k)
+                cl[k] = v;
+        }
+        if (Object.keys(cl).length)
+            out.conditionalLines = cl;
+    }
+    if (r.builtinSkills && typeof r.builtinSkills === 'object') {
+        const bs = {};
+        for (const [name, ov] of Object.entries(r.builtinSkills)) {
+            if (!/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/.test(name))
+                throw new BundleError(`非法 skill 名：${name}`);
+            if (!ov || typeof ov !== 'object')
+                continue;
+            const o = ov;
+            const entry = {};
+            if (typeof o.body === 'string') {
+                if (Buffer.byteLength(o.body, 'utf-8') > MAX_SKILL_BODY_BYTES) {
+                    throw new BundleError(`skill 正文过大：${name}`);
+                }
+                entry.body = o.body;
+            }
+            if (o.disabled === true)
+                entry.disabled = true;
+            if (entry.body !== undefined || entry.disabled)
+                bs[name] = entry;
+        }
+        if (Object.keys(bs).length)
+            out.builtinSkills = bs;
+    }
+    return out;
+}
+// ─── Diff (confirm-before-apply preview) ─────────────────────────────────────
+function preview(s, n = 60) {
+    if (s === undefined)
+        return undefined;
+    const one = s.replace(/\s+/g, ' ').trim();
+    return one.length > n ? one.slice(0, n) + '…' : one;
+}
+/** Compute the diff a bundle import would produce against current state. Pure —
+ *  reads current state but writes nothing. */
+export function previewBundleImport(bundle) {
+    const current = readCustomizationState();
+    const diff = [];
+    // Prompt overrides
+    for (const loc of Object.keys(bundle.promptOverrides ?? {})) {
+        const incoming = bundle.promptOverrides[loc] ?? {};
+        for (const [key, val] of Object.entries(incoming)) {
+            const existing = current.promptOverrides?.[loc]?.[key];
+            const action = existing === undefined ? 'add' : existing === val ? 'unchanged' : 'replace';
+            diff.push({ kind: 'prompt', id: key, locale: loc, action, before: preview(existing), after: preview(val) });
+        }
+    }
+    // Conditional lines
+    for (const [key, val] of Object.entries(bundle.conditionalLines ?? {})) {
+        const existing = current.conditionalLines?.[key];
+        const action = existing === undefined ? 'add' : existing === val ? 'unchanged' : 'replace';
+        diff.push({ kind: 'conditional', id: key, action, before: existing === undefined ? undefined : String(existing), after: String(val) });
+    }
+    // Skills
+    for (const [name, ov] of Object.entries(bundle.builtinSkills ?? {})) {
+        const existing = current.builtinSkills?.[name];
+        if (ov.disabled && !ov.body) {
+            diff.push({ kind: 'skill', id: name, action: 'disable', after: '停用' });
+            continue;
+        }
+        const existingBody = existing?.body !== undefined ? readSkillOverrideBody(name) : undefined;
+        const action = existingBody === undefined ? 'add' : existingBody === ov.body ? 'unchanged' : 'replace';
+        diff.push({ kind: 'skill', id: name, action, before: preview(existingBody), after: preview(ov.body) });
+    }
+    const summary = {
+        adds: diff.filter((d) => d.action === 'add').length,
+        replaces: diff.filter((d) => d.action === 'replace').length,
+        disables: diff.filter((d) => d.action === 'disable').length,
+        unchanged: diff.filter((d) => d.action === 'unchanged').length,
+    };
+    return { bundle, diff, summary };
+}
+// ─── Apply ───────────────────────────────────────────────────────────────────
+/**
+ * Apply a validated bundle by REPLACING the current customization content with
+ * it (snapshotting first, so it's reversible). Returns the resulting state.
+ *
+ * "Replace" (not merge) is deliberate for P0: it makes import deterministic and
+ * the diff preview honest — what you see is exactly the resulting state. A merge
+ * mode can be layered on later if requested.
+ */
+export function applyBundle(bundle, label = 'import bundle') {
+    const next = { schemaVersion: 1 };
+    if (bundle.promptOverrides)
+        next.promptOverrides = bundle.promptOverrides;
+    if (bundle.conditionalLines)
+        next.conditionalLines = bundle.conditionalLines;
+    const skillBodies = {};
+    if (bundle.builtinSkills) {
+        const bs = {};
+        for (const [name, ov] of Object.entries(bundle.builtinSkills)) {
+            const entry = {};
+            if (typeof ov.body === 'string') {
+                entry.body = ov.body;
+                skillBodies[name] = ov.body;
+            }
+            if (ov.disabled)
+                entry.disabled = true;
+            if (entry.body !== undefined || entry.disabled)
+                bs[name] = entry;
+        }
+        if (Object.keys(bs).length)
+            next.builtinSkills = bs;
+    }
+    return replaceState(next, skillBodies, label);
+}
+/** Serialize a bundle to pretty JSON (with a trailing newline) for file output. */
+export function serializeBundle(bundle) {
+    return JSON.stringify(bundle, null, 2) + '\n';
+}
+//# sourceMappingURL=customization-bundle.js.map

package/dist/skills/customization-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customization-bundle.js","sourceRoot":"","sources":["../../src/skills/customization-bundle.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,EAEZ,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,MAAM,CAAC,MAAM,WAAW,GAAG,6BAA6B,CAAC;AACzD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAU,CAAC;AAmChD,gFAAgF;AAEhF;2DAC2D;AAC3D,MAAM,UAAU,YAAY,CAAC,OAA8C,EAAE;IAC3E,MAAM,KAAK,GAAG,sBAAsB,EAAE,CAAC;IACvC,MAAM,MAAM,GAAwB;QAClC,aAAa,EAAE,qBAAqB;QACpC,IAAI,EAAE,WAAW;KAClB,CAAC;IACF,IAAI,IAAI,CAAC,IAAI;QAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvC,IAAI,IAAI,CAAC,SAAS;QAAE,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAEtD,IAAI,KAAK,CAAC,eAAe,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,EAAE,CAAC;QACvE,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IACjD,CAAC;IACD,IAAI,KAAK,CAAC,gBAAgB,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,EAAE,CAAC;QACzE,MAAM,CAAC,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,CAAC;IACnD,CAAC;IACD,IAAI,KAAK,CAAC,aAAa,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,MAAM,EAAE,CAAC;QACnE,MAAM,MAAM,GAA0D,EAAE,CAAC;QACzE,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;YAC7D,MAAM,KAAK,GAA0C,EAAE,CAAC;YACxD,IAAI,EAAE,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC1B,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;gBACzC,IAAI,OAAO,IAAI,KAAK,QAAQ;oBAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,uBAAuB;YAC1E,CAAC;YACD,IAAI,EAAE,CAAC,QAAQ;gBAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;YACvC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ;gBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACvE,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM;YAAE,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC;IAChE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gFAAgF;AAEhF,MAAM,OAAO,WAAY,SAAQ,KAAK;CAAG;AAEzC;kEACkE;AAClE,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAAC,CAAC;IACrC,MAAM,CAAC;QAAC,MAAM,IAAI,WAAW,CAAC,YAAY,CAAC,CAAC;IAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,MAAM,IAAI,WAAW,CAAC,sBAAsB,CAAC,CAAC;IACzF,MAAM,CAAC,GAAG,MAAiC,CAAC;IAC5C,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW;QAAE,MAAM,IAAI,WAAW,CAAC,aAAa,WAAW,GAAG,CAAC,CAAC;IAC/E,IAAI,CAAC,CAAC,aAAa,KAAK,qBAAqB;QAAE,MAAM,IAAI,WAAW,CAAC,yBAAyB,qBAAqB,GAAG,CAAC,CAAC;IAExH,MAAM,GAAG,GAAwB,EAAE,aAAa,EAAE,qBAAqB,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC7F,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAAE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAChE,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAAE,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;IAEjE,IAAI,CAAC,CAAC,eAAe,IAAI,OAAO,CAAC,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;QAC/D,MAAM,EAAE,GAAoD,EAAE,CAAC;QAC/D,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,eAA0C,CAAC,EAAE,CAAC;YACtF,IAAI,CAAE,iBAAuC,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,SAAS;YACtE,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,SAAS;YAC9C,MAAM,KAAK,GAA2B,EAAE,CAAC;YACzC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;gBACpE,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC;oBAAE,SAAS;gBAC1C,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,yBAAyB,EAAE,CAAC;oBAC9D,MAAM,IAAI,WAAW,CAAC,eAAe,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;gBACrD,CAAC;gBACD,yEAAyE;gBACzE,wCAAwC;gBACxC,MAAM,GAAG,GAAG,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC3C,IAAI,GAAG;oBAAE,MAAM,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC;gBACvD,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACf,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM;gBAAE,EAAE,CAAC,GAAa,CAAC,GAAG,KAAK,CAAC;QAC3D,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM;YAAE,GAAG,CAAC,eAAe,GAAG,EAAE,CAAC;IACvD,CAAC;IAED,IAAI,CAAC,CAAC,gBAAgB,IAAI,OAAO,CAAC,CAAC,gBAAgB,KAAK,QAAQ,EAAE,CAAC;QACjE,MAAM,EAAE,GAA4B,EAAE,CAAC;QACvC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,gBAA2C,CAAC,EAAE,CAAC;YACnF,IAAI,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC;gBAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM;YAAE,GAAG,CAAC,gBAAgB,GAAG,EAAE,CAAC;IACxD,CAAC;IAED,IAAI,CAAC,CAAC,aAAa,IAAI,OAAO,CAAC,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;QAC3D,MAAM,EAAE,GAA0D,EAAE,CAAC;QACrE,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,aAAwC,CAAC,EAAE,CAAC;YACpF,IAAI,CAAC,kCAAkC,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,MAAM,IAAI,WAAW,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;YAChG,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ;gBAAE,SAAS;YAC5C,MAAM,CAAC,GAAG,EAA6B,CAAC;YACxC,MAAM,KAAK,GAA0C,EAAE,CAAC;YACxD,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC/B,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,oBAAoB,EAAE,CAAC;oBAC9D,MAAM,IAAI,WAAW,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;gBAC9C,CAAC;gBACD,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;YACtB,CAAC;YACD,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI;gBAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;YAC/C,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ;gBAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACnE,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM;YAAE,GAAG,CAAC,aAAa,GAAG,EAAE,CAAC;IACrD,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,gFAAgF;AAEhF,SAAS,OAAO,CAAC,CAAqB,EAAE,CAAC,GAAG,EAAE;IAC5C,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACtC,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AACtD,CAAC;AAED;8CAC8C;AAC9C,MAAM,UAAU,mBAAmB,CAAC,MAA2B;IAC7D,MAAM,OAAO,GAAG,sBAAsB,EAAE,CAAC;IACzC,MAAM,IAAI,GAAsB,EAAE,CAAC;IAEnC,mBAAmB;IACnB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAa,EAAE,CAAC;QACxE,MAAM,QAAQ,GAAG,MAAM,CAAC,eAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACpD,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClD,MAAM,QAAQ,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3F,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9G,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,IAAI,EAAE,CAAC,EAAE,CAAC;QACvE,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3F,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzI,CAAC;IAED,SAAS;IACT,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,CAAC;QACpE,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,EAAE,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACvE,SAAS;QACX,CAAC;QACD,MAAM,YAAY,GAAG,QAAQ,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5F,MAAM,MAAM,GAAG,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;QACvG,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzG,CAAC;IAED,MAAM,OAAO,GAAG;QACd,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,MAAM;QACnD,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;QAC3D,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;QAC3D,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM;KAC/D,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACnC,CAAC;AAED,gFAAgF;AAEhF;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,MAA2B,EAAE,KAAK,GAAG,eAAe;IAC9E,MAAM,IAAI,GAAuB,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;IACtD,IAAI,MAAM,CAAC,eAAe;QAAE,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;IAC1E,IAAI,MAAM,CAAC,gBAAgB;QAAE,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;IAC7E,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzB,MAAM,EAAE,GAAqD,EAAE,CAAC;QAChE,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;YAC9D,MAAM,KAAK,GAA0C,EAAE,CAAC;YACxD,IAAI,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAAC,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC;gBAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;YAAC,CAAC;YACvF,IAAI,EAAE,CAAC,QAAQ;gBAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;YACvC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ;gBAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACnE,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM;YAAE,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;IACtD,CAAC;IACD,OAAO,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,eAAe,CAAC,MAA2B;IACzD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAChD,CAAC"}

package/dist/skills/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/skills/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,QAAQ;IACvB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;CACjB;AAihCD,eAAO,MAAM,SAAS,qkOAoFrB,CAAC;AAwSF,eAAO,MAAM,gBAAgB,ikQAoH5B,CAAC;AAEF,eAAO,MAAM,cAAc,eAAe,CAAC;AAE3C;;;;;4DAK4D;AAC5D,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AAEzD,eAAO,MAAM,cAAc,EAAE,QAAQ,EASpC,CAAC;AAEF;;;;;;;;;;;;6EAY6E;AAC7E,eAAO,MAAM,uBAAuB,EAAE,QAAQ,EAI7C,CAAC;AAEF;kDACkD;AAClD,eAAO,MAAM,4BAA4B,EAAE,MAAM,EACL,CAAC;AAE7C;;qCAEqC;AACrC,eAAO,MAAM,mBAAmB,EAAE,MAAM,EASvC,CAAC"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/skills/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,QAAQ;IACvB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;CACjB;AAwhCD,eAAO,MAAM,SAAS,qkOAoFrB,CAAC;AAwSF,eAAO,MAAM,gBAAgB,ikQAoH5B,CAAC;AAEF,eAAO,MAAM,cAAc,eAAe,CAAC;AAE3C;;;;;4DAK4D;AAC5D,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AAEzD,eAAO,MAAM,cAAc,EAAE,QAAQ,EASpC,CAAC;AAEF;;;;;;;;;;;;6EAY6E;AAC7E,eAAO,MAAM,uBAAuB,EAAE,QAAQ,EAI7C,CAAC;AAEF;kDACkD;AAClD,eAAO,MAAM,4BAA4B,EAAE,MAAM,EACL,CAAC;AAE7C;;qCAEqC;AACrC,eAAO,MAAM,mBAAmB,EAAE,MAAM,EASvC,CAAC"}

package/dist/skills/definitions.js

@@ -612,7 +612,7 @@ team scope 输出的 \`agents[]\` 每项：\`appId\`（拉群/补人就用它）
 `;
 const HANDOFF_SKILL = `---
 name: botmux-handoff
-description: 把当前任务交棒给团队里另一个机器人时使用（多机器人协作接力）。当你做完自己负责的部分、需要另一个机器人接手下一步，或用户说"交给X""让X接着做""@某bot继续""下一步谁谁来"时触发。先用 botmux-bots 查花名册挑对象，再用结构化交接发给对方。
+description: 把当前任务交棒给团队里另一个机器人时使用（多机器人协作接力）。当你做完自己负责的部分、需要另一个机器人接手下一步，或用户说"交给X""让X接着做""@某bot继续""下一步谁谁来"时触发。单个目标 bot 或单个专项的接力默认保留在当前话题，不新建子项目话题；先用 botmux-bots 查花名册挑对象，再用结构化交接发给对方。
 ---
 
 # botmux-handoff — 机器人接力交棒
@@ -626,6 +626,13 @@ description: 把当前任务交棒给团队里另一个机器人时使用（多
    - 确认它 \`mentionable: true\`（若为 false，先让它/用户 \`/introduce\` 一次再点名）。
 2. 用 \`botmux send --mention\` 发一条**结构化交接**给它。
 
+## 话题规则
+
+- **单 bot 接力留在当前话题**：直接运行 \`botmux send --mention\`，不加 \`--top-level\`；BotMux 会把消息发回当前轮次所在话题。
+- 不要为单个接手者运行不带 \`--into\` 的 \`botmux dispatch\`：它会额外发一条顶层子项目消息、新建话题。
+- 如果必须使用稳定 App ID 和接单确认，使用 \`botmux dispatch --into <当前话题根消息id> --bot-app <larkAppId> ...\`，明确追加到当前话题。
+- 只有任务确实拆成多个独立子项目、需要并行跟踪和主 bot 汇总时，才使用 \`botmux-orchestrate\` 新开话题。
+
 ## 交接必须包含 5 要素
 
 - **交给谁**：@ 目标机器人
@@ -1215,7 +1222,7 @@ $${GOAL_ENV.INPUTS_PATH}
 `;
 const ORCHESTRATE_SKILL = `---
 name: botmux-orchestrate
-description: 多 bot 长期项目编排。仅当任务同时需要「多个 bot 分工」+「持续的 goal 群/多话题协调与进度板」+「主 bot 汇总验收」时触发，例如多组 coder/reviewer 并行推进。若只是一个有界 DAG、跑完即散、产出单一交付物，应使用 botmux-workflow；单步任务直接处理。显式提到 botmux orchestrate / goal supervise / dispatch 派活时也使用。
+description: 多 bot 长期项目编排。仅当任务同时需要「多个 bot 分工」+「持续的 goal 群/多话题协调与进度板」+「主 bot 汇总验收」时触发，例如多组 coder/reviewer 并行推进。若只是一个有界 DAG、跑完即散、产出单一交付物，应使用 botmux-workflow；只把下一步或单个专项交给一个 bot 时，必须使用 botmux-handoff 留在当前话题，不得新建子项目话题。显式提到 botmux orchestrate / goal supervise / dispatch 派活时也使用。
 ---
 
 # botmux-orchestrate — 多 bot 多话题编排
@@ -1225,7 +1232,7 @@ description: 多 bot 长期项目编排。仅当任务同时需要「多个 bot
 ## 适用 & 不适用
 - 适用：一个长期项目同时满足三个结构化判据：① **多个 bot 分工**处理基本独立的子项目；② 需要持续存在的 **goal 群/多话题协调**和共享进度板；③ 主 bot 要持续收件并做最终**验收**。
 - 不适用：一个**有界 DAG、跑完即散、只有一个交付物**的多步目标——使用 **botmux-workflow**。
-- 不适用：单步请求 / 普通改代码（直接做），或只需把下一步交给一个 bot（用 botmux-handoff）。
+- 不适用：单步请求 / 普通改代码（直接做），或只需把下一步、单个专项交给一个 bot（用 botmux-handoff，留在当前话题）。
 
 ## 物理事实（先记牢）
 - **你和子 bot 之间没有直连**，只能靠飞书消息触发；**没有请求-响应关联**——子 bot 干完用 \`botmux report\` 把回报发回**你这条主编排话题**（不是在它自己的子话题里 @ 你——那条子话题没有你的会话，@ 会另起一个无上下文的新会话）。对你就是「话题里来了条新消息」，你被唤起（带完整上下文）后去读任务板拿结构化状态。

package/dist/skills/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/skills/definitions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/skills/definitions.ts"],"names":[],"mappings":"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"}

package/dist/skills/effective-builtins.d.ts

@@ -0,0 +1,38 @@
+import type { SkillDef } from './definitions.js';
+/**
+ * Register the store as i18n's prompt-override resolver. Safe to call more than
+ * once — it simply (re)installs the same resolver closure, which reads store
+ * state live on each lookup. Kept as an explicit registration rather than an
+ * import side-effect so the pure i18n module never transitively pulls in the
+ * filesystem-backed store.
+ */
+export declare function registerPromptOverrideResolver(): void;
+/**
+ * Resolve whether a gated prompt line should render. `shippedDefault` is the
+ * value the shipped code computed (e.g. `config.noVisibleOutputHint`). A user
+ * override forces it either way; absent override returns the shipped default,
+ * so gating behaves exactly as before when uncustomized.
+ */
+export declare function resolveConditionalLine(key: string, shippedDefault: boolean): boolean;
+/**
+ * Apply user overrides to the shipped built-in skill list:
+ *   - a skill marked `disabled` is removed entirely (not injected anywhere)
+ *   - a skill with an override body has its `content` replaced
+ *   - everything else passes through untouched
+ *
+ * Returns a NEW array; the shipped `defs` is never mutated. When customization
+ * is off or no skill overrides exist, returns a shallow copy equal to `defs`.
+ */
+export declare function effectiveBuiltinSkills(defs: SkillDef[]): SkillDef[];
+/**
+ * Resolve the effective content for a single built-in skill by name, given its
+ * shipped default. Returns:
+ *   - `undefined` if the skill is disabled (caller should treat as absent)
+ *   - the override body if one is set
+ *   - `shippedContent` otherwise
+ */
+export declare function effectiveBuiltinSkillContent(name: string, shippedContent: string): string | undefined;
+/** True if the named built-in skill is disabled by the user (and customization
+ *  is on). Lets callers that iterate names skip disabled skills cheaply. */
+export declare function isBuiltinSkillDisabled(name: string): boolean;
+//# sourceMappingURL=effective-builtins.d.ts.map

package/dist/skills/effective-builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-builtins.d.ts","sourceRoot":"","sources":["../../src/skills/effective-builtins.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAIjD;;;;;;GAMG;AACH,wBAAgB,8BAA8B,IAAI,IAAI,CAOrD;AAID;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAG,OAAO,CAIpF;AAID;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAiBnE;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUrG;AAED;4EAC4E;AAC5E,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG5D"}

package/dist/skills/effective-builtins.js

@@ -0,0 +1,96 @@
+import { setPromptOverrideResolver } from '../i18n/index.js';
+import { customizationEnabled, readCustomizationState, readSkillOverrideBody, } from '../services/customization-store.js';
+// ─── Prompt key overrides → i18n t() ─────────────────────────────────────────
+/**
+ * Register the store as i18n's prompt-override resolver. Safe to call more than
+ * once — it simply (re)installs the same resolver closure, which reads store
+ * state live on each lookup. Kept as an explicit registration rather than an
+ * import side-effect so the pure i18n module never transitively pulls in the
+ * filesystem-backed store.
+ */
+export function registerPromptOverrideResolver() {
+    setPromptOverrideResolver((key, locale) => {
+        // Master off ⇒ no overrides ⇒ shipped bytes.
+        if (!customizationEnabled())
+            return undefined;
+        const state = readCustomizationState();
+        return state.promptOverrides?.[locale]?.[key];
+    });
+}
+// ─── Conditional prompt lines ────────────────────────────────────────────────
+/**
+ * Resolve whether a gated prompt line should render. `shippedDefault` is the
+ * value the shipped code computed (e.g. `config.noVisibleOutputHint`). A user
+ * override forces it either way; absent override returns the shipped default,
+ * so gating behaves exactly as before when uncustomized.
+ */
+export function resolveConditionalLine(key, shippedDefault) {
+    if (!customizationEnabled())
+        return shippedDefault;
+    const forced = readCustomizationState().conditionalLines?.[key];
+    return typeof forced === 'boolean' ? forced : shippedDefault;
+}
+// ─── Built-in skill overrides ────────────────────────────────────────────────
+/**
+ * Apply user overrides to the shipped built-in skill list:
+ *   - a skill marked `disabled` is removed entirely (not injected anywhere)
+ *   - a skill with an override body has its `content` replaced
+ *   - everything else passes through untouched
+ *
+ * Returns a NEW array; the shipped `defs` is never mutated. When customization
+ * is off or no skill overrides exist, returns a shallow copy equal to `defs`.
+ */
+export function effectiveBuiltinSkills(defs) {
+    if (!customizationEnabled())
+        return defs.slice();
+    const overrides = readCustomizationState().builtinSkills;
+    if (!overrides || !Object.keys(overrides).length)
+        return defs.slice();
+    const out = [];
+    for (const def of defs) {
+        const ov = overrides[def.name];
+        if (!ov) {
+            out.push(def);
+            continue;
+        }
+        if (ov.disabled)
+            continue; // drop disabled skills
+        if (ov.body !== undefined) {
+            const body = readSkillOverrideBody(def.name);
+            out.push({ name: def.name, content: typeof body === 'string' ? body : def.content });
+        }
+        else {
+            out.push(def);
+        }
+    }
+    return out;
+}
+/**
+ * Resolve the effective content for a single built-in skill by name, given its
+ * shipped default. Returns:
+ *   - `undefined` if the skill is disabled (caller should treat as absent)
+ *   - the override body if one is set
+ *   - `shippedContent` otherwise
+ */
+export function effectiveBuiltinSkillContent(name, shippedContent) {
+    if (!customizationEnabled())
+        return shippedContent;
+    const ov = readCustomizationState().builtinSkills?.[name];
+    if (!ov)
+        return shippedContent;
+    if (ov.disabled)
+        return undefined;
+    if (ov.body !== undefined) {
+        const body = readSkillOverrideBody(name);
+        return typeof body === 'string' ? body : shippedContent;
+    }
+    return shippedContent;
+}
+/** True if the named built-in skill is disabled by the user (and customization
+ *  is on). Lets callers that iterate names skip disabled skills cheaply. */
+export function isBuiltinSkillDisabled(name) {
+    if (!customizationEnabled())
+        return false;
+    return readCustomizationState().builtinSkills?.[name]?.disabled === true;
+}
+//# sourceMappingURL=effective-builtins.js.map

package/dist/skills/effective-builtins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-builtins.js","sourceRoot":"","sources":["../../src/skills/effective-builtins.ts"],"names":[],"mappings":"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"}

package/dist/skills/injection-mode.d.ts

@@ -40,6 +40,8 @@ export interface BuiltinSkillEntry {
     description: string;
     content: string;
 }
+/** First `description:` value from a SKILL.md YAML frontmatter (single line). */
+export declare function frontmatterDescription(content: string): string;
 /**
  * The built-in skills the model should be told about in `prompt` mode. Mirrors
  * exactly what `global` mode would install: the unconditional BUILTIN_SKILLS,
@@ -62,7 +64,8 @@ export declare function builtinSkillEntries(opts: {
  *  on-demand reads in `prompt` mode (independent of the per-CLI toggles above,
  *  so a name that made it into the catalog always resolves). The v3 Workflow
  *  family resolves only while the feature is enabled, so a disabled host can't
- *  pull a skill it never advertised. */
+ *  pull a skill it never advertised. Honors a user override body; returns
+ *  undefined for a user-disabled skill. */
 export declare function builtinSkillContent(name: string): string | undefined;
 /**
  * The `<botmux_builtin_skills>` prompt block for `prompt` mode: a one-line-per-skill

package/dist/skills/injection-mode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"injection-mode.d.ts","sourceRoot":"","sources":["../../src/skills/injection-mode.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAuB/C,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE7D,yEAAyE;AACzE,eAAO,MAAM,+BAA+B,EAAE,kBAA6B,CAAC;AAE5E,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,kBAAkB,CAExE;AAED,2EAA2E;AAC3E,wBAAgB,kCAAkC,IAAI,kBAAkB,CAGvE;AAED,uEAAuE;AACvE,wBAAgB,yBAAyB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAElF;AAED,8EAA8E;AAC9E,wBAAgB,+BAA+B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAQtF;AAQD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAWpE;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAClE,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAI1G;AAID,MAAM,WAAW,iBAAiB;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;CAAE;AAwB1F;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;iFAE6E;IAC7E,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;0CAEsC;IACtC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,iBAAiB,EAAE,CAOtB;AAED;;;;wCAIwC;AACxC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,iBAAiB,EAAE,EAC5B,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GACvC,MAAM,CAkBR;AAED;;;+EAG+E;AAC/E,wBAAgB,uBAAuB,CACrC,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GAClE,MAAM,CAeR;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yCAAyC,CACvD,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3F,MAAM,CAiBR"}
+{"version":3,"file":"injection-mode.d.ts","sourceRoot":"","sources":["../../src/skills/injection-mode.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAwB/C,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE7D,yEAAyE;AACzE,eAAO,MAAM,+BAA+B,EAAE,kBAA6B,CAAC;AAE5E,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,kBAAkB,CAExE;AAED,2EAA2E;AAC3E,wBAAgB,kCAAkC,IAAI,kBAAkB,CAGvE;AAED,uEAAuE;AACvE,wBAAgB,yBAAyB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAElF;AAED,8EAA8E;AAC9E,wBAAgB,+BAA+B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAQtF;AAQD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAWpE;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAClE,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAI1G;AAID,MAAM,WAAW,iBAAiB;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;CAAE;AAiB1F,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;iFAE6E;IAC7E,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;0CAEsC;IACtC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,iBAAiB,EAAE,CAUtB;AAED;;;;;2CAK2C;AAC3C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,iBAAiB,EAAE,EAC5B,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GACvC,MAAM,CAkBR;AAED;;;+EAG+E;AAC/E,wBAAgB,uBAAuB,CACrC,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GAClE,MAAM,CAeR;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yCAAyC,CACvD,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3F,MAAM,CAiBR"}

package/dist/skills/injection-mode.js

@@ -30,6 +30,7 @@ import { createCliAdapterSync } from '../adapters/cli/registry.js';
 import { escapeXmlText } from '../utils/xml.js';
 import { isWorkflowFeatureEnabled } from '../global-config.js';
 import { BUILTIN_SKILLS, WORKFLOW_FEATURE_SKILLS, ASK_SKILL, ASK_SKILL_NAME, WHITEBOARD_SKILL, WHITEBOARD_SKILL_NAME, } from './definitions.js';
+import { effectiveBuiltinSkills, effectiveBuiltinSkillContent } from './effective-builtins.js';
 /** The unconditional built-ins with the v3 Workflow family spliced back in at
  *  their historical position (right after `botmux-handoff`) when the machine-wide
  *  workflow switch is ON. Splicing rather than appending keeps the ENABLED-path
@@ -129,7 +130,7 @@ function promptCatalogDescription(entry, locale) {
         : '首次复杂飞书发送前读取：多行/结构化 Markdown（表格或代码块）、附件/卡片/@mention、跨群/顶层发布或 --attention。按完整说明使用 heredoc/--content-file，不要把 JSON.stringify/JSON 转义产生的 \\n 当字面量发送。';
 }
 /** First `description:` value from a SKILL.md YAML frontmatter (single line). */
-function frontmatterDescription(content) {
+export function frontmatterDescription(content) {
     const fm = content.match(/^---\n([\s\S]*?)\n---/)?.[1] ?? '';
     const line = fm.split('\n').find((l) => l.startsWith('description:'));
     return line ? line.slice('description:'.length).trim() : '';
@@ -149,20 +150,27 @@ export function builtinSkillEntries(opts) {
         defs.push({ name: WHITEBOARD_SKILL_NAME, content: WHITEBOARD_SKILL });
     if (opts.excludeRoutingCovered)
         defs = defs.filter((d) => !FULLY_ROUTING_COVERED_SKILLS.has(d.name));
+    // Apply user overrides last: replaces bodies + drops user-disabled skills.
+    // Byte-identical to the pre-feature list when nothing is customized.
+    defs = effectiveBuiltinSkills(defs);
     return defs.map((d) => ({ name: d.name, description: frontmatterDescription(d.content), content: d.content }));
 }
 /** Full SKILL.md body for a built-in skill name — backs `botmux skill show`
  *  on-demand reads in `prompt` mode (independent of the per-CLI toggles above,
  *  so a name that made it into the catalog always resolves). The v3 Workflow
  *  family resolves only while the feature is enabled, so a disabled host can't
- *  pull a skill it never advertised. */
+ *  pull a skill it never advertised. Honors a user override body; returns
+ *  undefined for a user-disabled skill. */
 export function builtinSkillContent(name) {
     const all = [
         ...baseBuiltinSkills(isWorkflowFeatureEnabled()),
         { name: ASK_SKILL_NAME, content: ASK_SKILL },
         { name: WHITEBOARD_SKILL_NAME, content: WHITEBOARD_SKILL },
     ];
-    return all.find((d) => d.name === name)?.content;
+    const shipped = all.find((d) => d.name === name)?.content;
+    if (shipped === undefined)
+        return undefined;
+    return effectiveBuiltinSkillContent(name, shipped);
 }
 /**
  * The `<botmux_builtin_skills>` prompt block for `prompt` mode: a one-line-per-skill

package/dist/skills/injection-mode.js.map

@@ -1 +1 @@
-{"version":3,"file":"injection-mode.js","sourceRoot":"","sources":["../../src/skills/injection-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,SAAS,EAAE,cAAc,EACzB,gBAAgB,EAAE,qBAAqB,GACxC,MAAM,kBAAkB,CAAC;AAE1B;;;;;8CAK8C;AAC9C,SAAS,iBAAiB,CAAC,eAAwB;IACjD,IAAI,CAAC,eAAe;QAAE,OAAO,CAAC,GAAG,cAAc,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC;IAC5E,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC;IAC5D,OAAO,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,uBAAuB,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;AACnG,CAAC;AAID,yEAAyE;AACzE,MAAM,CAAC,MAAM,+BAA+B,GAAuB,QAAQ,CAAC;AAE5E,MAAM,UAAU,oBAAoB,CAAC,CAAU;IAC7C,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,KAAK,CAAC;AACzD,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,kCAAkC;IAChD,MAAM,CAAC,GAAG,gBAAgB,EAAE,CAAC,MAAM,EAAE,gBAAgB,CAAC;IACtD,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,+BAA+B,CAAC;AACvE,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,yBAAyB,CAAC,WAAoB;IAC5D,OAAO,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,kCAAkC,EAAE,CAAC;AAChG,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,+BAA+B,CAAC,SAAkB;IAChE,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;YACpE,IAAI,GAAG;gBAAE,OAAO,yBAAyB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC,CAAC,qCAAqC,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,kCAAkC,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,OAAO,EAAE,CAAC;IAChC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CAAC,SAAiB;IACzD,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IACrC,IAAI,CAAC;QACH,KAAK,MAAM,CAAC,IAAI,cAAc,EAAE,EAAE,CAAC;YACjC,IAAI,yBAAyB,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,QAAQ;gBAAE,SAAS;YACvE,IAAI,EAAsB,CAAC;YAC3B,IAAI,CAAC;gBAAC,EAAE,GAAG,oBAAoB,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC,SAAS,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,SAAS;YAAC,CAAC;YAC5F,IAAI,EAAE,IAAI,UAAU,CAAC,EAAE,CAAC,KAAK,MAAM;gBAAE,OAAO,IAAI,CAAC;QACnD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC;AACf,CAAC;AAiBD,MAAM,UAAU,4BAA4B,CAAC,KAAY,EAAE,eAAwB;IACjF,IAAI,EAAE,CAAC;IACP,IAAI,CAAC;QAAC,EAAE,GAAG,oBAAoB,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,MAAM,CAAC;IAAC,CAAC;IACnF,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;AACrE,CAAC;AAMD;;kFAEkF;AAClF,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAC,CAAC,gBAAgB,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC,CAAC;AAEjG;;gFAEgF;AAChF,SAAS,wBAAwB,CAAC,KAAwB,EAAE,MAAe;IACzE,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa;QAAE,OAAO,KAAK,CAAC,WAAW,CAAC;IAC3D,OAAO,MAAM,KAAK,IAAI;QACpB,CAAC,CAAC,kSAAkS;QACpS,CAAC,CAAC,kJAAkJ,CAAC;AACzJ,CAAC;AAED,iFAAiF;AACjF,SAAS,sBAAsB,CAAC,OAAe;IAC7C,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7D,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAWnC;IACC,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,IAAI,wBAAwB,EAAE,CAAC;IAC3E,IAAI,IAAI,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAC9C,IAAI,CAAC,IAAI,CAAC,WAAW;QAAE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/E,IAAI,IAAI,CAAC,iBAAiB;QAAE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAClG,IAAI,IAAI,CAAC,qBAAqB;QAAE,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,4BAA4B,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACrG,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,sBAAsB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AACjH,CAAC;AAED;;;;wCAIwC;AACxC,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,GAAG,GAAG;QACV,GAAG,iBAAiB,CAAC,wBAAwB,EAAE,CAAC;QAChD,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE;QAC5C,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,gBAAgB,EAAE;KAC3D,CAAC;IACF,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,OAAO,CAAC;AACnD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,6BAA6B,CAC3C,OAA4B,EAC5B,MAAe,EACf,OAAsC,EAAE;IAExC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,EAAE,GAAG,MAAM,KAAK,IAAI,CAAC;IAC3B,+EAA+E;IAC/E,qEAAqE;IACrE,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,KAAK,KAAK,CAAC;IAClD,MAAM,KAAK,GAAG,UAAU;QACtB,CAAC,CAAC,CAAC,EAAE;YACH,CAAC,CAAC,iRAAiR;YACnR,CAAC,CAAC,uHAAuH,CAAC;QAC5H,CAAC,CAAC,CAAC,EAAE;YACH,CAAC,CAAC,+PAA+P;YACjQ,CAAC,CAAC,mGAAmG,CAAC,CAAC;IAC3G,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,wBAAwB,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACvG,uEAAuE;IACvE,4EAA4E;IAC5E,wDAAwD;IACxD,OAAO,CAAC,yBAAyB,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,EAAE,0BAA0B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5G,CAAC;AAED;;;+EAG+E;AAC/E,MAAM,UAAU,uBAAuB,CACrC,MAAe,EACf,OAAiE,EAAE;IAEnE,MAAM,EAAE,GAAG,MAAM,KAAK,IAAI,CAAC;IAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,KAAK,KAAK,CAAC;IAClD,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,IAAI,wBAAwB,EAAE,CAAC;IAC3E,+EAA+E;IAC/E,8EAA8E;IAC9E,MAAM,EAAE,GAAG,CAAC,EAAU,EAAE,MAAc,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACvF,MAAM,KAAK,GAAG,UAAU;QACtB,CAAC,CAAC,CAAC,EAAE;YACH,CAAC,CAAC,oFAAoF,EAAE,CAAC,aAAa,EAAE,aAAa,CAAC,wHAAwH;YAC9O,CAAC,CAAC,wDAAwD,EAAE,CAAC,aAAa,EAAE,EAAE,CAAC,0EAA0E,CAAC;QAC5J,CAAC,CAAC,CAAC,EAAE;YACH,CAAC,CAAC,uEAAuE,EAAE,CAAC,aAAa,EAAE,aAAa,CAAC,wHAAwH;YACjO,CAAC,CAAC,6DAA6D,EAAE,CAAC,aAAa,EAAE,EAAE,CAAC,yEAAyE,CAAC,CAAC;IACnK,OAAO,4BAA4B,aAAa,CAAC,KAAK,CAAC,4BAA4B,CAAC;AACtF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,yCAAyC,CACvD,SAA6B,EAC7B,MAA0B,EAC1B,OAA0F,EAAE;IAE5F,MAAM,IAAI,GAAG,+BAA+B,CAAC,SAAS,CAAC,CAAC;IACxD,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,KAAK,KAAK,CAAC;IACvD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,6BAA6B,CAClC,mBAAmB,CAAC;YAClB,WAAW,EAAE,IAAI,CAAC,WAAW,KAAK,IAAI;YACtC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,KAAK,IAAI;YAClD,wEAAwE;YACxE,qBAAqB,EAAE,eAAe;SACvC,CAAC,EACF,MAAM,EACN,EAAE,eAAe,EAAE,CACpB,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,uBAAuB,CAAC,MAAM,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC;IAChF,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"injection-mode.js","sourceRoot":"","sources":["../../src/skills/injection-mode.ts"],"names":[],"mappings":"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"}

package/dist/skills/installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/skills/installer.ts"],"names":[],"mappings":"AAwBA;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAerF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAoBlF;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAkBnG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAkB1G;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAqBzG;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAiC/E"}
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/skills/installer.ts"],"names":[],"mappings":"AAyBA;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAerF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAoBlF;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAkBnG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAkB1G;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAqBzG;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAsD/E"}

package/dist/skills/installer.js

@@ -4,6 +4,7 @@ import { join } from 'node:path';
 import { homedir } from 'node:os';
 import { logger } from '../utils/logger.js';
 import { BUILTIN_SKILLS, RETIRED_SKILL_NAMES, WORKFLOW_FEATURE_SKILLS, ASK_SKILL, ASK_SKILL_NAME, WHITEBOARD_SKILL, WHITEBOARD_SKILL_NAME } from './definitions.js';
+import { effectiveBuiltinSkills } from './effective-builtins.js';
 // This module only manages botmux-owned bridge/ask skills. User-defined skills
 // live in src/core/skills/* and services/skill-registry-store.ts so their
 // lifecycle stays independent of any specific CLI's global skill directory.
@@ -226,7 +227,12 @@ export function ensureSkills(cliId, skillsDir) {
         mkdirSync(dir, { recursive: true });
     }
     catch { /* ignore */ }
-    for (const skill of BUILTIN_SKILLS) {
+    // Apply user overrides: replaced bodies + user-disabled skills removed. When
+    // nothing is customized this equals BUILTIN_SKILLS, so the on-disk files are
+    // byte-identical to the pre-feature baseline.
+    const effective = effectiveBuiltinSkills([...BUILTIN_SKILLS]);
+    const effectiveNames = new Set(effective.map((s) => s.name));
+    for (const skill of effective) {
         const skillDir = join(dir, skill.name);
         const skillFile = join(skillDir, 'SKILL.md');
         try {
@@ -244,6 +250,23 @@ export function ensureSkills(cliId, skillsDir) {
             logger.warn(`[skills] Failed to install ${skill.name} for ${cliId}: ${err.message}`);
         }
     }
+    // Remove a built-in skill's dir when the user has DISABLED it (present in the
+    // shipped set but dropped from the effective set). Without this, a global-mode
+    // CLI would keep injecting a skill the user turned off (stale file on disk).
+    for (const shipped of BUILTIN_SKILLS) {
+        if (effectiveNames.has(shipped.name))
+            continue;
+        const disabledDir = join(dir, shipped.name);
+        if (!existsSync(disabledDir))
+            continue;
+        try {
+            rmSync(disabledDir, { recursive: true, force: true });
+            logger.info(`[skills] Removed user-disabled built-in skill ${shipped.name} for ${cliId}`);
+        }
+        catch (err) {
+            logger.warn(`[skills] Failed to remove disabled skill ${shipped.name} for ${cliId}: ${err.message}`);
+        }
+    }
     // Clean up retired skill directories (e.g. botmux-thread-messages → botmux-history).
     for (const retired of RETIRED_SKILL_NAMES) {
         const retiredDir = join(dir, retired);