cmyr-template-cli 1.45.5 → 1.46.0

package/dist/index.js

@@ -23,13 +23,318 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/index.ts
-var import_path = __toESM(require("path"));
+var import_path4 = __toESM(require("path"));
 var import_plop = require("plop");
 var import_commander = require("commander");
 var import_minimist = __toESM(require("minimist"));
+var import_fs_extra3 = __toESM(require("fs-extra"));
+
+// src/utils/config.ts
+var import_path = __toESM(require("path"));
+var import_os = __toESM(require("os"));
 var import_fs_extra = __toESM(require("fs-extra"));
+var import_lodash = require("lodash");
+async function loadTemplateCliConfig() {
+  const paths = [process.cwd(), import_os.default.homedir()].map((e) => import_path.default.join(e, ".ctrc"));
+  const [local, home] = (await Promise.all(paths.map(async (p) => {
+    try {
+      if (await import_fs_extra.default.pathExists(p)) {
+        return await import_fs_extra.default.readJSON(p);
+      }
+      return null;
+    } catch (error) {
+      console.error(error);
+      return null;
+    }
+  }))).filter(Boolean);
+  return (0, import_lodash.mergeWith)(home, local, (objValue, srcValue) => {
+    if (typeof objValue === "string" && srcValue === "") {
+      return objValue;
+    }
+    if (typeof srcValue !== "undefined" && srcValue !== null) {
+      return srcValue;
+    }
+    return objValue;
+  });
+}
+
+// src/commands/ai-update.ts
+var import_path3 = __toESM(require("path"));
+
+// src/utils/ai-scaffolding.ts
+var import_path2 = __toESM(require("path"));
+var import_os2 = __toESM(require("os"));
+var import_crypto = __toESM(require("crypto"));
+var import_ora = __toESM(require("ora"));
+var import_axios = __toESM(require("axios"));
+var import_adm_zip = __toESM(require("adm-zip"));
+var import_fs_extra2 = __toESM(require("fs-extra"));
+
+// src/utils/constants.ts
+var GITHUB_API_URL = "https://api.github.com";
+var REMOTES = [
+  "https://github.com",
+  "https://gh.flyinbug.top/gh/https://github.com",
+  "https://cors.isteed.cc/github.com",
+  "https://kgithub.com",
+  "https://ghproxy.1888866.xyz/https://github.com",
+  "https://hub.gitmirror.com/https://github.com",
+  "https://ghproxy.cfd/https://github.com",
+  "https://github.boki.moe/https://github.com",
+  "https://gh-proxy.net/https://github.com",
+  "https://gh.monlor.com/https://github.com",
+  "https://fastgit.cc/https://github.com",
+  "https://github.tbedu.top/https://github.com",
+  "https://ghfile.geekertao.top/https://github.com",
+  "https://ghp.keleyaa.com/https://github.com",
+  "https://ghpxy.hwinzniej.top/https://github.com",
+  "https://cdn.crashmc.com/https://github.com",
+  "https://git.yylx.win/https://github.com",
+  "https://gitproxy.mrhjx.cn/https://github.com",
+  "https://ghproxy.cxkpro.top/https://github.com",
+  "https://gh.xxooo.cf/https://github.com",
+  "https://gh.llkk.cc/https://github.com",
+  "https://raw.ihtw.moe/github.com",
+  "https://dgithub.xyz",
+  "https://gh.nxnow.top/https://github.com",
+  "https://gh.zwy.one/https://github.com",
+  "https://ghproxy.monkeyray.net/https://github.com",
+  "https://ghproxy.net/https://github.com",
+  "https://ghfast.top/https://github.com",
+  "https://wget.la/https://github.com",
+  "https://wget.la/https://github.com",
+  "https://hk.gh-proxy.com/https://github.com",
+  "https://ghfast.top/https://github.com",
+  "https://ghproxy.net/https://github.com"
+];
+
+// src/utils/ai-scaffolding.ts
+var DEFAULT_AI_SKILLS_REPOSITORY = "CaoMeiYouRen/cmyr-skills-agents";
+var AI_MANIFEST_RELATIVE_PATH = ".ai/manifest.json";
+function getAiSourceConfig(config) {
+  const localPath = config?.AI_SKILLS_LOCAL_PATH?.trim();
+  if (localPath) {
+    return {
+      type: "local",
+      localPath: import_path2.default.resolve(localPath)
+    };
+  }
+  return {
+    type: "github",
+    repository: config?.AI_SKILLS_REPOSITORY?.trim() || DEFAULT_AI_SKILLS_REPOSITORY
+  };
+}
+async function getGitHubLatestCommit(repository) {
+  try {
+    const response = await import_axios.default.get(`${GITHUB_API_URL}/repos/${repository}/commits/master`, {
+      headers: {
+        Accept: "application/vnd.github+json"
+      },
+      timeout: 15 * 1e3
+    });
+    return response.data?.sha || null;
+  } catch {
+    return null;
+  }
+}
+async function prepareAgentsSource(source) {
+  if (source.type === "local") {
+    const localPath = source.localPath || "";
+    if (!await import_fs_extra2.default.pathExists(localPath)) {
+      throw new Error(`AI 技能资产本地路径不存在: ${localPath}`);
+    }
+    return {
+      sourceDir: localPath,
+      source: { ...source },
+      cleanup: async () => void 0
+    };
+  }
+  const repository = source.repository || DEFAULT_AI_SKILLS_REPOSITORY;
+  const tempDir = import_path2.default.join(import_os2.default.tmpdir(), `cmyr-skills-agents-${(0, import_crypto.randomUUID)()}`);
+  try {
+    await downloadAgentsRepositoryZip(repository, tempDir);
+    const commit = await getGitHubLatestCommit(repository);
+    return {
+      sourceDir: tempDir,
+      source: { ...source, commit },
+      cleanup: async () => {
+        await import_fs_extra2.default.remove(tempDir);
+      }
+    };
+  } catch (error) {
+    await import_fs_extra2.default.remove(tempDir);
+    throw error;
+  }
+}
+async function downloadAgentsRepositoryZip(repository, destination) {
+  const loading = (0, import_ora.default)("正在下载 AI 技能资产仓库……").start();
+  try {
+    const candidates = REMOTES.map((remote) => `${remote}/${repository}/archive/refs/heads/master.zip`);
+    const response = await Promise.any(
+      candidates.map((url) => import_axios.default.get(url, {
+        responseType: "arraybuffer",
+        timeout: 30 * 1e3
+      }))
+    );
+    const zip = new import_adm_zip.default(Buffer.from(response.data));
+    const entries = zip.getEntries();
+    const topDir = entries[0]?.entryName.split("/")[0];
+    if (!topDir) {
+      throw new Error("无效的 zip 文件");
+    }
+    await import_fs_extra2.default.ensureDir(destination);
+    for (const entry of entries) {
+      if (entry.entryName.startsWith(`${topDir}/`)) {
+        const relativePath = entry.entryName.slice(topDir.length + 1);
+        if (!relativePath) {
+          continue;
+        }
+        const targetPath = import_path2.default.join(destination, relativePath);
+        const resolvedTarget = import_path2.default.resolve(targetPath);
+        const resolvedDestination = import_path2.default.resolve(destination);
+        const relative = import_path2.default.relative(resolvedDestination, resolvedTarget);
+        if (relative.startsWith("..") || import_path2.default.isAbsolute(relative)) {
+          throw new Error(`路径遍历攻击检测: ${relativePath}`);
+        }
+        if (entry.isDirectory) {
+          await import_fs_extra2.default.ensureDir(targetPath);
+        } else {
+          await import_fs_extra2.default.ensureDir(import_path2.default.dirname(targetPath));
+          await import_fs_extra2.default.writeFile(targetPath, entry.getData());
+        }
+      }
+    }
+    loading.succeed("AI 技能资产仓库下载成功！");
+  } catch (error) {
+    loading.fail("AI 技能资产仓库下载失败！");
+    throw error;
+  }
+}
+async function readL0Selection(sourceDir) {
+  const manifestPath = import_path2.default.join(sourceDir, "manifest.json");
+  const manifest = await import_fs_extra2.default.readJSON(manifestPath);
+  const l0 = manifest?.l0Selection;
+  if (!l0 || !Array.isArray(l0.skills) || !Array.isArray(l0.agents)) {
+    throw new Error("AI 技能资产仓库 manifest.json 缺少有效的 l0Selection");
+  }
+  return {
+    files: Array.isArray(l0.files) ? l0.files : [],
+    skills: l0.skills,
+    agents: l0.agents
+  };
+}
+async function computeFileHash(filePath) {
+  const content = await import_fs_extra2.default.readFile(filePath);
+  return import_crypto.default.createHash("sha256").update(content).digest("hex");
+}
+async function copyL0Selection(sourceDir, projectPath, l0) {
+  const hashes = {};
+  const githubSkillsDir = import_path2.default.join(projectPath, ".github/skills");
+  const githubAgentsDir = import_path2.default.join(projectPath, ".github/agents");
+  await import_fs_extra2.default.ensureDir(githubSkillsDir);
+  await import_fs_extra2.default.ensureDir(githubAgentsDir);
+  for (const skillName of l0.skills) {
+    const sourceSkillDir = import_path2.default.join(sourceDir, "skills", skillName);
+    if (!await import_fs_extra2.default.pathExists(sourceSkillDir)) {
+      console.warn(`警告: 技能 ${skillName} 在资产仓库中不存在，已跳过`);
+      continue;
+    }
+    const targetSkillDir = import_path2.default.join(githubSkillsDir, skillName);
+    await import_fs_extra2.default.copy(sourceSkillDir, targetSkillDir);
+    await collectHashes(targetSkillDir, import_path2.default.join(".github/skills", skillName), hashes);
+  }
+  for (const agentName of l0.agents) {
+    const sourceAgentFile = import_path2.default.join(sourceDir, "agents", `${agentName}.agent.md`);
+    if (!await import_fs_extra2.default.pathExists(sourceAgentFile)) {
+      console.warn(`警告: 代理 ${agentName} 在资产仓库中不存在，已跳过`);
+      continue;
+    }
+    const targetAgentFile = import_path2.default.join(githubAgentsDir, `${agentName}.agent.md`);
+    await import_fs_extra2.default.copyFile(sourceAgentFile, targetAgentFile);
+    const relativePath = `.github/agents/${agentName}.agent.md`;
+    hashes[relativePath] = await computeFileHash(targetAgentFile);
+  }
+  return hashes;
+}
+async function collectHashes(dir, dirRelativePath, hashes) {
+  const entries = await import_fs_extra2.default.readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = import_path2.default.join(dir, entry.name);
+    const relativePath = import_path2.default.join(dirRelativePath, entry.name).split(import_path2.default.sep).join("/");
+    if (entry.isDirectory()) {
+      await collectHashes(fullPath, relativePath, hashes);
+    } else if (entry.isFile()) {
+      hashes[relativePath] = await computeFileHash(fullPath);
+    }
+  }
+}
+async function writeAiManifest(projectPath, manifest) {
+  const manifestPath = import_path2.default.join(projectPath, AI_MANIFEST_RELATIVE_PATH);
+  await import_fs_extra2.default.ensureDir(import_path2.default.dirname(manifestPath));
+  await import_fs_extra2.default.writeJSON(manifestPath, manifest, { spaces: 4 });
+}
+async function readAiManifest(projectPath) {
+  const manifestPath = import_path2.default.join(projectPath, AI_MANIFEST_RELATIVE_PATH);
+  if (!await import_fs_extra2.default.pathExists(manifestPath)) {
+    return null;
+  }
+  try {
+    return await import_fs_extra2.default.readJSON(manifestPath);
+  } catch {
+    return null;
+  }
+}
+async function updateAiScaffolding(projectPath, config) {
+  const loading = (0, import_ora.default)("正在更新 AI 基建快照……").start();
+  const oldManifest = await readAiManifest(projectPath);
+  if (!oldManifest) {
+    loading.fail("未找到 .ai/manifest.json，请先通过脚手架初始化 AI 基建");
+    return;
+  }
+  try {
+    const source = getAiSourceConfig(config);
+    const prepared = await prepareAgentsSource(source);
+    try {
+      const l0 = await readL0Selection(prepared.sourceDir);
+      const oldSkills = oldManifest.l0Selection?.skills || [];
+      const oldAgents = oldManifest.l0Selection?.agents || [];
+      for (const skillName of oldSkills) {
+        if (!l0.skills.includes(skillName)) {
+          await import_fs_extra2.default.remove(import_path2.default.join(projectPath, ".github/skills", skillName));
+        }
+      }
+      for (const agentName of oldAgents) {
+        if (!l0.agents.includes(agentName)) {
+          await import_fs_extra2.default.remove(import_path2.default.join(projectPath, ".github/agents", `${agentName}.agent.md`));
+        }
+      }
+      const hashes = await copyL0Selection(prepared.sourceDir, projectPath, l0);
+      await writeAiManifest(projectPath, {
+        version: 1,
+        generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        source: prepared.source,
+        l0Selection: l0,
+        links: oldManifest.links || [],
+        hashes
+      });
+      loading.succeed("AI 基建快照更新成功！");
+    } finally {
+      await prepared.cleanup();
+    }
+  } catch (error) {
+    loading.fail("AI 基建快照更新失败！");
+    throw error;
+  }
+}
+
+// src/commands/ai-update.ts
+async function aiUpdateCommand(projectPath, config) {
+  await updateAiScaffolding(import_path3.default.resolve(projectPath), config);
+}
+
+// src/index.ts
 var program = new import_commander.Command("ct").description("草梅项目创建器");
-var pkg = import_fs_extra.default.readJSONSync(import_path.default.join(__dirname, "../package.json"));
+var pkg = import_fs_extra3.default.readJSONSync(import_path4.default.join(__dirname, "../package.json"));
 program.version(pkg?.version || "1.0.0", "-v, --version");
 var args = process.argv.slice(2);
 if (args.length === 0) {
@@ -42,7 +347,7 @@ var create = new import_commander.Command("create").description("创建项目").
   import_plop.Plop.launch(
     {
       cwd: argv.cwd,
-      configPath: import_path.default.resolve(__dirname, "./plopfile.js"),
+      configPath: import_path4.default.resolve(__dirname, "./plopfile.js"),
       require: argv.require,
       completion: argv.completion
     },
@@ -50,6 +355,17 @@ var create = new import_commander.Command("create").description("创建项目").
   );
 });
 program.addCommand(create);
+var aiUpdate = new import_commander.Command("ai-update").description("更新 AI 基建快照（技能/代理/植入清单）").option("-p, --path <path>", "项目路径（默认当前目录）", process.cwd()).action(async (opts2) => {
+  try {
+    const config = await loadTemplateCliConfig();
+    await aiUpdateCommand(opts2.path, config);
+    process.exit(0);
+  } catch (error) {
+    console.error(error);
+    process.exit(1);
+  }
+});
+program.addCommand(aiUpdate);
 program.parse(process.argv);
 var opts = program.opts();
 if (opts.debug) {

package/dist/plopfile.js

@@ -23,9 +23,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/plopfile.ts
-var import_path11 = __toESM(require("path"));
-var import_fs_extra12 = __toESM(require("fs-extra"));
-var import_ora11 = __toESM(require("ora"));
+var import_path13 = __toESM(require("path"));
+var import_fs_extra14 = __toESM(require("fs-extra"));
+var import_ora12 = __toESM(require("ora"));
 
 // src/config/env.ts
 var env = process.env;
@@ -33,12 +33,12 @@ var __DEV__ = env.NODE_ENV === "development";
 var PACKAGE_MANAGER = "pnpm";
 
 // src/utils/utils.ts
-var import_path10 = __toESM(require("path"));
+var import_path12 = __toESM(require("path"));
 var import_colors3 = __toESM(require("@colors/colors"));
-var import_ora10 = __toESM(require("ora"));
-var import_axios2 = __toESM(require("axios"));
-var import_adm_zip = __toESM(require("adm-zip"));
-var import_fs_extra11 = __toESM(require("fs-extra"));
+var import_ora11 = __toESM(require("ora"));
+var import_axios3 = __toESM(require("axios"));
+var import_adm_zip2 = __toESM(require("adm-zip"));
+var import_fs_extra13 = __toESM(require("fs-extra"));
 
 // src/utils/constants.ts
 var GITHUB_API_URL = "https://api.github.com";
@@ -2157,15 +2157,372 @@ async function initTest(projectPath, answers) {
 }
 
 // src/core/ai.ts
+var import_path11 = __toESM(require("path"));
+var import_ora10 = __toESM(require("ora"));
+var import_fs_extra12 = __toESM(require("fs-extra"));
+
+// src/utils/symlink.ts
 var import_path9 = __toESM(require("path"));
-var import_ora9 = __toESM(require("ora"));
 var import_fs_extra10 = __toESM(require("fs-extra"));
-async function initAIScaffolding(projectPath, projectInfo) {
-  const loading = (0, import_ora9.default)("正在初始化 AI 开发配置……").start();
+function toSymlinkTarget(linkPath, targetPath, method) {
+  if (process.platform === "win32" && method === "junction") {
+    return import_path9.default.win32.resolve(targetPath);
+  }
+  return import_path9.default.relative(import_path9.default.dirname(linkPath), targetPath);
+}
+async function isSameLinkTarget(linkPath, targetPath) {
+  try {
+    const resolvedLink = await import_fs_extra10.default.realpath(linkPath);
+    const resolvedTarget = await import_fs_extra10.default.realpath(targetPath);
+    return resolvedLink === resolvedTarget;
+  } catch {
+    return false;
+  }
+}
+async function createDirSymlink(linkPath, targetPath) {
+  await import_fs_extra10.default.ensureDir(import_path9.default.dirname(linkPath));
+  try {
+    if (await isSameLinkTarget(linkPath, targetPath)) {
+      return { linkPath, targetPath, method: "symlink", status: "existing" };
+    }
+    const existing = await import_fs_extra10.default.lstat(linkPath);
+    if (existing.isDirectory() || existing.isFile()) {
+      return { linkPath, targetPath, method: "symlink", status: "skipped" };
+    }
+  } catch (error) {
+    if (error?.code !== "ENOENT") {
+      throw error;
+    }
+  }
+  let method = "symlink";
+  if (process.platform === "win32") {
+    try {
+      await import_fs_extra10.default.symlink(import_path9.default.relative(import_path9.default.dirname(linkPath), targetPath), linkPath, "dir");
+      return { linkPath, targetPath, method, status: "created" };
+    } catch {
+      method = "junction";
+      await import_fs_extra10.default.symlink(toSymlinkTarget(linkPath, targetPath, method), linkPath, "junction");
+      return { linkPath, targetPath, method, status: "created" };
+    }
+  }
+  await import_fs_extra10.default.symlink(toSymlinkTarget(linkPath, targetPath, method), linkPath, "dir");
+  return { linkPath, targetPath, method, status: "created" };
+}
+async function createFileSymlink(linkPath, targetPath) {
+  await import_fs_extra10.default.ensureDir(import_path9.default.dirname(linkPath));
+  try {
+    if (await isSameLinkTarget(linkPath, targetPath)) {
+      return { linkPath, targetPath, method: "symlink", status: "existing" };
+    }
+    const existing = await import_fs_extra10.default.lstat(linkPath);
+    if (existing.isDirectory() || existing.isFile()) {
+      return { linkPath, targetPath, method: "symlink", status: "skipped" };
+    }
+  } catch (error) {
+    if (error?.code !== "ENOENT") {
+      throw error;
+    }
+  }
+  if (process.platform === "win32") {
+    try {
+      await import_fs_extra10.default.symlink(toSymlinkTarget(linkPath, targetPath, "symlink"), linkPath, "file");
+      return { linkPath, targetPath, method: "symlink", status: "created" };
+    } catch {
+      await import_fs_extra10.default.copyFile(targetPath, linkPath);
+      return { linkPath, targetPath, method: "copy", status: "created" };
+    }
+  }
+  await import_fs_extra10.default.symlink(toSymlinkTarget(linkPath, targetPath, "symlink"), linkPath, "file");
+  return { linkPath, targetPath, method: "symlink", status: "created" };
+}
+
+// src/utils/ai-scaffolding.ts
+var import_path10 = __toESM(require("path"));
+var import_os2 = __toESM(require("os"));
+var import_crypto = __toESM(require("crypto"));
+var import_ora9 = __toESM(require("ora"));
+var import_axios2 = __toESM(require("axios"));
+var import_adm_zip = __toESM(require("adm-zip"));
+var import_fs_extra11 = __toESM(require("fs-extra"));
+var DEFAULT_AI_SKILLS_REPOSITORY = "CaoMeiYouRen/cmyr-skills-agents";
+var AI_MANIFEST_RELATIVE_PATH = ".ai/manifest.json";
+function getAiSourceConfig(config) {
+  const localPath = config?.AI_SKILLS_LOCAL_PATH?.trim();
+  if (localPath) {
+    return {
+      type: "local",
+      localPath: import_path10.default.resolve(localPath)
+    };
+  }
+  return {
+    type: "github",
+    repository: config?.AI_SKILLS_REPOSITORY?.trim() || DEFAULT_AI_SKILLS_REPOSITORY
+  };
+}
+async function getGitHubLatestCommit(repository) {
+  try {
+    const response = await import_axios2.default.get(`${GITHUB_API_URL}/repos/${repository}/commits/master`, {
+      headers: {
+        Accept: "application/vnd.github+json"
+      },
+      timeout: 15 * 1e3
+    });
+    return response.data?.sha || null;
+  } catch {
+    return null;
+  }
+}
+async function prepareAgentsSource(source) {
+  if (source.type === "local") {
+    const localPath = source.localPath || "";
+    if (!await import_fs_extra11.default.pathExists(localPath)) {
+      throw new Error(`AI 技能资产本地路径不存在: ${localPath}`);
+    }
+    return {
+      sourceDir: localPath,
+      source: { ...source },
+      cleanup: async () => void 0
+    };
+  }
+  const repository = source.repository || DEFAULT_AI_SKILLS_REPOSITORY;
+  const tempDir = import_path10.default.join(import_os2.default.tmpdir(), `cmyr-skills-agents-${(0, import_crypto.randomUUID)()}`);
+  try {
+    await downloadAgentsRepositoryZip(repository, tempDir);
+    const commit = await getGitHubLatestCommit(repository);
+    return {
+      sourceDir: tempDir,
+      source: { ...source, commit },
+      cleanup: async () => {
+        await import_fs_extra11.default.remove(tempDir);
+      }
+    };
+  } catch (error) {
+    await import_fs_extra11.default.remove(tempDir);
+    throw error;
+  }
+}
+async function downloadAgentsRepositoryZip(repository, destination) {
+  const loading = (0, import_ora9.default)("正在下载 AI 技能资产仓库……").start();
+  try {
+    const candidates = REMOTES.map((remote) => `${remote}/${repository}/archive/refs/heads/master.zip`);
+    const response = await Promise.any(
+      candidates.map((url) => import_axios2.default.get(url, {
+        responseType: "arraybuffer",
+        timeout: 30 * 1e3
+      }))
+    );
+    const zip = new import_adm_zip.default(Buffer.from(response.data));
+    const entries = zip.getEntries();
+    const topDir = entries[0]?.entryName.split("/")[0];
+    if (!topDir) {
+      throw new Error("无效的 zip 文件");
+    }
+    await import_fs_extra11.default.ensureDir(destination);
+    for (const entry of entries) {
+      if (entry.entryName.startsWith(`${topDir}/`)) {
+        const relativePath = entry.entryName.slice(topDir.length + 1);
+        if (!relativePath) {
+          continue;
+        }
+        const targetPath = import_path10.default.join(destination, relativePath);
+        const resolvedTarget = import_path10.default.resolve(targetPath);
+        const resolvedDestination = import_path10.default.resolve(destination);
+        const relative = import_path10.default.relative(resolvedDestination, resolvedTarget);
+        if (relative.startsWith("..") || import_path10.default.isAbsolute(relative)) {
+          throw new Error(`路径遍历攻击检测: ${relativePath}`);
+        }
+        if (entry.isDirectory) {
+          await import_fs_extra11.default.ensureDir(targetPath);
+        } else {
+          await import_fs_extra11.default.ensureDir(import_path10.default.dirname(targetPath));
+          await import_fs_extra11.default.writeFile(targetPath, entry.getData());
+        }
+      }
+    }
+    loading.succeed("AI 技能资产仓库下载成功！");
+  } catch (error) {
+    loading.fail("AI 技能资产仓库下载失败！");
+    throw error;
+  }
+}
+async function readL0Selection(sourceDir) {
+  const manifestPath = import_path10.default.join(sourceDir, "manifest.json");
+  const manifest = await import_fs_extra11.default.readJSON(manifestPath);
+  const l0 = manifest?.l0Selection;
+  if (!l0 || !Array.isArray(l0.skills) || !Array.isArray(l0.agents)) {
+    throw new Error("AI 技能资产仓库 manifest.json 缺少有效的 l0Selection");
+  }
+  return {
+    files: Array.isArray(l0.files) ? l0.files : [],
+    skills: l0.skills,
+    agents: l0.agents
+  };
+}
+async function readAgentsTemplate(sourceDir) {
+  const templatePath = import_path10.default.join(sourceDir, "global/AGENTS.template.md");
+  if (!await import_fs_extra11.default.pathExists(templatePath)) {
+    return null;
+  }
+  return (await import_fs_extra11.default.readFile(templatePath, "utf8")).toString();
+}
+async function computeFileHash(filePath) {
+  const content = await import_fs_extra11.default.readFile(filePath);
+  return import_crypto.default.createHash("sha256").update(content).digest("hex");
+}
+async function copyL0Selection(sourceDir, projectPath, l0) {
+  const hashes = {};
+  const githubSkillsDir = import_path10.default.join(projectPath, ".github/skills");
+  const githubAgentsDir = import_path10.default.join(projectPath, ".github/agents");
+  await import_fs_extra11.default.ensureDir(githubSkillsDir);
+  await import_fs_extra11.default.ensureDir(githubAgentsDir);
+  for (const skillName of l0.skills) {
+    const sourceSkillDir = import_path10.default.join(sourceDir, "skills", skillName);
+    if (!await import_fs_extra11.default.pathExists(sourceSkillDir)) {
+      console.warn(`警告: 技能 ${skillName} 在资产仓库中不存在，已跳过`);
+      continue;
+    }
+    const targetSkillDir = import_path10.default.join(githubSkillsDir, skillName);
+    await import_fs_extra11.default.copy(sourceSkillDir, targetSkillDir);
+    await collectHashes(targetSkillDir, import_path10.default.join(".github/skills", skillName), hashes);
+  }
+  for (const agentName of l0.agents) {
+    const sourceAgentFile = import_path10.default.join(sourceDir, "agents", `${agentName}.agent.md`);
+    if (!await import_fs_extra11.default.pathExists(sourceAgentFile)) {
+      console.warn(`警告: 代理 ${agentName} 在资产仓库中不存在，已跳过`);
+      continue;
+    }
+    const targetAgentFile = import_path10.default.join(githubAgentsDir, `${agentName}.agent.md`);
+    await import_fs_extra11.default.copyFile(sourceAgentFile, targetAgentFile);
+    const relativePath = `.github/agents/${agentName}.agent.md`;
+    hashes[relativePath] = await computeFileHash(targetAgentFile);
+  }
+  return hashes;
+}
+async function collectHashes(dir, dirRelativePath, hashes) {
+  const entries = await import_fs_extra11.default.readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = import_path10.default.join(dir, entry.name);
+    const relativePath = import_path10.default.join(dirRelativePath, entry.name).split(import_path10.default.sep).join("/");
+    if (entry.isDirectory()) {
+      await collectHashes(fullPath, relativePath, hashes);
+    } else if (entry.isFile()) {
+      hashes[relativePath] = await computeFileHash(fullPath);
+    }
+  }
+}
+async function writeAiManifest(projectPath, manifest) {
+  const manifestPath = import_path10.default.join(projectPath, AI_MANIFEST_RELATIVE_PATH);
+  await import_fs_extra11.default.ensureDir(import_path10.default.dirname(manifestPath));
+  await import_fs_extra11.default.writeJSON(manifestPath, manifest, { spaces: 4 });
+}
+
+// src/pure/agents-md.ts
+function replaceAgentsTemplateTodos(content, projectInfo) {
+  let result = content;
+  const description = projectInfo.projectDescription || projectInfo.description || "";
+  if (description) {
+    result = result.replace("<!-- TODO: 一句话描述项目目的 -->", description);
+  }
+  const testFramework = projectInfo.isInitTest;
+  if (testFramework === "vitest" || testFramework === "jest") {
+    result = result.replace("<!-- TODO: 指定最低覆盖率阈值，如 80% -->", "80%");
+  }
+  return result;
+}
+function buildAgentsMdL1Section(projectInfo, l0Skills = [], projectSummary) {
+  const {
+    language,
+    runtime,
+    vueVersion
+  } = projectInfo.templateMeta || {};
+  const packageManager = projectInfo.packageManager || "npm";
+  const devCommand = projectInfo.devCommand;
+  const testCommand = projectInfo.testCommand;
+  const buildCommand = projectInfo.buildCommand;
+  const lintCommand = projectInfo.lintCommand;
+  const startCommand = projectInfo.startCommand;
+  const commitCommand = projectInfo.commitCommand;
+  const techStackLines = [
+    `- 主要语言: ${language || "typescript"}`,
+    `- 运行时: ${runtime || "nodejs"}`
+  ];
+  if (vueVersion === 2) {
+    techStackLines.push("- 框架: Vue 2");
+  } else if (vueVersion === 3) {
+    techStackLines.push("- 框架: Vue 3");
+  }
+  techStackLines.push(`- 包管理器: ${packageManager}`);
+  const commandLines = [
+    `- 安装依赖: \`${packageManager} install\``
+  ];
+  if (devCommand) {
+    commandLines.push(`- 启动开发环境: \`${devCommand}\``);
+  }
+  if (testCommand) {
+    commandLines.push(`- 运行测试: \`${testCommand}\``);
+  }
+  if (buildCommand) {
+    commandLines.push(`- 构建项目: \`${buildCommand}\``);
+  }
+  if (lintCommand) {
+    commandLines.push(`- 代码检查: \`${lintCommand}\``);
+  }
+  if (startCommand) {
+    commandLines.push(`- 启动生产或本地预览: \`${startCommand}\``);
+  }
+  if (commitCommand) {
+    commandLines.push(`- 生成提交: \`${commitCommand}\``);
+  }
+  const skillIndexLines = l0Skills.length > 0 ? l0Skills.map((skill) => `- ${skill}`) : ["- 未植入技能（L0 精选清单为空）"];
+  const summary = projectSummary?.summary || projectInfo.projectDescription || projectInfo.description || "";
+  const featureLines = projectSummary?.features?.length ? projectSummary.features.map((feature) => `- ${feature}`) : [];
+  const overviewLines = summary ? [summary, ...featureLines.length > 0 ? ["", "主要特性：", ...featureLines] : []] : ["（项目概述待补充）"];
+  return [
+    "---",
+    "",
+    "## 项目信息（由 cmyr-template-cli 生成）",
+    "",
+    "> 本节内容由脚手架基于 ProjectInfo 参数注入，如需调整请直接修改。",
+    "",
+    "### 项目概述",
+    ...overviewLines,
+    "",
+    "### 技术栈",
+    ...techStackLines,
+    "",
+    "### 常用命令",
+    ...commandLines,
+    "",
+    "### AI 技能索引",
+    "",
+    "> 技能与代理已快照植入 `.github/skills/`、`.github/agents/`，并被链接到各 AI 工具目录（.claude/.opencode/.agents 等）。",
+    ...skillIndexLines,
+    "",
+    "### 植入来源",
+    "",
+    "> 快照来源与校验记录见 `.ai/manifest.json`；更新命令：`ct ai-update`。",
+    ""
+  ].join("\n");
+}
+
+// src/core/ai.ts
+var AI_DIR_LINK_MAPPINGS = [
+  { linkRelPath: ".claude/skills", targetRelPath: ".github/skills" },
+  { linkRelPath: ".claude/agents", targetRelPath: ".github/agents" },
+  { linkRelPath: ".opencode/skills", targetRelPath: ".github/skills" },
+  { linkRelPath: ".opencode/agents", targetRelPath: ".github/agents" },
+  { linkRelPath: ".agents/skills", targetRelPath: ".github/skills" },
+  { linkRelPath: ".agents/agents", targetRelPath: ".github/agents" }
+];
+var AI_FILE_LINK_MAPPINGS = [
+  { linkRelPath: "CLAUDE.md", targetRelPath: "AGENTS.md" }
+];
+async function initAIScaffolding(projectPath, projectInfo, config) {
+  const loading = (0, import_ora10.default)("正在初始化 AI 开发配置……").start();
   try {
     const aiTools = projectInfo.aiTools ?? ["claude", "copilot"];
     if (aiTools.includes("claude")) {
-      await initAgentsMd(projectPath, projectInfo);
+      await initAgentsMdScaffolding(projectPath, projectInfo, config);
       await initClaudeDirectory(projectPath);
     }
     if (aiTools.includes("copilot")) {
@@ -2184,59 +2541,118 @@ async function initAIScaffolding(projectPath, projectInfo) {
     console.error(error);
   }
 }
-async function initAgentsMd(projectPath, projectInfo) {
-  const loading = (0, import_ora9.default)("正在生成 AGENTS.md……").start();
+async function initAgentsMdScaffolding(projectPath, projectInfo, config) {
+  let prepared = null;
   try {
-    const outputPath = import_path9.default.join(projectPath, "AGENTS.md");
-    if (await import_fs_extra10.default.pathExists(outputPath)) {
+    prepared = await prepareAgentsSource(getAiSourceConfig(config));
+    const l0 = await readL0Selection(prepared.sourceDir);
+    await initAgentsMd(projectPath, projectInfo, prepared.sourceDir, l0);
+    const hashes = await initSkillsSnapshot(projectPath, prepared.sourceDir, l0);
+    const links = await initAgentLinkDirs(projectPath, projectInfo);
+    await writeAiManifest(projectPath, {
+      version: 1,
+      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      source: prepared.source,
+      l0Selection: l0,
+      links,
+      hashes
+    });
+  } finally {
+    if (prepared) {
+      await prepared.cleanup();
+    }
+  }
+}
+async function initAgentsMd(projectPath, projectInfo, sourceDir, l0) {
+  const loading = (0, import_ora10.default)("正在生成 AGENTS.md……").start();
+  try {
+    const outputPath = import_path11.default.join(projectPath, "AGENTS.md");
+    if (await import_fs_extra12.default.pathExists(outputPath)) {
       loading.stopAndPersist({
         text: "AGENTS.md 已存在，跳过生成",
         symbol: "⊙"
       });
       return;
     }
-    const templatePath = import_path9.default.join(__dirname, "../templates/AGENTS.md.ejs");
-    const templateData = {
-      projectDescription: projectInfo.projectDescription || projectInfo.description || "",
-      language: projectInfo.templateMeta?.language || "typescript",
-      runtime: projectInfo.templateMeta?.runtime || "nodejs",
-      vueVersion: projectInfo.templateMeta?.vueVersion || 0,
-      packageManager: projectInfo.packageManager || "npm",
-      repositoryUrl: projectInfo.repositoryUrl || "",
-      documentationUrl: projectInfo.documentationUrl || "",
-      issuesUrl: projectInfo.issuesUrl || "",
-      contributingUrl: projectInfo.contributingUrl || "",
-      isInitTest: projectInfo.isInitTest || "none",
-      devCommand: projectInfo.devCommand,
-      testCommand: projectInfo.testCommand,
-      buildCommand: projectInfo.buildCommand,
-      lintCommand: projectInfo.lintCommand,
-      startCommand: projectInfo.startCommand,
-      commitCommand: projectInfo.commitCommand
-    };
-    await ejsRender(templatePath, templateData, outputPath);
+    if (!sourceDir) {
+      throw new Error("未提供 AI 技能资产源，无法生成 AGENTS.md");
+    }
+    const templateContent = await readAgentsTemplate(sourceDir);
+    if (!templateContent) {
+      throw new Error("资产仓库缺少 global/AGENTS.template.md，无法生成 AGENTS.md");
+    }
+    const l0Content = replaceAgentsTemplateTodos(templateContent, projectInfo);
+    const l1Section = buildAgentsMdL1Section(projectInfo, l0?.skills || [], projectInfo.aiGeneratedSummary);
+    await import_fs_extra12.default.writeFile(outputPath, `${l0Content.trimEnd()}
+
+${l1Section}`);
     loading.succeed("AGENTS.md 生成成功！");
   } catch (error) {
     loading.fail("AGENTS.md 生成失败！");
     throw error;
   }
 }
+async function initSkillsSnapshot(projectPath, sourceDir, l0) {
+  const loading = (0, import_ora10.default)("正在快照植入 AI 技能与代理……").start();
+  try {
+    const hashes = await copyL0Selection(sourceDir, projectPath, l0);
+    loading.succeed("AI 技能与代理快照植入成功！");
+    return hashes;
+  } catch (error) {
+    loading.fail("AI 技能与代理快照植入失败！");
+    throw error;
+  }
+}
+async function initAgentLinkDirs(projectPath, projectInfo) {
+  const loading = (0, import_ora10.default)("正在创建跨 agent 链接……").start();
+  try {
+    const links = [];
+    for (const mapping of AI_DIR_LINK_MAPPINGS) {
+      const linkPath = import_path11.default.join(projectPath, mapping.linkRelPath);
+      const targetPath = import_path11.default.join(projectPath, mapping.targetRelPath);
+      const result = await createDirSymlink(linkPath, targetPath);
+      links.push({
+        linkRelPath: mapping.linkRelPath,
+        targetRelPath: mapping.targetRelPath,
+        method: result.method
+      });
+    }
+    const isClaude = projectInfo.aiTools?.includes("claude");
+    if (isClaude) {
+      for (const mapping of AI_FILE_LINK_MAPPINGS) {
+        const linkPath = import_path11.default.join(projectPath, mapping.linkRelPath);
+        const targetPath = import_path11.default.join(projectPath, mapping.targetRelPath);
+        const result = await createFileSymlink(linkPath, targetPath);
+        links.push({
+          linkRelPath: mapping.linkRelPath,
+          targetRelPath: mapping.targetRelPath,
+          method: result.method
+        });
+      }
+    }
+    loading.succeed("跨 agent 链接创建成功！");
+    return links;
+  } catch (error) {
+    loading.fail("跨 agent 链接创建失败！");
+    throw error;
+  }
+}
 async function initCopilotInstructions(projectPath) {
-  const loading = (0, import_ora9.default)("正在生成 .github/copilot-instructions.md……").start();
+  const loading = (0, import_ora10.default)("正在生成 .github/copilot-instructions.md……").start();
   try {
-    const outputPath = import_path9.default.join(projectPath, ".github/copilot-instructions.md");
-    if (await import_fs_extra10.default.pathExists(outputPath)) {
+    const outputPath = import_path11.default.join(projectPath, ".github/copilot-instructions.md");
+    if (await import_fs_extra12.default.pathExists(outputPath)) {
       loading.stopAndPersist({
         text: ".github/copilot-instructions.md 已存在，跳过生成",
         symbol: "⊙"
       });
       return;
     }
-    const githubDir = import_path9.default.join(projectPath, ".github");
-    if (!await import_fs_extra10.default.pathExists(githubDir)) {
-      await import_fs_extra10.default.mkdirp(githubDir);
+    const githubDir = import_path11.default.join(projectPath, ".github");
+    if (!await import_fs_extra12.default.pathExists(githubDir)) {
+      await import_fs_extra12.default.mkdirp(githubDir);
     }
-    const templatePath = import_path9.default.join(__dirname, "../templates/.github/copilot-instructions.md.ejs");
+    const templatePath = import_path11.default.join(__dirname, "../templates/.github/copilot-instructions.md.ejs");
     await ejsRender(templatePath, {}, outputPath);
     loading.succeed(".github/copilot-instructions.md 生成成功！");
   } catch (error) {
@@ -2245,17 +2661,17 @@ async function initCopilotInstructions(projectPath) {
   }
 }
 async function initCursorRules(projectPath) {
-  const loading = (0, import_ora9.default)("正在生成 .cursorrules……").start();
+  const loading = (0, import_ora10.default)("正在生成 .cursorrules……").start();
   try {
-    const outputPath = import_path9.default.join(projectPath, ".cursorrules");
-    if (await import_fs_extra10.default.pathExists(outputPath)) {
+    const outputPath = import_path11.default.join(projectPath, ".cursorrules");
+    if (await import_fs_extra12.default.pathExists(outputPath)) {
       loading.stopAndPersist({
         text: ".cursorrules 已存在，跳过生成",
         symbol: "⊙"
       });
       return;
     }
-    const templatePath = import_path9.default.join(__dirname, "../templates/.cursorrules.ejs");
+    const templatePath = import_path11.default.join(__dirname, "../templates/.cursorrules.ejs");
     await ejsRender(templatePath, {}, outputPath);
     loading.succeed(".cursorrules 生成成功！");
   } catch (error) {
@@ -2264,17 +2680,17 @@ async function initCursorRules(projectPath) {
   }
 }
 async function initWindsurfRules(projectPath) {
-  const loading = (0, import_ora9.default)("正在生成 .windsurfrules……").start();
+  const loading = (0, import_ora10.default)("正在生成 .windsurfrules……").start();
   try {
-    const outputPath = import_path9.default.join(projectPath, ".windsurfrules");
-    if (await import_fs_extra10.default.pathExists(outputPath)) {
+    const outputPath = import_path11.default.join(projectPath, ".windsurfrules");
+    if (await import_fs_extra12.default.pathExists(outputPath)) {
       loading.stopAndPersist({
         text: ".windsurfrules 已存在，跳过生成",
         symbol: "⊙"
       });
       return;
     }
-    const templatePath = import_path9.default.join(__dirname, "../templates/.windsurfrules.ejs");
+    const templatePath = import_path11.default.join(__dirname, "../templates/.windsurfrules.ejs");
     await ejsRender(templatePath, {}, outputPath);
     loading.succeed(".windsurfrules 生成成功！");
   } catch (error) {
@@ -2283,18 +2699,17 @@ async function initWindsurfRules(projectPath) {
   }
 }
 async function initClaudeDirectory(projectPath) {
-  const loading = (0, import_ora9.default)("正在初始化 .claude/ 目录……").start();
+  const loading = (0, import_ora10.default)("正在初始化 .claude/ 目录……").start();
   try {
-    const claudeDir = import_path9.default.join(projectPath, ".claude");
-    if (await import_fs_extra10.default.pathExists(claudeDir)) {
+    const settingsPath = import_path11.default.join(projectPath, ".claude/settings.json");
+    if (await import_fs_extra12.default.pathExists(settingsPath)) {
       loading.stopAndPersist({
-        text: ".claude/ 目录已存在，跳过初始化",
+        text: ".claude/settings.json 已存在，跳过初始化",
         symbol: "⊙"
       });
       return;
     }
-    await import_fs_extra10.default.mkdirp(import_path9.default.join(claudeDir, "skills"));
-    await import_fs_extra10.default.mkdirp(import_path9.default.join(claudeDir, "agents"));
+    await import_fs_extra12.default.mkdirp(import_path11.default.join(projectPath, ".claude"));
     const files = [".claude/settings.json"];
     await copyFilesFromTemplates(projectPath, files, true);
     loading.succeed(".claude/ 目录初始化成功！");
@@ -2304,17 +2719,17 @@ async function initClaudeDirectory(projectPath) {
   }
 }
 async function initCursorDirectory(projectPath) {
-  const loading = (0, import_ora9.default)("正在初始化 .cursor/ 目录……").start();
+  const loading = (0, import_ora10.default)("正在初始化 .cursor/ 目录……").start();
   try {
-    const cursorDir = import_path9.default.join(projectPath, ".cursor", "rules");
-    if (await import_fs_extra10.default.pathExists(cursorDir)) {
+    const cursorDir = import_path11.default.join(projectPath, ".cursor", "rules");
+    if (await import_fs_extra12.default.pathExists(cursorDir)) {
       loading.stopAndPersist({
         text: ".cursor/ 目录已存在，跳过初始化",
         symbol: "⊙"
       });
       return;
     }
-    await import_fs_extra10.default.mkdirp(cursorDir);
+    await import_fs_extra12.default.mkdirp(cursorDir);
     loading.succeed(".cursor/ 目录初始化成功！");
   } catch (error) {
     loading.fail(".cursor/ 目录初始化失败！");
@@ -2325,7 +2740,7 @@ async function initCursorDirectory(projectPath) {
 // src/utils/utils.ts
 async function downloadGitRepo(repository, destination) {
   const fastRepo = await getFastGitRepo(repository);
-  const loading = (0, import_ora10.default)(`正在下载模板 - ${repository}`);
+  const loading = (0, import_ora11.default)(`正在下载模板 - ${repository}`);
   loading.start();
   return Promise.any([
     downloadAndExtractZip(fastRepo, destination, loading, repository),
@@ -2334,31 +2749,31 @@ async function downloadGitRepo(repository, destination) {
 }
 async function downloadAndExtractZip(url, destination, loading, repository) {
   try {
-    const response = await import_axios2.default.get(url, { responseType: "arraybuffer" });
+    const response = await import_axios3.default.get(url, { responseType: "arraybuffer" });
     const buffer = Buffer.from(response.data);
-    const zip = new import_adm_zip.default(buffer);
+    const zip = new import_adm_zip2.default(buffer);
     const entries = zip.getEntries();
     const topDir = entries[0]?.entryName.split("/")[0];
     if (!topDir) {
       throw new Error("无效的 zip 文件");
     }
-    await import_fs_extra11.default.ensureDir(destination);
+    await import_fs_extra13.default.ensureDir(destination);
     for (const entry of entries) {
       if (entry.entryName.startsWith(`${topDir}/`)) {
         const relativePath = entry.entryName.slice(topDir.length + 1);
         if (!relativePath) {
           continue;
         }
-        const targetPath = import_path10.default.join(destination, relativePath);
-        const resolvedPath = import_path10.default.resolve(targetPath);
-        if (!resolvedPath.startsWith(import_path10.default.resolve(destination))) {
+        const targetPath = import_path12.default.join(destination, relativePath);
+        const resolvedPath = import_path12.default.resolve(targetPath);
+        if (!resolvedPath.startsWith(import_path12.default.resolve(destination))) {
           throw new Error(`路径遍历攻击检测: ${relativePath}`);
         }
         if (entry.isDirectory) {
-          await import_fs_extra11.default.ensureDir(targetPath);
+          await import_fs_extra13.default.ensureDir(targetPath);
         } else {
-          await import_fs_extra11.default.ensureDir(import_path10.default.dirname(targetPath));
-          await import_fs_extra11.default.writeFile(targetPath, entry.getData());
+          await import_fs_extra13.default.ensureDir(import_path12.default.dirname(targetPath));
+          await import_fs_extra13.default.writeFile(targetPath, entry.getData());
         }
       }
     }
@@ -2370,7 +2785,7 @@ async function downloadAndExtractZip(url, destination, loading, repository) {
   }
 }
 async function getFastGitRepo(repository) {
-  const loading = (0, import_ora10.default)(`正在选择镜像源 - ${repository}`);
+  const loading = (0, import_ora11.default)(`正在选择镜像源 - ${repository}`);
   loading.start();
   try {
     const fastUrl = await getFastUrl(REMOTES.map((remote) => `${remote}/${repository}/archive/refs/heads/master.zip`));
@@ -2385,7 +2800,7 @@ async function getFastGitRepo(repository) {
 async function initProject(answers) {
   const typedAnswers = answers;
   const { name, template } = typedAnswers;
-  const projectPath = import_path10.default.join(process.cwd(), name);
+  const projectPath = import_path12.default.join(process.cwd(), name);
   await downloadGitRepo(`CaoMeiYouRen/${template}`, projectPath);
   await init(projectPath, typedAnswers);
   return "- 下载项目模板成功！";
@@ -2537,7 +2952,7 @@ async function getGitUserName() {
 }
 
 // src/utils/ai-api.ts
-var import_axios3 = __toESM(require("axios"));
+var import_axios4 = __toESM(require("axios"));
 
 // src/pure/ai.ts
 var MAX_USER_INPUT_LENGTH = 500;
@@ -2596,6 +3011,49 @@ function parseAIResponse(response) {
     return null;
   }
 }
+function buildProjectSummaryPrompt(projectInfo) {
+  if (typeof projectInfo.description !== "string" || !projectInfo.description.trim()) {
+    throw new Error("buildProjectSummaryPrompt: projectInfo.description is required");
+  }
+  return `你是一个项目文档撰写助手。基于以下项目信息，生成 README 项目简介：
+
+项目名称: ${projectInfo.name}
+项目描述: ${projectInfo.description}
+关键词: ${projectInfo.keywords.join(", ") || "无"}
+
+要求：
+1. **summary**：一段精炼的中文项目简介（80-150 字），突出项目价值，适合 README 引言
+2. **features**：3-5 个主要特性，每条不超过 15 字
+
+请以 JSON 格式返回（不要包含 markdown 代码块标记）：
+{
+  "summary": "项目简介",
+  "features": ["特性1", "特性2"]
+}`;
+}
+function parseProjectSummary(response) {
+  if (typeof response !== "string") {
+    return null;
+  }
+  try {
+    let jsonStr = response.trim();
+    const codeBlockRegex = /```(?:json)?\s*([\s\S]*?)\s*```/;
+    const match = jsonStr.match(codeBlockRegex);
+    if (match && match[1]) {
+      jsonStr = match[1].trim();
+    }
+    const parsed = JSON.parse(jsonStr);
+    if (!parsed || typeof parsed !== "object" || typeof parsed.summary !== "string" || parsed.summary.trim().length === 0 || !Array.isArray(parsed.features) || parsed.features.length === 0) {
+      return null;
+    }
+    return {
+      summary: parsed.summary,
+      features: parsed.features.filter((feature) => typeof feature === "string").slice(0, 5)
+    };
+  } catch {
+    return null;
+  }
+}
 
 // src/utils/ai-api.ts
 var AI_TIMEOUT = 30 * 1e3;
@@ -2620,7 +3078,7 @@ async function chatCompletion(request) {
     throw new Error("AI_API_BASE must use HTTPS for security (except for localhost)");
   }
   try {
-    const response = await import_axios3.default.post(
+    const response = await import_axios4.default.post(
       endpoint,
       {
         model,
@@ -2646,7 +3104,7 @@ async function chatCompletion(request) {
     }
     return content;
   } catch (error) {
-    if (import_axios3.default.isAxiosError(error)) {
+    if (import_axios4.default.isAxiosError(error)) {
       const axiosError = error;
       if (axiosError.code === "ECONNABORTED" || axiosError.message.includes("timeout")) {
         throw new Error(`AI API request timed out after ${AI_TIMEOUT / 1e3} seconds. Please try again.`);
@@ -2691,6 +3149,29 @@ async function getAIProjectSuggestion(userInput, config) {
   }
   return suggestion;
 }
+async function getAIProjectSummary(projectInfo, config) {
+  const { AI_API_BASE, AI_API_KEY, AI_MODEL } = config;
+  if (!AI_API_KEY) {
+    throw new Error(
+      'AI_API_KEY is not configured. Please add it to your .ctrc file:\n  "AI_API_KEY": "your-api-key-here"'
+    );
+  }
+  const prompt = buildProjectSummaryPrompt(projectInfo);
+  const response = await chatCompletion({
+    prompt,
+    apiKey: AI_API_KEY,
+    apiBase: AI_API_BASE,
+    model: AI_MODEL,
+    temperature: 0.7
+  });
+  const summary = parseProjectSummary(response);
+  if (!summary) {
+    throw new Error(
+      "Failed to parse AI project summary. The AI may have returned an invalid format. Please try again or contact support if the issue persists."
+    );
+  }
+  return summary;
+}
 
 // src/plopfile.ts
 module.exports = function(plop) {
@@ -2700,6 +3181,7 @@ module.exports = function(plop) {
     async prompts(inquirer) {
       const config = await loadTemplateCliConfig();
       let aiSuggestion = null;
+      let aiSummary = null;
       const questions = [
         // ===== AI 引导模式（必须最先询问） =====
         {
@@ -2724,7 +3206,7 @@ module.exports = function(plop) {
           message: "",
           async when(answers2) {
             if (answers2.isAIAssisted && answers2.aiUserInput) {
-              const spinner = (0, import_ora11.default)("AI 正在生成项目建议...").start();
+              const spinner = (0, import_ora12.default)("AI 正在生成项目建议...").start();
               try {
                 aiSuggestion = await getAIProjectSuggestion(answers2.aiUserInput, config);
                 spinner.succeed("AI 已生成项目建议");
@@ -2735,6 +3217,16 @@ module.exports = function(plop) {
                 console.log(`  关键词: ${aiSuggestion.keywords.join(", ")}`);
                 console.log(`  推荐模板: ${aiSuggestion.template}`);
                 console.log("");
+                try {
+                  const summary = await getAIProjectSummary({
+                    name: aiSuggestion.names[0],
+                    description: aiSuggestion.description,
+                    keywords: aiSuggestion.keywords
+                  }, config);
+                  aiSummary = summary;
+                  spinner.succeed("AI 已生成项目简介");
+                } catch {
+                }
               } catch (error) {
                 spinner.fail(`AI 引导失败: ${error instanceof Error ? error.message : String(error)}`);
                 console.log("回退到标准问答流程\n");
@@ -2899,7 +3391,7 @@ module.exports = function(plop) {
           name: "license",
           message: "请选择开源协议",
           async choices() {
-            return import_fs_extra12.default.readdir(import_path11.default.join(__dirname, "../templates/licenses/"));
+            return import_fs_extra14.default.readdir(import_path13.default.join(__dirname, "../templates/licenses/"));
           },
           default: "MIT",
           when(answers2) {
@@ -3076,6 +3568,9 @@ module.exports = function(plop) {
         answers.aiGeneratedKeywords = suggestion.keywords;
         answers.aiRecommendedTemplate = suggestion.template;
       }
+      if (aiSummary) {
+        answers.aiGeneratedSummary = aiSummary;
+      }
       delete answers._aiTrigger;
       return answers;
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cmyr-template-cli",
-  "version": "1.45.5",
+  "version": "1.46.0",
   "description": "草梅友仁自制的项目模板创建器",
   "author": "CaoMeiYouRen",
   "license": "MIT",
@@ -49,7 +49,7 @@
     "@types/node": "^26.0.1",
     "@vitest/coverage-v8": "^4.1.6",
     "commitizen": "^4.3.1",
-    "commitlint-config-cmyr": "1.0.0",
+    "commitlint-config-cmyr": "1.0.1",
     "conventional-changelog-cmyr-config": "^3.0.0",
     "conventional-changelog-writer": "^9.1.0",
     "cross-env": "^10.1.0",
@@ -60,7 +60,7 @@
     "husky": "^9.0.5",
     "lint-staged": "^17.0.4",
     "rimraf": "^6.1.3",
-    "semantic-release": "25.0.3",
+    "semantic-release": "25.0.8",
     "semantic-release-cmyr-config": "1.0.2",
     "tsup": "^8.5.1",
     "tsx": "^4.22.0",

package/templates/AGENTS.md.ejs

@@ -1,73 +0,0 @@
-# AGENTS.md
-
-## 项目概述
-<%= projectDescription %>
-
-## 角色与目标
-- 本文件用于约束 AI 代理与协作者在当前项目中的默认行为。
-- 任何更具体的项目规范、目录说明、设计决策或工作流要求，应以项目内的 README、开发规范、设计文档和配置文件为准。
-- 当下文内容与项目实际实现冲突时，以代码、配置和项目规范文档中的事实为准。
-
-## 技术栈
-- 主要语言: <%= language %>
-- 运行时: <%= runtime %>
-<% if (vueVersion === 3) { %>- 框架: Vue 3<% } %>
-<% if (vueVersion === 2) { %>- 框架: Vue 2<% } %>
-- 包管理器: <%= packageManager %>
-
-<% if (repositoryUrl || documentationUrl || issuesUrl || contributingUrl) { %>## 仓库信息
-<% if (repositoryUrl) { %>- 仓库地址: <%= repositoryUrl %><% } %>
-<% if (documentationUrl) { %>- 项目文档: <%= documentationUrl %><% } %>
-<% if (issuesUrl) { %>- Issue 地址: <%= issuesUrl %><% } %>
-<% if (contributingUrl) { %>- 贡献指南: <%= contributingUrl %><% } %>
-<% } %>
-
-## 项目结构
-> 以下目录为模板默认结构；具体项目可在生成后按实际情况增删。
-
-```
-src/           # 源代码
-<% if (isInitTest !== 'none') { %>tests/         # 测试文件
-<% } %><% if (devCommand) { %>playground/    # 本地调试或演示代码（如有）
-<% } %>docs/          # 文档与规范（如有）
-```
-
-## 常用命令
-- 安装依赖: `<%= packageManager %> install`
-<% if (devCommand) { %>- 启动开发环境: `<%= devCommand %>`<% } %>
-<% if (testCommand) { %>- 运行测试: `<%= testCommand %>`<% } %>
-<% if (buildCommand) { %>- 构建项目: `<%= buildCommand %>`<% } %>
-<% if (lintCommand) { %>- 代码检查: `<%= lintCommand %>`<% } %>
-<% if (startCommand) { %>- 启动生产或本地预览: `<%= startCommand %>`<% } %>
-<% if (commitCommand) { %>- 生成提交: `<%= commitCommand %>`<% } %>
-
-## 编码与协作约定
-- 优先遵循项目现有代码风格、目录约定和命名规范，不要擅自引入新的体系。
-- 使用与项目一致的语言特性和类型策略；如果项目启用了 TypeScript，则保持类型检查可通过。
-- 变更应尽量保持最小范围，避免顺手重构无关模块。
-- 需要新增或调整依赖时，优先确认项目已有方案是否已覆盖。
-- 提交信息遵循 Conventional Commits 规范。
-
-## 质量门禁
-<% if (isInitTest === 'vitest') { %>
-- 测试框架: Vitest
-- 目标覆盖率: >= 80%
-<% } else if (isInitTest === 'jest') { %>
-- 测试框架: Jest
-- 目标覆盖率: >= 80%
-<% } else { %>
-- 当前未配置测试框架；如后续补充测试，应同步更新本文件。
-<% } %>
-- 代码变更后，按项目实际可用命令完成 lint、typecheck、test 等必要校验。
-- 如果某项校验在当前项目中不存在，应在说明中明确标注，而不是假定其存在。
-
-## 安全与避免事项
-- 不要硬编码 API Key、Token、密码或其他敏感信息。
-- 不要直接修改构建产物、发布产物或生成目录中的文件。
-- 不要跳过 TypeScript 类型检查或项目规定的静态检查。
-- 不要使用 `var` 声明变量，优先使用 `const` 和 `let`。
-- 对环境变量、密钥文件和部署配置的修改应格外谨慎。
-
-## 可选补充
-- 如果项目存在更细的 AI 规则、目录约定或角色分工，可在此处继续补充，但不要与项目事实相冲突。
-- 如果项目已经定义了更强的安全、测试或发布流程，本文件应只保留入口级约束。