@coralai/sps-cli 0.55.12 → 0.56.0

package/dist/core/skills/SkillsManager.js

@@ -0,0 +1,231 @@
+/**
+ * @module        core/skills/SkillsManager
+ * @description   skill 的「发现 + 元数据 index + 加载」单一源,**后端无关**(不 import 任何 claude/openai)。
+ *                上层出口各取所需:openai/codex 经 spsMcpServer 的 list_skills/load_skill,
+ *                claude 用原生 settingSources/skills,reviewer 用 monitor-skills 命名空间。
+ *                设计:docs/adapters/skills-manager-design.md。
+ *
+ *                两段式(§3):发现轻(元数据)→ 加载重(正文,模型自调)。
+ *                多源合并(§2):同名 project 盖 user 盖 bundled。
+ * @layer         core
+ * @boundedContext skills
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+/** 正文截断上限(与 spsMcpServer 一致),防超长 SKILL.md 撑爆上下文。 */
+const MAX_BODY = 12000;
+export class SkillsManager {
+    cwd;
+    home;
+    bundled;
+    /** 元数据 index 缓存(按命名空间);reload() 清空。 */
+    cache = new Map();
+    constructor(opts) {
+        this.cwd = opts.cwd;
+        this.home = opts.home ?? process.env.HOME ?? '/home/coral';
+        this.bundled = {
+            skills: opts.bundledSkillsDir,
+            'monitor-skills': opts.bundledMonitorSkillsDir,
+        };
+    }
+    /** 某命名空间的根目录,**高→低优先级**(项目 > 全局 > 内建)。 */
+    roots(ns) {
+        const r = ns === 'skills'
+            ? [
+                // HQ = sps-cli 自己的命名空间(.sps/.coral),**不读 .claude**(那是 claude 适配器的投影)。
+                { dir: resolve(this.cwd, '.sps', 'skills'), source: 'project' },
+                { dir: resolve(this.home, '.coral', 'skills'), source: 'user' },
+            ]
+            : [
+                { dir: resolve(this.cwd, '.sps', 'monitor-skills'), source: 'project' },
+                { dir: resolve(this.home, '.coral', 'agents', 'monitor-skills'), source: 'user' },
+            ];
+        const b = this.bundled[ns];
+        if (b)
+            r.push({ dir: b, source: 'bundled' });
+        return r;
+    }
+    // ── 发现(元数据,轻)──────────────────────────────────────────
+    /** 多源合并后的全部元数据(同名 project 胜)。结果缓存。 */
+    discover(ns = 'skills') {
+        const cached = this.cache.get(ns);
+        if (cached)
+            return cached;
+        const byName = new Map();
+        for (const root of this.roots(ns)) {
+            // 高→低遍历,**先到先得 = 高优先级胜**(项目盖全局盖内建)。
+            for (const meta of scanRoot(root)) {
+                if (!byName.has(meta.name))
+                    byName.set(meta.name, meta);
+            }
+        }
+        const list = [...byName.values()];
+        this.cache.set(ns, list);
+        return list;
+    }
+    /** gating:把全集收窄成合格集(§4)。 */
+    eligible(metas, opts = {}) {
+        let out = metas;
+        if (opts.allow)
+            out = out.filter((m) => opts.allow.includes(m.name));
+        if (opts.deny)
+            out = out.filter((m) => !opts.deny.includes(m.name));
+        if (opts.tags?.length)
+            out = out.filter((m) => m.tags.some((t) => opts.tags.includes(t)));
+        return out;
+    }
+    /** 关键词/标签召回(场景③④的「查找供挑选」)。无 embedding——人/orchestrator 在结果上再判断。 */
+    search(query, metas, limit = 8) {
+        const terms = query.toLowerCase().trim().split(/\s+/).filter(Boolean);
+        if (!terms.length)
+            return metas.slice(0, limit);
+        const scored = metas
+            .map((m) => {
+            const tagK = [...m.tags, ...m.keywords].map((s) => s.toLowerCase());
+            const hay = `${m.name} ${m.description}`.toLowerCase();
+            let score = 0;
+            for (const t of terms) {
+                if (m.name.toLowerCase().includes(t))
+                    score += 3;
+                else if (tagK.some((k) => k.includes(t)))
+                    score += 2;
+                else if (hay.includes(t))
+                    score += 1;
+            }
+            return { m, score };
+        })
+            .filter((s) => s.score > 0)
+            .sort((a, b) => b.score - a.score);
+        return scored.slice(0, limit).map((s) => s.m);
+    }
+    /** 元数据 → 注入用的 compact catalog 串(openai/codex 出口;给模型「知道有啥」)。 */
+    catalog(metas) {
+        const lines = metas.filter((m) => m.description).map((m) => `- ${m.name}: ${m.description}`);
+        if (!lines.length)
+            return '';
+        return ['\n\n=== 可用 skills(相关就 load_skill 拉正文)===', ...lines].join('\n');
+    }
+    /** → claude `skills:[名单]` 过滤参数。 */
+    names(metas) {
+        return metas.map((m) => m.name);
+    }
+    // ── 加载(正文,重,按需)─────────────────────────────────────
+    /** 取单个 skill 的正文(frontmatter 剥掉)。命中合并后的最高优先级源 = 项目优先→全局回退。 */
+    load(name, ns = 'skills') {
+        const meta = this.discover(ns).find((m) => m.name === name);
+        if (!meta)
+            return null;
+        try {
+            return splitFrontmatter(readFileSync(meta.path, 'utf-8')).body.trim().slice(0, MAX_BODY) || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    // ── 维护 ────────────────────────────────────────────────────
+    /** 装载前校验:存在 + frontmatter 必填(name/description)。 */
+    validate(name, ns = 'skills') {
+        const meta = this.discover(ns).find((m) => m.name === name);
+        if (!meta)
+            return { ok: false, errors: [`未找到 skill: ${name}`] };
+        const errors = [];
+        if (!existsSync(meta.path))
+            errors.push('缺 SKILL.md');
+        if (!meta.description)
+            errors.push('frontmatter 缺 description');
+        return { ok: errors.length === 0, errors };
+    }
+    /** 清缓存(热重载:目录/文件变更后调一次,下次 discover 重扫)。 */
+    reload() {
+        this.cache.clear();
+    }
+}
+// ── 内部工具(纯函数)──────────────────────────────────────────
+/** 扫一个根目录,返回其下所有带 SKILL.md 的条目的元数据。 */
+function scanRoot(root) {
+    if (!existsSync(root.dir))
+        return [];
+    let entries;
+    try {
+        entries = readdirSync(root.dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const e of entries) {
+        const dir = resolve(root.dir, e.name);
+        // 目录,或指向目录的 symlink(外部 skill 常用 symlink 接入,与 distribution 一致)。
+        const isDir = e.isDirectory() || (e.isSymbolicLink() && safeIsDir(dir));
+        if (!isDir)
+            continue;
+        const path = resolve(dir, 'SKILL.md');
+        if (!existsSync(path))
+            continue;
+        const meta = toMeta(e.name, dir, path, root.source);
+        if (meta)
+            out.push(meta);
+    }
+    return out;
+}
+/** 读 SKILL.md frontmatter → SkillMeta。name 缺省回退目录名(对齐 claude/OpenClaw)。 */
+function toMeta(dirName, dir, path, source) {
+    let md;
+    try {
+        md = readFileSync(path, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    const { fm } = splitFrontmatter(md);
+    let data = {};
+    if (fm) {
+        try {
+            data = (parseYaml(fm) ?? {});
+        }
+        catch {
+            data = {}; // 坏 frontmatter 不阻塞,退化成「只有名字」的 skill
+        }
+    }
+    const name = typeof data.name === 'string' && data.name.trim() ? data.name.trim() : dirName;
+    const meta = data.metadata;
+    const reqRaw = (data.requires ?? meta?.requires);
+    return {
+        name,
+        description: typeof data.description === 'string' ? data.description.trim() : '',
+        tags: asStringArray(data.tags),
+        keywords: asStringArray(data.keywords),
+        version: typeof data.version === 'string' ? data.version : undefined,
+        source,
+        dir,
+        path,
+        requires: reqRaw
+            ? { bins: asStringArray(reqRaw.bins), env: asStringArray(reqRaw.env) }
+            : undefined,
+    };
+}
+/** 拆 YAML frontmatter(--- ... ---),返回 frontmatter 文本与正文。 */
+function splitFrontmatter(md) {
+    const m = md.match(/^---\n([\s\S]*?)\n---\n?/);
+    if (!m)
+        return { fm: null, body: md };
+    return { fm: m[1], body: md.slice(m[0].length) };
+}
+/** 容错地把 frontmatter 值规整成 string[](接受数组或逗号分隔串)。 */
+function asStringArray(v) {
+    if (Array.isArray(v))
+        return v.map((x) => String(x).trim()).filter(Boolean);
+    if (typeof v === 'string')
+        return v.split(',').map((s) => s.trim()).filter(Boolean);
+    return [];
+}
+function safeIsDir(p) {
+    try {
+        return statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=SkillsManager.js.map

package/dist/core/skills/SkillsManager.js.map

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

package/dist/core/skills/distribution.d.ts

@@ -0,0 +1,64 @@
+export type SkillLinkState = 'absent' | 'linked' | 'frozen';
+export interface SkillInfo {
+    name: string;
+    userPath: string;
+    hasSkillMd: boolean;
+}
+export interface ProjectSkillState extends SkillInfo {
+    state: SkillLinkState;
+    target?: string;
+}
+export declare function userSkillsRoot(): string;
+export declare function listUserSkills(): SkillInfo[];
+export declare function projectSkillsDir(projectDir: string): string;
+export declare function projectSkillPath(projectDir: string, name: string): string;
+export declare function inspectProjectSkill(projectDir: string, name: string): ProjectSkillState | null;
+export type AddResult = 'linked' | 'copied' | 'skipped-linked' | 'skipped-frozen' | 'skipped-absent';
+export declare function addSkillToProject(projectDir: string, name: string): AddResult;
+export declare function removeSkillFromProject(projectDir: string, name: string): boolean;
+export declare function freezeSkillInProject(projectDir: string, name: string): boolean;
+export declare function unfreezeSkillInProject(projectDir: string, name: string): boolean;
+/**
+ * Bulk link every user-level skill into the project. Idempotent:
+ * - absent → symlink（或回退 cpSync）
+ * - linked → 保留
+ * - frozen → 保留（用户已 freeze 的不重建）
+ */
+export declare function syncAllSkillsToProject(projectDir: string): {
+    linked: number;
+    copied: number;
+    kept: number;
+};
+/**
+ * claude 项目桥接:把**项目专属** skill(`<项目>/.sps/skills`)投影进 claude 的项目目录
+ * (`<项目>/.claude/skills`),让 claude worker 原生发现它们。openai/codex 直接读 `.sps/skills`,
+ * 不需要这步;全局 skill 走 syncAllSkillsToProject 另投影。幂等:目标已存在则跳过,不覆盖。
+ */
+export declare function linkProjectSkillsToClaude(projectDir: string): {
+    linked: number;
+    kept: number;
+};
+/**
+ * 把 bundled skills（npm 包内 skills/）拷贝到 ~/.coral/skills/。
+ *
+ * 默认 non-destructive：已存在的 skill 目录保留，不覆盖用户改动。
+ * `force=true`（v0.51.2+）：用 bundled 的 SKILL.md 覆盖（升级 sps-cli 后拉新 SOP）。
+ *   注意：force 会覆盖用户对 ~/.coral/skills/<name>/ 的直接编辑。如想保留定制，
+ *   先 `sps skill freeze <name> --project <p>` 把它固化到项目级（项目级副本不受
+ *   sync 影响）。
+ *
+ * Bundled → user 必须是 cpSync，因为 npm 包路径会随重装变化，symlink 会失效。
+ */
+export declare function syncBundledSkillsToUser(bundledSkillsDir: string, opts?: {
+    force?: boolean;
+}): {
+    copied: number;
+    updated: number;
+    skipped: number;
+};
+/**
+ * 把 .claude/skills/ 条目追加到 .gitignore（幂等）。
+ * 项目级 skill 是 symlink 到本机 ~/.coral/，不该进仓库。
+ */
+export declare function ensureSkillsGitignore(projectDir: string): void;
+//# sourceMappingURL=distribution.d.ts.map

package/dist/core/skills/distribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distribution.d.ts","sourceRoot":"","sources":["../../../src/core/skills/distribution.ts"],"names":[],"mappings":"AAmCA,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,cAAc,IAAI,SAAS,EAAE,CAoB5C;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAgB9F;AAED,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,QAAQ,GACR,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,CAAC;AAErB,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAmB7E;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKhF;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAU9E;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAahF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,GACjB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAYlD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,GACjB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAwBlC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,MAAM,EACxB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA0BtD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAY9D"}

package/dist/core/skills/distribution.js

@@ -0,0 +1,269 @@
+/**
+ * @module        core/skills/distribution
+ * @description   Skill 分发核心：user-level ~/.coral/skills/ ↔ project-level .claude/skills/
+ *
+ * @role          core
+ * @layer         core
+ * @boundedContext skill-distribution
+ *
+ * @responsibilities
+ *   - 列举 user-level skills（~/.coral/skills/）
+ *   - 在项目中 add/remove/freeze/unfreeze skill
+ *   - 默认用 symlink（同机器稳定路径），失败回退 cpSync
+ *   - 区分 linked（symlink）/ frozen（真实副本）/ foreign（未知目录）
+ */
+import { appendFileSync, cpSync, existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, readlinkSync, rmSync, statSync, symlinkSync, } from 'node:fs';
+import { resolve } from 'node:path';
+const HOME = process.env.HOME || '/home/coral';
+// sps-cli 自己的 skill HQ(后端无关)= ~/.coral/skills。.claude/skills 不是大本营——它是 claude
+// 适配器的「项目级投影」:本模块把 .coral 的 skill 软链进 <项目>/.claude/skills 供 claude 原生发现。
+// 详见 docs/adapters/skills-manager-design.md。
+const USER_SKILLS_DIR = resolve(HOME, '.coral', 'skills');
+export function userSkillsRoot() {
+    return USER_SKILLS_DIR;
+}
+export function listUserSkills() {
+    if (!existsSync(USER_SKILLS_DIR))
+        return [];
+    return readdirSync(USER_SKILLS_DIR, { withFileTypes: true })
+        .filter((e) => {
+        // 普通目录或指向目录的 symlink 都算（外部 skill 包经常用 symlink 接入）
+        if (e.isDirectory())
+            return true;
+        if (!e.isSymbolicLink())
+            return false;
+        try {
+            // statSync 跟随 symlink，解析到目标
+            return statSync(resolve(USER_SKILLS_DIR, e.name)).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    })
+        .map((e) => ({
+        name: e.name,
+        userPath: resolve(USER_SKILLS_DIR, e.name),
+        hasSkillMd: existsSync(resolve(USER_SKILLS_DIR, e.name, 'SKILL.md')),
+    }))
+        .filter((s) => s.hasSkillMd);
+}
+export function projectSkillsDir(projectDir) {
+    return resolve(projectDir, '.claude', 'skills');
+}
+export function projectSkillPath(projectDir, name) {
+    return resolve(projectSkillsDir(projectDir), name);
+}
+export function inspectProjectSkill(projectDir, name) {
+    const user = listUserSkills().find((s) => s.name === name);
+    if (!user)
+        return null;
+    const p = projectSkillPath(projectDir, name);
+    if (!existsSync(p))
+        return { ...user, state: 'absent' };
+    const stat = lstatSync(p);
+    if (stat.isSymbolicLink()) {
+        let target;
+        try {
+            target = readlinkSync(p);
+        }
+        catch {
+            /* ignore */
+        }
+        return { ...user, state: 'linked', target };
+    }
+    return { ...user, state: 'frozen' };
+}
+export function addSkillToProject(projectDir, name) {
+    const user = listUserSkills().find((s) => s.name === name);
+    if (!user)
+        return 'skipped-absent';
+    const skillsDir = projectSkillsDir(projectDir);
+    if (!existsSync(skillsDir))
+        mkdirSync(skillsDir, { recursive: true });
+    const dst = projectSkillPath(projectDir, name);
+    if (existsSync(dst)) {
+        return lstatSync(dst).isSymbolicLink() ? 'skipped-linked' : 'skipped-frozen';
+    }
+    try {
+        symlinkSync(user.userPath, dst, 'dir');
+        return 'linked';
+    }
+    catch {
+        cpSync(user.userPath, dst, { recursive: true, force: false });
+        return 'copied';
+    }
+}
+export function removeSkillFromProject(projectDir, name) {
+    const p = projectSkillPath(projectDir, name);
+    if (!existsSync(p) && !isDanglingSymlink(p))
+        return false;
+    rmSync(p, { recursive: true, force: true });
+    return true;
+}
+export function freezeSkillInProject(projectDir, name) {
+    const p = projectSkillPath(projectDir, name);
+    if (!existsSync(p))
+        return false;
+    const stat = lstatSync(p);
+    if (!stat.isSymbolicLink())
+        return false;
+    const user = listUserSkills().find((s) => s.name === name);
+    if (!user)
+        return false;
+    rmSync(p);
+    cpSync(user.userPath, p, { recursive: true, force: true });
+    return true;
+}
+export function unfreezeSkillInProject(projectDir, name) {
+    const p = projectSkillPath(projectDir, name);
+    const user = listUserSkills().find((s) => s.name === name);
+    if (!user)
+        return false;
+    if (existsSync(p)) {
+        const stat = lstatSync(p);
+        if (stat.isSymbolicLink())
+            return false;
+        rmSync(p, { recursive: true, force: true });
+    }
+    const skillsDir = projectSkillsDir(projectDir);
+    if (!existsSync(skillsDir))
+        mkdirSync(skillsDir, { recursive: true });
+    symlinkSync(user.userPath, p, 'dir');
+    return true;
+}
+/**
+ * Bulk link every user-level skill into the project. Idempotent:
+ * - absent → symlink（或回退 cpSync）
+ * - linked → 保留
+ * - frozen → 保留（用户已 freeze 的不重建）
+ */
+export function syncAllSkillsToProject(projectDir) {
+    const users = listUserSkills();
+    let linked = 0;
+    let copied = 0;
+    let kept = 0;
+    for (const u of users) {
+        const r = addSkillToProject(projectDir, u.name);
+        if (r === 'linked')
+            linked++;
+        else if (r === 'copied')
+            copied++;
+        else
+            kept++;
+    }
+    return { linked, copied, kept };
+}
+/**
+ * claude 项目桥接:把**项目专属** skill(`<项目>/.sps/skills`)投影进 claude 的项目目录
+ * (`<项目>/.claude/skills`),让 claude worker 原生发现它们。openai/codex 直接读 `.sps/skills`,
+ * 不需要这步;全局 skill 走 syncAllSkillsToProject 另投影。幂等:目标已存在则跳过,不覆盖。
+ */
+export function linkProjectSkillsToClaude(projectDir) {
+    const src = resolve(projectDir, '.sps', 'skills');
+    if (!existsSync(src))
+        return { linked: 0, kept: 0 };
+    const dstRoot = projectSkillsDir(projectDir); // <项目>/.claude/skills
+    if (!existsSync(dstRoot))
+        mkdirSync(dstRoot, { recursive: true });
+    let linked = 0;
+    let kept = 0;
+    for (const e of readdirSync(src, { withFileTypes: true })) {
+        const from = resolve(src, e.name);
+        const isDir = e.isDirectory() || (e.isSymbolicLink() && safeIsDir(from));
+        if (!isDir || !existsSync(resolve(from, 'SKILL.md')))
+            continue;
+        const dst = resolve(dstRoot, e.name);
+        if (existsSync(dst) || isDanglingSymlink(dst)) {
+            kept++; // 已有(全局投影 / 真实目录 / 旧链)→ 不覆盖
+            continue;
+        }
+        try {
+            symlinkSync(from, dst, 'dir');
+        }
+        catch {
+            cpSync(from, dst, { recursive: true, force: false });
+        }
+        linked++;
+    }
+    return { linked, kept };
+}
+/**
+ * 把 bundled skills（npm 包内 skills/）拷贝到 ~/.coral/skills/。
+ *
+ * 默认 non-destructive：已存在的 skill 目录保留，不覆盖用户改动。
+ * `force=true`（v0.51.2+）：用 bundled 的 SKILL.md 覆盖（升级 sps-cli 后拉新 SOP）。
+ *   注意：force 会覆盖用户对 ~/.coral/skills/<name>/ 的直接编辑。如想保留定制，
+ *   先 `sps skill freeze <name> --project <p>` 把它固化到项目级（项目级副本不受
+ *   sync 影响）。
+ *
+ * Bundled → user 必须是 cpSync，因为 npm 包路径会随重装变化，symlink 会失效。
+ */
+export function syncBundledSkillsToUser(bundledSkillsDir, opts = {}) {
+    if (!existsSync(bundledSkillsDir))
+        return { copied: 0, updated: 0, skipped: 0 };
+    if (!existsSync(USER_SKILLS_DIR))
+        mkdirSync(USER_SKILLS_DIR, { recursive: true });
+    let copied = 0;
+    let updated = 0;
+    let skipped = 0;
+    const entries = readdirSync(bundledSkillsDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const src = resolve(bundledSkillsDir, entry.name);
+        if (!existsSync(resolve(src, 'SKILL.md')))
+            continue;
+        const dst = resolve(USER_SKILLS_DIR, entry.name);
+        if (existsSync(dst)) {
+            if (opts.force) {
+                cpSync(src, dst, { recursive: true, force: true });
+                updated++;
+            }
+            else {
+                skipped++;
+            }
+            continue;
+        }
+        cpSync(src, dst, { recursive: true, force: false });
+        copied++;
+    }
+    return { copied, updated, skipped };
+}
+/**
+ * 把 .claude/skills/ 条目追加到 .gitignore（幂等）。
+ * 项目级 skill 是 symlink 到本机 ~/.coral/，不该进仓库。
+ */
+export function ensureSkillsGitignore(projectDir) {
+    const gitignore = resolve(projectDir, '.gitignore');
+    const entry = '.claude/skills/';
+    let existing = '';
+    if (existsSync(gitignore))
+        existing = readFileSync(gitignore, 'utf-8');
+    const has = existing
+        .split('\n')
+        .map((l) => l.trim())
+        .some((l) => l === entry || l === '.claude/skills');
+    if (has)
+        return;
+    const prefix = existing && !existing.endsWith('\n') ? '\n' : '';
+    appendFileSync(gitignore, `${prefix}${entry}\n`);
+}
+function isDanglingSymlink(p) {
+    try {
+        const stat = lstatSync(p);
+        return stat.isSymbolicLink();
+    }
+    catch {
+        return false;
+    }
+}
+/** 跟随 symlink 判断是否目录(坏链/不存在 → false)。 */
+function safeIsDir(p) {
+    try {
+        return statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=distribution.js.map

package/dist/core/skills/distribution.js.map

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

package/dist/core/skills/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @module        core/skills
+ * @description   skills 子系统统一出口。两块职责:
+ *                  - distribution —— 分发(symlink/freeze/sync,user ↔ project)
+ *                  - SkillsManager —— 发现/加载/检索(后端无关单一源)
+ *                设计:docs/adapters/skills-manager-design.md。
+ * @layer         core
+ * @boundedContext skills
+ */
+export * from './types.js';
+export { SkillsManager, type SkillsManagerOpts } from './SkillsManager.js';
+export * from './distribution.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,cAAc,mBAAmB,CAAC"}

package/dist/core/skills/index.js

@@ -0,0 +1,13 @@
+/**
+ * @module        core/skills
+ * @description   skills 子系统统一出口。两块职责:
+ *                  - distribution —— 分发(symlink/freeze/sync,user ↔ project)
+ *                  - SkillsManager —— 发现/加载/检索(后端无关单一源)
+ *                设计:docs/adapters/skills-manager-design.md。
+ * @layer         core
+ * @boundedContext skills
+ */
+export * from './types.js';
+export { SkillsManager } from './SkillsManager.js';
+export * from './distribution.js';
+//# sourceMappingURL=index.js.map

package/dist/core/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,aAAa,EAA0B,MAAM,oBAAoB,CAAC;AAC3E,cAAc,mBAAmB,CAAC"}