teamix-evo 0.4.1 → 0.6.0

package/dist/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command29 } from "commander";
-import { createRequire as createRequire7 } from "module";
+import { Command as Command32 } from "commander";
+import { createRequire as createRequire8 } from "module";
 
 // src/commands/tokens/index.ts
 import { Command as Command6 } from "commander";
@@ -529,9 +529,11 @@ function makeMirrorRecord(skill, targetAbs, content, ide, scope, rel2) {
 }
 async function updateSkills(options) {
   const { manifest, ides, scope, projectRoot } = options;
+  const idFilter = options.onlyIds ? new Set(options.onlyIds) : null;
   const summary = { overwritten: 0, managed: 0, skipped: 0, created: 0 };
   const updated = [];
   for (const skill of manifest.skills) {
+    if (idFilter && !idFilter.has(skill.id)) continue;
     const skillIdes = skill.ides.filter((i) => ides.includes(i));
     if (skillIdes.length === 0) continue;
     const sourceRecords = await rewriteSkillSource(
@@ -733,11 +735,73 @@ async function ensureMcpJson(projectRoot) {
 // src/core/skills-add.ts
 var DEFAULT_SKILLS_PACKAGE = "@teamix-evo/skills";
 var FLAT_VARIANT = "_flat";
+async function runSkillsInit(options) {
+  const { projectRoot } = options;
+  const packageName = options.packageName ?? DEFAULT_SKILLS_PACKAGE;
+  const ides = [...options.ides];
+  const scope = options.scope;
+  if (ides.length === 0) {
+    throw new Error("At least one IDE must be selected.");
+  }
+  await ensureTeamixDir(projectRoot);
+  const existingConfig = await readProjectConfig(projectRoot);
+  const existingSkillsCfg = existingConfig?.packages?.skills;
+  const { manifest, data, packageRoot } = await loadSkillsData(packageName);
+  const currentTokensVariant = await readTokensVariant(projectRoot);
+  const existing = await readExistingState(projectRoot, packageName);
+  const candidateIds = manifest.skills.filter((s) => {
+    const effectiveScope = s.scope ?? "project";
+    if (effectiveScope !== scope) {
+      logger.debug(
+        `Skipping skill "${s.id}" (scope=${effectiveScope}): current install scope is "${scope}". Use \`skills add ${s.id} --scope ${effectiveScope}\` to install.`
+      );
+      return false;
+    }
+    if (!s.variant) return true;
+    if (!currentTokensVariant) {
+      logger.debug(
+        `Skipping variant-bound skill "${s.id}" (variant=${s.variant}): no tokens variant installed; will be picked up when "tokens init" runs.`
+      );
+      return false;
+    }
+    if (s.variant !== currentTokensVariant) {
+      logger.debug(
+        `Skipping variant-bound skill "${s.id}" (variant=${s.variant}): current tokens variant is "${currentTokensVariant}".`
+      );
+      return false;
+    }
+    return true;
+  }).map((s) => s.id);
+  const skippedSkillIds = candidateIds.filter(
+    (id) => existing.skillIds.has(id)
+  );
+  const onlyIds = candidateIds.filter((id) => !existing.skillIds.has(id));
+  if (existingSkillsCfg && onlyIds.length === 0) {
+    return { status: "already-initialized" };
+  }
+  return finalizeSkillsInstall({
+    projectRoot,
+    packageName,
+    ideIdent: options.ide ?? "qoder",
+    manifest,
+    data,
+    packageRoot,
+    ides,
+    scope,
+    onlyIds,
+    skippedSkillIds,
+    existing,
+    existingConfig
+  });
+}
 async function runSkillsAdd(options) {
+  if (!options.names || options.names.length === 0) {
+    throw new Error(
+      "runSkillsAdd requires at least one skill id. Use runSkillsInit() for bulk install."
+    );
+  }
   const { projectRoot, names: requestedNames } = options;
   const packageName = options.packageName ?? DEFAULT_SKILLS_PACKAGE;
-  const ideIdent = options.ide ?? "qoder";
-  const isIncremental = !!requestedNames && requestedNames.length > 0;
   await ensureTeamixDir(projectRoot);
   const existingConfig = await readProjectConfig(projectRoot);
   const existingSkillsCfg = existingConfig?.packages?.skills;
@@ -750,57 +814,27 @@ async function runSkillsAdd(options) {
     throw new Error("Scope must be specified (project | global).");
   }
   const { manifest, data, packageRoot } = await loadSkillsData(packageName);
-  const currentTokensVariant = await readTokensVariant(projectRoot);
-  if (isIncremental) {
-    const known = new Set(manifest.skills.map((s) => s.id));
-    const unknown = requestedNames.filter((n) => !known.has(n));
-    if (unknown.length > 0) {
-      const available = [...known].join(", ");
-      throw new Error(
-        `Unknown skill id(s): ${unknown.join(", ")}. Available: ${available || "(none)"}.`
+  const known = new Set(manifest.skills.map((s) => s.id));
+  const unknown = requestedNames.filter((n) => !known.has(n));
+  if (unknown.length > 0) {
+    const available = [...known].join(", ");
+    throw new Error(
+      `Unknown skill id(s): ${unknown.join(", ")}. Available: ${available || "(none)"}.`
+    );
+  }
+  for (const s of manifest.skills) {
+    if (requestedNames.includes(s.id) && s.scope && s.scope !== scope) {
+      logger.warn(
+        `"${s.id}" \u63A8\u8350 ${s.scope} scope \u5B89\u88C5\u3002\u5F53\u524D\u4EE5 ${scope} scope \u5F3A\u5236\u5B89\u88C5,\u53EF\u80FD\u4E0E\u53E6\u4E00 scope \u7684\u526F\u672C\u51B2\u7A81\u3002\u5EFA\u8BAE\u6539\u7528 \`skills add ${s.id} --scope ${s.scope}\`\u3002`
       );
     }
   }
-  const existingInstalled = await readInstalledManifest(projectRoot);
-  const existingPkg = existingInstalled?.installed.find(
-    (p) => p.package === packageName
+  const existing = await readExistingState(projectRoot, packageName);
+  const skippedSkillIds = requestedNames.filter(
+    (n) => existing.skillIds.has(n)
   );
-  const existingLock = await readSkillsLock(projectRoot);
-  const existingSkillIds = /* @__PURE__ */ new Set([
-    ...Object.keys(existingLock?.skills ?? {}),
-    // Legacy fallback: pre-ADR-0013 installs only had manifest.json. Derive
-    // skill ids by stripping the trailing :source / :sub-file suffix.
-    ...(existingPkg?.resources ?? []).map((r) => r.id.split(":")[0])
-  ]);
-  let onlyIds;
-  let skippedSkillIds;
-  if (isIncremental) {
-    skippedSkillIds = requestedNames.filter((n) => existingSkillIds.has(n));
-    onlyIds = requestedNames.filter((n) => !existingSkillIds.has(n));
-  } else {
-    const candidateIds = manifest.skills.filter((s) => {
-      if (!s.variant) return true;
-      if (!currentTokensVariant) {
-        logger.debug(
-          `Skipping variant-bound skill "${s.id}" (variant=${s.variant}): no tokens variant installed; will be picked up when "tokens init" runs.`
-        );
-        return false;
-      }
-      if (s.variant !== currentTokensVariant) {
-        logger.debug(
-          `Skipping variant-bound skill "${s.id}" (variant=${s.variant}): current tokens variant is "${currentTokensVariant}".`
-        );
-        return false;
-      }
-      return true;
-    }).map((s) => s.id);
-    skippedSkillIds = candidateIds.filter((id) => existingSkillIds.has(id));
-    onlyIds = candidateIds.filter((id) => !existingSkillIds.has(id));
-  }
-  if (!isIncremental && existingSkillsCfg && onlyIds.length === 0) {
-    return { status: "already-added" };
-  }
-  if (isIncremental && onlyIds.length === 0) {
+  const onlyIds = requestedNames.filter((n) => !existing.skillIds.has(n));
+  if (onlyIds.length === 0) {
     return {
       status: "installed",
       packageName,
@@ -814,6 +848,48 @@ async function runSkillsAdd(options) {
       skippedSkillIds
     };
   }
+  return finalizeSkillsInstall({
+    projectRoot,
+    packageName,
+    ideIdent: options.ide ?? "qoder",
+    manifest,
+    data,
+    packageRoot,
+    ides,
+    scope,
+    onlyIds,
+    skippedSkillIds,
+    existing,
+    existingConfig
+  });
+}
+async function readExistingState(projectRoot, packageName) {
+  const installed = await readInstalledManifest(projectRoot);
+  const pkg = installed?.installed.find((p) => p.package === packageName);
+  const lock = await readSkillsLock(projectRoot);
+  const skillIds = /* @__PURE__ */ new Set([
+    ...Object.keys(lock?.skills ?? {}),
+    // Legacy fallback: pre-ADR-0013 installs only had manifest.json. Derive
+    // skill ids by stripping the trailing :source / :sub-file suffix.
+    ...(pkg?.resources ?? []).map((r) => r.id.split(":")[0] ?? r.id)
+  ]);
+  return { installed, pkg, lock, skillIds };
+}
+async function finalizeSkillsInstall(args) {
+  const {
+    projectRoot,
+    packageName,
+    ideIdent,
+    manifest,
+    data,
+    packageRoot,
+    ides,
+    scope,
+    onlyIds,
+    skippedSkillIds,
+    existing,
+    existingConfig
+  } = args;
   const result = await installSkills({
     projectRoot,
     manifest,
@@ -837,7 +913,7 @@ async function runSkillsAdd(options) {
   };
   await writeProjectConfig(projectRoot, config);
   const installedAt = (/* @__PURE__ */ new Date()).toISOString();
-  const installedManifest = existingInstalled ?? {
+  const installedManifest = existing.installed ?? {
     schemaVersion: 1,
     installed: []
   };
@@ -845,7 +921,7 @@ async function runSkillsAdd(options) {
     (p) => p.package === packageName
   );
   const mergedResources = mergeInstalledResources(
-    existingPkg?.resources ?? [],
+    existing.pkg?.resources ?? [],
     result.resources
   );
   const entry = {
@@ -858,7 +934,7 @@ async function runSkillsAdd(options) {
   if (idx >= 0) installedManifest.installed[idx] = entry;
   else installedManifest.installed.push(entry);
   await writeInstalledManifest(projectRoot, installedManifest);
-  const lock = existingLock ?? {
+  const lock = existing.lock ?? {
     schemaVersion: 1,
     skills: {}
   };
@@ -1521,11 +1597,11 @@ var uninstallCommand = new Command5("uninstall").description(
       `Will remove ${removable.length} file(s); keep ${kept} managed file(s).`
     );
     if (!opts.yes) {
-      const confirm4 = await prompts.confirm({
+      const confirm5 = await prompts.confirm({
         message: "\u786E\u8BA4\u5378\u8F7D tokens \u53D8\u4F53\uFF1F",
         initialValue: false
       });
-      if (prompts.isCancel(confirm4) || !confirm4) {
+      if (prompts.isCancel(confirm5) || !confirm5) {
         logger.info("Cancelled.");
         return;
       }
@@ -1588,28 +1664,132 @@ tokensCommand.addCommand(listVariantsCommand);
 tokensCommand.addCommand(uninstallCommand);
 
 // src/commands/skills/index.ts
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
 
-// src/commands/skills/add.ts
+// src/commands/skills/init.ts
 import { Command as Command7 } from "commander";
 import * as prompts2 from "@clack/prompts";
-var addCommand = new Command7("add").description(
-  "\u5411\u9879\u76EE\uFF08\u6216\u5168\u5C40 IDE \u914D\u7F6E\uFF09\u6DFB\u52A0 teamix-evo skills\uFF1B\u4E0D\u4F20 names \u5219\u6DFB\u52A0 manifest \u5185\u5168\u90E8 skill"
-).argument(
-  "[names...]",
-  "\u53EF\u9009\uFF1A\u4EC5\u6DFB\u52A0\u6307\u5B9A skill id\uFF08\u589E\u91CF\u6A21\u5F0F\uFF09\uFF1B\u7701\u7565\u5219\u6DFB\u52A0\u5168\u90E8"
-).option("--ide <list>", '\u9017\u53F7\u5206\u9694\u7684 IDE \u5217\u8868\uFF0C\u5982 "qoder,claude"').option(
+var initCommand2 = new Command7("init").description(
+  "\u81EA\u4E3E teamix-evo skills\uFF08\u6309 tokens variant + scope \u5168\u88C5\u7B26\u5408\u6761\u4EF6\u7684 skill\uFF1Bscope \u4E3A global-only \u7684 entry skill \u81EA\u52A8\u8DF3\u8FC7 \u2014 ADR 0033\uFF09"
+).option("--ide <list>", '\u9017\u53F7\u5206\u9694\u7684 IDE \u5217\u8868\uFF0C\u5982 "qoder,claude"').option("--scope <scope>", "project | global\uFF08\u9ED8\u8BA4 project\uFF09").option("-y, --yes", "\u4F7F\u7528\u9ED8\u8BA4\u503C\uFF0C\u8DF3\u8FC7\u4EA4\u4E92").action(async (opts) => {
+  try {
+    const ide = detectIde();
+    const cwd = ide.getProjectRoot();
+    const { ides, scope } = await resolveIdesAndScope({ opts });
+    let projectRoot = cwd;
+    if (scope === "global" && !isTeamixEvoProject(cwd)) {
+      projectRoot = await ensureGlobalMetaRoot();
+      logger.info(`Global skill install \u2014 meta root: ${projectRoot}`);
+    } else if (scope !== "global" && !hasPackageJson(cwd)) {
+      logger.error(
+        "No package.json found in current directory. Please run this command in a valid project root."
+      );
+      process.exit(1);
+    }
+    logger.info(
+      `Initializing skills (bulk): ides=[${ides.join(",")}], scope="${scope}"`
+    );
+    logger.debug(`Project root: ${projectRoot}`);
+    const result = await runSkillsInit({
+      projectRoot,
+      ides,
+      scope,
+      ide: ide.name
+    });
+    if (result.status === "already-initialized") {
+      logger.warn(
+        `Skills already initialized. Use "teamix-evo skills add <name>" to add specific skills, "teamix-evo skills update" to refresh, or "teamix-evo skills uninstall" to remove.`
+      );
+      return;
+    }
+    logger.success(`Skills initialized: ${result.skillCount} skill(s)`);
+    logger.info(`  IDEs:    ${result.ides.join(", ")}`);
+    logger.info(`  Scope:   ${result.scope}`);
+    if (result.addedSkillIds.length > 0) {
+      logger.info(`  Added:   ${result.addedSkillIds.join(", ")}`);
+    }
+    if (result.skippedSkillIds.length > 0) {
+      logger.info(
+        `  Skipped: ${result.skippedSkillIds.join(", ")} (already added)`
+      );
+    }
+    logger.info(`  Files:   ${result.fileCount}`);
+    logger.info("");
+    logger.info('Run "teamix-evo skills list" to see installed skills.');
+  } catch (err) {
+    logger.error(`Failed to init skills: ${err.message}`);
+    logger.debug(err.stack ?? "");
+    process.exitCode = 1;
+  }
+});
+async function resolveIdesAndScope(args) {
+  const { opts } = args;
+  if (opts.ide || opts.yes) {
+    const ides = opts.ide ? parseIdeList(opts.ide) : [...ALL_IDE_KINDS];
+    const scope = parseScope(opts.scope);
+    if (ides.length === 0) {
+      throw new Error("At least one IDE must be selected.");
+    }
+    return { ides, scope };
+  }
+  const idesAns = await prompts2.multiselect({
+    message: "\u9009\u62E9\u8981\u6CE8\u5165\u6280\u80FD\u7684 AI IDE\uFF08\u81F3\u5C11\u4E00\u4E2A\uFF09",
+    options: ALL_IDE_KINDS.map((k) => ({
+      value: k,
+      label: k === "qoder" ? "Qoder" : "Claude Code"
+    })),
+    initialValues: [...ALL_IDE_KINDS],
+    required: true
+  });
+  if (prompts2.isCancel(idesAns)) {
+    throw new Error("Cancelled by user.");
+  }
+  const scopeAns = await prompts2.select({
+    message: "\u5B89\u88C5\u8303\u56F4\uFF1F",
+    options: [
+      { value: "project", label: "\u9879\u76EE\u7EA7\uFF08.qoder/.claude \u5728\u5F53\u524D\u9879\u76EE\uFF09" },
+      { value: "global", label: "\u5168\u5C40\uFF08~/.qoder/~/.claude\uFF09" }
+    ],
+    initialValue: "project"
+  });
+  if (prompts2.isCancel(scopeAns)) {
+    throw new Error("Cancelled by user.");
+  }
+  return { ides: idesAns, scope: scopeAns };
+}
+function parseIdeList(input) {
+  const parts = input.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
+  const result = [];
+  for (const p of parts) {
+    if (p === "qoder" || p === "claude") {
+      if (!result.includes(p)) result.push(p);
+    } else {
+      throw new Error(`Unknown IDE: "${p}". Expected qoder | claude.`);
+    }
+  }
+  return result;
+}
+function parseScope(input) {
+  const v = (input ?? "project").toLowerCase();
+  if (v === "project" || v === "global") return v;
+  throw new Error(`Invalid --scope: "${input}". Expected project | global.`);
+}
+
+// src/commands/skills/add.ts
+import { Command as Command8 } from "commander";
+import * as prompts3 from "@clack/prompts";
+var addCommand = new Command8("add").description(
+  "\u589E\u91CF\u6DFB\u52A0 teamix-evo skills\uFF08\u5FC5\u987B\u6307\u5B9A\u81F3\u5C11\u4E00\u4E2A skill id\uFF1B\u81EA\u4E3E\u8BF7\u7528 `skills init`\uFF09"
+).argument("<names...>", "\u81F3\u5C11\u4E00\u4E2A skill id\uFF08\u589E\u91CF\u88C5\uFF09").option("--ide <list>", '\u9017\u53F7\u5206\u9694\u7684 IDE \u5217\u8868\uFF0C\u5982 "qoder,claude"').option(
   "--scope <scope>",
-  "project | global\uFF08\u9ED8\u8BA4 project\uFF1B\u589E\u91CF\u6A21\u5F0F\u4E0B\u9ED8\u8BA4\u590D\u7528\u5DF2\u6709\u914D\u7F6E\uFF09"
+  "project | global\uFF08\u9ED8\u8BA4\u6CBF\u7528\u65E2\u6709 skills \u914D\u7F6E\uFF1B\u9996\u6B21\u5B89\u88C5\u9ED8\u8BA4 project\uFF09"
 ).option("-y, --yes", "\u4F7F\u7528\u9ED8\u8BA4\u503C\uFF0C\u8DF3\u8FC7\u4EA4\u4E92").action(async (names, opts) => {
   try {
     const ide = detectIde();
     const cwd = ide.getProjectRoot();
-    const isIncremental = names.length > 0;
-    const { ides, scope } = await resolveIdesAndScope({
+    const { ides, scope } = await resolveIdesAndScope2({
       opts,
-      projectRoot: cwd,
-      isIncremental
+      projectRoot: cwd
     });
     let projectRoot = cwd;
     if (scope === "global" && !isTeamixEvoProject(cwd)) {
@@ -1622,9 +1802,9 @@ var addCommand = new Command7("add").description(
       process.exit(1);
     }
     logger.info(
-      isIncremental ? `Adding skills [${names.join(",")}]: ides=[${ides.join(
+      `Adding skills [${names.join(",")}]: ides=[${ides.join(
         ","
-      )}], scope="${scope}"` : `Adding skills (all): ides=[${ides.join(",")}], scope="${scope}"`
+      )}], scope="${scope}"`
     );
     logger.debug(`Project root: ${projectRoot}`);
     const result = await runSkillsAdd({
@@ -1632,14 +1812,8 @@ var addCommand = new Command7("add").description(
       ides,
       scope,
       ide: ide.name,
-      names: isIncremental ? names : void 0
+      names
     });
-    if (result.status === "already-added") {
-      logger.warn(
-        `Skills already added. Use "teamix-evo skills add <name>" to add specific skills, "teamix-evo skills update" to refresh, or "teamix-evo skills uninstall" to remove.`
-      );
-      return;
-    }
     if (result.addedSkillIds.length === 0 && result.skippedSkillIds.length > 0) {
       logger.warn(
         `\u5DF2\u5B58\u5728\uFF0C\u65E0\u9700\u6DFB\u52A0\uFF1A${result.skippedSkillIds.join(
@@ -1668,9 +1842,9 @@ var addCommand = new Command7("add").description(
     process.exitCode = 1;
   }
 });
-async function resolveIdesAndScope(args) {
-  const { opts, projectRoot, isIncremental } = args;
-  if (isIncremental && !opts.ide && !opts.scope && !opts.yes) {
+async function resolveIdesAndScope2(args) {
+  const { opts, projectRoot } = args;
+  if (!opts.ide && !opts.scope && !opts.yes) {
     const existing = await readProjectConfig(projectRoot);
     const cfg = existing?.packages?.skills;
     if (cfg && cfg.ides && cfg.ides.length > 0 && cfg.scope) {
@@ -1684,14 +1858,14 @@ async function resolveIdesAndScope(args) {
     }
   }
   if (opts.ide || opts.yes) {
-    const ides = opts.ide ? parseIdeList(opts.ide) : [...ALL_IDE_KINDS];
-    const scope = parseScope(opts.scope);
+    const ides = opts.ide ? parseIdeList2(opts.ide) : [...ALL_IDE_KINDS];
+    const scope = parseScope2(opts.scope);
     if (ides.length === 0) {
       throw new Error("At least one IDE must be selected.");
     }
     return { ides, scope };
   }
-  const idesAns = await prompts2.multiselect({
+  const idesAns = await prompts3.multiselect({
     message: "\u9009\u62E9\u8981\u6CE8\u5165\u6280\u80FD\u7684 AI IDE\uFF08\u81F3\u5C11\u4E00\u4E2A\uFF09",
     options: ALL_IDE_KINDS.map((k) => ({
       value: k,
@@ -1700,10 +1874,10 @@ async function resolveIdesAndScope(args) {
     initialValues: [...ALL_IDE_KINDS],
     required: true
   });
-  if (prompts2.isCancel(idesAns)) {
+  if (prompts3.isCancel(idesAns)) {
     throw new Error("Cancelled by user.");
   }
-  const scopeAns = await prompts2.select({
+  const scopeAns = await prompts3.select({
     message: "\u5B89\u88C5\u8303\u56F4\uFF1F",
     options: [
       { value: "project", label: "\u9879\u76EE\u7EA7\uFF08.qoder/.claude \u5728\u5F53\u524D\u9879\u76EE\uFF09" },
@@ -1711,12 +1885,12 @@ async function resolveIdesAndScope(args) {
     ],
     initialValue: "project"
   });
-  if (prompts2.isCancel(scopeAns)) {
+  if (prompts3.isCancel(scopeAns)) {
     throw new Error("Cancelled by user.");
   }
   return { ides: idesAns, scope: scopeAns };
 }
-function parseIdeList(input) {
+function parseIdeList2(input) {
   const parts = input.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
   const result = [];
   for (const p of parts) {
@@ -1728,16 +1902,16 @@ function parseIdeList(input) {
   }
   return result;
 }
-function parseScope(input) {
+function parseScope2(input) {
   const v = (input ?? "project").toLowerCase();
   if (v === "project" || v === "global") return v;
   throw new Error(`Invalid --scope: "${input}". Expected project | global.`);
 }
 
 // src/commands/skills/list.ts
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 var SKILLS_PACKAGE = "@teamix-evo/skills";
-var listCommand2 = new Command8("list").alias("ls").description(
+var listCommand2 = new Command9("list").alias("ls").description(
   "\u5217\u51FA teamix-evo skills\uFF08\u9ED8\u8BA4\u5C55\u793A\u5168\u90E8 skill \u5E76\u6807\u6CE8\u5DF2\u88C5/\u672A\u88C5\uFF1B--installed \u4EC5\u770B\u5DF2\u88C5\uFF09"
 ).option("--installed", "\u4EC5\u5C55\u793A\u5DF2\u5B89\u88C5\u7684 skill\uFF08\u9690\u85CF\u672A\u5B89\u88C5\u9879\uFF09").action(async (opts) => {
   try {
@@ -1766,7 +1940,7 @@ var listCommand2 = new Command8("list").alias("ls").description(
     if (opts.installed) {
       if (!config?.packages?.skills || !pkg) {
         logger.info("No skills installed.");
-        logger.info('Run "teamix-evo skills add" to get started.');
+        logger.info('Run "teamix-evo skills init" to get started.');
         return;
       }
       printInstalledHeader(config.packages.skills, pkg.installedAt);
@@ -1795,7 +1969,7 @@ var listCommand2 = new Command8("list").alias("ls").description(
     } else {
       logger.info("Skills package not yet added.");
       logger.info(
-        'Run "teamix-evo skills add" to add all, or "teamix-evo skills add <id>" for specific skills.'
+        'Run "teamix-evo skills init" to bootstrap, or "teamix-evo skills add <id...>" for specific skills.'
       );
     }
     logger.info("");
@@ -1831,10 +2005,185 @@ function printInstalledHeader(cfg, installedAt) {
 }
 
 // src/commands/skills/update.ts
-import { Command as Command9 } from "commander";
-var SKILLS_PACKAGE2 = "@teamix-evo/skills";
+import { Command as Command10 } from "commander";
+import { createRequire as createRequire4 } from "module";
+
+// src/core/skills-update.ts
+var DEFAULT_SKILLS_PACKAGE3 = "@teamix-evo/skills";
 var FLAT_VARIANT2 = "_flat";
-var updateCommand2 = new Command9("update").description("\u66F4\u65B0\u5DF2\u5B89\u88C5\u7684 teamix-evo skills").action(async () => {
+async function runSkillsUpdate(options) {
+  const { projectRoot, names: requestedNames, dryRun } = options;
+  const packageName = options.packageName ?? DEFAULT_SKILLS_PACKAGE3;
+  const config = await readProjectConfig(projectRoot);
+  const skillsCfg = config?.packages?.skills;
+  if (!skillsCfg) {
+    return { status: "no-skills" };
+  }
+  const ides = skillsCfg.ides ?? ["qoder", "claude"];
+  const scope = skillsCfg.scope ?? "project";
+  const existingLock = await readSkillsLock(projectRoot);
+  if (!existingLock || Object.keys(existingLock.skills).length === 0) {
+    return { status: "no-skills" };
+  }
+  const { manifest, data, packageRoot } = await loadSkillsData(packageName);
+  const manifestById = new Map(manifest.skills.map((s) => [s.id, s]));
+  const lockIds = Object.keys(existingLock.skills);
+  const requestedSet = requestedNames ? new Set(requestedNames) : null;
+  if (requestedSet) {
+    const unknown = requestedNames.filter(
+      (n) => !lockIds.includes(n) && !manifestById.has(n)
+    );
+    if (unknown.length > 0) {
+      throw new Error(
+        `Unknown skill id(s): ${unknown.join(
+          ", "
+        )}. Available (installed): ${lockIds.join(", ") || "(none)"}.`
+      );
+    }
+  }
+  const targetIds = [];
+  const skippedSkillIds = [];
+  for (const id of lockIds) {
+    if (requestedSet && !requestedSet.has(id)) continue;
+    const entry2 = manifestById.get(id);
+    if (!entry2) {
+      logger.debug(
+        `Skipping "${id}": no longer in upstream manifest. Use \`skills uninstall ${id}\` to remove.`
+      );
+      skippedSkillIds.push(id);
+      continue;
+    }
+    const effectiveScope = entry2.scope ?? "project";
+    if (effectiveScope !== scope) {
+      logger.debug(
+        `Skipping "${id}" (scope=${effectiveScope}): current install scope is "${scope}".`
+      );
+      skippedSkillIds.push(id);
+      continue;
+    }
+    targetIds.push(id);
+  }
+  const allSame = targetIds.every((id) => {
+    const lockVer = existingLock.skills[id].version;
+    const manVer = manifestById.get(id).version;
+    return lockVer === manVer;
+  });
+  if (targetIds.length > 0 && allSame && !dryRun) {
+    return {
+      status: "no-changes",
+      packageName,
+      version: manifest.version,
+      checkedSkillIds: targetIds
+    };
+  }
+  if (dryRun) {
+    const plan = targetIds.map((id) => {
+      const lockVer = existingLock.skills[id].version;
+      const entry2 = manifestById.get(id);
+      const sameVersion = lockVer === entry2.version;
+      return {
+        id,
+        current: lockVer,
+        next: entry2.version,
+        strategy: entry2.updateStrategy ?? "managed",
+        action: sameVersion ? "up-to-date" : "version-bump"
+      };
+    });
+    return {
+      status: "dry-run",
+      packageName,
+      currentVersion: skillsCfg.version,
+      availableVersion: manifest.version,
+      plan
+    };
+  }
+  if (targetIds.length === 0) {
+    return {
+      status: "updated",
+      packageName,
+      version: manifest.version,
+      ides,
+      scope,
+      updatedSkillIds: [],
+      skippedSkillIds,
+      summary: { overwritten: 0, managed: 0, skipped: 0, created: 0 },
+      resources: []
+    };
+  }
+  const result = await updateSkills({
+    projectRoot,
+    manifest,
+    data,
+    packageRoot,
+    ides,
+    scope,
+    onlyIds: targetIds
+  });
+  config.packages.skills = {
+    ...skillsCfg,
+    version: manifest.version
+  };
+  await writeProjectConfig(projectRoot, config);
+  const installedManifest = await readInstalledManifest(projectRoot) ?? {
+    schemaVersion: 1,
+    installed: []
+  };
+  const idx = installedManifest.installed.findIndex(
+    (p) => p.package === packageName
+  );
+  const installedAt = (/* @__PURE__ */ new Date()).toISOString();
+  const prior = idx >= 0 ? installedManifest.installed[idx].resources : [];
+  const targetSet = new Set(targetIds);
+  const preserved = prior.filter((r) => {
+    const skillId = r.id.split(":")[0];
+    return skillId ? !targetSet.has(skillId) : true;
+  });
+  const entry = {
+    package: packageName,
+    variant: FLAT_VARIANT2,
+    version: manifest.version,
+    installedAt,
+    resources: [...preserved, ...result.resources]
+  };
+  if (idx >= 0) installedManifest.installed[idx] = entry;
+  else installedManifest.installed.push(entry);
+  await writeInstalledManifest(projectRoot, installedManifest);
+  const lock = {
+    schemaVersion: 1,
+    skills: { ...existingLock.skills }
+  };
+  for (const id of targetIds) {
+    const skillDef = manifestById.get(id);
+    if (!skillDef) continue;
+    const mirroredTo = skillDef.ides.filter((i) => ides.includes(i));
+    lock.skills[id] = {
+      version: skillDef.version,
+      from: packageName,
+      installedAt,
+      scope,
+      mirroredTo
+    };
+  }
+  await writeSkillsLock(projectRoot, lock);
+  return {
+    status: "updated",
+    packageName,
+    version: manifest.version,
+    ides,
+    scope,
+    updatedSkillIds: targetIds,
+    skippedSkillIds,
+    summary: result.summary,
+    resources: result.resources
+  };
+}
+
+// src/commands/skills/update.ts
+var require5 = createRequire4(import.meta.url);
+var SKILLS_PACKAGE2 = "@teamix-evo/skills";
+var updateCommand2 = new Command10("update").description(
+  "\u66F4\u65B0\u5DF2\u5B89\u88C5\u7684 teamix-evo skills\uFF08\u4EC5\u5347\u7EA7 lock \u5DF2\u8BB0\u5F55\u4E14 scope \u5339\u914D\u7684 skill \u2014 ADR 0035\uFF09"
+).argument("[names...]", "\u53EF\u9009\uFF1A\u4EC5\u5347\u7EA7\u6307\u5B9A skill id;\u7701\u7565\u5219\u5347\u7EA7\u5168\u90E8\u5DF2\u88C5").option("--dry-run", "\u9884\u89C8\u53D8\u66F4\uFF0C\u4E0D\u5199\u76D8").action(async (names, opts) => {
   try {
     const ide = detectIde();
     const cwd = ide.getProjectRoot();
@@ -1842,95 +2191,101 @@ var updateCommand2 = new Command9("update").description("\u66F4\u65B0\u5DF2\u5B8
     if (projectRoot !== cwd) {
       logger.info(`Using global skills meta root: ${projectRoot}`);
     }
-    const config = await readProjectConfig(projectRoot);
-    if (!config?.packages?.skills) {
-      logger.error('Skills not added. Run "teamix-evo skills add" first.');
-      process.exitCode = 1;
-      return;
-    }
-    const installedManifest = await readInstalledManifest(projectRoot);
-    if (!installedManifest) {
-      logger.error("No installed manifest found.");
-      process.exitCode = 1;
-      return;
-    }
-    const skillsEntry = config.packages.skills;
-    const ides = skillsEntry.ides ?? [
-      "qoder",
-      "claude"
-    ];
-    const scope = skillsEntry.scope ?? "project";
-    logger.info(`Updating skills (ides=[${ides.join(",")}], scope=${scope})`);
-    const { manifest, data, packageRoot } = await loadSkillsData(
-      SKILLS_PACKAGE2
-    );
-    logger.info(
-      `Current: v${skillsEntry.version} \u2192 Available: v${manifest.version}`
-    );
-    const result = await updateSkills({
+    await printVersionBanner();
+    const result = await runSkillsUpdate({
       projectRoot,
-      manifest,
-      data,
-      packageRoot,
-      ides,
-      scope
+      names: names.length > 0 ? names : void 0,
+      dryRun: opts.dryRun
     });
-    config.packages.skills.version = manifest.version;
-    await writeProjectConfig(projectRoot, config);
-    const installedAt = (/* @__PURE__ */ new Date()).toISOString();
-    const idx = installedManifest.installed.findIndex(
-      (p) => p.package === SKILLS_PACKAGE2
-    );
-    const entry = {
-      package: SKILLS_PACKAGE2,
-      variant: FLAT_VARIANT2,
-      version: manifest.version,
-      installedAt,
-      resources: result.resources
-    };
-    if (idx >= 0) installedManifest.installed[idx] = entry;
-    else installedManifest.installed.push(entry);
-    await writeInstalledManifest(projectRoot, installedManifest);
-    const existingLock = await readSkillsLock(projectRoot) ?? {
-      schemaVersion: 1,
-      skills: {}
-    };
-    const lock = {
-      schemaVersion: 1,
-      skills: { ...existingLock.skills }
-    };
-    for (const skill of manifest.skills) {
-      const mirroredTo = skill.ides.filter((i) => ides.includes(i));
-      if (mirroredTo.length === 0) continue;
-      lock.skills[skill.id] = {
-        version: skill.version,
-        from: SKILLS_PACKAGE2,
-        installedAt,
-        scope,
-        mirroredTo
-      };
+    switch (result.status) {
+      case "no-skills":
+        logger.error(
+          'Skills not added. Run "teamix-evo skills init" first.'
+        );
+        process.exitCode = 1;
+        return;
+      case "no-changes":
+        logger.success(
+          `Already up-to-date (skills package v${result.version}).`
+        );
+        logger.info(
+          `  Checked: ${result.checkedSkillIds.join(", ") || "(none)"}`
+        );
+        return;
+      case "dry-run":
+        logger.info(
+          `Plan (${result.currentVersion} \u2192 ${result.availableVersion}):`
+        );
+        if (result.plan.length === 0) {
+          logger.info("  (no skills to update)");
+        } else {
+          for (const item of result.plan) {
+            logger.info(formatPlanItem(item));
+          }
+        }
+        logger.info("");
+        logger.info("Re-run without --dry-run to apply.");
+        return;
+      case "updated": {
+        const { summary } = result;
+        logger.success(
+          `Skills updated to v${result.version} (${result.updatedSkillIds.length} skill(s)).`
+        );
+        if (result.updatedSkillIds.length > 0) {
+          logger.info(
+            `  Updated: ${result.updatedSkillIds.join(", ")}`
+          );
+        }
+        if (result.skippedSkillIds.length > 0) {
+          logger.info(
+            `  Skipped: ${result.skippedSkillIds.join(", ")} (scope mismatch / removed upstream)`
+          );
+        }
+        logger.info(`  Created:     ${summary.created}`);
+        logger.info(`  Overwritten: ${summary.overwritten}`);
+        logger.info(`  Managed:     ${summary.managed}`);
+        logger.info(`  Skipped:     ${summary.skipped}`);
+        return;
+      }
     }
-    await writeSkillsLock(projectRoot, lock);
-    const { summary } = result;
-    logger.success(`Skills updated to v${manifest.version}`);
-    logger.info(`  Created:     ${summary.created}`);
-    logger.info(`  Overwritten: ${summary.overwritten}`);
-    logger.info(`  Managed:     ${summary.managed}`);
-    logger.info(`  Skipped:     ${summary.skipped}`);
   } catch (err) {
     logger.error(`Failed to update skills: ${err.message}`);
     logger.debug(err.stack ?? "");
     process.exitCode = 1;
   }
 });
+function formatPlanItem(item) {
+  const tag = item.action === "up-to-date" ? "  =" : item.strategy === "frozen" ? "  \u2298 " : item.strategy === "managed" ? "  \u2295 " : "  \u2192 ";
+  const ver = item.action === "up-to-date" ? `v${item.current} (no change)` : `v${item.current} \u2192 v${item.next} [${item.strategy}]`;
+  return `${tag}${item.id}  ${ver}`;
+}
+async function printVersionBanner() {
+  let cliVersion;
+  try {
+    const pkg = require5("../package.json");
+    cliVersion = pkg.version;
+  } catch {
+  }
+  try {
+    const { manifest } = await loadSkillsData(SKILLS_PACKAGE2);
+    if (cliVersion) {
+      logger.info(
+        `teamix-evo CLI v${cliVersion} \xB7 skills package v${manifest.version}`
+      );
+    } else {
+      logger.info(`skills package v${manifest.version}`);
+    }
+  } catch {
+  }
+}
 
 // src/commands/skills/uninstall.ts
-import { Command as Command10 } from "commander";
-import * as prompts3 from "@clack/prompts";
+import { Command as Command11 } from "commander";
+import * as prompts4 from "@clack/prompts";
 import * as path13 from "path";
 import * as fs10 from "fs/promises";
 var SKILLS_PACKAGE3 = "@teamix-evo/skills";
-var uninstallCommand2 = new Command10("uninstall").description(
+var uninstallCommand2 = new Command11("uninstall").description(
   "\u5378\u8F7D\u5DF2\u5B89\u88C5\u7684 teamix-evo skills\uFF1B\u4E0D\u4F20 ids \u5219\u5378\u8F7D\u6574\u5305\uFF0C\u4F20 ids \u5219\u6309 skill \u5220\u9664"
 ).argument(
   "[ids...]",
@@ -1984,11 +2339,11 @@ async function runFullUninstall(args) {
     `Will remove ${resources.length} skill file(s) installed by ${SKILLS_PACKAGE3}.`
   );
   if (!opts.yes) {
-    const confirm4 = await prompts3.confirm({
+    const confirm5 = await prompts4.confirm({
       message: "\u786E\u8BA4\u5378\u8F7D\uFF1F\u6B64\u64CD\u4F5C\u4F1A\u5220\u9664\u4E0A\u8FF0\u6587\u4EF6\u3002",
       initialValue: false
     });
-    if (prompts3.isCancel(confirm4) || !confirm4) {
+    if (prompts4.isCancel(confirm5) || !confirm5) {
       logger.info("Cancelled.");
       return;
     }
@@ -2053,11 +2408,11 @@ async function runPartialUninstall(args) {
     `Will remove ${matched.length} skill(s): ${matched.join(", ")} (${toRemove.length} file(s)).`
   );
   if (!opts.yes) {
-    const confirm4 = await prompts3.confirm({
+    const confirm5 = await prompts4.confirm({
       message: "\u786E\u8BA4\u5378\u8F7D\uFF1F\u6B64\u64CD\u4F5C\u4F1A\u5220\u9664\u4E0A\u8FF0\u6587\u4EF6\u3002",
       initialValue: false
     });
-    if (prompts3.isCancel(confirm4) || !confirm4) {
+    if (prompts4.isCancel(confirm5) || !confirm5) {
       logger.info("Cancelled.");
       return;
     }
@@ -2174,17 +2529,17 @@ function dedupe(values) {
 }
 
 // src/commands/skills/sync.ts
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 
 // src/core/skills-sync.ts
 import * as path14 from "path";
 import * as fs11 from "fs/promises";
-import { createRequire as createRequire4 } from "module";
+import { createRequire as createRequire5 } from "module";
 import { loadSkillsPackageManifest as loadSkillsPackageManifest2 } from "@teamix-evo/registry";
-var require5 = createRequire4(import.meta.url);
+var require6 = createRequire5(import.meta.url);
 async function readSkillMetaFromUpstream(skillId) {
   try {
-    const pkgJson = require5.resolve("@teamix-evo/skills/package.json");
+    const pkgJson = require6.resolve("@teamix-evo/skills/package.json");
     const packageRoot = path14.dirname(pkgJson);
     const manifest = await loadSkillsPackageManifest2(packageRoot);
     const entry = manifest.skills.find((s) => s.id === skillId);
@@ -2283,7 +2638,7 @@ async function refreshMirrorRecords(projectRoot, newMirrorRecords) {
 }
 
 // src/commands/skills/sync.ts
-var syncCommand = new Command11("sync").description(
+var syncCommand = new Command12("sync").description(
   "\u628A .teamix-evo/skills/ \u4E0B\u7684\u6E90\u91CD\u65B0\u955C\u50CF\u5230 IDE \u8DEF\u5F84\uFF08.qoder / .claude\uFF09"
 ).argument(
   "[names...]",
@@ -2302,8 +2657,8 @@ var syncCommand = new Command11("sync").description(
     if (projectRoot !== cwd) {
       logger.info(`Using global skills meta root: ${projectRoot}`);
     }
-    const ides = opts.ide ? parseIdeList2(opts.ide) : void 0;
-    const scope = opts.scope ? parseScope2(opts.scope) : void 0;
+    const ides = opts.ide ? parseIdeList3(opts.ide) : void 0;
+    const scope = opts.scope ? parseScope3(opts.scope) : void 0;
     const result = await runSkillsSync({
       projectRoot,
       ides,
@@ -2335,7 +2690,7 @@ var syncCommand = new Command11("sync").description(
     process.exitCode = 1;
   }
 });
-function parseIdeList2(input) {
+function parseIdeList3(input) {
   const parts = input.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
   const result = [];
   for (const p of parts) {
@@ -2349,14 +2704,14 @@ function parseIdeList2(input) {
   }
   return result;
 }
-function parseScope2(input) {
+function parseScope3(input) {
   const v = input.toLowerCase();
   if (v === "project" || v === "global") return v;
   throw new Error(`Invalid --scope: "${input}". Expected project | global.`);
 }
 
 // src/commands/skills/doctor.ts
-import { Command as Command12 } from "commander";
+import { Command as Command13 } from "commander";
 
 // src/core/skills-doctor.ts
 import * as path15 from "path";
@@ -2375,7 +2730,7 @@ async function runSkillsDoctor(options) {
         kind: "missing-source",
         skillId,
         path: sourceDir,
-        detail: 'Run "teamix-evo skills add" to reinstall.'
+        detail: 'Run "teamix-evo skills init" to reinstall.'
       });
       continue;
     }
@@ -2445,7 +2800,7 @@ async function dirExists2(p) {
 }
 
 // src/commands/skills/doctor.ts
-var doctorCommand = new Command12("doctor").description(
+var doctorCommand = new Command13("doctor").description(
   "\u68C0\u67E5 .teamix-evo/skills/ \u6E90\u4E0E IDE \u955C\u50CF\u662F\u5426\u6F02\u79FB\uFF1B\u63D0\u793A\u5982\u4F55\u4FEE\u590D"
 ).action(async () => {
   try {
@@ -2458,7 +2813,7 @@ var doctorCommand = new Command12("doctor").description(
     const result = await runSkillsDoctor({ projectRoot });
     if (result.status === "no-skills") {
       logger.info(
-        'No skills recorded. Run "teamix-evo skills add" first.'
+        'No skills recorded. Run "teamix-evo skills init" first.'
       );
       return;
     }
@@ -2484,9 +2839,10 @@ var doctorCommand = new Command12("doctor").description(
 });
 
 // src/commands/skills/index.ts
-var skillsCommand = new Command13("skills").description(
+var skillsCommand = new Command14("skills").description(
   "\u7BA1\u7406 teamix-evo skills\uFF08\u5411 AI IDE \u6CE8\u5165\u6280\u80FD\uFF1Bsource-mirror \u6A21\u578B\u89C1 ADR 0013\uFF09"
 );
+skillsCommand.addCommand(initCommand2);
 skillsCommand.addCommand(addCommand);
 skillsCommand.addCommand(listCommand2);
 skillsCommand.addCommand(updateCommand2);
@@ -2495,11 +2851,11 @@ skillsCommand.addCommand(doctorCommand);
 skillsCommand.addCommand(uninstallCommand2);
 
 // src/commands/ui/index.ts
-import { Command as Command17 } from "commander";
+import { Command as Command18 } from "commander";
 
 // src/commands/ui/init.ts
-import { Command as Command14 } from "commander";
-import * as prompts4 from "@clack/prompts";
+import { Command as Command15 } from "commander";
+import * as prompts5 from "@clack/prompts";
 
 // src/core/ui-init.ts
 var DEFAULT_UI_ALIASES = {
@@ -2556,7 +2912,7 @@ async function runUiInit(options) {
 }
 
 // src/commands/ui/init.ts
-var initCommand2 = new Command14("init").description(
+var initCommand3 = new Command15("init").description(
   "\u521D\u59CB\u5316 teamix-evo ui \u914D\u7F6E\uFF08\u8BE2\u95EE aliases / iconLibrary / tsx / rsc\uFF09"
 ).option("-y, --yes", "\u4F7F\u7528\u9ED8\u8BA4\u503C\uFF0C\u8DF3\u8FC7\u4EA4\u4E92").option(
   "--components <path>",
@@ -2618,41 +2974,41 @@ async function resolveConfig(opts) {
       rsc: opts.rsc ?? false
     };
   }
-  const components = await prompts4.text({
+  const components = await prompts5.text({
     message: "components \u8DEF\u5F84\uFF08\u6CE8\u5165\u6309\u94AE\u7B49\u7EC4\u4EF6\u6E90\u7801\u7684\u76EE\u5F55\uFF09",
     initialValue: opts.components ?? DEFAULT_UI_ALIASES.components
   });
-  if (prompts4.isCancel(components)) throw new Error("Cancelled by user.");
-  const hooks = await prompts4.text({
+  if (prompts5.isCancel(components)) throw new Error("Cancelled by user.");
+  const hooks = await prompts5.text({
     message: "hooks \u8DEF\u5F84",
     initialValue: opts.hooks ?? DEFAULT_UI_ALIASES.hooks
   });
-  if (prompts4.isCancel(hooks)) throw new Error("Cancelled by user.");
-  const utils = await prompts4.text({
+  if (prompts5.isCancel(hooks)) throw new Error("Cancelled by user.");
+  const utils = await prompts5.text({
     message: "utils \u8DEF\u5F84\uFF08cn \u7B49\u5DE5\u5177\uFF09",
     initialValue: opts.utils ?? DEFAULT_UI_ALIASES.utils
   });
-  if (prompts4.isCancel(utils)) throw new Error("Cancelled by user.");
-  const lib = await prompts4.text({
+  if (prompts5.isCancel(utils)) throw new Error("Cancelled by user.");
+  const lib = await prompts5.text({
     message: "lib \u8DEF\u5F84\uFF08\u5171\u4EAB\u4EE3\u7801\u6839\uFF09",
     initialValue: opts.lib ?? DEFAULT_UI_ALIASES.lib
   });
-  if (prompts4.isCancel(lib)) throw new Error("Cancelled by user.");
-  const iconLibrary = await prompts4.text({
+  if (prompts5.isCancel(lib)) throw new Error("Cancelled by user.");
+  const iconLibrary = await prompts5.text({
     message: "icon \u5E93\uFF08\u58F0\u660E\u6027\uFF0C\u7EC4\u4EF6\u6E90\u7801\u5DF2 hardcode lucide-react\uFF09",
     initialValue: opts.iconLibrary ?? "lucide"
   });
-  if (prompts4.isCancel(iconLibrary)) throw new Error("Cancelled by user.");
-  const tsxAns = await prompts4.confirm({
+  if (prompts5.isCancel(iconLibrary)) throw new Error("Cancelled by user.");
+  const tsxAns = await prompts5.confirm({
     message: "\u4F7F\u7528 TSX\uFF1F",
     initialValue: opts.tsx ?? true
   });
-  if (prompts4.isCancel(tsxAns)) throw new Error("Cancelled by user.");
-  const rscAns = await prompts4.confirm({
+  if (prompts5.isCancel(tsxAns)) throw new Error("Cancelled by user.");
+  const rscAns = await prompts5.confirm({
     message: "\u4F7F\u7528 React Server Components\uFF1F",
     initialValue: opts.rsc ?? false
   });
-  if (prompts4.isCancel(rscAns)) throw new Error("Cancelled by user.");
+  if (prompts5.isCancel(rscAns)) throw new Error("Cancelled by user.");
   return {
     aliases: {
       components,
@@ -2669,16 +3025,16 @@ async function resolveConfig(opts) {
 }
 
 // src/commands/ui/add.ts
-import { Command as Command15 } from "commander";
+import { Command as Command16 } from "commander";
 
 // src/core/ui-client.ts
 import * as path16 from "path";
 import * as fs13 from "fs/promises";
-import { createRequire as createRequire5 } from "module";
+import { createRequire as createRequire6 } from "module";
 import { loadUiPackageManifest } from "@teamix-evo/registry";
-var require6 = createRequire5(import.meta.url);
+var require7 = createRequire6(import.meta.url);
 function resolvePackageRoot2(packageName) {
-  const pkgJsonPath = require6.resolve(`${packageName}/package.json`);
+  const pkgJsonPath = require7.resolve(`${packageName}/package.json`);
   return path16.dirname(pkgJsonPath);
 }
 async function loadUiData(packageName) {
@@ -2894,7 +3250,7 @@ function mergeResources(prior, next) {
 }
 
 // src/commands/ui/add.ts
-var addCommand2 = new Command15("add").description(
+var addCommand2 = new Command16("add").description(
   "\u5B89\u88C5\u4E00\u4E2A\u6216\u591A\u4E2A ui entry\uFF08\u6309 id\uFF0C\u81EA\u52A8\u5C55\u5F00 registryDependencies\uFF09"
 ).argument("<ids...>", 'entry id \u5217\u8868\uFF0C\u5982 "button" "dialog"').option("--overwrite", "\u5373\u4F7F\u76EE\u6807\u6587\u4EF6\u5DF2\u5B58\u5728\u4E5F\u8986\u76D6\uFF08\u7ED5\u8FC7 frozen \u8DF3\u8FC7\uFF09").option(
   "--include-deprecated",
@@ -2940,7 +3296,7 @@ var addCommand2 = new Command15("add").description(
 );
 
 // src/commands/ui/list.ts
-import { Command as Command16 } from "commander";
+import { Command as Command17 } from "commander";
 
 // src/core/ui-list.ts
 var DEFAULT_UI_PACKAGE2 = "@teamix-evo/ui";
@@ -2978,7 +3334,7 @@ async function runUiList(options) {
 }
 
 // src/commands/ui/list.ts
-var listCommand3 = new Command16("list").description("\u5217\u51FA @teamix-evo/ui \u7684\u6240\u6709 entry \u53CA\u5DF2\u5B89\u88C5\u72B6\u6001").option("--installed", "\u4EC5\u5C55\u793A\u5DF2\u5B89\u88C5\u7684 entry").option(
+var listCommand3 = new Command17("list").description("\u5217\u51FA @teamix-evo/ui \u7684\u6240\u6709 entry \u53CA\u5DF2\u5B89\u88C5\u72B6\u6001").option("--installed", "\u4EC5\u5C55\u793A\u5DF2\u5B89\u88C5\u7684 entry").option(
   "--include-deprecated",
   "\u540C\u65F6\u5217\u51FA\u5DF2\u5F52\u6863\u7684 deprecated entry\uFF08\u9ED8\u8BA4\u9690\u85CF\uFF0CADR 0028\uFF09"
 ).action(
@@ -3030,30 +3386,30 @@ var listCommand3 = new Command16("list").description("\u5217\u51FA @teamix-evo/u
 );
 
 // src/commands/ui/index.ts
-var uiCommand = new Command17("ui").description(
+var uiCommand = new Command18("ui").description(
   "\u7BA1\u7406 teamix-evo ui \u7EC4\u4EF6\uFF08\u6E90\u7801\u6CE8\u5165\u5F0F\u5B89\u88C5\uFF0Cshadcn \u98CE\u683C\uFF09"
 );
-uiCommand.addCommand(initCommand2);
+uiCommand.addCommand(initCommand3);
 uiCommand.addCommand(addCommand2);
 uiCommand.addCommand(listCommand3);
 
 // src/commands/biz-ui/index.ts
-import { Command as Command21 } from "commander";
+import { Command as Command22 } from "commander";
 
 // src/commands/biz-ui/add.ts
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 
 // src/core/variant-ui-add.ts
 import * as path18 from "path";
-import { createRequire as createRequire6 } from "module";
+import { createRequire as createRequire7 } from "module";
 import {
   loadUiPackageManifest as loadUiPackageManifest2,
   loadVariantUiPackageCatalog,
   loadVariantUiPackageManifest
 } from "@teamix-evo/registry";
-var require7 = createRequire6(import.meta.url);
+var require8 = createRequire7(import.meta.url);
 function resolvePackageRoot3(packageName) {
-  const pkgJsonPath = require7.resolve(`${packageName}/package.json`);
+  const pkgJsonPath = require8.resolve(`${packageName}/package.json`);
   return path18.dirname(pkgJsonPath);
 }
 async function runVariantUiAdd(packageName, options) {
@@ -3212,7 +3568,7 @@ async function listTemplatesEntries(variant, packageRoot) {
 }
 
 // src/commands/biz-ui/add.ts
-var addCommand3 = new Command18("add").description(
+var addCommand3 = new Command19("add").description(
   "\u5B89\u88C5\u4E00\u4E2A\u6216\u591A\u4E2A\u4E1A\u52A1 UI \u7EC4\u4EF6(\u6309 id,\u81EA\u52A8\u5C55\u5F00 ui \u5305\u7684 registryDependencies)"
 ).argument("<ids...>", '\u7EC4\u4EF6 id \u5217\u8868,\u5982 "tenant-switcher" "org-picker"').option("--variant <name>", '\u53D8\u4F53 id(\u5FC5\u586B,\u5982 "opentrek"\u3001"uni-manager")').option("--overwrite", "\u5373\u4F7F\u76EE\u6807\u6587\u4EF6\u5DF2\u5B58\u5728\u4E5F\u8986\u76D6").action(
   async (ids, opts) => {
@@ -3261,8 +3617,8 @@ var addCommand3 = new Command18("add").description(
 );
 
 // src/commands/biz-ui/list.ts
-import { Command as Command19 } from "commander";
-var listCommand4 = new Command19("list").description("\u5217\u51FA\u6307\u5B9A\u53D8\u4F53\u4E0B\u7684 biz-ui entries").requiredOption("--variant <name>", "\u53D8\u4F53\u540D\uFF08\u5982 opentrek / uni-manager\uFF09").action(async (opts) => {
+import { Command as Command20 } from "commander";
+var listCommand4 = new Command20("list").description("\u5217\u51FA\u6307\u5B9A\u53D8\u4F53\u4E0B\u7684 biz-ui entries").requiredOption("--variant <name>", "\u53D8\u4F53\u540D\uFF08\u5982 opentrek / uni-manager\uFF09").action(async (opts) => {
   try {
     const result = await listBizUiEntries(opts.variant);
     logger.info(`${result.packageName}#${result.variant} entries:`);
@@ -3287,8 +3643,8 @@ var listCommand4 = new Command19("list").description("\u5217\u51FA\u6307\u5B9A\u
 });
 
 // src/commands/biz-ui/list-variants.ts
-import { Command as Command20 } from "commander";
-var listVariantsCommand2 = new Command20("list-variants").description("\u5217\u51FA @teamix-evo/biz-ui \u5305\u5185\u63D0\u4F9B\u7684\u6240\u6709\u4E1A\u52A1\u53D8\u4F53").action(async () => {
+import { Command as Command21 } from "commander";
+var listVariantsCommand2 = new Command21("list-variants").description("\u5217\u51FA @teamix-evo/biz-ui \u5305\u5185\u63D0\u4F9B\u7684\u6240\u6709\u4E1A\u52A1\u53D8\u4F53").action(async () => {
   try {
     const result = await listBizUiVariants();
     logger.info(`Available biz-ui variants in ${result.packageName}:`);
@@ -3310,7 +3666,7 @@ var listVariantsCommand2 = new Command20("list-variants").description("\u5217\u5
 });
 
 // src/commands/biz-ui/index.ts
-var bizUiCommand = new Command21("biz-ui").description(
+var bizUiCommand = new Command22("biz-ui").description(
   "\u7BA1\u7406\u4E1A\u52A1 UI \u7EC4\u4EF6(\u53D8\u4F53\u611F\u77E5 \u2014 \u4E0E design / templates \u540C\u53D8\u4F53\u540D\u7A7A\u95F4)"
 );
 bizUiCommand.addCommand(addCommand3);
@@ -3318,11 +3674,11 @@ bizUiCommand.addCommand(listCommand4);
 bizUiCommand.addCommand(listVariantsCommand2);
 
 // src/commands/templates/index.ts
-import { Command as Command25 } from "commander";
+import { Command as Command26 } from "commander";
 
 // src/commands/templates/add.ts
-import { Command as Command22 } from "commander";
-var addCommand4 = new Command22("add").description(
+import { Command as Command23 } from "commander";
+var addCommand4 = new Command23("add").description(
   "\u5B89\u88C5\u4E00\u4E2A\u6216\u591A\u4E2A\u9875\u9762\u6A21\u677F(\u6309 id,\u81EA\u52A8\u5C55\u5F00 ui \u5305\u7684 registryDependencies)"
 ).argument("<ids...>", '\u6A21\u677F id \u5217\u8868,\u5982 "list-detail-page"').option("--variant <name>", '\u53D8\u4F53 id(\u5FC5\u586B,\u5982 "opentrek"\u3001"uni-manager")').option("--overwrite", "\u5373\u4F7F\u76EE\u6807\u6587\u4EF6\u5DF2\u5B58\u5728\u4E5F\u8986\u76D6").action(
   async (ids, opts) => {
@@ -3371,8 +3727,8 @@ var addCommand4 = new Command22("add").description(
 );
 
 // src/commands/templates/list.ts
-import { Command as Command23 } from "commander";
-var listCommand5 = new Command23("list").description("\u5217\u51FA\u6307\u5B9A\u53D8\u4F53\u4E0B\u7684 templates entries").requiredOption("--variant <name>", "\u53D8\u4F53\u540D\uFF08\u5982 opentrek / uni-manager\uFF09").action(async (opts) => {
+import { Command as Command24 } from "commander";
+var listCommand5 = new Command24("list").description("\u5217\u51FA\u6307\u5B9A\u53D8\u4F53\u4E0B\u7684 templates entries").requiredOption("--variant <name>", "\u53D8\u4F53\u540D\uFF08\u5982 opentrek / uni-manager\uFF09").action(async (opts) => {
   try {
     const result = await listTemplatesEntries(opts.variant);
     logger.info(`${result.packageName}#${result.variant} entries:`);
@@ -3397,8 +3753,8 @@ var listCommand5 = new Command23("list").description("\u5217\u51FA\u6307\u5B9A\u
 });
 
 // src/commands/templates/list-variants.ts
-import { Command as Command24 } from "commander";
-var listVariantsCommand3 = new Command24("list-variants").description("\u5217\u51FA @teamix-evo/templates \u5305\u5185\u63D0\u4F9B\u7684\u6240\u6709\u9875\u9762\u6A21\u677F\u53D8\u4F53").action(async () => {
+import { Command as Command25 } from "commander";
+var listVariantsCommand3 = new Command25("list-variants").description("\u5217\u51FA @teamix-evo/templates \u5305\u5185\u63D0\u4F9B\u7684\u6240\u6709\u9875\u9762\u6A21\u677F\u53D8\u4F53").action(async () => {
   try {
     const result = await listTemplatesVariants();
     logger.info(`Available templates variants in ${result.packageName}:`);
@@ -3420,7 +3776,7 @@ var listVariantsCommand3 = new Command24("list-variants").description("\u5217\u5
 });
 
 // src/commands/templates/index.ts
-var templatesCommand = new Command25("templates").description(
+var templatesCommand = new Command26("templates").description(
   "\u7BA1\u7406\u9875\u9762\u6A21\u677F(\u53D8\u4F53\u611F\u77E5 \u2014 \u4E0E design / biz-ui \u540C\u53D8\u4F53\u540D\u7A7A\u95F4)"
 );
 templatesCommand.addCommand(addCommand4);
@@ -3428,24 +3784,26 @@ templatesCommand.addCommand(listCommand5);
 templatesCommand.addCommand(listVariantsCommand3);
 
 // src/commands/logs/index.ts
-import { Command as Command28 } from "commander";
+import { Command as Command29 } from "commander";
 
 // src/commands/logs/analyze.ts
-import { Command as Command26 } from "commander";
+import { Command as Command27 } from "commander";
 import { readFileSync, readdirSync, existsSync as existsSync2, statSync } from "fs";
 import { resolve as resolve3, join as join17 } from "path";
 var DATE_DIR_RE = /^\d{4}-\d{2}-\d{2}$/;
-var logsAnalyzeCommand = new Command26("analyze").description(
-  "\u6C47\u603B vibe-logger \u8F93\u51FA (.log/ai/**/*.jsonl) \u2014 \u5DE5\u5177 / \u5305\u6807\u7B7E / MCP \u8C03\u7528\u9891\u7387,\u8F85\u52A9\u751F\u6001\u4F18\u5316"
-).option("--dir <path>", "log \u76EE\u5F55 (\u9ED8\u8BA4 <project>/.log/ai)").option(
+var logsAnalyzeCommand = new Command27("analyze").description(
+  "\u6C47\u603B vibe-logger \u8F93\u51FA (.teamix-evo/logs/ai/**/*.jsonl) \u2014 \u5DE5\u5177 / \u5305\u6807\u7B7E / MCP \u8C03\u7528\u9891\u7387,\u8F85\u52A9\u751F\u6001\u4F18\u5316"
+).option("--dir <path>", "log \u76EE\u5F55 (\u9ED8\u8BA4 <project>/.teamix-evo/logs/ai)").option(
   "--days <n>",
   "\u53EA\u770B\u6700\u8FD1 N \u5929\u7684\u76EE\u5F55 (\u9ED8\u8BA4\u5168\u90E8;\u6309\u76EE\u5F55\u540D YYYY-MM-DD \u6BD4\u5BF9,\u4E0D\u89E3\u6790\u8BB0\u5F55 ts)"
 ).option("--top <n>", "\u6BCF\u4E2A\u6392\u884C\u5C55\u793A\u524D N \u9879 (\u9ED8\u8BA4 10)", "10").option("--json", "\u4EE5 JSON \u8F93\u51FA (CI/\u5DE5\u5177\u53CB\u597D)").action((opts) => {
-  const baseDir = resolve3(opts.dir ?? join17(process.cwd(), ".log", "ai"));
+  const baseDir = resolve3(
+    opts.dir ?? join17(process.cwd(), ".teamix-evo", "logs", "ai")
+  );
   if (!existsSync2(baseDir)) {
     logger.warn(`No log directory at ${baseDir}.`);
     logger.info(
-      "\u8FD0\u884C vibe-logger hook \u89E6\u53D1\u540E\u4F1A\u5728\u6B64\u76EE\u5F55\u751F\u6210 JSONL \u2014 \u89C1 .claude/scripts/vibe-logger.mjs"
+      "\u8FD0\u884C vibe-logger hook \u89E6\u53D1\u540E\u4F1A\u5728\u6B64\u76EE\u5F55\u751F\u6210 JSONL \u2014 \u89C1 .claude/scripts/vibe-logger.mjs\uFF08\u9ED8\u8BA4\u8DEF\u5F84 .teamix-evo/logs/ai\uFF09"
     );
     return;
   }
@@ -3615,18 +3973,20 @@ function parseIntOrUndef(v) {
 }
 
 // src/commands/logs/trace.ts
-import { Command as Command27 } from "commander";
+import { Command as Command28 } from "commander";
 import { readFileSync as readFileSync2, readdirSync as readdirSync2, existsSync as existsSync3, statSync as statSync2 } from "fs";
 import { resolve as resolve4, join as join18 } from "path";
 var DATE_DIR_RE2 = /^\d{4}-\d{2}-\d{2}$/;
-var logsTraceCommand = new Command27("trace").description(
+var logsTraceCommand = new Command28("trace").description(
   "\u6309\u4F1A\u8BDD\u8FD8\u539F AI \u8C03\u7528\u94FE\u8DEF:\u4ECE\u7528\u6237 prompt \u8D77\u59CB,\u4E32\u8054\u540E\u7EED PreToolUse/PostToolUse \u76F4\u5230\u4E0B\u4E00\u4E2A prompt \u6216 Stop"
-).option("--prompt <keyword>", "\u6309\u7528\u6237\u8F93\u5165\u5173\u952E\u5B57\u8FC7\u6EE4 (\u5B50\u4E32\u5339\u914D,\u4E0D\u533A\u5206\u5927\u5C0F\u5199)").option("--session <id>", "\u6307\u5B9A\u4F1A\u8BDD ID (\u524D\u7F00\u5339\u914D)").option("--days <n>", "\u53EA\u770B\u6700\u8FD1 N \u5929\u7684\u76EE\u5F55 (\u9ED8\u8BA4 7)", "7").option("--dir <path>", "log \u76EE\u5F55 (\u9ED8\u8BA4 <project>/.log/ai)").option("--json", "\u4EE5 JSON \u8F93\u51FA (CI/\u5DE5\u5177\u53CB\u597D)").action((opts) => {
-  const baseDir = resolve4(opts.dir ?? join18(process.cwd(), ".log", "ai"));
+).option("--prompt <keyword>", "\u6309\u7528\u6237\u8F93\u5165\u5173\u952E\u5B57\u8FC7\u6EE4 (\u5B50\u4E32\u5339\u914D,\u4E0D\u533A\u5206\u5927\u5C0F\u5199)").option("--session <id>", "\u6307\u5B9A\u4F1A\u8BDD ID (\u524D\u7F00\u5339\u914D)").option("--days <n>", "\u53EA\u770B\u6700\u8FD1 N \u5929\u7684\u76EE\u5F55 (\u9ED8\u8BA4 7)", "7").option("--dir <path>", "log \u76EE\u5F55 (\u9ED8\u8BA4 <project>/.teamix-evo/logs/ai)").option("--json", "\u4EE5 JSON \u8F93\u51FA (CI/\u5DE5\u5177\u53CB\u597D)").action((opts) => {
+  const baseDir = resolve4(
+    opts.dir ?? join18(process.cwd(), ".teamix-evo", "logs", "ai")
+  );
   if (!existsSync3(baseDir)) {
     logger.warn(`No log directory at ${baseDir}.`);
     logger.info(
-      "\u8FD0\u884C vibe-logger hook \u89E6\u53D1\u540E\u4F1A\u5728\u6B64\u76EE\u5F55\u751F\u6210 JSONL \u2014 \u89C1 .claude/scripts/vibe-logger.mjs"
+      "\u8FD0\u884C vibe-logger hook \u89E6\u53D1\u540E\u4F1A\u5728\u6B64\u76EE\u5F55\u751F\u6210 JSONL \u2014 \u89C1 .claude/scripts/vibe-logger.mjs\uFF08\u9ED8\u8BA4\u8DEF\u5F84 .teamix-evo/logs/ai\uFF09"
     );
     return;
   }
@@ -3778,7 +4138,9 @@ function printTrace(baseDir, r) {
     logger.info("");
     for (const c of s.chains) {
       logger.info(
-        `[${formatTime(c.promptTs)}] \u{1F4AC} Prompt: ${quote(truncate(c.prompt, 200))}`
+        `[${formatTime(c.promptTs)}] \u{1F4AC} Prompt: ${quote(
+          truncate(c.prompt, 200)
+        )}`
       );
       for (const step of c.steps) {
         logger.info(`  ${formatStep(step)}`);
@@ -3825,16 +4187,175 @@ function parseIntOrUndef2(v) {
 }
 
 // src/commands/logs/index.ts
-var logsCommand = new Command28("logs").description(
-  "\u67E5\u8BE2 vibe-logger \u8F93\u51FA (.log/ai/**/*.jsonl) \u2014 AI \u8C03\u7528\u94FE\u5206\u6790"
+var logsCommand = new Command29("logs").description(
+  "\u67E5\u8BE2 vibe-logger \u8F93\u51FA (.teamix-evo/logs/ai/**/*.jsonl) \u2014 AI \u8C03\u7528\u94FE\u5206\u6790"
 );
 logsCommand.addCommand(logsAnalyzeCommand);
 logsCommand.addCommand(logsTraceCommand);
 
+// src/commands/lint/index.ts
+import { Command as Command31 } from "commander";
+
+// src/commands/lint/init.ts
+import { Command as Command30 } from "commander";
+import * as prompts6 from "@clack/prompts";
+
+// src/core/lint-init.ts
+import * as path19 from "path";
+import * as fs15 from "fs";
+import { execa } from "execa";
+var ESLINT_CONFIG_CONTENT = `/**
+ * teamix-evo consumer ESLint preset \u2014 9 token-discipline rules.
+ * - Repo-wide: no-color-literal / no-arbitrary-tw-value / no-raw-color-scale /
+ *   no-large-radius / prefer-gap-over-space / no-manual-dark-classnames /
+ *   dialog-must-have-title (all error)
+ * - src/components/ui/** only: no-relative-ui-import / icon-from-lucide (error)
+ *
+ * See ADR 0008 / docs/principles.md \xA7P4.
+ */
+import consumerPreset from '@teamix-evo/eslint-config/presets/consumer';
+
+export default [...consumerPreset];
+`;
+var STYLELINT_CONFIG_CONTENT = `/** @type {import('stylelint').Config} */
+module.exports = {
+  extends: ['@teamix-evo/stylelint-config/presets/consumer'],
+};
+`;
+var ESLINT_DEPS = [
+  "@teamix-evo/eslint-config",
+  "eslint",
+  "@typescript-eslint/parser"
+];
+var STYLELINT_DEPS = ["@teamix-evo/stylelint-config", "stylelint"];
+async function runLintInit(options) {
+  const { projectRoot, skipInstall } = options;
+  const eslintConfigPath = path19.join(projectRoot, "eslint.config.js");
+  const stylelintConfigPath = path19.join(projectRoot, "stylelint.config.cjs");
+  const eslintExists = await fileExists(eslintConfigPath);
+  const stylelintExists = await fileExists(stylelintConfigPath);
+  if (eslintExists && stylelintExists) {
+    return { status: "already-initialized" };
+  }
+  if (!skipInstall) {
+    const depsToInstall = [
+      ...eslintExists ? [] : ESLINT_DEPS,
+      ...stylelintExists ? [] : STYLELINT_DEPS
+    ];
+    if (depsToInstall.length > 0) {
+      const pm = detectPm(projectRoot);
+      const args = pm === "yarn" ? ["add", "--dev", ...depsToInstall] : pm === "pnpm" ? ["add", "-D", ...depsToInstall] : ["install", "--save-dev", ...depsToInstall];
+      logger.info(`Installing lint deps via ${pm}...`);
+      await execa(pm, args, { cwd: projectRoot, stdio: "inherit" });
+    }
+  }
+  let wroteEslint = false;
+  let wroteStylelint = false;
+  if (!eslintExists) {
+    await writeFileSafe(eslintConfigPath, ESLINT_CONFIG_CONTENT);
+    logger.debug(`Wrote eslint.config.js \u2192 ${eslintConfigPath}`);
+    wroteEslint = true;
+  }
+  if (!stylelintExists) {
+    await writeFileSafe(stylelintConfigPath, STYLELINT_CONFIG_CONTENT);
+    logger.debug(`Wrote stylelint.config.cjs \u2192 ${stylelintConfigPath}`);
+    wroteStylelint = true;
+  }
+  await patchPackageJsonScripts(projectRoot);
+  return {
+    status: "installed",
+    eslint: wroteEslint,
+    stylelint: wroteStylelint
+  };
+}
+function detectPm(projectRoot) {
+  if (fs15.existsSync(path19.join(projectRoot, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs15.existsSync(path19.join(projectRoot, "yarn.lock"))) return "yarn";
+  return "npm";
+}
+async function patchPackageJsonScripts(projectRoot) {
+  const pkgPath = path19.join(projectRoot, "package.json");
+  const raw = await readFileOrNull(pkgPath);
+  if (!raw) return;
+  let pkg;
+  try {
+    pkg = JSON.parse(raw);
+  } catch {
+    return;
+  }
+  const scripts = pkg.scripts ?? {};
+  let changed = false;
+  if (!scripts.lint) {
+    scripts.lint = "eslint src/";
+    changed = true;
+  }
+  if (!scripts["lint:css"]) {
+    scripts["lint:css"] = "stylelint 'src/**/*.css'";
+    changed = true;
+  }
+  if (changed) {
+    pkg.scripts = scripts;
+    await writeFileSafe(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+    logger.debug("Patched package.json scripts with lint / lint:css");
+  }
+}
+
+// src/commands/lint/init.ts
+var initCommand4 = new Command30("init").description(
+  "\u521D\u59CB\u5316 ESLint + Stylelint \u5DE5\u7A0B\u89C4\u8303\uFF08\u5B89\u88C5\u4F9D\u8D56 + \u751F\u6210\u914D\u7F6E\u6587\u4EF6 + \u6CE8\u5165 scripts\uFF09"
+).option("-y, --yes", "\u8DF3\u8FC7\u786E\u8BA4\uFF0C\u76F4\u63A5\u6267\u884C").action(async (opts) => {
+  try {
+    const ide = detectIde();
+    const projectRoot = ide.getProjectRoot();
+    if (!hasPackageJson(projectRoot)) {
+      logger.error(
+        "No package.json found in current directory. Please run this command in a valid project root."
+      );
+      process.exit(1);
+    }
+    if (!opts.yes) {
+      const shouldContinue = await prompts6.confirm({
+        message: "\u5373\u5C06\u5B89\u88C5 ESLint + Stylelint token-discipline \u89C4\u5219\u96C6\u5E76\u751F\u6210\u914D\u7F6E\u6587\u4EF6\uFF0C\u662F\u5426\u7EE7\u7EED\uFF1F"
+      });
+      if (prompts6.isCancel(shouldContinue) || !shouldContinue) {
+        logger.info("Cancelled.");
+        return;
+      }
+    }
+    const result = await runLintInit({ projectRoot });
+    if (result.status === "already-initialized") {
+      logger.warn(
+        "Lint already initialized. eslint.config.js and stylelint.config.cjs both exist."
+      );
+      return;
+    }
+    logger.success("Lint initialized.");
+    if (result.eslint) {
+      logger.info("  + eslint.config.js");
+    }
+    if (result.stylelint) {
+      logger.info("  + stylelint.config.cjs");
+    }
+    logger.info("");
+    logger.info('Run "npm run lint" to check JSX/TSX token discipline.');
+    logger.info('Run "npm run lint:css" to check CSS token discipline.');
+  } catch (err) {
+    logger.error(`Failed to initialize lint: ${err.message}`);
+    logger.debug(err.stack ?? "");
+    process.exitCode = 1;
+  }
+});
+
+// src/commands/lint/index.ts
+var lintCommand = new Command31("lint").description(
+  "\u7BA1\u7406\u5DE5\u7A0B\u89C4\u8303\uFF08ESLint + Stylelint token-discipline \u89C4\u5219\u96C6\uFF09"
+);
+lintCommand.addCommand(initCommand4);
+
 // src/index.ts
-var require8 = createRequire7(import.meta.url);
-var { version } = require8("../package.json");
-var program = new Command29();
+var require9 = createRequire8(import.meta.url);
+var { version } = require9("../package.json");
+var program = new Command32();
 program.name("teamix-evo").description("Where ideas evolve. \u2014 AI Coding \u5957\u4EF6").version(version);
 program.addCommand(tokensCommand);
 program.addCommand(skillsCommand);
@@ -3842,5 +4363,11 @@ program.addCommand(uiCommand);
 program.addCommand(bizUiCommand);
 program.addCommand(templatesCommand);
 program.addCommand(logsCommand);
+program.addCommand(lintCommand);
+function enableHelpAfterError(cmd) {
+  cmd.showHelpAfterError(true);
+  for (const child of cmd.commands) enableHelpAfterError(child);
+}
+enableHelpAfterError(program);
 program.parse();
 //# sourceMappingURL=index.js.map