@lambertkeith/spec-go 0.2.5 → 0.3.1

package/dist/{index.js → cli/index.js}

@@ -6,27 +6,75 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
 
-// src/cli.ts
-import path7 from "path";
-import fs5 from "fs";
+// src/cli/cli.ts
+import path8 from "path";
+import fs6 from "fs";
 import { Command } from "commander";
-import pc6 from "picocolors";
+import pc7 from "picocolors";
 
 // package.json
-var version = "0.2.5";
+var version = "0.3.1";
 
-// src/prompts.ts
-import path2 from "path";
-import fs from "fs";
+// src/cli/prompts.ts
+import path5 from "path";
+import fs3 from "fs";
 import { input, select, confirm, Separator } from "@inquirer/prompts";
 import pc from "picocolors";
 
-// src/utils.ts
+// src/core/types.ts
+var silentLogger = {
+  info: () => {
+  },
+  success: () => {
+  },
+  warn: () => {
+  },
+  error: () => {
+  },
+  dim: () => {
+  }
+};
+
+// src/core/config.ts
+import fs from "fs";
 import path from "path";
-import { fileURLToPath } from "url";
-import { spawn } from "child_process";
+import os from "os";
+var CONFIG_PATH = path.join(os.homedir(), ".spec-go.json");
+var DEFAULT_CONFIG = {
+  defaults: {
+    github: false,
+    public: false,
+    template: ""
+  },
+  github: {
+    token: "",
+    defaultOrg: ""
+  }
+};
+function ensureConfigExists() {
+  if (!fs.existsSync(CONFIG_PATH)) {
+    saveConfig(DEFAULT_CONFIG);
+  }
+}
+function loadConfig() {
+  try {
+    if (fs.existsSync(CONFIG_PATH)) {
+      const content = fs.readFileSync(CONFIG_PATH, "utf-8");
+      return JSON.parse(content);
+    }
+  } catch {
+  }
+  return {};
+}
+function saveConfig(config) {
+  fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2), "utf-8");
+  fs.chmodSync(CONFIG_PATH, 384);
+}
+function getConfigPath() {
+  return CONFIG_PATH;
+}
 
-// src/debug.ts
+// src/core/debug.ts
 var debugEnabled = false;
 function setDebugEnabled(enabled) {
   debugEnabled = enabled;
@@ -57,11 +105,39 @@ function formatData(data) {
   }
 }
 
-// src/utils.ts
+// src/core/exit-codes.ts
+var ExitCodes = {
+  /** 成功完成 */
+  SUCCESS: 0,
+  /** 用户错误：参数错误、输入无效 */
+  USER_ERROR: 1,
+  /** 外部错误：网络、GitHub API、包管理器 */
+  EXTERNAL_ERROR: 2,
+  /** 未知内部错误 */
+  INTERNAL_ERROR: 10,
+  /** 模板相关错误 */
+  TEMPLATE_ERROR: 11,
+  /** 文件系统错误 */
+  FILE_SYSTEM_ERROR: 12,
+  /** Git 操作错误 */
+  GIT_ERROR: 13
+};
+var CliError = class extends Error {
+  constructor(message, exitCode = ExitCodes.INTERNAL_ERROR) {
+    super(message);
+    this.exitCode = exitCode;
+    this.name = "CliError";
+  }
+};
+
+// src/core/utils.ts
+import path2 from "path";
+import { fileURLToPath } from "url";
+import { spawn } from "child_process";
 var __filename = fileURLToPath(import.meta.url);
-var __dirname = path.dirname(__filename);
+var __dirname = path2.dirname(__filename);
 function getTemplatesDir() {
-  return path.resolve(__dirname, "..", "templates");
+  return path2.resolve(__dirname, "..", "..", "templates");
 }
 function isValidPackageName(name) {
   return /^(?:@[a-z0-9-*~][a-z0-9-*._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/.test(name);
@@ -70,11 +146,11 @@ function toValidPackageName(name) {
   return name.trim().toLowerCase().replace(/\s+/g, "-").replace(/^[._]/, "").replace(/[^a-z0-9-~]+/g, "-");
 }
 function isEmpty(dirPath) {
-  const fs6 = __require("fs");
-  if (!fs6.existsSync(dirPath)) {
+  const fs7 = __require("fs");
+  if (!fs7.existsSync(dirPath)) {
     return true;
   }
-  const files = fs6.readdirSync(dirPath);
+  const files = fs7.readdirSync(dirPath);
   return files.length === 0 || files.length === 1 && files[0] === ".git";
 }
 function execAsync(command, args, options = {}) {
@@ -108,157 +184,7 @@ function execAsync(command, args, options = {}) {
   });
 }
 
-// src/exit-codes.ts
-var ExitCodes = {
-  /** 成功完成 */
-  SUCCESS: 0,
-  /** 用户错误：参数错误、输入无效 */
-  USER_ERROR: 1,
-  /** 外部错误：网络、GitHub API、包管理器 */
-  EXTERNAL_ERROR: 2,
-  /** 未知内部错误 */
-  INTERNAL_ERROR: 10,
-  /** 模板相关错误 */
-  TEMPLATE_ERROR: 11,
-  /** 文件系统错误 */
-  FILE_SYSTEM_ERROR: 12,
-  /** Git 操作错误 */
-  GIT_ERROR: 13
-};
-var CliError = class extends Error {
-  constructor(message, exitCode = ExitCodes.INTERNAL_ERROR) {
-    super(message);
-    this.exitCode = exitCode;
-    this.name = "CliError";
-  }
-};
-
-// src/prompts.ts
-var DEFAULT_TEMPLATE = "node-ts";
-async function runPrompts(argProjectName, options, userConfig = {}, interactive = true) {
-  const defaults = userConfig.defaults ?? {};
-  const templatesDir = getTemplatesDir();
-  const registryPath = path2.join(templatesDir, "template.config.json");
-  const registry = JSON.parse(
-    fs.readFileSync(registryPath, "utf-8")
-  );
-  debug("prompts", `\u4EA4\u4E92\u6A21\u5F0F: ${interactive}`);
-  debug("prompts", `CLI \u53C2\u6570`, { argProjectName, options });
-  let projectName = argProjectName;
-  if (!projectName) {
-    if (!interactive) {
-      console.log(pc.red("\u9519\u8BEF: \u975E\u4EA4\u4E92\u6A21\u5F0F\u4E0B\u5FC5\u987B\u63D0\u4F9B\u9879\u76EE\u540D\u79F0"));
-      throw new CliError("\u975E\u4EA4\u4E92\u6A21\u5F0F\u4E0B\u5FC5\u987B\u63D0\u4F9B\u9879\u76EE\u540D\u79F0", ExitCodes.USER_ERROR);
-    }
-    projectName = await input({
-      message: "\u9879\u76EE\u540D\u79F0:",
-      default: "my-project",
-      validate: (value) => {
-        if (!value.trim()) {
-          return "\u9879\u76EE\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A";
-        }
-        if (!isValidPackageName(toValidPackageName(value))) {
-          return "\u65E0\u6548\u7684\u9879\u76EE\u540D\u79F0";
-        }
-        return true;
-      }
-    });
-  }
-  const validName = toValidPackageName(projectName);
-  const targetDir = path2.resolve(process.cwd(), validName);
-  if (fs.existsSync(targetDir) && !isEmpty(targetDir)) {
-    if (!interactive) {
-      console.log(pc.yellow(`\u8B66\u544A: \u76EE\u6807\u76EE\u5F55 "${validName}" \u975E\u7A7A\uFF0C\u5C06\u8986\u76D6\u5DF2\u6709\u6587\u4EF6`));
-    } else {
-      const overwrite = await confirm({
-        message: `\u76EE\u6807\u76EE\u5F55 "${validName}" \u975E\u7A7A\uFF0C\u662F\u5426\u7EE7\u7EED? (\u5C06\u8986\u76D6\u5DF2\u6709\u6587\u4EF6)`,
-        default: false
-      });
-      if (!overwrite) {
-        const error = new Error("PROMPT_CANCELLED");
-        throw error;
-      }
-    }
-  }
-  let template = options.template;
-  if (!template) {
-    if (!interactive) {
-      template = defaults.template || DEFAULT_TEMPLATE;
-      console.log(pc.dim(`\u4F7F\u7528\u9ED8\u8BA4\u6A21\u677F: ${template}`));
-    } else {
-      const defaultTemplate = defaults.template;
-      const singleTemplates = registry.templates.filter((t) => t.category !== "fullstack");
-      const fullstackTemplates = registry.templates.filter((t) => t.category === "fullstack");
-      const templateChoices = [];
-      templateChoices.push(new Separator("\u2500\u2500 \u5355\u4F53\u9879\u76EE \u2500\u2500"));
-      for (const t of singleTemplates) {
-        templateChoices.push({
-          name: `${t.displayName} ${pc.dim(`- ${t.description}`)}`,
-          value: t.name
-        });
-      }
-      if (fullstackTemplates.length > 0) {
-        templateChoices.push(new Separator("\u2500\u2500 \u524D\u540E\u7AEF\u5206\u79BB \u2500\u2500"));
-        for (const t of fullstackTemplates) {
-          templateChoices.push({
-            name: `${t.displayName} ${pc.dim(`- ${t.description}`)}`,
-            value: t.name
-          });
-        }
-      }
-      template = await select({
-        message: "\u9009\u62E9\u6A21\u677F:",
-        choices: templateChoices,
-        default: defaultTemplate && registry.templates.some((t) => t.name === defaultTemplate) ? defaultTemplate : void 0
-      });
-    }
-  }
-  const found = registry.templates.find((t) => t.name === template);
-  if (!found) {
-    console.log(pc.red(`\u9519\u8BEF: \u672A\u627E\u5230\u6A21\u677F "${template}"`));
-    console.log(pc.dim(`\u53EF\u7528\u6A21\u677F: ${registry.templates.map((t) => t.name).join(", ")}`));
-    throw new CliError(`\u672A\u627E\u5230\u6A21\u677F "${template}"`, ExitCodes.USER_ERROR);
-  }
-  let initGit2 = options.git !== false;
-  if (options.git === void 0 && interactive) {
-    initGit2 = await confirm({
-      message: "\u521D\u59CB\u5316 Git \u4ED3\u5E93?",
-      default: true
-    });
-  }
-  let createGithub = options.github ?? false;
-  if (initGit2 && options.github === void 0 && interactive) {
-    createGithub = await confirm({
-      message: "\u5728 GitHub \u521B\u5EFA\u8FDC\u7A0B\u4ED3\u5E93?",
-      default: defaults.github ?? false
-    });
-  }
-  let isPublic = options.public ?? false;
-  if (createGithub && options.public === void 0 && interactive) {
-    const publicDefault = defaults.public ?? false;
-    isPublic = await select({
-      message: "\u4ED3\u5E93\u53EF\u89C1\u6027:",
-      choices: [
-        { name: "private (\u79C1\u6709)", value: false },
-        { name: "public (\u516C\u5F00)", value: true }
-      ],
-      default: publicDefault
-    });
-  }
-  const result = {
-    projectName: validName,
-    template,
-    targetDir,
-    initGit: initGit2,
-    createGithub,
-    isPublic,
-    noInstall: options.install === false
-  };
-  debug("prompts", "\u6700\u7EC8\u9879\u76EE\u9009\u9879", result);
-  return result;
-}
-
-// src/scaffold.ts
+// src/core/scaffold.ts
 import path3 from "path";
 import fs2 from "fs-extra";
 async function scaffoldProject(options) {
@@ -361,49 +287,7 @@ async function copyFile(srcPath, destPath, projectName, config) {
   await fs2.writeFile(destPath, content, "utf-8");
 }
 
-// src/git.ts
-import pc2 from "picocolors";
-
-// src/config.ts
-import fs3 from "fs";
-import path4 from "path";
-import os from "os";
-var CONFIG_PATH = path4.join(os.homedir(), ".spec-go.json");
-var DEFAULT_CONFIG = {
-  defaults: {
-    github: false,
-    public: false,
-    template: ""
-  },
-  github: {
-    token: "",
-    defaultOrg: ""
-  }
-};
-function ensureConfigExists() {
-  if (!fs3.existsSync(CONFIG_PATH)) {
-    saveConfig(DEFAULT_CONFIG);
-  }
-}
-function loadConfig() {
-  try {
-    if (fs3.existsSync(CONFIG_PATH)) {
-      const content = fs3.readFileSync(CONFIG_PATH, "utf-8");
-      return JSON.parse(content);
-    }
-  } catch {
-  }
-  return {};
-}
-function saveConfig(config) {
-  fs3.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2), "utf-8");
-  fs3.chmodSync(CONFIG_PATH, 384);
-}
-function getConfigPath() {
-  return CONFIG_PATH;
-}
-
-// src/github-api.ts
+// src/core/github-api.ts
 var GITHUB_API_BASE = "https://api.github.com";
 async function githubFetch(endpoint, token, options = {}) {
   const url = `${GITHUB_API_BASE}${endpoint}`;
@@ -413,7 +297,7 @@ async function githubFetch(endpoint, token, options = {}) {
       ...options,
       headers: {
         "Accept": "application/vnd.github+json",
-        "Authorization": `Bearer ${token.slice(0, 8)}...`,
+        "Authorization": `Bearer ${token}`,
         "X-GitHub-Api-Version": "2022-11-28",
         "User-Agent": "spec-go",
         ...options.headers
@@ -479,7 +363,7 @@ async function createRepository(token, options) {
   });
 }
 
-// src/git.ts
+// src/core/git.ts
 async function initGit(targetDir) {
   debug("git", `\u521D\u59CB\u5316 Git \u4ED3\u5E93: ${targetDir}`);
   await execAsync("git", ["init"], { cwd: targetDir });
@@ -487,27 +371,27 @@ async function initGit(targetDir) {
   await execAsync("git", ["commit", "-m", "Initial commit"], { cwd: targetDir });
   debug("git", "Git \u521D\u59CB\u5316\u5B8C\u6210");
 }
-async function createGithubRepo(repoName, targetDir, isPublic) {
+async function createGithubRepo(options) {
+  const { repoName, targetDir, isPublic, organization, logger = silentLogger } = options;
   debug("git", `\u521B\u5EFA GitHub \u4ED3\u5E93: ${repoName}, \u516C\u5F00: ${isPublic}`);
   const config = loadConfig();
   if (!config.github?.token) {
-    console.log(pc2.yellow("\u26A0 \u672A\u914D\u7F6E GitHub Token\uFF0C\u8DF3\u8FC7\u4ED3\u5E93\u521B\u5EFA"));
-    console.log(pc2.dim(`  \u8FD0\u884C ${pc2.cyan("spec-go config --setup-github")} \u914D\u7F6E Token`));
-    console.log(pc2.dim(`  \u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84: ${getConfigPath()}`));
+    logger.warn("\u26A0 \u672A\u914D\u7F6E GitHub Token\uFF0C\u8DF3\u8FC7\u4ED3\u5E93\u521B\u5EFA");
+    logger.dim(`  \u8FD0\u884C spec-go config --setup-github \u914D\u7F6E Token`);
+    logger.dim(`  \u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84: ${getConfigPath()}`);
     return null;
   }
   const token = config.github.token;
-  const defaultOrg = config.github.defaultOrg;
+  const defaultOrg = organization || config.github.defaultOrg;
   const validateResult = await validateToken(token);
   if (!validateResult.success) {
-    console.log(pc2.yellow(`\u26A0 GitHub Token \u65E0\u6548: ${validateResult.error}`));
+    logger.warn(`\u26A0 GitHub Token \u65E0\u6548: ${validateResult.error}`);
     if (validateResult.rateLimitReset) {
-      console.log(pc2.dim(`  Rate limit \u5C06\u5728 ${validateResult.rateLimitReset.toLocaleString()} \u91CD\u7F6E`));
+      logger.dim(`  Rate limit \u5C06\u5728 ${validateResult.rateLimitReset.toLocaleString()} \u91CD\u7F6E`);
     }
-    console.log(pc2.dim(`  \u8FD0\u884C ${pc2.cyan("spec-go config --setup-github")} \u91CD\u65B0\u914D\u7F6E`));
+    logger.dim(`  \u8FD0\u884C spec-go config --setup-github \u91CD\u65B0\u914D\u7F6E`);
     return null;
   }
-  const username = validateResult.data.login;
   const createResult = await createRepository(token, {
     name: repoName,
     isPrivate: !isPublic,
@@ -515,12 +399,12 @@ async function createGithubRepo(repoName, targetDir, isPublic) {
   });
   if (!createResult.success) {
     if (createResult.statusCode === 422) {
-      console.log(pc2.yellow(`\u26A0 \u4ED3\u5E93 "${repoName}" \u5DF2\u5B58\u5728\uFF0C\u8BF7\u9009\u62E9\u5176\u4ED6\u540D\u79F0`));
+      logger.warn(`\u26A0 \u4ED3\u5E93 "${repoName}" \u5DF2\u5B58\u5728\uFF0C\u8BF7\u9009\u62E9\u5176\u4ED6\u540D\u79F0`);
     } else if (createResult.rateLimitReset) {
-      console.log(pc2.yellow(`\u26A0 API \u8BF7\u6C42\u6B21\u6570\u5DF2\u8FBE\u4E0A\u9650`));
-      console.log(pc2.dim(`  \u5C06\u5728 ${createResult.rateLimitReset.toLocaleString()} \u91CD\u7F6E`));
+      logger.warn(`\u26A0 API \u8BF7\u6C42\u6B21\u6570\u5DF2\u8FBE\u4E0A\u9650`);
+      logger.dim(`  \u5C06\u5728 ${createResult.rateLimitReset.toLocaleString()} \u91CD\u7F6E`);
     } else {
-      console.log(pc2.yellow(`\u26A0 \u521B\u5EFA\u4ED3\u5E93\u5931\u8D25: ${createResult.error}`));
+      logger.warn(`\u26A0 \u521B\u5EFA\u4ED3\u5E93\u5931\u8D25: ${createResult.error}`);
     }
     return null;
   }
@@ -549,55 +433,297 @@ async function createGithubRepo(repoName, targetDir, isPublic) {
       { cwd: targetDir }
     );
     if (pushMaster.code !== 0) {
-      console.log(pc2.yellow(`\u26A0 \u63A8\u9001\u5931\u8D25: ${pushResult.stderr || pushMaster.stderr}`));
-      console.log(pc2.dim(`  \u4ED3\u5E93\u5DF2\u521B\u5EFA: ${repo.html_url}`));
-      console.log(pc2.dim("  \u8BF7\u624B\u52A8\u63A8\u9001\u4EE3\u7801"));
+      logger.warn(`\u26A0 \u63A8\u9001\u5931\u8D25: ${pushResult.stderr || pushMaster.stderr}`);
+      logger.dim(`  \u4ED3\u5E93\u5DF2\u521B\u5EFA: ${repo.html_url}`);
+      logger.dim("  \u8BF7\u624B\u52A8\u63A8\u9001\u4EE3\u7801");
       return repo.html_url;
     }
   }
   return repo.html_url;
 }
 
-// src/post-init.ts
-import path5 from "path";
-import pc3 from "picocolors";
-async function runPostInit(targetDir, commands) {
+// src/core/post-init.ts
+import path4 from "path";
+async function runPostInit(targetDir, commands, options = {}) {
+  const { logger = silentLogger } = options;
   for (const cmd of commands) {
-    console.log(pc3.dim(`  ${cmd.description}...`));
+    logger.dim(`  ${cmd.description}...`);
     const [command, ...args] = cmd.command.split(" ");
     const result = await execAsync(command, args, {
       cwd: targetDir,
       stdio: "pipe"
     });
     if (result.code !== 0) {
-      console.log(pc3.yellow(`\u26A0 ${cmd.description} \u5931\u8D25`));
+      logger.warn(`\u26A0 ${cmd.description} \u5931\u8D25`);
       if (result.stderr) {
-        console.log(pc3.dim(result.stderr.slice(0, 200)));
+        logger.dim(result.stderr.slice(0, 200));
       }
     }
   }
 }
-async function runWorkspacePostInit(targetDir, config) {
+async function runWorkspacePostInit(targetDir, config, options = {}) {
+  const { logger = silentLogger } = options;
   if (config.postInit && config.postInit.length > 0) {
-    await runPostInit(targetDir, config.postInit);
+    await runPostInit(targetDir, config.postInit, options);
   }
   if (config.workspaces) {
     for (const ws of config.workspaces) {
       if (ws.postInit && ws.postInit.length > 0) {
-        const wsDir = path5.join(targetDir, ws.name);
-        console.log(pc3.dim(`  [${ws.name}]`));
-        await runPostInit(wsDir, ws.postInit);
+        const wsDir = path4.join(targetDir, ws.name);
+        logger.dim(`  [${ws.name}]`);
+        await runPostInit(wsDir, ws.postInit, options);
       }
     }
   }
 }
 
-// src/update-check.ts
-import fs4 from "fs";
-import path6 from "path";
+// src/cli/prompts.ts
+var DEFAULT_TEMPLATE = "node-ts";
+async function runPrompts(argProjectName, options, userConfig = {}, interactive = true) {
+  const defaults = userConfig.defaults ?? {};
+  const templatesDir = getTemplatesDir();
+  const registryPath = path5.join(templatesDir, "template.config.json");
+  const registry = JSON.parse(
+    fs3.readFileSync(registryPath, "utf-8")
+  );
+  debug("prompts", `\u4EA4\u4E92\u6A21\u5F0F: ${interactive}`);
+  debug("prompts", `CLI \u53C2\u6570`, { argProjectName, options });
+  let projectName = argProjectName;
+  if (!projectName) {
+    if (!interactive) {
+      console.log(pc.red("\u9519\u8BEF: \u975E\u4EA4\u4E92\u6A21\u5F0F\u4E0B\u5FC5\u987B\u63D0\u4F9B\u9879\u76EE\u540D\u79F0"));
+      throw new CliError("\u975E\u4EA4\u4E92\u6A21\u5F0F\u4E0B\u5FC5\u987B\u63D0\u4F9B\u9879\u76EE\u540D\u79F0", ExitCodes.USER_ERROR);
+    }
+    projectName = await input({
+      message: "\u9879\u76EE\u540D\u79F0:",
+      default: "my-project",
+      validate: (value) => {
+        if (!value.trim()) {
+          return "\u9879\u76EE\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A";
+        }
+        if (!isValidPackageName(toValidPackageName(value))) {
+          return "\u65E0\u6548\u7684\u9879\u76EE\u540D\u79F0";
+        }
+        return true;
+      }
+    });
+  }
+  const validName = toValidPackageName(projectName);
+  const targetDir = path5.resolve(process.cwd(), validName);
+  if (fs3.existsSync(targetDir) && !isEmpty(targetDir)) {
+    if (!interactive) {
+      console.log(pc.yellow(`\u8B66\u544A: \u76EE\u6807\u76EE\u5F55 "${validName}" \u975E\u7A7A\uFF0C\u5C06\u8986\u76D6\u5DF2\u6709\u6587\u4EF6`));
+    } else {
+      const overwrite = await confirm({
+        message: `\u76EE\u6807\u76EE\u5F55 "${validName}" \u975E\u7A7A\uFF0C\u662F\u5426\u7EE7\u7EED? (\u5C06\u8986\u76D6\u5DF2\u6709\u6587\u4EF6)`,
+        default: false
+      });
+      if (!overwrite) {
+        const error = new Error("PROMPT_CANCELLED");
+        throw error;
+      }
+    }
+  }
+  let template = options.template;
+  if (!template) {
+    if (!interactive) {
+      template = defaults.template || DEFAULT_TEMPLATE;
+      console.log(pc.dim(`\u4F7F\u7528\u9ED8\u8BA4\u6A21\u677F: ${template}`));
+    } else {
+      const defaultTemplate = defaults.template;
+      const singleTemplates = registry.templates.filter((t) => t.category !== "fullstack");
+      const fullstackTemplates = registry.templates.filter((t) => t.category === "fullstack");
+      const templateChoices = [];
+      templateChoices.push(new Separator("\u2500\u2500 \u5355\u4F53\u9879\u76EE \u2500\u2500"));
+      for (const t of singleTemplates) {
+        templateChoices.push({
+          name: `${t.displayName} ${pc.dim(`- ${t.description}`)}`,
+          value: t.name
+        });
+      }
+      if (fullstackTemplates.length > 0) {
+        templateChoices.push(new Separator("\u2500\u2500 \u524D\u540E\u7AEF\u5206\u79BB \u2500\u2500"));
+        for (const t of fullstackTemplates) {
+          templateChoices.push({
+            name: `${t.displayName} ${pc.dim(`- ${t.description}`)}`,
+            value: t.name
+          });
+        }
+      }
+      template = await select({
+        message: "\u9009\u62E9\u6A21\u677F:",
+        choices: templateChoices,
+        default: defaultTemplate && registry.templates.some((t) => t.name === defaultTemplate) ? defaultTemplate : void 0
+      });
+    }
+  }
+  const found = registry.templates.find((t) => t.name === template);
+  if (!found) {
+    console.log(pc.red(`\u9519\u8BEF: \u672A\u627E\u5230\u6A21\u677F "${template}"`));
+    console.log(pc.dim(`\u53EF\u7528\u6A21\u677F: ${registry.templates.map((t) => t.name).join(", ")}`));
+    throw new CliError(`\u672A\u627E\u5230\u6A21\u677F "${template}"`, ExitCodes.USER_ERROR);
+  }
+  let initGit2 = options.git !== false;
+  if (options.git === void 0 && interactive) {
+    initGit2 = await confirm({
+      message: "\u521D\u59CB\u5316 Git \u4ED3\u5E93?",
+      default: true
+    });
+  }
+  let createGithub = options.github ?? false;
+  if (initGit2 && options.github === void 0 && interactive) {
+    createGithub = await confirm({
+      message: "\u5728 GitHub \u521B\u5EFA\u8FDC\u7A0B\u4ED3\u5E93?",
+      default: defaults.github ?? false
+    });
+  }
+  let isPublic = options.public ?? false;
+  if (createGithub && options.public === void 0 && interactive) {
+    const publicDefault = defaults.public ?? false;
+    isPublic = await select({
+      message: "\u4ED3\u5E93\u53EF\u89C1\u6027:",
+      choices: [
+        { name: "private (\u79C1\u6709)", value: false },
+        { name: "public (\u516C\u5F00)", value: true }
+      ],
+      default: publicDefault
+    });
+  }
+  const result = {
+    projectName: validName,
+    template,
+    targetDir,
+    initGit: initGit2,
+    createGithub,
+    isPublic,
+    noInstall: options.install === false
+  };
+  debug("prompts", "\u6700\u7EC8\u9879\u76EE\u9009\u9879", result);
+  return result;
+}
+
+// src/cli/github-setup.ts
+import { input as input2, confirm as confirm2 } from "@inquirer/prompts";
+import pc2 from "picocolors";
+var TOKEN_HELP_URL = "https://github.com/settings/tokens/new?scopes=repo&description=spec-go";
+function isUserCancelled(err) {
+  const error = err;
+  return error.message === "PROMPT_CANCELLED" || error.name === "ExitPromptError" || error.message.includes("User force closed");
+}
+async function runGitHubSetup() {
+  console.log();
+  console.log(pc2.cyan("\u914D\u7F6E GitHub Token"));
+  console.log();
+  console.log("\u9700\u8981\u4E00\u4E2A\u5177\u6709 repo \u6743\u9650\u7684 Personal Access Token (Classic) \u6765\u521B\u5EFA\u4ED3\u5E93\u3002");
+  console.log();
+  console.log(pc2.dim("\u83B7\u53D6\u6B65\u9AA4:"));
+  console.log(pc2.dim("1. \u8BBF\u95EE GitHub Settings > Developer settings > Personal access tokens"));
+  console.log(pc2.dim('2. \u70B9\u51FB "Generate new token (classic)"'));
+  console.log(pc2.dim('3. \u52FE\u9009 "repo" \u6743\u9650'));
+  console.log(pc2.dim("4. \u751F\u6210\u5E76\u590D\u5236 Token"));
+  console.log();
+  console.log(pc2.dim(`\u5FEB\u6377\u94FE\u63A5: ${TOKEN_HELP_URL}`));
+  console.log();
+  try {
+    const token = await input2({
+      message: "\u8BF7\u8F93\u5165 GitHub Token:",
+      validate: (value) => {
+        if (!value.trim()) {
+          return "Token \u4E0D\u80FD\u4E3A\u7A7A";
+        }
+        if (!value.startsWith("ghp_") && !value.startsWith("github_pat_")) {
+          return "Token \u683C\u5F0F\u4E0D\u6B63\u786E\uFF0C\u5E94\u4EE5 ghp_ \u6216 github_pat_ \u5F00\u5934";
+        }
+        return true;
+      }
+    });
+    console.log();
+    console.log(pc2.dim("\u6B63\u5728\u9A8C\u8BC1 Token..."));
+    const result = await validateToken(token.trim());
+    if (!result.success) {
+      console.log(pc2.red(`\u2717 Token \u9A8C\u8BC1\u5931\u8D25: ${result.error}`));
+      if (result.rateLimitReset) {
+        console.log(pc2.dim(`  Rate limit \u5C06\u5728 ${result.rateLimitReset.toLocaleString()} \u91CD\u7F6E`));
+      }
+      return false;
+    }
+    const user = result.data;
+    console.log(pc2.green(`\u2714 Token \u6709\u6548\uFF0C\u5DF2\u767B\u5F55\u4E3A: ${user.login}${user.name ? ` (${user.name})` : ""}`));
+    console.log();
+    const setOrg = await confirm2({
+      message: "\u662F\u5426\u8BBE\u7F6E\u9ED8\u8BA4\u7EC4\u7EC7? (\u5426\u5219\u4ED3\u5E93\u5C06\u521B\u5EFA\u5728\u4E2A\u4EBA\u8D26\u6237\u4E0B)",
+      default: false
+    });
+    let defaultOrg;
+    if (setOrg) {
+      defaultOrg = await input2({
+        message: "\u9ED8\u8BA4\u7EC4\u7EC7\u540D\u79F0:",
+        validate: (value) => {
+          if (!value.trim()) {
+            return "\u7EC4\u7EC7\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A";
+          }
+          return true;
+        }
+      });
+      defaultOrg = defaultOrg.trim();
+    }
+    const config = loadConfig();
+    config.github = {
+      token: token.trim(),
+      ...defaultOrg && { defaultOrg }
+    };
+    saveConfig(config);
+    console.log();
+    console.log(pc2.green("\u2714 GitHub \u914D\u7F6E\u5DF2\u4FDD\u5B58"));
+    console.log(pc2.dim("  \u914D\u7F6E\u6587\u4EF6\u5DF2\u8BBE\u7F6E\u4E3A\u4EC5\u5F53\u524D\u7528\u6237\u53EF\u8BFB"));
+    return true;
+  } catch (err) {
+    if (isUserCancelled(err)) {
+      console.log(pc2.yellow("\n\u64CD\u4F5C\u5DF2\u53D6\u6D88"));
+      return false;
+    }
+    throw err;
+  }
+}
+function showConfig() {
+  const config = loadConfig();
+  console.log();
+  console.log(pc2.cyan("\u5F53\u524D\u914D\u7F6E:"));
+  console.log();
+  if (config.defaults) {
+    console.log(pc2.dim("defaults:"));
+    if (config.defaults.github !== void 0) {
+      console.log(`  github: ${config.defaults.github}`);
+    }
+    if (config.defaults.public !== void 0) {
+      console.log(`  public: ${config.defaults.public}`);
+    }
+    if (config.defaults.template !== void 0) {
+      console.log(`  template: ${config.defaults.template}`);
+    }
+  }
+  if (config.github) {
+    console.log(pc2.dim("github:"));
+    if (config.github.token) {
+      const masked = config.github.token.slice(0, 8) + "..." + config.github.token.slice(-4);
+      console.log(`  token: ${masked}`);
+    }
+    if (config.github.defaultOrg) {
+      console.log(`  defaultOrg: ${config.github.defaultOrg}`);
+    }
+  }
+  if (!config.defaults && !config.github) {
+    console.log(pc2.dim("(\u65E0\u914D\u7F6E)"));
+  }
+  console.log();
+}
+
+// src/cli/update-check.ts
+import fs4 from "fs";
+import path6 from "path";
 import os2 from "os";
 import { execSync } from "child_process";
-import pc4 from "picocolors";
+import pc3 from "picocolors";
 var CACHE_PATH = path6.join(os2.homedir(), ".spec-go-update-check");
 var CACHE_TTL = 24 * 60 * 60 * 1e3;
 var PACKAGE_NAME = "@lambertkeith/spec-go";
@@ -655,9 +781,9 @@ async function checkForUpdates(currentVersion) {
   if (latestVersion && compareVersions(currentVersion, latestVersion) < 0) {
     console.log();
     console.log(
-      pc4.yellow(`  \u26A0 \u53D1\u73B0\u65B0\u7248\u672C ${pc4.bold(latestVersion)}\uFF0C\u5F53\u524D ${currentVersion}`)
+      pc3.yellow(`  \u26A0 \u53D1\u73B0\u65B0\u7248\u672C ${pc3.bold(latestVersion)}\uFF0C\u5F53\u524D ${currentVersion}`)
     );
-    console.log(pc4.cyan(`    \u8FD0\u884C ${pc4.bold(`npm update -g ${PACKAGE_NAME}`)} \u66F4\u65B0`));
+    console.log(pc3.cyan(`    \u8FD0\u884C ${pc3.bold(`npm update -g ${PACKAGE_NAME}`)} \u66F4\u65B0`));
     console.log();
   }
 }
@@ -680,148 +806,433 @@ function getUpdateCommand(pm) {
 async function runUpdate(currentVersion, checkOnly) {
   const latestVersion = await fetchLatestVersion();
   if (!latestVersion) {
-    console.log(pc4.red("\u2717 \u65E0\u6CD5\u83B7\u53D6\u6700\u65B0\u7248\u672C\u4FE1\u606F"));
+    console.log(pc3.red("\u2717 \u65E0\u6CD5\u83B7\u53D6\u6700\u65B0\u7248\u672C\u4FE1\u606F"));
     process.exit(ExitCodes.EXTERNAL_ERROR);
   }
   const comparison = compareVersions(currentVersion, latestVersion);
   if (comparison >= 0) {
-    console.log(pc4.green(`\u2714 \u5DF2\u662F\u6700\u65B0\u7248\u672C (${currentVersion})`));
+    console.log(pc3.green(`\u2714 \u5DF2\u662F\u6700\u65B0\u7248\u672C (${currentVersion})`));
     return;
   }
-  console.log(pc4.cyan(`\u53D1\u73B0\u65B0\u7248\u672C: ${currentVersion} \u2192 ${latestVersion}`));
+  console.log(pc3.cyan(`\u53D1\u73B0\u65B0\u7248\u672C: ${currentVersion} \u2192 ${latestVersion}`));
   if (checkOnly) {
-    console.log(pc4.dim(`\u8FD0\u884C spec-go update \u66F4\u65B0`));
+    console.log(pc3.dim(`\u8FD0\u884C spec-go update \u66F4\u65B0`));
     return;
   }
   const pm = detectPackageManager();
   const updateCmd = getUpdateCommand(pm);
-  console.log(pc4.dim(`\u6B63\u5728\u6267\u884C: ${updateCmd}`));
+  console.log(pc3.dim(`\u6B63\u5728\u6267\u884C: ${updateCmd}`));
   try {
     execSync(updateCmd, { stdio: "inherit" });
-    console.log(pc4.green(`\u2714 \u66F4\u65B0\u5B8C\u6210`));
+    console.log(pc3.green(`\u2714 \u66F4\u65B0\u5B8C\u6210`));
   } catch {
-    console.log(pc4.red("\u2717 \u66F4\u65B0\u5931\u8D25\uFF0C\u8BF7\u624B\u52A8\u6267\u884C\u66F4\u65B0\u547D\u4EE4"));
+    console.log(pc3.red("\u2717 \u66F4\u65B0\u5931\u8D25\uFF0C\u8BF7\u624B\u52A8\u6267\u884C\u66F4\u65B0\u547D\u4EE4"));
     process.exit(ExitCodes.EXTERNAL_ERROR);
   }
 }
 
-// src/github-setup.ts
-import { input as input2, confirm as confirm2 } from "@inquirer/prompts";
+// src/cli/guide.ts
+import path7 from "path";
+import fs5 from "fs";
+import { select as select2 } from "@inquirer/prompts";
 import pc5 from "picocolors";
-var TOKEN_HELP_URL = "https://github.com/settings/tokens/new?scopes=repo&description=spec-go";
-function isUserCancelled(err) {
-  const error = err;
-  return error.message === "PROMPT_CANCELLED" || error.name === "ExitPromptError" || error.message.includes("User force closed");
-}
-async function runGitHubSetup() {
-  console.log();
-  console.log(pc5.cyan("\u914D\u7F6E GitHub Token"));
-  console.log();
-  console.log("\u9700\u8981\u4E00\u4E2A\u5177\u6709 repo \u6743\u9650\u7684 Personal Access Token (Classic) \u6765\u521B\u5EFA\u4ED3\u5E93\u3002");
-  console.log();
-  console.log(pc5.dim("\u83B7\u53D6\u6B65\u9AA4:"));
-  console.log(pc5.dim("1. \u8BBF\u95EE GitHub Settings > Developer settings > Personal access tokens"));
-  console.log(pc5.dim('2. \u70B9\u51FB "Generate new token (classic)"'));
-  console.log(pc5.dim('3. \u52FE\u9009 "repo" \u6743\u9650'));
-  console.log(pc5.dim("4. \u751F\u6210\u5E76\u590D\u5236 Token"));
-  console.log();
-  console.log(pc5.dim(`\u5FEB\u6377\u94FE\u63A5: ${TOKEN_HELP_URL}`));
-  console.log();
-  try {
-    const token = await input2({
-      message: "\u8BF7\u8F93\u5165 GitHub Token:",
-      validate: (value) => {
-        if (!value.trim()) {
-          return "Token \u4E0D\u80FD\u4E3A\u7A7A";
-        }
-        if (!value.startsWith("ghp_") && !value.startsWith("github_pat_")) {
-          return "Token \u683C\u5F0F\u4E0D\u6B63\u786E\uFF0C\u5E94\u4EE5 ghp_ \u6216 github_pat_ \u5F00\u5934";
+
+// src/cli/guide-content.ts
+import pc4 from "picocolors";
+var guideTopics = [
+  // 入门指南类
+  {
+    id: "quickstart",
+    title: "\u5FEB\u901F\u5F00\u59CB",
+    description: "5\u5206\u949F\u5FEB\u901F\u4E0A\u624B spec-go",
+    category: "\u5165\u95E8\u6307\u5357",
+    content: () => `
+${pc4.cyan("\u5FEB\u901F\u5F00\u59CB")}
+
+${pc4.bold("1. \u521B\u5EFA\u9879\u76EE")}
+  ${pc4.green("spec-go my-app")}
+
+  \u6309\u7167\u4EA4\u4E92\u5F0F\u63D0\u793A\u9009\u62E9\u6A21\u677F\u548C\u914D\u7F6E\u9009\u9879\u3002
+
+${pc4.bold("2. \u8FDB\u5165\u9879\u76EE\u76EE\u5F55")}
+  ${pc4.green("cd my-app")}
+
+${pc4.bold("3. \u542F\u52A8\u5F00\u53D1\u670D\u52A1\u5668")}
+  ${pc4.green("pnpm dev")}
+
+  \u6839\u636E\u4E0D\u540C\u6A21\u677F\uFF0C\u542F\u52A8\u547D\u4EE4\u53EF\u80FD\u6709\u6240\u4E0D\u540C\u3002
+
+${pc4.dim("\u63D0\u793A\uFF1A\u4F7F\u7528")} ${pc4.green("spec-go guide templates")} ${pc4.dim("\u67E5\u770B\u6240\u6709\u53EF\u7528\u6A21\u677F")}
+${pc4.dim("\u63D0\u793A\uFF1A\u4F7F\u7528")} ${pc4.green("spec-go guide examples")} ${pc4.dim("\u67E5\u770B\u66F4\u591A\u4F7F\u7528\u793A\u4F8B")}
+`
+  },
+  {
+    id: "templates",
+    title: "\u6A21\u677F\u5217\u8868",
+    description: "\u67E5\u770B\u6240\u6709\u53EF\u7528\u7684\u9879\u76EE\u6A21\u677F",
+    category: "\u5165\u95E8\u6307\u5357",
+    content: (data) => {
+      const templates = data?.templates || [];
+      const singleTemplates = templates.filter((t) => t.category !== "fullstack");
+      const fullstackTemplates = templates.filter((t) => t.category === "fullstack");
+      let output = `
+${pc4.cyan("\u53EF\u7528\u6A21\u677F")}
+
+`;
+      if (singleTemplates.length > 0) {
+        output += `${pc4.bold("\u5355\u4F53\u9879\u76EE\uFF1A")}
+`;
+        for (const t of singleTemplates) {
+          output += `  ${pc4.green(t.name.padEnd(24))} ${pc4.dim(t.displayName)}
+`;
+          output += `  ${" ".repeat(24)} ${pc4.dim(t.description)}
+`;
         }
-        return true;
+        output += "\n";
       }
-    });
-    console.log();
-    console.log(pc5.dim("\u6B63\u5728\u9A8C\u8BC1 Token..."));
-    const result = await validateToken(token.trim());
-    if (!result.success) {
-      console.log(pc5.red(`\u2717 Token \u9A8C\u8BC1\u5931\u8D25: ${result.error}`));
-      if (result.rateLimitReset) {
-        console.log(pc5.dim(`  Rate limit \u5C06\u5728 ${result.rateLimitReset.toLocaleString()} \u91CD\u7F6E`));
+      if (fullstackTemplates.length > 0) {
+        output += `${pc4.bold("\u524D\u540E\u7AEF\u5206\u79BB\uFF1A")}
+`;
+        for (const t of fullstackTemplates) {
+          output += `  ${pc4.green(t.name.padEnd(24))} ${pc4.dim(t.displayName)}
+`;
+          output += `  ${" ".repeat(24)} ${pc4.dim(t.description)}
+`;
+        }
+        output += "\n";
       }
-      return false;
+      output += `${pc4.dim("\u4F7F\u7528\u65B9\u5F0F\uFF1A")}
+`;
+      output += `  ${pc4.green("spec-go my-app --template <\u6A21\u677F\u540D>")}
+`;
+      output += `  ${pc4.green("spec-go list")} ${pc4.dim("# \u67E5\u770B\u7B80\u6D01\u5217\u8868")}
+`;
+      return output;
     }
-    const user = result.data;
-    console.log(pc5.green(`\u2714 Token \u6709\u6548\uFF0C\u5DF2\u767B\u5F55\u4E3A: ${user.login}${user.name ? ` (${user.name})` : ""}`));
-    console.log();
-    const setOrg = await confirm2({
-      message: "\u662F\u5426\u8BBE\u7F6E\u9ED8\u8BA4\u7EC4\u7EC7? (\u5426\u5219\u4ED3\u5E93\u5C06\u521B\u5EFA\u5728\u4E2A\u4EBA\u8D26\u6237\u4E0B)",
-      default: false
-    });
-    let defaultOrg;
-    if (setOrg) {
-      defaultOrg = await input2({
-        message: "\u9ED8\u8BA4\u7EC4\u7EC7\u540D\u79F0:",
-        validate: (value) => {
-          if (!value.trim()) {
-            return "\u7EC4\u7EC7\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A";
-          }
-          return true;
-        }
-      });
-      defaultOrg = defaultOrg.trim();
+  },
+  {
+    id: "examples",
+    title: "\u4F7F\u7528\u793A\u4F8B",
+    description: "\u5E38\u89C1\u4F7F\u7528\u573A\u666F\u548C\u6700\u4F73\u5B9E\u8DF5",
+    category: "\u5165\u95E8\u6307\u5357",
+    content: () => `
+${pc4.cyan("\u4F7F\u7528\u793A\u4F8B")}
+
+${pc4.bold("1. \u521B\u5EFA React \u9879\u76EE")}
+  ${pc4.green("spec-go my-react-app --template react-ts")}
+
+${pc4.bold("2. \u521B\u5EFA\u5168\u6808\u9879\u76EE\uFF08\u524D\u540E\u7AEF\u5206\u79BB\uFF09")}
+  ${pc4.green("spec-go my-fullstack --template fullstack-react-node")}
+
+${pc4.bold("3. \u521B\u5EFA API \u9879\u76EE")}
+  ${pc4.green("spec-go my-api --template express-ts")}
+
+${pc4.bold("4. \u975E\u4EA4\u4E92\u6A21\u5F0F\uFF08CI/CD\uFF09")}
+  ${pc4.green("spec-go my-app --template node-ts --yes --no-install")}
+
+${pc4.bold("5. \u521B\u5EFA\u5E76\u63A8\u9001\u5230 GitHub")}
+  ${pc4.green("spec-go my-app --template react-ts --github --public")}
+
+${pc4.bold("6. \u8DF3\u8FC7 Git \u521D\u59CB\u5316")}
+  ${pc4.green("spec-go my-app --template vue-ts --no-git")}
+
+${pc4.dim("\u63D0\u793A\uFF1A\u4F7F\u7528")} ${pc4.green("spec-go --help")} ${pc4.dim("\u67E5\u770B\u6240\u6709\u53EF\u7528\u9009\u9879")}
+`
+  },
+  // 功能特性类
+  {
+    id: "github",
+    title: "GitHub \u96C6\u6210",
+    description: "GitHub \u4ED3\u5E93\u521B\u5EFA\u548C\u914D\u7F6E",
+    category: "\u529F\u80FD\u7279\u6027",
+    content: (data) => `
+${pc4.cyan("GitHub \u96C6\u6210")}
+
+${pc4.bold("\u914D\u7F6E GitHub Token")}
+
+${pc4.dim("1. \u751F\u6210 Personal Access Token")}
+   \u8BBF\u95EE\uFF1Ahttps://github.com/settings/tokens
+   \u6743\u9650\uFF1Arepo (\u5B8C\u6574\u4ED3\u5E93\u8BBF\u95EE\u6743\u9650)
+
+${pc4.dim("2. \u914D\u7F6E Token")}
+   ${pc4.green("spec-go config --setup-github")}
+
+${pc4.dim("3. \u9A8C\u8BC1\u914D\u7F6E")}
+   ${pc4.green("spec-go config --show")}
+
+${pc4.bold("\u4F7F\u7528 GitHub \u96C6\u6210")}
+
+${pc4.dim("\u521B\u5EFA\u9879\u76EE\u5E76\u63A8\u9001\u5230 GitHub\uFF1A")}
+  ${pc4.green("spec-go my-app --github")}          ${pc4.dim("# \u521B\u5EFA\u79C1\u6709\u4ED3\u5E93")}
+  ${pc4.green("spec-go my-app --github --public")} ${pc4.dim("# \u521B\u5EFA\u516C\u5F00\u4ED3\u5E93")}
+
+${pc4.bold("\u914D\u7F6E\u6587\u4EF6\u4F4D\u7F6E")}
+  ${data?.configPath || "~/.spec-go.json"}
+
+${pc4.dim("\u63D0\u793A\uFF1AToken \u4F1A\u5B89\u5168\u5B58\u50A8\u5728\u672C\u5730\u914D\u7F6E\u6587\u4EF6\u4E2D")}
+`
+  },
+  {
+    id: "mcp",
+    title: "MCP Server",
+    description: "MCP Server \u914D\u7F6E\u548C\u4F7F\u7528",
+    category: "\u529F\u80FD\u7279\u6027",
+    content: () => `
+${pc4.cyan("MCP Server \u914D\u7F6E")}
+
+${pc4.bold("\u4EC0\u4E48\u662F MCP Server\uFF1F")}
+
+  MCP (Model Context Protocol) Server \u5141\u8BB8 Claude Code \u76F4\u63A5\u8C03\u7528 spec-go \u7684\u529F\u80FD\u3002
+
+${pc4.bold("\u6784\u5EFA MCP Server")}
+
+  ${pc4.dim("1. \u6784\u5EFA\u9879\u76EE")}
+     ${pc4.green("pnpm build")}
+
+  ${pc4.dim("2. \u914D\u7F6E Claude Code")}
+     \u7F16\u8F91 ${pc4.dim("~/.claude/settings.json")}\uFF1A
+
+     {
+       "mcpServers": {
+         "spec-go": {
+           "command": "node",
+           "args": ["/path/to/create-idp/dist/mcp/index.js"]
+         }
+       }
+     }
+
+  ${pc4.dim("3. \u91CD\u542F Claude Code")}
+
+${pc4.bold("\u53EF\u7528\u5DE5\u5177")}
+
+  \u2022 create_project        - \u521B\u5EFA\u65B0\u9879\u76EE
+  \u2022 list_templates        - \u5217\u51FA\u6240\u6709\u6A21\u677F
+  \u2022 validate_project_name - \u9A8C\u8BC1\u9879\u76EE\u540D\u79F0
+  \u2022 init_git_repo         - \u521D\u59CB\u5316 Git \u4ED3\u5E93
+  \u2022 create_github_repo    - \u521B\u5EFA GitHub \u4ED3\u5E93
+
+${pc4.bold("\u4F7F\u7528\u793A\u4F8B")}
+
+  \u5728 Claude Code \u4E2D\u76F4\u63A5\u8BF4\uFF1A
+  ${pc4.dim('"\u4F7F\u7528 spec-go \u521B\u5EFA\u4E00\u4E2A React \u9879\u76EE"')}
+
+${pc4.dim("\u63D0\u793A\uFF1A\u67E5\u770B\u9879\u76EE README \u4E86\u89E3\u66F4\u591A MCP \u914D\u7F6E\u7EC6\u8282")}
+`
+  },
+  // 参考文档类
+  {
+    id: "commands",
+    title: "\u547D\u4EE4\u53C2\u8003",
+    description: "\u6240\u6709\u547D\u4EE4\u7684\u5B8C\u6574\u8BF4\u660E",
+    category: "\u53C2\u8003\u6587\u6863",
+    content: () => `
+${pc4.cyan("\u547D\u4EE4\u53C2\u8003")}
+
+${pc4.bold("\u4E3B\u547D\u4EE4")}
+
+  ${pc4.green("spec-go [project-name] [options]")}
+  \u521B\u5EFA\u65B0\u9879\u76EE
+
+  ${pc4.dim("\u9009\u9879\uFF1A")}
+    -t, --template <name>  \u6307\u5B9A\u6A21\u677F
+    --github               \u521B\u5EFA GitHub \u4ED3\u5E93
+    --public               \u521B\u5EFA\u516C\u5F00\u4ED3\u5E93\uFF08\u9ED8\u8BA4\u79C1\u6709\uFF09
+    --no-git               \u8DF3\u8FC7 Git \u521D\u59CB\u5316
+    --no-install           \u8DF3\u8FC7\u4F9D\u8D56\u5B89\u88C5
+    -y, --yes              \u975E\u4EA4\u4E92\u6A21\u5F0F\uFF0C\u4F7F\u7528\u9ED8\u8BA4\u503C
+    --debug                \u542F\u7528\u8C03\u8BD5\u8F93\u51FA
+
+${pc4.bold("\u5B50\u547D\u4EE4")}
+
+  ${pc4.green("spec-go list [--json]")}
+  \u5217\u51FA\u6240\u6709\u53EF\u7528\u6A21\u677F
+
+  ${pc4.green("spec-go config")}
+  \u7BA1\u7406\u914D\u7F6E
+    --setup-github  \u914D\u7F6E GitHub Token
+    --show          \u663E\u793A\u5F53\u524D\u914D\u7F6E
+    --path          \u663E\u793A\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84
+
+  ${pc4.green("spec-go update [--check]")}
+  \u68C0\u67E5\u5E76\u66F4\u65B0\u5230\u6700\u65B0\u7248\u672C
+    --check  \u4EC5\u68C0\u67E5\u7248\u672C\uFF0C\u4E0D\u6267\u884C\u66F4\u65B0
+
+  ${pc4.green("spec-go guide [topic] [--list] [--json]")}
+  \u663E\u793A\u4F7F\u7528\u6307\u5357
+    --list  \u5217\u51FA\u6240\u6709\u53EF\u7528\u4E3B\u9898
+    --json  JSON \u683C\u5F0F\u8F93\u51FA
+
+${pc4.dim("\u63D0\u793A\uFF1A\u4F7F\u7528")} ${pc4.green("spec-go <command> --help")} ${pc4.dim("\u67E5\u770B\u547D\u4EE4\u8BE6\u7EC6\u5E2E\u52A9")}
+`
+  },
+  {
+    id: "config",
+    title: "\u914D\u7F6E\u8BE6\u89E3",
+    description: "\u914D\u7F6E\u6587\u4EF6\u7ED3\u6784\u548C\u8BF4\u660E",
+    category: "\u53C2\u8003\u6587\u6863",
+    content: (data) => `
+${pc4.cyan("\u914D\u7F6E\u8BE6\u89E3")}
+
+${pc4.bold("\u914D\u7F6E\u6587\u4EF6\u4F4D\u7F6E")}
+
+  ${data?.configPath || "~/.spec-go.json"}
+
+${pc4.bold("\u914D\u7F6E\u7ED3\u6784")}
+
+  {
+    "github": {
+      "token": "ghp_xxxxxxxxxxxx"  ${pc4.dim("// GitHub Personal Access Token")}
+    },
+    "defaults": {
+      "template": "node-ts",          ${pc4.dim("// \u9ED8\u8BA4\u6A21\u677F")}
+      "github": false,                ${pc4.dim("// \u9ED8\u8BA4\u662F\u5426\u521B\u5EFA GitHub \u4ED3\u5E93")}
+      "public": false                 ${pc4.dim("// \u9ED8\u8BA4\u4ED3\u5E93\u53EF\u89C1\u6027")}
     }
-    const config = loadConfig();
-    config.github = {
-      token: token.trim(),
-      ...defaultOrg && { defaultOrg }
-    };
-    saveConfig(config);
-    console.log();
-    console.log(pc5.green("\u2714 GitHub \u914D\u7F6E\u5DF2\u4FDD\u5B58"));
-    console.log(pc5.dim("  \u914D\u7F6E\u6587\u4EF6\u5DF2\u8BBE\u7F6E\u4E3A\u4EC5\u5F53\u524D\u7528\u6237\u53EF\u8BFB"));
-    return true;
+  }
+
+${pc4.bold("\u914D\u7F6E\u7BA1\u7406\u547D\u4EE4")}
+
+  ${pc4.green("spec-go config --setup-github")}  ${pc4.dim("# \u914D\u7F6E GitHub Token")}
+  ${pc4.green("spec-go config --show")}          ${pc4.dim("# \u663E\u793A\u5F53\u524D\u914D\u7F6E")}
+  ${pc4.green("spec-go config --path")}          ${pc4.dim("# \u663E\u793A\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84")}
+
+${pc4.bold("\u5B89\u5168\u6027\u8BF4\u660E")}
+
+  \u2022 Token \u5B58\u50A8\u5728\u672C\u5730\u914D\u7F6E\u6587\u4EF6\u4E2D
+  \u2022 \u914D\u7F6E\u6587\u4EF6\u6743\u9650\u5E94\u8BBE\u7F6E\u4E3A\u4EC5\u5F53\u524D\u7528\u6237\u53EF\u8BFB
+  \u2022 \u4E0D\u8981\u5C06\u914D\u7F6E\u6587\u4EF6\u63D0\u4EA4\u5230\u7248\u672C\u63A7\u5236\u7CFB\u7EDF
+
+${pc4.dim("\u63D0\u793A\uFF1A\u4F7F\u7528")} ${pc4.green("spec-go guide github")} ${pc4.dim("\u4E86\u89E3\u5982\u4F55\u914D\u7F6E GitHub \u96C6\u6210")}
+`
+  }
+];
+
+// src/cli/guide.ts
+function prepareDynamicData() {
+  const data = {};
+  try {
+    const templatesDir = getTemplatesDir();
+    const registryPath = path7.join(templatesDir, "template.config.json");
+    const registry = JSON.parse(
+      fs5.readFileSync(registryPath, "utf-8")
+    );
+    data.templates = registry.templates;
   } catch (err) {
-    if (isUserCancelled(err)) {
-      console.log(pc5.yellow("\n\u64CD\u4F5C\u5DF2\u53D6\u6D88"));
-      return false;
-    }
-    throw err;
+    data.templates = [];
+  }
+  try {
+    data.configPath = getConfigPath();
+  } catch (err) {
+    data.configPath = "~/.spec-go.json";
   }
+  return data;
 }
-function showConfig() {
-  const config = loadConfig();
+async function showGuideMenu(data) {
+  const categories = Array.from(new Set(guideTopics.map((t) => t.category)));
+  const choices = categories.flatMap((category) => {
+    const topicsInCategory = guideTopics.filter((t) => t.category === category);
+    return [
+      { name: pc5.cyan(`\u2500\u2500 ${category} \u2500\u2500`), value: "", disabled: true },
+      ...topicsInCategory.map((t) => ({
+        name: `${t.title} ${pc5.dim(`- ${t.description}`)}`,
+        value: t.id
+      }))
+    ];
+  });
+  const topicId = await select2({
+    message: "\u9009\u62E9\u4E3B\u9898:",
+    choices
+  });
+  if (topicId) {
+    showTopic(topicId, data);
+  }
+}
+function showTopic(topicId, data) {
+  const topic = guideTopics.find((t) => t.id === topicId);
+  if (!topic) {
+    console.log(pc5.red(`\u9519\u8BEF: \u672A\u627E\u5230\u4E3B\u9898 "${topicId}"`));
+    console.log(pc5.dim(`\u4F7F\u7528 ${pc5.green("spec-go guide --list")} \u67E5\u770B\u6240\u6709\u53EF\u7528\u4E3B\u9898`));
+    process.exit(1);
+  }
   console.log();
-  console.log(pc5.cyan("\u5F53\u524D\u914D\u7F6E:"));
+  console.log(topic.content(data));
   console.log();
-  if (config.defaults) {
-    console.log(pc5.dim("defaults:"));
-    if (config.defaults.github !== void 0) {
-      console.log(`  github: ${config.defaults.github}`);
-    }
-    if (config.defaults.public !== void 0) {
-      console.log(`  public: ${config.defaults.public}`);
-    }
-    if (config.defaults.template !== void 0) {
-      console.log(`  template: ${config.defaults.template}`);
+}
+function listTopics() {
+  const categories = Array.from(new Set(guideTopics.map((t) => t.category)));
+  console.log();
+  console.log(pc5.cyan("\u53EF\u7528\u4E3B\u9898"));
+  console.log();
+  for (const category of categories) {
+    console.log(pc5.bold(`${category}:`));
+    const topicsInCategory = guideTopics.filter((t) => t.category === category);
+    for (const topic of topicsInCategory) {
+      console.log(`  ${pc5.green(topic.id.padEnd(16))} ${pc5.dim(topic.description)}`);
     }
+    console.log();
   }
-  if (config.github) {
-    console.log(pc5.dim("github:"));
-    if (config.github.token) {
-      const masked = config.github.token.slice(0, 8) + "..." + config.github.token.slice(-4);
-      console.log(`  token: ${masked}`);
-    }
-    if (config.github.defaultOrg) {
-      console.log(`  defaultOrg: ${config.github.defaultOrg}`);
-    }
+  console.log(pc5.dim("\u4F7F\u7528\u65B9\u5F0F:"));
+  console.log(`  ${pc5.green("spec-go guide <\u4E3B\u9898ID>")}`);
+  console.log();
+}
+function outputJson() {
+  const output = {
+    topics: guideTopics.map((t) => ({
+      id: t.id,
+      title: t.title,
+      description: t.description,
+      category: t.category
+    }))
+  };
+  console.log(JSON.stringify(output, null, 2));
+}
+async function runGuide(topic, options) {
+  const data = prepareDynamicData();
+  if (options.json) {
+    outputJson();
+    return;
   }
-  if (!config.defaults && !config.github) {
-    console.log(pc5.dim("(\u65E0\u914D\u7F6E)"));
+  if (options.list) {
+    listTopics();
+    return;
+  }
+  if (topic) {
+    showTopic(topic, data);
+    return;
+  }
+  try {
+    await showGuideMenu(data);
+  } catch (err) {
+    const error = err;
+    if (error.message === "PROMPT_CANCELLED" || error.name === "ExitPromptError" || error.message.includes("User force closed")) {
+      console.log(pc5.yellow("\n\u64CD\u4F5C\u5DF2\u53D6\u6D88"));
+      process.exit(0);
+    }
+    throw err;
   }
-  console.log();
 }
 
-// src/cli.ts
+// src/cli/console-logger.ts
+import pc6 from "picocolors";
+var consoleLogger = {
+  info(message) {
+    console.log(message);
+  },
+  success(message) {
+    console.log(pc6.green(message));
+  },
+  warn(message) {
+    console.log(pc6.yellow(message));
+  },
+  error(message) {
+    console.log(pc6.red(message));
+  },
+  dim(message) {
+    console.log(pc6.dim(message));
+  }
+};
+
+// src/cli/cli.ts
 function isInteractive(options) {
   if (options.yes) return false;
   return process.stdin.isTTY === true;
@@ -833,7 +1244,7 @@ async function createCli() {
       setDebugEnabled(true);
     }
     console.log();
-    console.log(`  ${pc6.cyan("spec-go")} ${pc6.dim(`v${version}`)}`);
+    console.log(`  ${pc7.cyan("spec-go")} ${pc7.dim(`v${version}`)}`);
     console.log();
     checkForUpdates(version).catch(() => {
     });
@@ -845,7 +1256,7 @@ async function createCli() {
     } catch (err) {
       const error = err;
       if (error.message === "PROMPT_CANCELLED" || error.name === "ExitPromptError" || error.message.includes("User force closed")) {
-        console.log(pc6.yellow("\n\u64CD\u4F5C\u5DF2\u53D6\u6D88"));
+        console.log(pc7.yellow("\n\u64CD\u4F5C\u5DF2\u53D6\u6D88"));
         process.exit(ExitCodes.SUCCESS);
       }
       throw err;
@@ -853,9 +1264,9 @@ async function createCli() {
   });
   program.command("list").description("\u5217\u51FA\u6240\u6709\u53EF\u7528\u6A21\u677F").option("--json", "\u4EE5 JSON \u683C\u5F0F\u8F93\u51FA").action((options) => {
     const templatesDir = getTemplatesDir();
-    const registryPath = path7.join(templatesDir, "template.config.json");
+    const registryPath = path8.join(templatesDir, "template.config.json");
     const registry = JSON.parse(
-      fs5.readFileSync(registryPath, "utf-8")
+      fs6.readFileSync(registryPath, "utf-8")
     );
     if (options.json) {
       const output = {
@@ -872,15 +1283,15 @@ async function createCli() {
     const singleTemplates = registry.templates.filter((t) => t.category !== "fullstack");
     const fullstackTemplates = registry.templates.filter((t) => t.category === "fullstack");
     console.log();
-    console.log(pc6.cyan("  \u5355\u4F53\u9879\u76EE:"));
+    console.log(pc7.cyan("  \u5355\u4F53\u9879\u76EE:"));
     for (const t of singleTemplates) {
-      console.log(`    ${pc6.green(t.name.padEnd(24))} ${pc6.dim(t.displayName)}`);
+      console.log(`    ${pc7.green(t.name.padEnd(24))} ${pc7.dim(t.displayName)}`);
     }
     if (fullstackTemplates.length > 0) {
       console.log();
-      console.log(pc6.cyan("  \u524D\u540E\u7AEF\u5206\u79BB:"));
+      console.log(pc7.cyan("  \u524D\u540E\u7AEF\u5206\u79BB:"));
       for (const t of fullstackTemplates) {
-        console.log(`    ${pc6.green(t.name.padEnd(24))} ${pc6.dim(t.displayName)}`);
+        console.log(`    ${pc7.green(t.name.padEnd(24))} ${pc7.dim(t.displayName)}`);
       }
     }
     console.log();
@@ -895,43 +1306,47 @@ async function createCli() {
       console.log(getConfigPath());
     } else {
       console.log();
-      console.log(pc6.cyan("\u914D\u7F6E\u7BA1\u7406\u547D\u4EE4:"));
+      console.log(pc7.cyan("\u914D\u7F6E\u7BA1\u7406\u547D\u4EE4:"));
       console.log();
-      console.log(`  ${pc6.dim("spec-go config --setup-github")}  \u914D\u7F6E GitHub Token`);
-      console.log(`  ${pc6.dim("spec-go config --show")}          \u663E\u793A\u5F53\u524D\u914D\u7F6E`);
-      console.log(`  ${pc6.dim("spec-go config --path")}          \u663E\u793A\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84`);
+      console.log(`  ${pc7.dim("spec-go config --setup-github")}  \u914D\u7F6E GitHub Token`);
+      console.log(`  ${pc7.dim("spec-go config --show")}          \u663E\u793A\u5F53\u524D\u914D\u7F6E`);
+      console.log(`  ${pc7.dim("spec-go config --path")}          \u663E\u793A\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84`);
       console.log();
     }
   });
   program.command("update").description("\u68C0\u67E5\u5E76\u66F4\u65B0\u5230\u6700\u65B0\u7248\u672C").option("--check", "\u4EC5\u68C0\u67E5\u7248\u672C\uFF0C\u4E0D\u6267\u884C\u66F4\u65B0").action(async (options) => {
     await runUpdate(version, options.check ?? false);
   });
+  program.command("guide [topic]").description("\u663E\u793A\u4F7F\u7528\u6307\u5357\u548C\u5E2E\u52A9\u6587\u6863").option("--list", "\u5217\u51FA\u6240\u6709\u53EF\u7528\u4E3B\u9898").option("--json", "\u4EE5 JSON \u683C\u5F0F\u8F93\u51FA").action(async (topic, options) => {
+    await runGuide(topic, options);
+  });
   return program;
 }
 async function executeProject(options) {
   const templateConfig = await scaffoldProject(options);
-  console.log(pc6.green("\u2714 \u9879\u76EE\u6587\u4EF6\u5DF2\u751F\u6210"));
+  console.log(pc7.green("\u2714 \u9879\u76EE\u6587\u4EF6\u5DF2\u751F\u6210"));
   if (!options.noInstall && templateConfig) {
     if (templateConfig.type === "workspace") {
-      await runWorkspacePostInit(options.targetDir, templateConfig);
-      console.log(pc6.green("\u2714 \u4F9D\u8D56\u5B89\u88C5\u5B8C\u6210"));
+      await runWorkspacePostInit(options.targetDir, templateConfig, { logger: consoleLogger });
+      console.log(pc7.green("\u2714 \u4F9D\u8D56\u5B89\u88C5\u5B8C\u6210"));
     } else if (templateConfig.postInit) {
-      await runPostInit(options.targetDir, templateConfig.postInit);
-      console.log(pc6.green("\u2714 \u4F9D\u8D56\u5B89\u88C5\u5B8C\u6210"));
+      await runPostInit(options.targetDir, templateConfig.postInit, { logger: consoleLogger });
+      console.log(pc7.green("\u2714 \u4F9D\u8D56\u5B89\u88C5\u5B8C\u6210"));
     }
   }
   if (options.initGit) {
     await initGit(options.targetDir);
-    console.log(pc6.green("\u2714 Git \u4ED3\u5E93\u5DF2\u521D\u59CB\u5316"));
+    console.log(pc7.green("\u2714 Git \u4ED3\u5E93\u5DF2\u521D\u59CB\u5316"));
   }
   if (options.createGithub) {
-    const repoUrl = await createGithubRepo(
-      options.projectName,
-      options.targetDir,
-      options.isPublic
-    );
+    const repoUrl = await createGithubRepo({
+      repoName: options.projectName,
+      targetDir: options.targetDir,
+      isPublic: options.isPublic,
+      logger: consoleLogger
+    });
     if (repoUrl) {
-      console.log(pc6.green(`\u2714 GitHub \u4ED3\u5E93\u5DF2\u521B\u5EFA: ${pc6.cyan(repoUrl)}`));
+      console.log(pc7.green(`\u2714 GitHub \u4ED3\u5E93\u5DF2\u521B\u5EFA: ${pc7.cyan(repoUrl)}`));
     }
   }
   console.log();
@@ -939,21 +1354,21 @@ async function executeProject(options) {
   const cdCmd = options.targetDir !== process.cwd() ? `cd ${options.projectName} && ` : "";
   if (templateConfig?.type === "workspace") {
     if (pm === "pnpm") {
-      console.log(pc6.dim(`  ${cdCmd}pnpm dev`));
+      console.log(pc7.dim(`  ${cdCmd}pnpm dev`));
     } else {
-      console.log(pc6.dim(`  ${cdCmd}make dev`));
+      console.log(pc7.dim(`  ${cdCmd}make dev`));
     }
   } else if (pm === "maven") {
-    console.log(pc6.dim(`  ${cdCmd}./mvnw spring-boot:run`));
+    console.log(pc7.dim(`  ${cdCmd}./mvnw spring-boot:run`));
   } else if (pm === "gradle") {
-    console.log(pc6.dim(`  ${cdCmd}./gradlew bootRun`));
+    console.log(pc7.dim(`  ${cdCmd}./gradlew bootRun`));
   } else {
-    console.log(pc6.dim(`  ${cdCmd}${pm} dev`));
+    console.log(pc7.dim(`  ${cdCmd}${pm} dev`));
   }
   console.log();
 }
 
-// src/index.ts
+// src/cli/index.ts
 async function main() {
   ensureConfigExists();
   const program = await createCli();