@team-harness/memory-algorithms 0.1.0

package/dist/upstream/core/skill/skill-tools.d.ts

@@ -0,0 +1,75 @@
+/**
+ * SkillToolsV2 — 给 Review Agent 的工具集（绑定到 SkillCore）
+ *
+ * 暴露 4 个写动作 + 2 个读动作，覆盖 SkillExtractor 的需要：
+ *   - skill_list      列出团队内可见 skill
+ *   - skill_view      查看单个 skill 详情
+ *   - skill_create    新建 skill
+ *   - skill_update    全量替换 SKILL.md
+ *   - skill_patch     单点串替
+ *   - skill_files_write  增/改资源
+ *
+ * 不暴露 delete / files_remove —— 抽取流程不应能销毁团队 skill。
+ * 工具错误以 JSON.stringify({error}) 返回，让 LLM 能 self-correct。
+ *
+ * 每次成功的写操作都 push 一条 ExtractedSkillCandidate 到 auditSink，
+ * SkillExtractor 把它作为 candidates 返回给调用方。
+ */
+import { type SkillCore } from "../../../runtime/skill-workspace.js";
+export type ExtractedAction = "create" | "update" | "patch" | "files_write";
+export interface ExtractedSkillCandidate {
+    action: ExtractedAction;
+    name: string;
+    skill_id?: string;
+    version?: number;
+    description?: string;
+}
+export interface CreateSkillToolsOptions {
+    core: SkillCore;
+    /** 调用方身份（owner 校验依据）。 */
+    user_id: string;
+    team_id: string;
+    agent_id: string;
+    task_id?: string;
+    auditSink: ExtractedSkillCandidate[];
+    logger?: {
+        info(msg: string): void;
+        warn(msg: string): void;
+        error(msg: string): void;
+    };
+}
+export declare function createSkillTools(opts: CreateSkillToolsOptions): {
+    skill_list: import("../../../runtime/tools.js").LocalTool<{
+        query?: string;
+        top_k?: number;
+    }>;
+    skill_view: import("../../../runtime/tools.js").LocalTool<{
+        skill_id: string;
+        version?: number;
+    }>;
+    skill_create: import("../../../runtime/tools.js").LocalTool<{
+        name: string;
+        content: string;
+    }>;
+    skill_update: import("../../../runtime/tools.js").LocalTool<{
+        skill_id: string;
+        content: string;
+        expected_version: number;
+    }>;
+    skill_patch: import("../../../runtime/tools.js").LocalTool<{
+        skill_id: string;
+        old_string: string;
+        new_string: string;
+        replace_all?: boolean;
+        expected_version: number;
+    }>;
+    skill_files_write: import("../../../runtime/tools.js").LocalTool<{
+        skill_id: string;
+        path: string;
+        content: string;
+        encoding?: "utf-8" | "base64";
+        mime_type?: string;
+        is_executable?: boolean;
+        expected_version: number;
+    }>;
+};

package/dist/upstream/core/skill/skill-tools.js

@@ -0,0 +1,193 @@
+/**
+ * SkillToolsV2 — 给 Review Agent 的工具集（绑定到 SkillCore）
+ *
+ * 暴露 4 个写动作 + 2 个读动作，覆盖 SkillExtractor 的需要：
+ *   - skill_list      列出团队内可见 skill
+ *   - skill_view      查看单个 skill 详情
+ *   - skill_create    新建 skill
+ *   - skill_update    全量替换 SKILL.md
+ *   - skill_patch     单点串替
+ *   - skill_files_write  增/改资源
+ *
+ * 不暴露 delete / files_remove —— 抽取流程不应能销毁团队 skill。
+ * 工具错误以 JSON.stringify({error}) 返回，让 LLM 能 self-correct。
+ *
+ * 每次成功的写操作都 push 一条 ExtractedSkillCandidate 到 auditSink，
+ * SkillExtractor 把它作为 candidates 返回给调用方。
+ */
+import { tool, jsonSchema } from "../../../runtime/tools.js";
+import { SkillCoreError } from "../../../runtime/skill-workspace.js";
+function jsonError(e) {
+    if (e instanceof SkillCoreError) {
+        return JSON.stringify({ error: e.code, message: e.message });
+    }
+    return JSON.stringify({ error: "INTERNAL", message: e.message });
+}
+export function createSkillTools(opts) {
+    const { core, user_id, team_id, agent_id, task_id, auditSink, logger } = opts;
+    // Read 路径：不带 task_id — audit 字段不参与检索。skill-core.ts:list/search
+    // 内部已经再兜底 undefine 掉 task_id, 但工具层依然显式区分以让意图清晰、
+    // 并防止未来 core 侧回退时又把 bug 引回来。
+    // Write 路径：带 task_id 落审计列 (记 skill 首次落库时的对话上下文)。
+    const readIds = { user_id, team_id, agent_id };
+    const writeIds = { user_id, team_id, agent_id, task_id };
+    return {
+        skill_list: tool({
+            description: "List or search your agent's skills. Use this FIRST to see what already exists. "
+                + "Pass `query` to rank results by keyword/semantic relevance; omit `query` to browse "
+                + "the most-recently-updated skills.",
+            inputSchema: jsonSchema({
+                type: "object",
+                properties: {
+                    query: {
+                        type: "string",
+                        description: "Optional. When set, ranks skills by relevance to this query using BM25 "
+                            + "keyword search over name + description + content (Chinese tokenized with jieba); "
+                            + "hybrid embedding retrieval is planned but not yet enabled — same field, will "
+                            + "transparently upgrade. Write 2-5 relevant keywords for best recall. "
+                            + "When omitted, returns the most-recently-updated skills ordered by updated_at DESC.",
+                    },
+                    top_k: { type: "number", description: "Max results (default 10)" },
+                },
+            }),
+            execute: async ({ query, top_k }) => {
+                try {
+                    if (query && query.trim()) {
+                        const hits = await core.search({ ...readIds, query, top_k });
+                        return JSON.stringify(hits.map((h) => ({
+                            skill_id: h.skill.skill_id, name: h.skill.name, description: h.skill.description,
+                            version: h.skill.version, score: h.score,
+                        })));
+                    }
+                    const r = await core.list({ ...readIds, pagination: { limit: top_k ?? 50, offset: 0 } });
+                    return JSON.stringify(r.items.map((s) => ({
+                        skill_id: s.skill_id, name: s.name, description: s.description, version: s.version,
+                    })));
+                }
+                catch (e) {
+                    return jsonError(e);
+                }
+            },
+        }),
+        skill_view: tool({
+            description: "Read a skill's full SKILL.md and resource manifest.",
+            inputSchema: jsonSchema({
+                type: "object",
+                properties: {
+                    skill_id: { type: "string" },
+                    version: { type: "number", description: "Optional historical version (default head)" },
+                },
+                required: ["skill_id"],
+            }),
+            execute: async ({ skill_id, version }) => {
+                try {
+                    const r = await core.get({ ...readIds, skill_id, version });
+                    return JSON.stringify({
+                        skill_id: r.skill_id, version: r.version, name: r.name, description: r.description,
+                        content: r.content, manifest: r.manifest,
+                    });
+                }
+                catch (e) {
+                    return jsonError(e);
+                }
+            },
+        }),
+        skill_create: tool({
+            description: "Create a new skill. The frontmatter `name` MUST equal the `name` parameter.",
+            inputSchema: jsonSchema({
+                type: "object",
+                properties: {
+                    name: { type: "string", description: "Skill name (lowercase letters/digits/hyphen)" },
+                    content: { type: "string", description: "Full SKILL.md text including frontmatter" },
+                },
+                required: ["name", "content"],
+            }),
+            execute: async ({ name, content }) => {
+                try {
+                    const r = await core.create({ ...writeIds, name, content });
+                    auditSink.push({ action: "create", name, skill_id: r.skill_id, version: r.version, description: r.description });
+                    logger?.info(`[skill-tools] created ${r.skill_id}`);
+                    return JSON.stringify({ ok: true, skill_id: r.skill_id, version: r.version });
+                }
+                catch (e) {
+                    return jsonError(e);
+                }
+            },
+        }),
+        skill_update: tool({
+            description: "Replace the entire SKILL.md of an existing skill (you must own it).",
+            inputSchema: jsonSchema({
+                type: "object",
+                properties: {
+                    skill_id: { type: "string" },
+                    content: { type: "string", description: "New full SKILL.md text" },
+                    expected_version: { type: "number", description: "Required optimistic lock — the version you just read (skill_list/skill_view). After a successful write use the returned version for the next edit." },
+                },
+                required: ["skill_id", "content", "expected_version"],
+            }),
+            execute: async ({ skill_id, content, expected_version }) => {
+                try {
+                    const r = await core.update({ ...writeIds, skill_id, content, expected_version });
+                    auditSink.push({ action: "update", name: r.name, skill_id, version: r.version });
+                    return JSON.stringify({ ok: true, version: r.version });
+                }
+                catch (e) {
+                    return jsonError(e);
+                }
+            },
+        }),
+        skill_patch: tool({
+            description: "Replace a unique substring in the SKILL.md. If old_string occurs >1 times you must pass replace_all.",
+            inputSchema: jsonSchema({
+                type: "object",
+                properties: {
+                    skill_id: { type: "string" },
+                    old_string: { type: "string" },
+                    new_string: { type: "string" },
+                    replace_all: { type: "boolean", description: "Default false" },
+                    expected_version: { type: "number", description: "Required optimistic lock — the version you just read (skill_list/skill_view). After a successful write use the returned version for the next edit." },
+                },
+                required: ["skill_id", "old_string", "new_string", "expected_version"],
+            }),
+            execute: async ({ skill_id, old_string, new_string, replace_all, expected_version }) => {
+                try {
+                    const r = await core.patch({ ...writeIds, skill_id, old_string, new_string, replace_all, expected_version });
+                    auditSink.push({ action: "patch", name: r.name, skill_id, version: r.version });
+                    return JSON.stringify({ ok: true, version: r.version });
+                }
+                catch (e) {
+                    return jsonError(e);
+                }
+            },
+        }),
+        skill_files_write: tool({
+            description: "Write or overwrite a resource file in a skill's files/ directory.",
+            inputSchema: jsonSchema({
+                type: "object",
+                properties: {
+                    skill_id: { type: "string" },
+                    path: { type: "string", description: "Relative path under files/, e.g. 'scripts/run.sh'" },
+                    content: { type: "string" },
+                    encoding: { type: "string", enum: ["utf-8", "base64"] },
+                    mime_type: { type: "string" },
+                    is_executable: { type: "boolean" },
+                    expected_version: { type: "number", description: "Required optimistic lock — the version you just read (skill_list/skill_view). After a successful write use the returned version for the next edit." },
+                },
+                required: ["skill_id", "path", "content", "expected_version"],
+            }),
+            execute: async ({ skill_id, path, content, encoding, mime_type, is_executable, expected_version }) => {
+                try {
+                    const r = await core.writeFiles({
+                        ...writeIds, skill_id, expected_version,
+                        files: [{ path, content, encoding: encoding ?? "utf-8", mime_type, is_executable }],
+                    });
+                    auditSink.push({ action: "files_write", name: r.name, skill_id, version: r.version });
+                    return JSON.stringify({ ok: true, version: r.version });
+                }
+                catch (e) {
+                    return jsonError(e);
+                }
+            },
+        }),
+    };
+}

package/dist/upstream/core/skill/types.d.ts

@@ -0,0 +1,324 @@
+/**
+ * Type definitions for the Skill module — v2 redesign (2026-06-17).
+ *
+ * Host-neutral. No imports from openclaw / hermes / automation projects.
+ * 设计文档：docs/design/2026-06-17-skill-redesign-v2.md
+ */
+/**
+ * User-facing skill configuration. All fields optional; defaults applied
+ * by `resolveSkillConfig`.
+ */
+export interface SkillConfigInput {
+    enabled?: boolean;
+    /** Override for skill metadata + vector store backend. Falls back to outer storeBackend, then 'sqlite'. */
+    storeBackend?: "sqlite" | "tcvdb" | "mongodb";
+    /** Override for skill content (SKILL.md + resources) backend. Falls back to env probe → 'local'. */
+    contentBackend?: "local" | "cos";
+    routing?: {
+        mode?: "bm25" | "embedding" | "hybrid";
+        hybridAlpha?: number;
+        searchTopK?: number;
+        charBudgetPercent?: number;
+        fastPathMinNameLength?: number;
+    };
+    extraction?: {
+        enabled?: boolean;
+        toolCallThreshold?: number;
+        model?: string;
+        maxIterations?: number;
+        /**
+         * 单一"归档尺寸"旋钮（字节）。默认 40960 (40KB)。派生 7 个内部字段:
+         *   • Handler 的 bytesThreshold / requestCompressThresholdBytes = archiveBytes
+         *   • Oversize 兜底的 chunkMaxBytes = 2 × archiveBytes
+         *   • Oversize 兜底的 headKeepBytes / tailKeepBytes = archiveBytes
+         *   • Extractor transcript 截断的 headChars / tailChars = archiveBytes
+         * 语义: 归档 payload 目标大小 = archiveBytes，上限 = 2 × archiveBytes。
+         */
+        archiveBytes?: number;
+        /** Skill review 单次 LLM 调用输出 token 上限。不填 → 继承顶层 llm.maxTokens。 */
+        maxTokens?: number;
+        /**
+         * Extractor 在把 transcript 交给 review LLM 之前, 会先注入一段"预先检索"的
+         * skill 列表 (由抽取器自己代跑 skill_list 得到)。本字段控制这段的最大条数,
+         * 同时是 relevant 检索 (LLM 生成 query + BM25 search) 与 recent 兜底
+         * (按 updated_at DESC 分页) 共用的上限。默认 20; <=0 或非整数 warn 落回 20。
+         */
+        prefixSkillsLimit?: number;
+    };
+    /**
+     * 单条大 tool 消息头尾压缩规则。只影响 tool_call / tool_result 单条 content
+     * 超阈值时的头尾切分；user/assistant/system 永不压缩。
+     */
+    compress?: {
+        /** 单条 tool 消息 content 超过多少字节才压缩。默认 2048 (2KB)。 */
+        toolContentThresholdBytes?: number;
+        /** 压缩后保留的头字节。默认 1024 (1KB)。 */
+        headBytes?: number;
+        /** 压缩后保留的尾字节。默认 1024 (1KB)。 */
+        tailBytes?: number;
+    };
+    resources?: {
+        maxResourceSizeBytes?: number;
+        downloadDir?: string;
+        allowExecutable?: boolean;
+    };
+    /** 旧版本 TTL 天数。默认 0（关闭）。设 7 = 非 head 版本创建 7 天后过期。 */
+    versionTtlDays?: number;
+    /**
+     * Skill 抽取 worker 池 (2026-07-30 引入)。整个进程一个池, 全 instance
+     * 共享一条 skill agent 队列, 池里 N 条无状态 worker loop 从队列拿活。
+     * 详见 docs/design/2026-07-30-skill-worker-instance-decoupling.md。
+     */
+    worker?: {
+        /** 池里 worker 数, 全进程 skill 抽取并发上限。默认 60。可被 env TDAI_SKILL_WORKER_CONCURRENCY 覆盖。 */
+        concurrency?: number;
+        /** dequeueAgent 单次自旋 deadline (ms)。默认 5000。 */
+        brpopBlockMs?: number;
+        /** extract-lock TTL (ms), 保护同 (instance, agent) 串行。默认 600_000 (10 min)。 */
+        extractLockTtlMs?: number;
+        /** extract-lock 续约间隔 (ms), 默认 ttl / 4。 */
+        extractLockRenewIntervalMs?: number;
+    };
+}
+export interface ResolvedSkillConfig {
+    enabled: true;
+    storeBackend: "sqlite" | "tcvdb" | "mongodb";
+    contentBackend: "local" | "cos";
+    routing: {
+        mode: "bm25" | "embedding" | "hybrid";
+        hybridAlpha: number;
+        searchTopK: number;
+        charBudgetPercent: number;
+        fastPathMinNameLength: number;
+    };
+    extraction: {
+        enabled: boolean;
+        toolCallThreshold: number;
+        model?: string;
+        maxIterations: number;
+        /** 归档尺寸旋钮 (字节)。用户可见配置源；下面 7 个字段由它派生。 */
+        archiveBytes: number;
+        /** Skill review 单次 LLM 调用输出 token 上限；不填 → 由 runner 继承 llm.maxTokens。 */
+        maxTokens?: number;
+        /**
+         * Extractor 预检索 skill 列表条数上限 (relevant BM25 检索 & recent 兜底共用)。
+         * 默认 20。
+         */
+        prefixSkillsLimit: number;
+        /** Handler: buffer 累计字节 ≥ 触发归档。= archiveBytes。 */
+        bytesThreshold: number;
+        /** Handler: 单次 add 请求 ≥ 强制走压缩路径。= archiveBytes。 */
+        requestCompressThresholdBytes: number;
+        /** Oversize 兜底: 归档 payload > 触发切分。= 2 × archiveBytes。 */
+        chunkMaxBytes: number;
+        /** Oversize 兜底: 切完保留的头字节。= archiveBytes。 */
+        headKeepBytes: number;
+        /** Oversize 兜底: 切完保留的尾字节。= archiveBytes。 */
+        tailKeepBytes: number;
+        /** Extractor transcript 截断: 保留头字符。= archiveBytes (字节数近似当字符数)。 */
+        headChars: number;
+        /** Extractor transcript 截断: 保留尾字符。= archiveBytes。 */
+        tailChars: number;
+    };
+    /** 单条大 tool 消息头尾压缩，参数与 CompressOptions 对齐。 */
+    compress: {
+        toolContentThresholdBytes: number;
+        headBytes: number;
+        tailBytes: number;
+    };
+    resources: {
+        maxResourceSizeBytes: number;
+        downloadDir: string;
+        allowExecutable: boolean;
+    };
+    /** 旧版本 TTL 秒数。0 = 关闭。 */
+    versionTtlSeconds: number;
+    /** Skill 抽取 worker 池配置 (2026-07-30)。见 SkillConfigInput.worker 注释。 */
+    worker: {
+        concurrency: number;
+        brpopBlockMs: number;
+        extractLockTtlMs: number;
+        extractLockRenewIntervalMs: number;
+    };
+    /** Records of automatic downgrades made during resolution. */
+    degradations: SkillDegradation[];
+}
+export interface SkillDegradation {
+    field: string;
+    from: string;
+    to: string;
+    reason: string;
+    level: "info" | "warn";
+}
+/**
+ * Information about ambient capabilities that resolveSkillConfig uses
+ * to make downgrade decisions. Keep this minimal and explicit; no
+ * implicit env/process reads inside resolveSkillConfig itself.
+ */
+export interface SkillEnvProbe {
+    /** Outer storeBackend from MemoryTdaiConfig. */
+    outerStoreBackend?: "sqlite" | "tcvdb" | "mongodb";
+    /** TCVDB credentials present (url + apiKey + database all set). */
+    hasTcvdbCredentials: boolean;
+    /** COS credentials present (secretId + secretKey + bucket all set). */
+    hasCosCredentials: boolean;
+    /** Embedding subsystem usable (enabled + provider valid + dimensions > 0). */
+    embeddingAvailable: boolean;
+    /**
+     * Whether the host provides an LLMRunnerFactory. When false and
+     * extraction.enabled=true, we mark extraction as degraded (it stays
+     * "enabled" but will return [] at runtime).
+     */
+    llmRunnerAvailable: boolean;
+}
+/**
+ * 业务身份四元组。全部可选。
+ * team_id 和 agent_id 要么都传要么都不传（由 gateway schema 层 cross-field 校验保证）。
+ */
+export interface IdFields {
+    user_id?: string;
+    team_id?: string;
+    agent_id?: string;
+    task_id?: string;
+}
+/** skill 状态。与 interface.yaml 对齐：active 或 archived。 */
+export type SkillStatus = "active" | "archived";
+/** manifest_json 列里的单个资源元信息。字节不在此类型中。 */
+export interface SkillManifestEntry {
+    /** 相对 `files/` 的路径，UNIX 风格，禁 `..` / 绝对路径。例 "scripts/run.sh" */
+    path: string;
+    size_bytes: number;
+    mime_type: string;
+    is_executable: boolean;
+}
+export interface SkillSimilarityResult {
+    name: string;
+    description: string;
+    similarity: number;
+}
+export interface SkillProposeResult {
+    propose_id: string;
+    proposed: {
+        name: string;
+        description: string;
+    };
+    similar_skills: SkillSimilarityResult[];
+}
+/**
+ * skill 主表的一行。每行 = (skill_id, version) 一个不可变快照。
+ *
+ * - 字段对应 `skills` 表（见 skill-store-ddl.ts SKILLS_DDL）
+ * - `manifest` 是 `manifest_json` 列反序列化后的结构化形式
+ * - `is_head` 是 boolean（DB 中是 0/1 INTEGER）
+ */
+export interface Skill {
+    row_id: string;
+    skill_id: string;
+    version: number;
+    is_head: boolean;
+    user_id: string;
+    owner_agent_id: string;
+    team_id: string;
+    task_id: string;
+    name: string;
+    description: string;
+    content: string;
+    content_hash: string;
+    manifest: SkillManifestEntry[];
+    storage_dir: string;
+    status: SkillStatus;
+    metadata_json: string;
+    created_at_ms: number;
+    updated_at_ms: number;
+}
+/** `appendVersion` 的入参。store 内部基于 head 推导 version+1。 */
+export interface AppendVersionInput {
+    /** 写入身份。不传则写 "default"。 */
+    user_id?: string;
+    team_id?: string;
+    agent_id?: string;
+    task_id?: string;
+    /** 业务主键 — 首次创建由调用方生成；同 skill 的后续版本同 skill_id。 */
+    skill_id: string;
+    name: string;
+    description: string;
+    content: string;
+    content_hash: string;
+    manifest: SkillManifestEntry[];
+    storage_dir: string;
+    /** 仅 create 时由调用方指定为 owner_agent_id；后续版本由 store 校验后从 head 继承。 */
+    owner_agent_id?: string;
+    metadata_json?: string;
+}
+/** `listSkills` 的查询参数。仅返回 head + (status 满足) 的行。四个 ID 全部可选，传了就过滤。 */
+export interface ListSkillsOptions {
+    team_id?: string;
+    owner_agent_id?: string;
+    user_id?: string;
+    task_id?: string;
+    name_prefix?: string;
+    status?: SkillStatus[];
+    limit?: number;
+    offset?: number;
+}
+/** `searchSkills` 的查询参数。仅命中 head + active 行。四个 ID 全部可选，传了就过滤。 */
+export interface SearchSkillsOptions {
+    team_id?: string;
+    query: string;
+    queryEmbedding?: Float32Array;
+    topK?: number;
+    /**
+     * 检索模式（设计 §3.5.7）。
+     *   - 'bm25'      : 仅 FTS5 BM25
+     *   - 'embedding' : 仅 vec0 KNN（需 queryEmbedding）
+     *   - 'hybrid'    : BM25 + KNN RRF 融合（需 queryEmbedding）
+     * 不传 / 未配置 embedding 时降级为 bm25。
+     */
+    mode?: "bm25" | "embedding" | "hybrid";
+    /** 可选：按 owner agent 过滤搜索结果。 */
+    agent_id?: string;
+    /** 可选：按 task 过滤搜索结果。 */
+    task_id?: string;
+    /** 可选：按 user 过滤搜索结果。 */
+    user_id?: string;
+}
+/** 抽取接口的结构化对话消息。对齐 interface.yaml §SkillImportMessage。 */
+export interface ExtractMessage {
+    role: "user" | "assistant" | "tool_call" | "tool_result";
+    content: string;
+    timestamp?: string;
+}
+/**
+ * Skill Review Agent 用的 LLM runner 形状。boot 端构造后注入 SkillExtractor。
+ * 与 src/adapters/standalone/llm-runner.ts 的 StandaloneLLMRunner.run 兼容。
+ */
+export interface ExtractorLLMRunner {
+    run(params: {
+        prompt: string;
+        systemPrompt?: string;
+        /** Tool dict (Vercel AI SDK shape). 当 enableTools=true 时驱动 tool-call 循环。 */
+        tools?: Record<string, unknown>;
+        enableTools?: boolean;
+        maxIterations?: number;
+        taskId: string;
+        timeoutMs?: number;
+        /** Worker 在锁失效时通过 abort 信号取消 LLM 调用。 */
+        signal?: AbortSignal;
+    }): Promise<string>;
+}
+export interface SkillFile {
+    frontmatter: {
+        name: string;
+        description: string;
+        category?: string;
+        created_at?: string;
+        updated_at?: string;
+        source?: "auto" | "manual";
+        resources?: Array<{
+            path: string;
+            type: "text" | "executable" | "binary";
+        }>;
+    };
+    body: string;
+    raw: string;
+}

package/dist/upstream/core/skill/types.js

@@ -0,0 +1,7 @@
+/**
+ * Type definitions for the Skill module — v2 redesign (2026-06-17).
+ *
+ * Host-neutral. No imports from openclaw / hermes / automation projects.
+ * 设计文档：docs/design/2026-06-17-skill-redesign-v2.md
+ */
+export {};