@xdxer/dingtalk-agent 0.1.4-beta.2 → 0.1.4-beta.4

package/dist/src/skill-manager.js

@@ -1,38 +1,32 @@
-// 全局 Skill 生命周期：一个 canonical copy，按 Agent 客户端暴露。
-//
-// canonical: ~/.agents/skills/dingtalk-basic-behavior
-// Claude:    ~/.claude/skills/dingtalk-basic-behavior -> canonical
-//
-// 不链接 npm/node_modules：包升级、卸载或 npx cache 清理都不应让 Skill 断掉。
-import { cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync, readdirSync, renameSync, rmSync, symlinkSync, writeFileSync, } from 'node:fs';
-import { createHash, randomUUID } from 'node:crypto';
+// Skill 安装生命周期由开放生态的 `npx skills` 负责。
+// dingtalk-agent 只做两件事：把内置 Skill 目录交给上游 CLI；只读验证客户端能否发现。
+import { existsSync, lstatSync, readFileSync, readlinkSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { dirname, join, relative, resolve } from 'node:path';
+import { dirname, join, resolve } from 'node:path';
+import { spawnSync } from 'node:child_process';
 export const GLOBAL_SKILL_NAME = 'dingtalk-basic-behavior';
-const MARKER = '.dingtalk-agent-install.json';
-const MANAGER = '@xdxer/dingtalk-agent';
+const SKILLS_PACKAGE = 'skills@latest';
+const REGISTRY = 'https://registry.npmjs.org';
+const AGENTS = ['claude-code', 'codex', 'opencode'];
 export function skillStatus(packageRoot, options = {}) {
     const paths = globalPaths(packageRoot, options.home);
     const bundled = bundledInfo(packageRoot);
-    const marker = readMarker(paths.canonical);
-    const canonicalExists = pathExists(paths.canonical);
-    const canonicalDirectory = canonicalExists && lstatSync(paths.canonical).isDirectory();
-    const installedHash = canonicalDirectory ? hashDirectory(paths.canonical) : '';
-    const managed = marker?.manager === MANAGER;
-    const modified = Boolean(managed && installedHash !== marker?.sourceHash);
+    const canonicalExists = isDirectory(paths.canonical);
+    const installedVersion = canonicalExists
+        ? parseSkillFrontmatter(readFileSync(join(paths.canonical, 'SKILL.md'), 'utf8')).version
+        : '';
     const claude = inspectExposure(paths.claude, paths.canonical);
     const sharedState = canonicalExists ? 'ok' : 'missing';
     return {
-        $schema: 'dingtalk-agent/skill-status@1',
+        $schema: 'dingtalk-agent/skill-status@2',
         name: GLOBAL_SKILL_NAME,
+        manager: 'skills-cli',
         bundled,
         canonical: {
             path: paths.canonical,
             exists: canonicalExists,
-            managed,
-            installedHash,
-            modified,
-            current: Boolean(managed && !modified && installedHash === bundled.hash),
+            installedVersion,
+            current: Boolean(canonicalExists && installedVersion === bundled.skillVersion),
         },
         claude: { path: paths.claude, ...claude },
         clients: [
@@ -49,144 +43,76 @@ export function skillStatus(packageRoot, options = {}) {
                 path: paths.canonical, state: sharedState,
             },
         ],
-        legacyCodex: { path: paths.legacyCodex, conflict: pathExists(paths.legacyCodex) },
     };
 }
 export function installGlobalSkill(packageRoot, options = {}) {
-    const before = skillStatus(packageRoot, options);
-    if (before.canonical.exists) {
-        if (!before.canonical.managed) {
-            throw new Error(`全局 Skill 同名目录不归 dingtalk-agent 管理，拒绝覆盖: ${before.canonical.path}`);
-        }
-        if (before.canonical.modified) {
-            throw new Error(`全局 Skill 有本地修改，拒绝覆盖: ${before.canonical.path}`);
-        }
-        if (!before.canonical.current) {
-            throw new Error('已安装版本不是当前内置版本；请运行 `dingtalk-agent skill upgrade`');
-        }
-        ensureClaudeExposure(before.canonical.path, before.claude.path, options.dryRun);
-        return options.dryRun ? before : skillStatus(packageRoot, options);
-    }
-    if (before.claude.state === 'conflict') {
-        throw new Error(`Claude Skill 路径已有陌生内容，拒绝覆盖: ${before.claude.path}`);
-    }
-    if (!options.dryRun) {
-        installCanonical(packageRoot, before.canonical.path);
-        ensureClaudeExposure(before.canonical.path, before.claude.path, false);
-    }
-    return options.dryRun ? before : skillStatus(packageRoot, options);
+    return runSkills(packageRoot, 'install', [
+        'add', globalPaths(packageRoot).source,
+        '--global', '--yes', '--agent', ...AGENTS,
+    ], options);
 }
 export function upgradeGlobalSkill(packageRoot, options = {}) {
-    const before = skillStatus(packageRoot, options);
-    if (!before.canonical.exists)
-        return installGlobalSkill(packageRoot, options);
-    if (!before.canonical.managed) {
-        throw new Error(`全局 Skill 不归 dingtalk-agent 管理，拒绝接管: ${before.canonical.path}`);
-    }
-    if (before.canonical.modified && !options.discardLocalChanges) {
-        throw new Error('全局 Skill 有本地修改；先保存改动，或显式使用 `--discard-local-changes` 放弃修改');
-    }
-    if (before.claude.state === 'conflict') {
-        throw new Error(`Claude Skill 路径已有陌生内容，拒绝覆盖: ${before.claude.path}`);
-    }
-    if (!options.dryRun && !before.canonical.current) {
-        replaceCanonical(packageRoot, before.canonical.path);
-    }
-    ensureClaudeExposure(before.canonical.path, before.claude.path, options.dryRun);
-    return options.dryRun ? before : skillStatus(packageRoot, options);
+    // Skill 随 npm 包发布；重新 add 当前包内目录，让 skills CLI 执行自己的覆盖/链接语义。
+    return runSkills(packageRoot, 'upgrade', [
+        'add', globalPaths(packageRoot).source,
+        '--global', '--yes', '--agent', ...AGENTS,
+    ], options);
 }
 export function uninstallGlobalSkill(packageRoot, options = {}) {
+    return runSkills(packageRoot, 'uninstall', [
+        'remove', GLOBAL_SKILL_NAME,
+        '--global', '--yes', '--agent', ...AGENTS,
+    ], options);
+}
+function runSkills(packageRoot, action, args, options) {
+    const commandArgs = ['--yes', `--registry=${REGISTRY}`, SKILLS_PACKAGE, ...args];
+    const command = ['npx', ...commandArgs].map(shellQuote).join(' ');
     const before = skillStatus(packageRoot, options);
-    if (!before.canonical.exists)
-        return before;
-    if (!before.canonical.managed) {
-        throw new Error(`全局 Skill 不归 dingtalk-agent 管理，拒绝删除: ${before.canonical.path}`);
-    }
-    if (before.canonical.modified && !options.discardLocalChanges) {
-        throw new Error('全局 Skill 有本地修改；先保存改动，或显式使用 `--discard-local-changes` 放弃修改');
-    }
-    if (!options.dryRun) {
-        if (before.claude.state === 'ok')
-            rmSync(before.claude.path);
-        rmSync(before.canonical.path, { recursive: true, force: true });
+    if (options.dryRun) {
+        return {
+            ...before,
+            operation: { action, command, executed: false, exitCode: null, output: '' },
+        };
+    }
+    const env = {
+        ...process.env,
+        ...(options.env || {}),
+        HOME: options.home || options.env?.HOME || process.env.HOME || homedir(),
+    };
+    const run = spawnSync('npx', commandArgs, {
+        encoding: 'utf8', env, timeout: 120_000,
+    });
+    const output = [run.stdout, run.stderr].filter(Boolean).join('\n').trim();
+    if (run.error || run.status !== 0) {
+        const reason = run.error?.code === 'ENOENT'
+            ? 'PATH 找不到 npx；请安装带 npm/npx 的 Node.js 18.3+'
+            : run.error?.message || output || `退出码 ${run.status}`;
+        throw new Error(`skills CLI ${action} 失败: ${reason}\n` +
+            `可手动执行: ${command}`);
     }
-    return options.dryRun ? before : skillStatus(packageRoot, options);
+    return {
+        ...skillStatus(packageRoot, options),
+        operation: { action, command, executed: true, exitCode: run.status, output },
+    };
 }
 function globalPaths(packageRoot, home = homedir()) {
     return {
         source: join(packageRoot, 'skills', GLOBAL_SKILL_NAME),
         canonical: join(home, '.agents', 'skills', GLOBAL_SKILL_NAME),
         claude: join(home, '.claude', 'skills', GLOBAL_SKILL_NAME),
-        legacyCodex: join(home, '.codex', 'skills', GLOBAL_SKILL_NAME),
     };
 }
 function bundledInfo(packageRoot) {
-    const paths = globalPaths(packageRoot);
-    validateSkill(paths.source);
+    const source = globalPaths(packageRoot).source;
+    validateSkill(source);
     const pkg = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'));
-    const frontmatter = parseSkillFrontmatter(readFileSync(join(paths.source, 'SKILL.md'), 'utf8'));
+    const frontmatter = parseSkillFrontmatter(readFileSync(join(source, 'SKILL.md'), 'utf8'));
     return {
-        path: paths.source,
+        path: source,
         packageVersion: String(pkg.version || ''),
         skillVersion: frontmatter.version,
-        hash: hashDirectory(paths.source),
     };
 }
-function installCanonical(packageRoot, destination) {
-    const source = globalPaths(packageRoot).source;
-    const bundled = bundledInfo(packageRoot);
-    const parent = dirname(destination);
-    mkdirSync(parent, { recursive: true });
-    const stage = join(parent, `.${GLOBAL_SKILL_NAME}.stage.${process.pid}.${randomUUID()}`);
-    try {
-        cpSync(source, stage, { recursive: true, errorOnExist: true, force: false });
-        writeFileSync(join(stage, MARKER), JSON.stringify(markerFor(bundled), null, 2) + '\n', { flag: 'wx' });
-        validateSkill(stage);
-        if (hashDirectory(stage) !== bundled.hash)
-            throw new Error('Skill staging hash 与内置版本不一致');
-        renameSync(stage, destination);
-    }
-    finally {
-        rmSync(stage, { recursive: true, force: true });
-    }
-}
-function replaceCanonical(packageRoot, destination) {
-    const parent = dirname(destination);
-    const backup = join(parent, `.${GLOBAL_SKILL_NAME}.backup.${process.pid}.${randomUUID()}`);
-    const stageDestination = join(parent, `.${GLOBAL_SKILL_NAME}.next.${process.pid}.${randomUUID()}`);
-    installCanonical(packageRoot, stageDestination);
-    renameSync(destination, backup);
-    try {
-        renameSync(stageDestination, destination);
-        rmSync(backup, { recursive: true, force: true });
-    }
-    catch (error) {
-        if (!existsSync(destination) && existsSync(backup))
-            renameSync(backup, destination);
-        throw error;
-    }
-    finally {
-        rmSync(stageDestination, { recursive: true, force: true });
-    }
-}
-function ensureClaudeExposure(canonical, exposure, dryRun = false) {
-    const state = inspectExposure(exposure, canonical);
-    if (state.state === 'ok')
-        return;
-    if (state.state === 'conflict')
-        throw new Error(`Claude Skill 路径已有陌生内容: ${exposure}`);
-    if (dryRun)
-        return;
-    mkdirSync(dirname(exposure), { recursive: true });
-    const target = relative(dirname(exposure), canonical) || '.';
-    try {
-        symlinkSync(target, exposure, 'dir');
-    }
-    catch (error) {
-        throw new Error(`无法为 Claude Code 创建 Skill symlink: ${String(error.message || error)}；` +
-            '请检查 ~/.claude/skills 的写权限');
-    }
-}
 function inspectExposure(exposure, canonical) {
     if (!pathExists(exposure))
         return { state: 'missing', target: '' };
@@ -194,47 +120,13 @@ function inspectExposure(exposure, canonical) {
     if (!stat.isSymbolicLink())
         return { state: 'conflict', target: '' };
     const raw = readlinkSync(exposure);
-    const target = resolve(dirname(exposure), raw);
-    return target === resolve(canonical)
+    return resolve(dirname(exposure), raw) === resolve(canonical)
         ? { state: 'ok', target: raw }
         : { state: 'conflict', target: raw };
 }
-function markerFor(bundled) {
-    return {
-        $schema: 'dingtalk-agent/managed-skill@1',
-        manager: MANAGER,
-        packageVersion: bundled.packageVersion,
-        skillVersion: bundled.skillVersion,
-        sourceHash: bundled.hash,
-        installedAt: new Date().toISOString(),
-        exposure: { claude: 'symlink' },
-    };
-}
-function readMarker(skillRoot) {
-    const path = join(skillRoot, MARKER);
-    if (!existsSync(path))
-        return null;
-    try {
-        const value = JSON.parse(readFileSync(path, 'utf8'));
-        return value?.$schema === 'dingtalk-agent/managed-skill@1' ? value : null;
-    }
-    catch {
-        return null;
-    }
-}
-function pathExists(path) {
-    try {
-        lstatSync(path);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 function validateSkill(root) {
-    if (!existsSync(root) || !lstatSync(root).isDirectory()) {
+    if (!isDirectory(root))
         throw new Error(`内置 Skill 不存在: ${root}`);
-    }
     const file = join(root, 'SKILL.md');
     if (!existsSync(file))
         throw new Error(`Skill 缺少 SKILL.md: ${root}`);
@@ -261,28 +153,24 @@ function parseSkillFrontmatter(text) {
         version: nestedVersion?.[1]?.trim() || readScalar('version'),
     };
 }
-function hashDirectory(root) {
-    const hash = createHash('sha256');
-    for (const path of walk(root)) {
-        const rel = relative(root, path).split('\\').join('/');
-        if (rel === MARKER)
-            continue;
-        hash.update(rel).update('\0').update(readFileSync(path)).update('\0');
+function isDirectory(path) {
+    try {
+        return lstatSync(path).isDirectory();
+    }
+    catch {
+        return false;
     }
-    return hash.digest('hex');
 }
-function walk(root) {
-    const out = [];
-    for (const name of readdirSync(root).sort()) {
-        const path = join(root, name);
-        const stat = lstatSync(path);
-        if (stat.isSymbolicLink())
-            throw new Error(`Skill 内不允许符号链接: ${path}`);
-        if (stat.isDirectory())
-            out.push(...walk(path));
-        else if (stat.isFile())
-            out.push(path);
+function pathExists(path) {
+    try {
+        lstatSync(path);
+        return true;
     }
-    return out;
+    catch {
+        return false;
+    }
+}
+function shellQuote(value) {
+    return /^[A-Za-z0-9_./:=@-]+$/.test(value) ? value : `'${value.replace(/'/g, `'"'"'`)}'`;
 }
 //# sourceMappingURL=skill-manager.js.map

package/dist/src/skill-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-manager.js","sourceRoot":"","sources":["../../src/skill-manager.ts"],"names":[],"mappings":"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","sourcesContent":["// 全局 Skill 生命周期：一个 canonical copy，按 Agent 客户端暴露。\n//\n// canonical: ~/.agents/skills/dingtalk-basic-behavior\n// Claude:    ~/.claude/skills/dingtalk-basic-behavior -> canonical\n//\n// 不链接 npm/node_modules：包升级、卸载或 npx cache 清理都不应让 Skill 断掉。\n\nimport {\n  cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync,\n  readdirSync, renameSync, rmSync, symlinkSync, writeFileSync,\n} from 'node:fs'\nimport { createHash, randomUUID } from 'node:crypto'\nimport { homedir } from 'node:os'\nimport { dirname, join, relative, resolve } from 'node:path'\n\nexport const GLOBAL_SKILL_NAME = 'dingtalk-basic-behavior'\nconst MARKER = '.dingtalk-agent-install.json'\nconst MANAGER = '@xdxer/dingtalk-agent'\n\ninterface InstallMarker {\n  $schema: 'dingtalk-agent/managed-skill@1'\n  manager: typeof MANAGER\n  packageVersion: string\n  skillVersion: string\n  sourceHash: string\n  installedAt: string\n  exposure: { claude: 'symlink' }\n}\n\nexport interface SkillManagerOptions {\n  home?: string\n  dryRun?: boolean\n  discardLocalChanges?: boolean\n}\n\nexport interface GlobalSkillStatus {\n  $schema: 'dingtalk-agent/skill-status@1'\n  name: string\n  bundled: { path: string; packageVersion: string; skillVersion: string; hash: string }\n  canonical: {\n    path: string\n    exists: boolean\n    managed: boolean\n    installedHash: string\n    modified: boolean\n    current: boolean\n  }\n  claude: { path: string; state: 'ok' | 'missing' | 'conflict'; target: string }\n  clients: Array<{\n    name: 'claude-code' | 'codex' | 'opencode'\n    label: string\n    discovery: 'symlink' | 'shared-agent-skills'\n    path: string\n    state: 'ok' | 'missing' | 'conflict'\n  }>\n  legacyCodex: { path: string; conflict: boolean }\n}\n\nexport function skillStatus(packageRoot: string, options: SkillManagerOptions = {}): GlobalSkillStatus {\n  const paths = globalPaths(packageRoot, options.home)\n  const bundled = bundledInfo(packageRoot)\n  const marker = readMarker(paths.canonical)\n  const canonicalExists = pathExists(paths.canonical)\n  const canonicalDirectory = canonicalExists && lstatSync(paths.canonical).isDirectory()\n  const installedHash = canonicalDirectory ? hashDirectory(paths.canonical) : ''\n  const managed = marker?.manager === MANAGER\n  const modified = Boolean(managed && installedHash !== marker?.sourceHash)\n  const claude = inspectExposure(paths.claude, paths.canonical)\n  const sharedState = canonicalExists ? 'ok' : 'missing'\n  return {\n    $schema: 'dingtalk-agent/skill-status@1',\n    name: GLOBAL_SKILL_NAME,\n    bundled,\n    canonical: {\n      path: paths.canonical,\n      exists: canonicalExists,\n      managed,\n      installedHash,\n      modified,\n      current: Boolean(managed && !modified && installedHash === bundled.hash),\n    },\n    claude: { path: paths.claude, ...claude },\n    clients: [\n      {\n        name: 'claude-code', label: 'Claude Code', discovery: 'symlink',\n        path: paths.claude, state: claude.state,\n      },\n      {\n        name: 'codex', label: 'Codex', discovery: 'shared-agent-skills',\n        path: paths.canonical, state: sharedState,\n      },\n      {\n        name: 'opencode', label: 'OpenCode', discovery: 'shared-agent-skills',\n        path: paths.canonical, state: sharedState,\n      },\n    ],\n    legacyCodex: { path: paths.legacyCodex, conflict: pathExists(paths.legacyCodex) },\n  }\n}\n\nexport function installGlobalSkill(\n  packageRoot: string,\n  options: SkillManagerOptions = {},\n): GlobalSkillStatus {\n  const before = skillStatus(packageRoot, options)\n  if (before.canonical.exists) {\n    if (!before.canonical.managed) {\n      throw new Error(`全局 Skill 同名目录不归 dingtalk-agent 管理，拒绝覆盖: ${before.canonical.path}`)\n    }\n    if (before.canonical.modified) {\n      throw new Error(`全局 Skill 有本地修改，拒绝覆盖: ${before.canonical.path}`)\n    }\n    if (!before.canonical.current) {\n      throw new Error('已安装版本不是当前内置版本；请运行 `dingtalk-agent skill upgrade`')\n    }\n    ensureClaudeExposure(before.canonical.path, before.claude.path, options.dryRun)\n    return options.dryRun ? before : skillStatus(packageRoot, options)\n  }\n\n  if (before.claude.state === 'conflict') {\n    throw new Error(`Claude Skill 路径已有陌生内容，拒绝覆盖: ${before.claude.path}`)\n  }\n  if (!options.dryRun) {\n    installCanonical(packageRoot, before.canonical.path)\n    ensureClaudeExposure(before.canonical.path, before.claude.path, false)\n  }\n  return options.dryRun ? before : skillStatus(packageRoot, options)\n}\n\nexport function upgradeGlobalSkill(\n  packageRoot: string,\n  options: SkillManagerOptions = {},\n): GlobalSkillStatus {\n  const before = skillStatus(packageRoot, options)\n  if (!before.canonical.exists) return installGlobalSkill(packageRoot, options)\n  if (!before.canonical.managed) {\n    throw new Error(`全局 Skill 不归 dingtalk-agent 管理，拒绝接管: ${before.canonical.path}`)\n  }\n  if (before.canonical.modified && !options.discardLocalChanges) {\n    throw new Error(\n      '全局 Skill 有本地修改；先保存改动，或显式使用 `--discard-local-changes` 放弃修改',\n    )\n  }\n  if (before.claude.state === 'conflict') {\n    throw new Error(`Claude Skill 路径已有陌生内容，拒绝覆盖: ${before.claude.path}`)\n  }\n  if (!options.dryRun && !before.canonical.current) {\n    replaceCanonical(packageRoot, before.canonical.path)\n  }\n  ensureClaudeExposure(before.canonical.path, before.claude.path, options.dryRun)\n  return options.dryRun ? before : skillStatus(packageRoot, options)\n}\n\nexport function uninstallGlobalSkill(\n  packageRoot: string,\n  options: SkillManagerOptions = {},\n): GlobalSkillStatus {\n  const before = skillStatus(packageRoot, options)\n  if (!before.canonical.exists) return before\n  if (!before.canonical.managed) {\n    throw new Error(`全局 Skill 不归 dingtalk-agent 管理，拒绝删除: ${before.canonical.path}`)\n  }\n  if (before.canonical.modified && !options.discardLocalChanges) {\n    throw new Error(\n      '全局 Skill 有本地修改；先保存改动，或显式使用 `--discard-local-changes` 放弃修改',\n    )\n  }\n  if (!options.dryRun) {\n    if (before.claude.state === 'ok') rmSync(before.claude.path)\n    rmSync(before.canonical.path, { recursive: true, force: true })\n  }\n  return options.dryRun ? before : skillStatus(packageRoot, options)\n}\n\nfunction globalPaths(packageRoot: string, home = homedir()) {\n  return {\n    source: join(packageRoot, 'skills', GLOBAL_SKILL_NAME),\n    canonical: join(home, '.agents', 'skills', GLOBAL_SKILL_NAME),\n    claude: join(home, '.claude', 'skills', GLOBAL_SKILL_NAME),\n    legacyCodex: join(home, '.codex', 'skills', GLOBAL_SKILL_NAME),\n  }\n}\n\nfunction bundledInfo(packageRoot: string) {\n  const paths = globalPaths(packageRoot)\n  validateSkill(paths.source)\n  const pkg = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'))\n  const frontmatter = parseSkillFrontmatter(readFileSync(join(paths.source, 'SKILL.md'), 'utf8'))\n  return {\n    path: paths.source,\n    packageVersion: String(pkg.version || ''),\n    skillVersion: frontmatter.version,\n    hash: hashDirectory(paths.source),\n  }\n}\n\nfunction installCanonical(packageRoot: string, destination: string): void {\n  const source = globalPaths(packageRoot).source\n  const bundled = bundledInfo(packageRoot)\n  const parent = dirname(destination)\n  mkdirSync(parent, { recursive: true })\n  const stage = join(parent, `.${GLOBAL_SKILL_NAME}.stage.${process.pid}.${randomUUID()}`)\n  try {\n    cpSync(source, stage, { recursive: true, errorOnExist: true, force: false })\n    writeFileSync(join(stage, MARKER), JSON.stringify(markerFor(bundled), null, 2) + '\\n', { flag: 'wx' })\n    validateSkill(stage)\n    if (hashDirectory(stage) !== bundled.hash) throw new Error('Skill staging hash 与内置版本不一致')\n    renameSync(stage, destination)\n  } finally {\n    rmSync(stage, { recursive: true, force: true })\n  }\n}\n\nfunction replaceCanonical(packageRoot: string, destination: string): void {\n  const parent = dirname(destination)\n  const backup = join(parent, `.${GLOBAL_SKILL_NAME}.backup.${process.pid}.${randomUUID()}`)\n  const stageDestination = join(parent, `.${GLOBAL_SKILL_NAME}.next.${process.pid}.${randomUUID()}`)\n  installCanonical(packageRoot, stageDestination)\n  renameSync(destination, backup)\n  try {\n    renameSync(stageDestination, destination)\n    rmSync(backup, { recursive: true, force: true })\n  } catch (error) {\n    if (!existsSync(destination) && existsSync(backup)) renameSync(backup, destination)\n    throw error\n  } finally {\n    rmSync(stageDestination, { recursive: true, force: true })\n  }\n}\n\nfunction ensureClaudeExposure(canonical: string, exposure: string, dryRun = false): void {\n  const state = inspectExposure(exposure, canonical)\n  if (state.state === 'ok') return\n  if (state.state === 'conflict') throw new Error(`Claude Skill 路径已有陌生内容: ${exposure}`)\n  if (dryRun) return\n  mkdirSync(dirname(exposure), { recursive: true })\n  const target = relative(dirname(exposure), canonical) || '.'\n  try {\n    symlinkSync(target, exposure, 'dir')\n  } catch (error) {\n    throw new Error(\n      `无法为 Claude Code 创建 Skill symlink: ${String(error.message || error)}；` +\n      '请检查 ~/.claude/skills 的写权限',\n    )\n  }\n}\n\nfunction inspectExposure(exposure: string, canonical: string): {\n  state: 'ok' | 'missing' | 'conflict'\n  target: string\n} {\n  if (!pathExists(exposure)) return { state: 'missing', target: '' }\n  const stat = lstatSync(exposure)\n  if (!stat.isSymbolicLink()) return { state: 'conflict', target: '' }\n  const raw = readlinkSync(exposure)\n  const target = resolve(dirname(exposure), raw)\n  return target === resolve(canonical)\n    ? { state: 'ok', target: raw }\n    : { state: 'conflict', target: raw }\n}\n\nfunction markerFor(bundled: ReturnType<typeof bundledInfo>): InstallMarker {\n  return {\n    $schema: 'dingtalk-agent/managed-skill@1',\n    manager: MANAGER,\n    packageVersion: bundled.packageVersion,\n    skillVersion: bundled.skillVersion,\n    sourceHash: bundled.hash,\n    installedAt: new Date().toISOString(),\n    exposure: { claude: 'symlink' },\n  }\n}\n\nfunction readMarker(skillRoot: string): InstallMarker | null {\n  const path = join(skillRoot, MARKER)\n  if (!existsSync(path)) return null\n  try {\n    const value = JSON.parse(readFileSync(path, 'utf8'))\n    return value?.$schema === 'dingtalk-agent/managed-skill@1' ? value : null\n  } catch { return null }\n}\n\nfunction pathExists(path: string): boolean {\n  try { lstatSync(path); return true } catch { return false }\n}\n\nfunction validateSkill(root: string): void {\n  if (!existsSync(root) || !lstatSync(root).isDirectory()) {\n    throw new Error(`内置 Skill 不存在: ${root}`)\n  }\n  const file = join(root, 'SKILL.md')\n  if (!existsSync(file)) throw new Error(`Skill 缺少 SKILL.md: ${root}`)\n  const metadata = parseSkillFrontmatter(readFileSync(file, 'utf8'))\n  if (metadata.name !== GLOBAL_SKILL_NAME) {\n    throw new Error(`Skill name=${metadata.name} 与目录名 ${GLOBAL_SKILL_NAME} 不一致`)\n  }\n  if (!metadata.description) throw new Error('Skill frontmatter 缺少 description')\n}\n\nfunction parseSkillFrontmatter(text: string): { name: string; description: string; version: string } {\n  const match = text.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---(?:\\r?\\n|$)/)\n  if (!match) throw new Error('SKILL.md 缺少 YAML frontmatter')\n  const block = match[1]\n  const readScalar = (key: string) => {\n    const found = block.match(new RegExp(`^${key}:\\\\s*(.+)$`, 'm'))\n    return found ? found[1].trim().replace(/^(['\"])(.*)\\1$/, '$2') : ''\n  }\n  const nestedVersion = block.match(/^metadata:\\s*\\r?\\n(?:[ \\t]+.*\\r?\\n)*?[ \\t]+version:\\s*['\"]?([^'\"\\r\\n]+)['\"]?\\s*$/m)\n  return {\n    name: readScalar('name'),\n    description: readScalar('description'),\n    version: nestedVersion?.[1]?.trim() || readScalar('version'),\n  }\n}\n\nfunction hashDirectory(root: string): string {\n  const hash = createHash('sha256')\n  for (const path of walk(root)) {\n    const rel = relative(root, path).split('\\\\').join('/')\n    if (rel === MARKER) continue\n    hash.update(rel).update('\\0').update(readFileSync(path)).update('\\0')\n  }\n  return hash.digest('hex')\n}\n\nfunction walk(root: string): string[] {\n  const out: string[] = []\n  for (const name of readdirSync(root).sort()) {\n    const path = join(root, name)\n    const stat = lstatSync(path)\n    if (stat.isSymbolicLink()) throw new Error(`Skill 内不允许符号链接: ${path}`)\n    if (stat.isDirectory()) out.push(...walk(path))\n    else if (stat.isFile()) out.push(path)\n  }\n  return out\n}\n"]}
+{"version":3,"file":"skill-manager.js","sourceRoot":"","sources":["../../src/skill-manager.ts"],"names":[],"mappings":"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","sourcesContent":["// Skill 安装生命周期由开放生态的 `npx skills` 负责。\n// dingtalk-agent 只做两件事：把内置 Skill 目录交给上游 CLI；只读验证客户端能否发现。\n\nimport { existsSync, lstatSync, readFileSync, readlinkSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { dirname, join, resolve } from 'node:path'\nimport { spawnSync } from 'node:child_process'\n\nexport const GLOBAL_SKILL_NAME = 'dingtalk-basic-behavior'\nconst SKILLS_PACKAGE = 'skills@latest'\nconst REGISTRY = 'https://registry.npmjs.org'\nconst AGENTS = ['claude-code', 'codex', 'opencode']\n\nexport interface SkillManagerOptions {\n  home?: string\n  dryRun?: boolean\n  env?: NodeJS.ProcessEnv\n}\n\nexport interface GlobalSkillStatus {\n  $schema: 'dingtalk-agent/skill-status@2'\n  name: string\n  manager: 'skills-cli'\n  bundled: { path: string; packageVersion: string; skillVersion: string }\n  canonical: {\n    path: string\n    exists: boolean\n    installedVersion: string\n    current: boolean\n  }\n  claude: { path: string; state: 'ok' | 'missing' | 'conflict'; target: string }\n  clients: Array<{\n    name: 'claude-code' | 'codex' | 'opencode'\n    label: string\n    discovery: 'symlink' | 'shared-agent-skills'\n    path: string\n    state: 'ok' | 'missing' | 'conflict'\n  }>\n  operation?: {\n    action: 'install' | 'upgrade' | 'uninstall'\n    command: string\n    executed: boolean\n    exitCode: number | null\n    output: string\n  }\n}\n\nexport function skillStatus(packageRoot: string, options: SkillManagerOptions = {}): GlobalSkillStatus {\n  const paths = globalPaths(packageRoot, options.home)\n  const bundled = bundledInfo(packageRoot)\n  const canonicalExists = isDirectory(paths.canonical)\n  const installedVersion = canonicalExists\n    ? parseSkillFrontmatter(readFileSync(join(paths.canonical, 'SKILL.md'), 'utf8')).version\n    : ''\n  const claude = inspectExposure(paths.claude, paths.canonical)\n  const sharedState = canonicalExists ? 'ok' : 'missing'\n  return {\n    $schema: 'dingtalk-agent/skill-status@2',\n    name: GLOBAL_SKILL_NAME,\n    manager: 'skills-cli',\n    bundled,\n    canonical: {\n      path: paths.canonical,\n      exists: canonicalExists,\n      installedVersion,\n      current: Boolean(canonicalExists && installedVersion === bundled.skillVersion),\n    },\n    claude: { path: paths.claude, ...claude },\n    clients: [\n      {\n        name: 'claude-code', label: 'Claude Code', discovery: 'symlink',\n        path: paths.claude, state: claude.state,\n      },\n      {\n        name: 'codex', label: 'Codex', discovery: 'shared-agent-skills',\n        path: paths.canonical, state: sharedState,\n      },\n      {\n        name: 'opencode', label: 'OpenCode', discovery: 'shared-agent-skills',\n        path: paths.canonical, state: sharedState,\n      },\n    ],\n  }\n}\n\nexport function installGlobalSkill(\n  packageRoot: string,\n  options: SkillManagerOptions = {},\n): GlobalSkillStatus {\n  return runSkills(packageRoot, 'install', [\n    'add', globalPaths(packageRoot).source,\n    '--global', '--yes', '--agent', ...AGENTS,\n  ], options)\n}\n\nexport function upgradeGlobalSkill(\n  packageRoot: string,\n  options: SkillManagerOptions = {},\n): GlobalSkillStatus {\n  // Skill 随 npm 包发布；重新 add 当前包内目录，让 skills CLI 执行自己的覆盖/链接语义。\n  return runSkills(packageRoot, 'upgrade', [\n    'add', globalPaths(packageRoot).source,\n    '--global', '--yes', '--agent', ...AGENTS,\n  ], options)\n}\n\nexport function uninstallGlobalSkill(\n  packageRoot: string,\n  options: SkillManagerOptions = {},\n): GlobalSkillStatus {\n  return runSkills(packageRoot, 'uninstall', [\n    'remove', GLOBAL_SKILL_NAME,\n    '--global', '--yes', '--agent', ...AGENTS,\n  ], options)\n}\n\nfunction runSkills(\n  packageRoot: string,\n  action: 'install' | 'upgrade' | 'uninstall',\n  args: string[],\n  options: SkillManagerOptions,\n): GlobalSkillStatus {\n  const commandArgs = ['--yes', `--registry=${REGISTRY}`, SKILLS_PACKAGE, ...args]\n  const command = ['npx', ...commandArgs].map(shellQuote).join(' ')\n  const before = skillStatus(packageRoot, options)\n  if (options.dryRun) {\n    return {\n      ...before,\n      operation: { action, command, executed: false, exitCode: null, output: '' },\n    }\n  }\n\n  const env = {\n    ...process.env,\n    ...(options.env || {}),\n    HOME: options.home || options.env?.HOME || process.env.HOME || homedir(),\n  }\n  const run = spawnSync('npx', commandArgs, {\n    encoding: 'utf8', env, timeout: 120_000,\n  })\n  const output = [run.stdout, run.stderr].filter(Boolean).join('\\n').trim()\n  if (run.error || run.status !== 0) {\n    const reason = (run.error as NodeJS.ErrnoException | undefined)?.code === 'ENOENT'\n      ? 'PATH 找不到 npx；请安装带 npm/npx 的 Node.js 18.3+'\n      : run.error?.message || output || `退出码 ${run.status}`\n    throw new Error(\n      `skills CLI ${action} 失败: ${reason}\\n` +\n      `可手动执行: ${command}`,\n    )\n  }\n  return {\n    ...skillStatus(packageRoot, options),\n    operation: { action, command, executed: true, exitCode: run.status, output },\n  }\n}\n\nfunction globalPaths(packageRoot: string, home = homedir()) {\n  return {\n    source: join(packageRoot, 'skills', GLOBAL_SKILL_NAME),\n    canonical: join(home, '.agents', 'skills', GLOBAL_SKILL_NAME),\n    claude: join(home, '.claude', 'skills', GLOBAL_SKILL_NAME),\n  }\n}\n\nfunction bundledInfo(packageRoot: string) {\n  const source = globalPaths(packageRoot).source\n  validateSkill(source)\n  const pkg = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'))\n  const frontmatter = parseSkillFrontmatter(readFileSync(join(source, 'SKILL.md'), 'utf8'))\n  return {\n    path: source,\n    packageVersion: String(pkg.version || ''),\n    skillVersion: frontmatter.version,\n  }\n}\n\nfunction inspectExposure(exposure: string, canonical: string): {\n  state: 'ok' | 'missing' | 'conflict'\n  target: string\n} {\n  if (!pathExists(exposure)) return { state: 'missing', target: '' }\n  const stat = lstatSync(exposure)\n  if (!stat.isSymbolicLink()) return { state: 'conflict', target: '' }\n  const raw = readlinkSync(exposure)\n  return resolve(dirname(exposure), raw) === resolve(canonical)\n    ? { state: 'ok', target: raw }\n    : { state: 'conflict', target: raw }\n}\n\nfunction validateSkill(root: string): void {\n  if (!isDirectory(root)) throw new Error(`内置 Skill 不存在: ${root}`)\n  const file = join(root, 'SKILL.md')\n  if (!existsSync(file)) throw new Error(`Skill 缺少 SKILL.md: ${root}`)\n  const metadata = parseSkillFrontmatter(readFileSync(file, 'utf8'))\n  if (metadata.name !== GLOBAL_SKILL_NAME) {\n    throw new Error(`Skill name=${metadata.name} 与目录名 ${GLOBAL_SKILL_NAME} 不一致`)\n  }\n  if (!metadata.description) throw new Error('Skill frontmatter 缺少 description')\n}\n\nfunction parseSkillFrontmatter(text: string): { name: string; description: string; version: string } {\n  const match = text.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---(?:\\r?\\n|$)/)\n  if (!match) throw new Error('SKILL.md 缺少 YAML frontmatter')\n  const block = match[1]\n  const readScalar = (key: string) => {\n    const found = block.match(new RegExp(`^${key}:\\\\s*(.+)$`, 'm'))\n    return found ? found[1].trim().replace(/^(['\"])(.*)\\1$/, '$2') : ''\n  }\n  const nestedVersion = block.match(/^metadata:\\s*\\r?\\n(?:[ \\t]+.*\\r?\\n)*?[ \\t]+version:\\s*['\"]?([^'\"\\r\\n]+)['\"]?\\s*$/m)\n  return {\n    name: readScalar('name'),\n    description: readScalar('description'),\n    version: nestedVersion?.[1]?.trim() || readScalar('version'),\n  }\n}\n\nfunction isDirectory(path: string): boolean {\n  try { return lstatSync(path).isDirectory() } catch { return false }\n}\n\nfunction pathExists(path: string): boolean {\n  try { lstatSync(path); return true } catch { return false }\n}\n\nfunction shellQuote(value: string): string {\n  return /^[A-Za-z0-9_./:=@-]+$/.test(value) ? value : `'${value.replace(/'/g, `'\"'\"'`)}'`\n}\n"]}

package/docs/ARCHITECTURE.md

@@ -88,7 +88,8 @@ Claude Tag 官方的线程模型与本项目高度一致：一个 thread 是一
 机器首次使用从不会依赖全局 PATH 的入口开始：
 
 ```bash
-npx --yes --registry=https://registry.npmjs.org @xdxer/dingtalk-agent@beta setup
+npx --yes --registry=https://registry.npmjs.org \
+  --package=@xdxer/dingtalk-agent@beta dta-setup setup
 ```
 
 `setup` 只处理用户级 CLI、PATH、DWS 健康/认证和全局 Skill；它不初始化当前代码仓库。普通 Session 随后直接 `bootstrap`，只有需要长期 Workspace 或 Prepared Run 时才 `init`。三者分开，避免把“机器缺命令”“Agent 缺行为”和“当前目录需要持久状态”混成一个不可恢复的大初始化。
@@ -214,4 +215,4 @@ npm run typecheck
 npm run eval:contract
 ```
 
-29 个确定性场景覆盖三条主链：setup/PATH/DWS/多客户端发现与错误提示、Skill-first 安装/水合，以及 Prepared Run 的 Session、Wait、幂等、目标与回执。
+29 个确定性场景覆盖三条主链：setup/PATH/DWS/多客户端发现与错误提示、基于 `npx skills` 的 Skill-first 安装/水合，以及 Prepared Run 的 Session、Wait、幂等、目标与回执。

package/docs/INSTALLATION.md

@@ -5,10 +5,11 @@
 首次使用永远从 `npx` 开始：
 
 ```bash
-npx --yes --registry=https://registry.npmjs.org @xdxer/dingtalk-agent@beta setup
+npx --yes --registry=https://registry.npmjs.org \
+  --package=@xdxer/dingtalk-agent@beta dta-setup setup
 ```
 
-安装完成后优先使用短命令；长短名称完全等价：
+`dta-setup` 是只用于 npx bootstrap 的独立 bin 名称。Why：如果 PATH 中已有旧版 `dta`，npm exec 可能直接复用旧 binary，而不执行指定的新版本；独立名称可以强制解析当前 npm 包。安装完成后优先使用短命令；`dta` 与完整名称完全等价：
 
 ```bash
 dta --version
@@ -50,7 +51,8 @@ export PATH="$HOME/.local/bin:$PATH"
 不希望修改 shell 配置时：
 
 ```bash
-npx --yes --registry=https://registry.npmjs.org @xdxer/dingtalk-agent@beta setup --no-shell-write
+npx --yes --registry=https://registry.npmjs.org \
+  --package=@xdxer/dingtalk-agent@beta dta-setup setup --no-shell-write
 ```
 
 ### DWS
@@ -73,7 +75,15 @@ dws auth login
 
 ## Skill 安装策略
 
-`dta skill install` 使用一份 canonical copy，避免 npm cache 清理或包升级导致软链接断裂：
+`dta` 不维护第二套 Skill 安装器。`dta skill install` 等价于把 npm 包内的 Skill 目录交给开放生态的 `npx skills add`：
+
+```bash
+npx --yes --registry=https://registry.npmjs.org skills@latest add \
+  <package>/skills/dingtalk-basic-behavior \
+  --global --yes --agent claude-code codex opencode
+```
+
+上游 `skills` CLI 负责 canonical copy、客户端链接、覆盖和卸载语义：
 
 | 客户端 | 发现方式 | 路径 |
 |---|---|---|
@@ -81,13 +91,16 @@ dws auth login
 | Codex | shared Agent Skills | `~/.agents/skills/dingtalk-basic-behavior` |
 | OpenCode | shared Agent Skills | `~/.agents/skills/dingtalk-basic-behavior` |
 
-安装器不会覆盖陌生同名目录，也不会静默覆盖用户对受管 Skill 的本地修改。检查和升级：
+检查、重装当前 npm 包内版本和卸载：
 
 ```bash
 dta skill status
 dta skill upgrade
+dta skill uninstall
 ```
 
+`skill status` 只做只读发现检查；`install/upgrade/uninstall` 分别委托 `skills add/add/remove`。旧版 dta 写入的管理 marker 会在第一次 `skills add` 时被上游 canonical copy 替换，此后不再存在两套管理状态。
+
 OpenCode 官方同时支持 `.opencode/skills`、`.claude/skills` 和 `.agents/skills`，所以不需要再复制第三份内容。
 
 ## 使用 npx skills
@@ -105,7 +118,7 @@ npx skills add ./skills/dingtalk-basic-behavior \
   --global --yes --agent claude-code --agent codex --agent opencode
 ```
 
-两种管理器不要交叉覆盖同一个安装。`dingtalk-agent` 发现 canonical 目录不归自己管理时会 fail closed；此时继续使用 `npx skills update/remove` 管理即可。
+也可以完全绕过 `dta skill ...`，直接使用 `npx skills` 管理；两种入口最终调用的是同一个上游安装器。
 
 ## 初始化的三个层级
 

package/evals/evals.json

@@ -214,13 +214,13 @@
     {
       "id": 20,
       "prompt": "在一个没有 Workspace 的空目录安装全局 Basic Behavior，重复安装，再制造一个同名陌生 Skill。",
-      "expected_output": "安装不依赖 init；canonical copy 可被 Codex 发现，Claude 使用相对 symlink；重复安装幂等；陌生同名目录绝不覆盖。",
+      "expected_output": "安装不依赖 init；dta 将本地 Skill source 委托给 npx skills；canonical copy 可被 Codex/OpenCode 发现，Claude 使用 symlink；重复安装由上游处理。",
       "files": [],
       "expectations": [
         "空目录可直接安装 canonical Skill",
-        "重复安装保持 current 且无漂移",
-        "Claude exposure 是指向 canonical 的相对 symlink",
-        "同名陌生 Skill 被 fail closed"
+        "重复安装由 skills CLI 执行并保持 current",
+        "Claude exposure 指向 canonical copy",
+        "安装结果不再包含 dta 自定义管理 marker"
       ]
     },
     {
@@ -259,14 +259,14 @@
     },
     {
       "id": 24,
-      "prompt": "安装受管 Skill 后手工修改内容，再尝试 upgrade/uninstall，最后显式放弃本地修改并卸载。",
-      "expected_output": "status 识别漂移；默认升级和卸载都保护本地修改；显式 discard 后原子修复；卸载只移除受管 canonical 与准确的 Claude exposure。",
+      "prompt": "通过 dta 安装 Skill 后手工修改内容，再执行 upgrade 和 uninstall。",
+      "expected_output": "status 只读报告 skills-cli 管理状态；upgrade 通过 npx skills add 重装；uninstall 通过 npx skills remove 清理所有目标客户端。",
       "files": [],
       "expectations": [
-        "受管 Skill 的本地漂移可被检测",
-        "upgrade 默认不覆盖本地修改",
-        "uninstall 默认不删除本地修改",
-        "显式 discard 可修复，随后安全卸载 canonical 与 exposure"
+        "status 明确报告 manager=skills-cli",
+        "upgrade 委托 skills add 并采用上游覆盖语义",
+        "uninstall 委托 skills remove",
+        "升级后版本 current，卸载后 canonical 与 exposure 消失"
       ]
     },
     {
@@ -306,7 +306,7 @@
       "expected_output": "setup 把 CLI 安装到 ~/.local/bin，幂等写入 shell PATH，安装 canonical Skill，并让 Claude Code、Codex、OpenCode 与 DWS 检查全部 ready。",
       "files": [],
       "expectations": [
-        "用户级 CLI 被安装且可执行 --version",
+        "用户级 CLI、dta 和 dta-setup bootstrap 入口均被安装",
         "shell rc 只追加受管的 ~/.local/bin PATH 块",
         "canonical Skill 与 Claude exposure 安装成功，三个 Agent 客户端均可发现",
         "DWS 版本和认证检查通过，setup 最终 ready"