@ats-cx/cx-cli 0.1.0

package/dist/index.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { runCli } from "./cli.js";
+const result = await runCli(process.argv.slice(2));
+if (result.stdout) {
+    console.log(result.stdout);
+}
+process.exit(result.exitCode);
+//# sourceMappingURL=index.js.map

package/dist/init.d.ts

@@ -0,0 +1,17 @@
+import type { CliResult } from "./output.js";
+export interface InitOptions {
+    /** 从这里向上找 git 根作为工作区宿主。 */
+    cwd: string;
+    /** 工具箱根（由 CLI 自身安装位置推导：包根），用于读取 .env 模板与种子语义表。 */
+    toolkitRoot: string;
+}
+/**
+ * `cx-cli init`：在宿主仓库根创建 .cx-cli 诊断工作区。
+ *
+ * 幂等：只补缺失的文件/目录；.env（凭据）与 event-semantics.json（策展成果）绝不覆盖。
+ * 已有 config.json 只定点移除无效或悬空的 toolkitConfigDir，其余键保留；.gitignore 每次重写为
+ * 当前模板，否则老工作区的 `*` 会把语义表挡在宿主仓库 git 之外。两者都记入 rewritten。
+ * 宿主不像编辑器仓库（缺 resource/ 或 src/apps/）只警告不阻塞。
+ * 退出码：0 成功（含警告与 .env 缺键）/ 1 找不到 git 根或文件系统错误。
+ */
+export declare function runInit(options: InitOptions): CliResult;

package/dist/init.js

@@ -0,0 +1,194 @@
+import { copyFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { isApmConfigured, loadConfig, SENTENCE } from "@ats-cx/cx-core";
+import { UserFacingError } from "./errors.js";
+import { formatOut, jsonOut } from "./output.js";
+import { REQUIRED_ENV_KEYS } from "./project-pull.js";
+import { centralSkillsWarning } from "./skills.js";
+import { WORKSPACE_DIR_NAME } from "./workspace.js";
+/**
+ * 工作区 .gitignore 模板：默认全屏蔽，只反向放行语义表与策展提案（spec 组件 D）。
+ *
+ * 用 `*` + 反向放行而不是逐项列举屏蔽项：工作区放着 DB 凭据与诊断产物，将来落进来的
+ * 新文件（用户自造的 .env 变体、后续版本新增的契约文件）必须默认进不了宿主仓库 git。
+ * 逐项列举是黑名单，漏一项就是凭据外泄；这里的白名单漏一项只是少留档一个文件。
+ *
+ * config.json 留在屏蔽内——它可能含钉死的本机路径，且产物布局是本机的事；进宿主 git 无意义。
+ * .gitignore 自身必须放行：同事 clone 后没有它，.env 就失去屏蔽。
+ * curation/ 要目录与内容各放行一行——父目录被 `*` 排除时，git 不会递归进去看内容。
+ */
+const WORKSPACE_GITIGNORE = `# 默认全屏蔽：工作区含 DB 凭据（.env）、本机绑定（config.json）与诊断产物
+*
+
+# 例外：语义表与策展提案随宿主仓库 git 留档
+!.gitignore
+!event-semantics.json
+!curation/
+!curation/**
+`;
+/**
+ * `cx-cli init`：在宿主仓库根创建 .cx-cli 诊断工作区。
+ *
+ * 幂等：只补缺失的文件/目录；.env（凭据）与 event-semantics.json（策展成果）绝不覆盖。
+ * 已有 config.json 只定点移除无效或悬空的 toolkitConfigDir，其余键保留；.gitignore 每次重写为
+ * 当前模板，否则老工作区的 `*` 会把语义表挡在宿主仓库 git 之外。两者都记入 rewritten。
+ * 宿主不像编辑器仓库（缺 resource/ 或 src/apps/）只警告不阻塞。
+ * 退出码：0 成功（含警告与 .env 缺键）/ 1 找不到 git 根或文件系统错误。
+ */
+export function runInit(options) {
+    try {
+        const cwd = resolve(options.cwd);
+        const hostRoot = findGitRoot(cwd);
+        if (!hostRoot) {
+            throw new UserFacingError(`错误: 从 ${cwd} 向上未找到 git 仓库根。\n请在编辑器源码仓库内运行 cx-cli init。`);
+        }
+        const warnings = [];
+        if (!existsSync(join(hostRoot, "resource")) || !existsSync(join(hostRoot, "src/apps"))) {
+            warnings.push(`宿主仓库 ${hostRoot} 缺少 resource/ 或 src/apps/，不像编辑器源码仓库；工作区照常创建。`);
+        }
+        const workspaceDir = join(hostRoot, WORKSPACE_DIR_NAME);
+        const created = [];
+        const skipped = [];
+        const rewritten = [];
+        mkdirSync(workspaceDir, { recursive: true });
+        for (const dir of ["runs", "data", "out"]) {
+            const path = join(workspaceDir, dir);
+            (existsSync(path) ? skipped : created).push(`${dir}/`);
+            mkdirSync(path, { recursive: true });
+        }
+        // 唯一的非幂等例外：老工作区里内容为 `*` 的 .gitignore 会把语义表挡在 git 外，
+        // 必须换成选择性模板，否则组件 D 的「宿主 git 承载语义历史」不成立。
+        writeFileSync(join(workspaceDir, ".gitignore"), WORKSPACE_GITIGNORE);
+        rewritten.push(".gitignore");
+        const workspaceConfig = {
+            runsDir: "runs",
+            projectHistoryDir: "data",
+            outDir: "out",
+        };
+        const configPath = join(workspaceDir, "config.json");
+        if (!existsSync(configPath)) {
+            writeFileSync(configPath, `${JSON.stringify(workspaceConfig, null, 2)}\n`);
+            created.push("config.json");
+        }
+        else {
+            let existingConfig = null;
+            let invalidConfigJson = false;
+            try {
+                const parsed = JSON.parse(readFileSync(configPath, "utf8"));
+                if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+                    existingConfig = parsed;
+                }
+            }
+            catch {
+                invalidConfigJson = true;
+            }
+            const pointer = existingConfig?.toolkitConfigDir;
+            const resolvedPointer = typeof pointer === "string" && pointer.length > 0 ? resolve(workspaceDir, pointer) : null;
+            const hasPointer = existingConfig ? Object.hasOwn(existingConfig, "toolkitConfigDir") : false;
+            const toolkitConfigDir = join(resolve(options.toolkitRoot), "config");
+            if (invalidConfigJson) {
+                skipped.push("config.json");
+                warnings.push("config.json 不是合法 JSON，未修改；请手工修复或删除后重跑 cx-cli init。");
+            }
+            else if (existingConfig && hasPointer && (typeof pointer !== "string" || pointer.length === 0)) {
+                delete existingConfig.toolkitConfigDir;
+                writeFileSync(configPath, `${JSON.stringify(existingConfig, null, 2)}\n`);
+                rewritten.push("config.json");
+                warnings.push(`config.json 的 toolkitConfigDir 不是路径字符串，已移除；共享配置改用 ${toolkitConfigDir}。`);
+            }
+            else if (existingConfig &&
+                resolvedPointer &&
+                (!existsSync(resolvedPointer) || !statSync(resolvedPointer).isDirectory())) {
+                delete existingConfig.toolkitConfigDir;
+                writeFileSync(configPath, `${JSON.stringify(existingConfig, null, 2)}\n`);
+                rewritten.push("config.json");
+                warnings.push(`config.json 的 toolkitConfigDir 指向不存在的 ${resolvedPointer}，已移除；共享配置改用 ${toolkitConfigDir}。`);
+            }
+            else {
+                skipped.push("config.json");
+            }
+        }
+        const envExample = join(resolve(options.toolkitRoot), ".env.example");
+        const envPath = join(workspaceDir, ".env");
+        if (existsSync(envPath)) {
+            skipped.push(".env");
+        }
+        else if (existsSync(envExample)) {
+            writeFileSync(envPath, readFileSync(envExample, "utf8"));
+            created.push(".env");
+        }
+        else {
+            warnings.push(`工具箱缺少 ${envExample}，未生成 .env 模板；请手工创建 ${envPath}。`);
+        }
+        const seedSemantics = join(resolve(options.toolkitRoot), "config", "event-semantics.json");
+        const semanticsPath = join(workspaceDir, "event-semantics.json");
+        if (existsSync(semanticsPath)) {
+            skipped.push("event-semantics.json");
+        }
+        else if (existsSync(seedSemantics)) {
+            copyFileSync(seedSemantics, semanticsPath);
+            created.push("event-semantics.json");
+        }
+        else {
+            warnings.push(`工具箱缺少 ${seedSemantics}，未生成工作区 event-semantics.json；诊断命令会因缺语义表报错。`);
+        }
+        const toolkitConfigDir = join(resolve(options.toolkitRoot), "config");
+        const apmState = loadConfig(toolkitConfigDir, { source: "toolkit" }).apmProviderState;
+        if (apmState?.kind === "invalid") {
+            warnings.push(`apm 配置无效：${apmState.error}`);
+        }
+        else if (!isApmConfigured(apmState)) {
+            warnings.push(SENTENCE(apmState.fillPath));
+        }
+        const skillsWarning = centralSkillsWarning(options.toolkitRoot);
+        if (skillsWarning) {
+            warnings.push(skillsWarning);
+        }
+        const missingEnvKeys = readMissingEnvKeys(envPath);
+        const hint = missingEnvKeys.length > 0
+            ? `请在 ${envPath} 填入 ${missingEnvKeys.join(", ")}（数据库凭据向团队获取，只留本机、不入库），之后即可运行 cx-cli project pull。`
+            : apmState?.kind === "invalid"
+                ? "工作区就绪；修好 apm 配置后可运行 run new / apm query。"
+                : !isApmConfigured(apmState)
+                    ? "工作区就绪；填好 apm 后可运行 run new / apm query。"
+                    : "工作区就绪，可直接运行 cx-cli project pull / run new / apm query。";
+        return formatOut({ hostRoot, workspaceDir, created, skipped, rewritten, warnings, missingEnvKeys, hint });
+    }
+    catch (error) {
+        if (error instanceof UserFacingError) {
+            return { exitCode: 1, stdout: error.message };
+        }
+        return jsonOut({ error: error instanceof Error ? error.message : String(error) }, 1);
+    }
+}
+/** 向上找最近的 .git（目录或 worktree/submodule 的 .git 文件都算）。 */
+function findGitRoot(start) {
+    for (let current = start;;) {
+        if (existsSync(join(current, ".git"))) {
+            return current;
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+/**
+ * 静态检查 .env 缺哪些必填键（map 决策 10：只提示、不代填）。
+ * 不用 process.loadEnvFile：它写进程级 env 且已有同名变量优先，这里只关心文件本身的内容。
+ */
+function readMissingEnvKeys(envPath) {
+    if (!existsSync(envPath)) {
+        return [...REQUIRED_ENV_KEYS];
+    }
+    const values = new Map();
+    for (const line of readFileSync(envPath, "utf8").split(/\r?\n/)) {
+        const match = /^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=(.*)$/.exec(line);
+        if (match) {
+            values.set(match[1], match[2].trim());
+        }
+    }
+    return REQUIRED_ENV_KEYS.filter(key => !values.get(key));
+}
+//# sourceMappingURL=init.js.map

package/dist/output.d.ts

@@ -0,0 +1,7 @@
+/** exit code 约定：0 成功 / 1 业务失败（含 finalize 校验失败、run 不存在）/ 2 参数错误。 */
+export interface CliResult {
+    exitCode: 0 | 1 | 2;
+    stdout: string;
+}
+export declare function jsonOut(data: unknown, exitCode?: CliResult["exitCode"]): CliResult;
+export declare function formatOut(data: unknown, exitCode?: CliResult["exitCode"]): CliResult;

package/dist/output.js

@@ -0,0 +1,7 @@
+export function jsonOut(data, exitCode = 0) {
+    return { exitCode, stdout: JSON.stringify(data, null, 2) };
+}
+export function formatOut(data, exitCode = 0) {
+    return jsonOut(data, exitCode);
+}
+//# sourceMappingURL=output.js.map

package/dist/project-pull.d.ts

@@ -0,0 +1,32 @@
+import type { ConfigSource, RemoteProjectPullResult } from "@ats-cx/cx-core";
+import type { CliResult } from "./output.js";
+import type { Workspace } from "./workspace.js";
+/** project pull 必填的 .env 键（DB_PORT 缺省 3306 不算必填）；init 的缺键提示复用同一清单。 */
+export declare const REQUIRED_ENV_KEYS: readonly ["DB_HOST", "DB_USER", "DB_PASSWORD", "DB_NAME"];
+export interface ProjectPullOptions {
+    history: boolean;
+    /** .env 路径，由调用方按优先级选定（--env > 工作区 .env > 机器级 .env）。 */
+    envPath: string;
+    /** 错误提示中的包内 .env 模板绝对路径。 */
+    envExamplePath: string;
+    configDir: string;
+    configSource: ConfigSource;
+    /** 命中的工作区；快照落盘路径（projectHistoryDir）随之落工作区内。 */
+    workspace?: Workspace | null;
+}
+/**
+ * `project pull`：唯一直连 DB 的命令。
+ *
+ * 退出码：0 全部成功 / 1 业务失败（.env 缺失或缺键、连接或 SQL 失败、全部 id 都查到 0 条、有记录落盘失败）。
+ * 单个 id 查到 0 条只记警告继续——多 id 拉取时不该被一个空项目拖垮。
+ */
+export declare function runProjectPull(projectIds: string[], options: ProjectPullOptions): Promise<CliResult>;
+/**
+ * 单个 projectId 查到 0 条只是警告；全部 id 都空，或有记录落盘失败，才算这次 pull 失败。
+ * 单独成函数是为了让这段退出码语义可直接单测（成功路径需要真实 DB，测不到）。
+ *
+ * 空 projects 列表是「没有要拉的项目」，不是「全部为空」——`every` 对空数组返回 true，
+ * 不先挡掉会落进失败分支返回一个没有任何 warning 解释的 exit 1。
+ * 参数合法性由 commander 负责（缺参数已 exit 2），这里只描述拉取结果。
+ */
+export declare function pullExitCode(result: RemoteProjectPullResult): 0 | 1;

package/dist/project-pull.js

@@ -0,0 +1,81 @@
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { createMysqlClient, createRemoteProjectProvider, loadConfig } from "@ats-cx/cx-core";
+import { UserFacingError } from "./errors.js";
+import { formatOut, jsonOut } from "./output.js";
+import { applyWorkspace } from "./workspace.js";
+/** project pull 必填的 .env 键（DB_PORT 缺省 3306 不算必填）；init 的缺键提示复用同一清单。 */
+export const REQUIRED_ENV_KEYS = ["DB_HOST", "DB_USER", "DB_PASSWORD", "DB_NAME"];
+/**
+ * `project pull`：唯一直连 DB 的命令。
+ *
+ * 退出码：0 全部成功 / 1 业务失败（.env 缺失或缺键、连接或 SQL 失败、全部 id 都查到 0 条、有记录落盘失败）。
+ * 单个 id 查到 0 条只记警告继续——多 id 拉取时不该被一个空项目拖垮。
+ */
+export async function runProjectPull(projectIds, options) {
+    try {
+        const dbConfig = loadDbConfig(options.envPath, options.envExamplePath);
+        const shared = loadConfig(options.configDir, { source: options.configSource });
+        const { projectHistoryDir } = options.workspace ? applyWorkspace(shared, options.workspace) : shared;
+        const client = await createMysqlClient(dbConfig);
+        let result;
+        try {
+            const provider = createRemoteProjectProvider(client, projectHistoryDir);
+            result = options.history ? await provider.pullHistory(projectIds) : await provider.pullLatest(projectIds);
+        }
+        finally {
+            await client.close();
+        }
+        return formatOut({ mode: options.history ? "history" : "latest", projectHistoryDir, ...result }, pullExitCode(result));
+    }
+    catch (error) {
+        if (error instanceof UserFacingError) {
+            return { exitCode: 1, stdout: error.message };
+        }
+        return jsonOut({ error: error instanceof Error ? error.message : String(error) }, 1);
+    }
+}
+/**
+ * 单个 projectId 查到 0 条只是警告；全部 id 都空，或有记录落盘失败，才算这次 pull 失败。
+ * 单独成函数是为了让这段退出码语义可直接单测（成功路径需要真实 DB，测不到）。
+ *
+ * 空 projects 列表是「没有要拉的项目」，不是「全部为空」——`every` 对空数组返回 true，
+ * 不先挡掉会落进失败分支返回一个没有任何 warning 解释的 exit 1。
+ * 参数合法性由 commander 负责（缺参数已 exit 2），这里只描述拉取结果。
+ */
+export function pullExitCode(result) {
+    if (result.projects.length === 0) {
+        return 0;
+    }
+    const failed = result.projects.some(project => project.failures.length > 0);
+    const allEmpty = result.projects.every(project => project.snapshotCount === 0);
+    return failed || allEmpty ? 1 : 0;
+}
+/**
+ * 只有 project 命令组加载 .env（诊断命令不碰 DB）。用 Node 原生 loadEnvFile，不引 dotenv。
+ * 注意其语义：进程已有的同名环境变量优先于文件值。
+ */
+function loadDbConfig(envPath, envExamplePath) {
+    const file = resolve(envPath);
+    const template = resolve(envExamplePath);
+    if (!existsSync(file)) {
+        throw new UserFacingError(`错误: 未找到 .env 文件 ${file}。\n请填入数据库连接信息（模板见 ${template}），或用 --env 指定路径。`);
+    }
+    process.loadEnvFile(file);
+    const missing = REQUIRED_ENV_KEYS.filter(key => !process.env[key]);
+    if (missing.length > 0) {
+        throw new UserFacingError(`错误: ${file} 缺少数据库连接配置: ${missing.join(", ")}。\n请补齐数据库连接配置（模板见 ${template}）。`);
+    }
+    const port = process.env.DB_PORT ? Number(process.env.DB_PORT) : 3306;
+    if (!Number.isInteger(port) || port <= 0) {
+        throw new UserFacingError(`错误: ${file} 的 DB_PORT 不是合法端口: ${process.env.DB_PORT}。`);
+    }
+    return {
+        host: String(process.env.DB_HOST),
+        user: String(process.env.DB_USER),
+        password: String(process.env.DB_PASSWORD),
+        database: String(process.env.DB_NAME),
+        port,
+    };
+}
+//# sourceMappingURL=project-pull.js.map

package/dist/report.d.ts

@@ -0,0 +1,3 @@
+import type { DiagnosisResult } from "@ats-cx/cx-core";
+/** 按 spec §10 的固定六段渲染 report.md，头部声明源码版本漂移风险。 */
+export declare function renderReport(runDir: string, result: DiagnosisResult, complaint: string): string;

package/dist/report.js

@@ -0,0 +1,42 @@
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+/** 按 spec §10 的固定六段渲染 report.md，头部声明源码版本漂移风险。 */
+export function renderReport(runDir, result, complaint) {
+    const sourceVersions = existsSync(join(runDir, "source-versions.json"))
+        ? JSON.parse(readFileSync(join(runDir, "source-versions.json"), "utf8"))
+        : [];
+    const versionNote = sourceVersions.length
+        ? sourceVersions
+            .map(v => `- ${v.repoId}: ${v.reachable ? `commit ${v.commit ?? "未知"}${v.dirty ? "（工作区有未提交改动）" : ""}` : "不可达"}`)
+            .join("\n")
+        : "- 无源码仓库参与本次诊断";
+    const listOrNone = (items) => (items.length ? items.map(item => `- ${item}`).join("\n") : "- 无");
+    return [
+        `# 诊断报告 ${result.runId}`,
+        "",
+        `> 源码证据基于以下版本，与事发时间可能存在版本漂移：`,
+        versionNote,
+        "",
+        "## Case 摘要",
+        `- projectId: ${result.projectId}`,
+        `- 用户反馈: ${complaint || "（未提供）"}`,
+        `- 诊断状态: ${result.diagnosisStatus}`,
+        "",
+        "## 已确认事实",
+        listOrNone(result.confirmedFacts.map(fact => `${fact.description}（证据: ${fact.evidenceRefs.join(", ") || "无"}）`)),
+        "",
+        "## 最可能根因",
+        listOrNone(result.rootCauses.map(cause => `[${cause.confidence}] ${cause.description}（证据: ${cause.evidenceRefs.join(", ") || "无"}）`)),
+        "",
+        "## 关键证据",
+        listOrNone(result.evidenceRefs),
+        "",
+        "## 仍需补充的证据",
+        listOrNone(result.missingEvidence),
+        "",
+        "## 建议下一步",
+        listOrNone(result.recommendedNextActions),
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=report.js.map

package/dist/skills.d.ts

@@ -0,0 +1,12 @@
+import type { CliResult } from "./output.js";
+export declare const SKILLS_INSTALL_HELP = "Usage: cx-cli skills install\n\n\u628A\u5305\u5185 skills/<name> \u8F6F\u94FE\u8FDB\u672C\u673A Agent\uFF08\u4E24\u6BB5\u94FE\uFF09:\n  <\u5305\u6839>/skills/<name>     -> ~/.agents/skills/<name>    \u4E2D\u592E skills \u5E93\uFF1BCodex \u76F4\u63A5\u8BFB\u8FD9\u91CC\n  ~/.agents/skills/<name>  -> ~/.claude/skills/<name>    \u4EC5\u5F53 ~/.claude/ \u5B58\u5728\uFF1BClaude Code \u53EA\u8BFB\u8FD9\u91CC\n\u5E76\u521B\u5EFA\u673A\u5668\u7EA7\u8986\u76D6\u76EE\u5F55 ~/.config/cx-cli/\uFF08\u9075 $XDG_CONFIG_HOME\uFF09\uFF0C\u7F3A apm-provider.local.json \u5219\u843D\u9AA8\u67B6\uFF08\u5DF2\u6709\u4E0D\u8986\u76D6\uFF09\u3002\n\n\u5E42\u7B49: \u5DF2\u6307\u5411\u5F53\u524D\u5305\u7684\u94FE\u4E0D\u52A8\uFF1B\u6307\u5411\u522B\u5904\u6216\u60AC\u7A7A\u7684\u8F6F\u94FE\u91CD\u6307\uFF08\u8F93\u51FA updated\uFF09\uFF1B\u76EE\u6807\u662F\u771F\u5B9E\u6587\u4EF6/\u76EE\u5F55\u5219\u8DF3\u8FC7\u5E76\u8B66\u544A\uFF0C\u4E0D\u5220\u3002\n\u53EA\u652F\u6301 npm \u5168\u5C40\u5B89\u88C5\uFF08npm i -g @ats-cx/cx-cli\uFF09\u4E0E\u7EF4\u62A4\u8005\u7684 pnpm link\uFF1Bnpx \u7F13\u5B58\u4E0E pnpm add -g \u4E0B\u62D2\u7EDD\uFF08exit 1\uFF09\u3002\n\u88C5\u597D\u540E Agent \u65E0\u9700\u91CD\u542F\uFF1B\u5305\u5347\u7EA7\u540E\u65B0\u589E\u7684 skill \u9700\u91CD\u8DD1\u672C\u547D\u4EE4\uFF1B\u66F4\u540D / \u5220\u9664\u7684\u65E7\u94FE\u7531\u672C\u547D\u4EE4\u81EA\u52A8\u6E05\u7406\uFF08pruned\uFF09\u3002\n\n\u8F93\u51FA:\n  { packageRoot, packageVersion, centralDir, agents, skills, created, updated, skipped, pruned, configDir, warnings, hint }";
+export declare const SKILLS_STATUS_HELP = "Usage: cx-cli skills status\n\n\u68C0\u67E5\u5305\u5185\u6BCF\u4E2A skill \u7684\u4E24\u6BB5\u94FE\uFF08\u4E2D\u592E\u5E93 ~/.agents/skills/<name>\uFF1B~/.claude/ \u5B58\u5728\u65F6\u518D\u67E5 ~/.claude/skills/<name>\uFF09\n\u4E0E\u673A\u5668\u7EA7\u8986\u76D6\u76EE\u5F55 ~/.config/cx-cli/ \u662F\u5426\u5C31\u7EEA\u3002\u94FE\u72B6\u6001: linked / stale\uFF08\u6307\u5411\u522B\u5904\uFF09/ dangling\uFF08\u60AC\u7A7A\uFF09/ missing / occupied\uFF08\u88AB\u771F\u5B9E\u76EE\u5F55\u5360\u7528\uFF09\u3002\n\u5168\u90E8 linked \u624D ok\uFF1B\u5426\u5219 exit 1 \u5E76\u5728 issues \u5217\u51FA\u3002apm \u672A\u914D\u7F6E\u53EA\u8FDB hint\uFF0C\u4E0D\u5F71\u54CD ok\u3002\n\n\u8F93\u51FA:\n  { ok, packageRoot, packageVersion, centralDir, agents, skills: [{ name, central, claude? }], orphans, issues, configDir, hint }";
+export declare const SKILLS_UNINSTALL_HELP = "Usage: cx-cli skills uninstall\n\n\u89E3\u9664\u672C\u5305\u7684 skills \u94FE\u63A5: \u5220 ~/.claude/skills/<name>\u3001~/.codex/skills/<name> \u4E2D\u6307\u5411\u4E2D\u592E\u5E93\u7684\u8F6F\u94FE\uFF0C\n\u518D\u5220 ~/.agents/skills/<name> \u4E2D\u6307\u5411\u5F53\u524D\u5305\u6216\u5DF2\u60AC\u7A7A\u7684\u8F6F\u94FE\u3002\u6307\u5411\u522B\u5904\u7684\u8F6F\u94FE\u4E0E\u771F\u5B9E\u6587\u4EF6/\u76EE\u5F55\u4E00\u5F8B\u4E0D\u52A8\uFF08\u5217\u5165 skipped\uFF09\u3002\n\u4E0D\u52A8 ~/.config/cx-cli/\u3002\u5378\u8F7D\u987A\u5E8F: \u5148\u672C\u547D\u4EE4\uFF0C\u518D npm rm -g @ats-cx/cx-cli\u3002\n\n\u8F93\u51FA:\n  { packageRoot, packageVersion, removed, skipped: [{ path, reason }], warnings, hint }";
+export interface SkillsCommandOptions {
+    packageRoot: string;
+    packageVersion: string;
+}
+export declare function centralSkillsWarning(packageRoot: string): string | null;
+export declare function runSkillsInstall(options: SkillsCommandOptions): CliResult;
+export declare function runSkillsStatus(options: SkillsCommandOptions): CliResult;
+export declare function runSkillsUninstall(options: SkillsCommandOptions): CliResult;