@longzai-intelligence-issues/cli 0.0.1

package/src/commands/gate.commands.ts

@@ -0,0 +1,259 @@
+import type { Command } from '@longzai-intelligence-cli/core';
+
+import { defineCommand } from '@longzai-intelligence-cli/core';
+import {
+  runDocsCheck,
+  runHealth,
+  runLint,
+  runNumberingAudit,
+  runNumberingCheck,
+  runNumberingNext,
+  runTriage,
+  runWriteDocsBaseline,
+  runWriteLintBaseline,
+} from '@longzai-intelligence-issues/ledger';
+import { writeFileSync } from 'node:fs';
+import * as z from 'zod';
+
+import { fail, info, loadConfigOrExit, ok, repoRoot, violation } from './context.utils.js';
+
+/**
+ * 门禁与观测命令组：lint / numbering / docs / health / triage
+ *
+ * 判据口径：exit 0 过 / exit 1 违规（报文逐条输出后退出）。
+ */
+export function registerGateCommands(program: Command): void {
+  defineCommand(program, {
+    name: 'lint',
+    description: '注册表 lint（12 核心规则 + 棘轮基线三态）',
+    options: [
+      { flags: '--dir <dir>', description: '限定注册表目录（可重复）' },
+      { flags: '--strict-legacy', description: '旧格式状态行一并计违规' },
+      { flags: '--write-baseline', description: '再生棘轮基线（须配 --issue）' },
+      { flags: '--issue <issue>', description: '收编指针（write-baseline 必填）' },
+      { flags: '--config <path>', description: '显式配置路径' },
+    ],
+    schema: z
+      .object({
+        dir: z.union([z.string(), z.array(z.string())]).optional(),
+        strictLegacy: z.boolean().optional(),
+        writeBaseline: z.boolean().optional(),
+        issue: z.string().optional(),
+        config: z.string().optional(),
+      })
+      .passthrough(),
+    action: async (opts) => {
+      const root = repoRoot();
+      const { config, configFilePath } = await loadConfigOrExit(opts.config);
+
+      /**
+       * 限定目录归一
+       */
+      const dirRels = opts.dir === undefined ? undefined : Array.isArray(opts.dir) ? opts.dir : [opts.dir];
+
+      /**
+       * strictLegacy 覆盖（命令级旗标优先）
+       */
+      const effective = opts.strictLegacy === true ? { ...config, lint: { ...config.lint, strictLegacy: true } } : config;
+
+      if (opts.writeBaseline === true) {
+        const regen = runWriteLintBaseline({ root, config: effective, issuePointer: opts.issue ?? '' });
+
+        if (!regen.ok) {
+          fail(regen.error);
+        }
+
+        writeFileSync(configFilePath, regen.content);
+        ok(`基线已再生（${regen.entryCount} 条，收编指针 ${opts.issue}）——棘轮只许缩短`);
+        return;
+      }
+
+      const result = runLint({ root, config: effective, dirRels });
+
+      for (const v of result.violations) {
+        violation(`${v.file}:${v.line} [${v.rule}] ${v.message}`);
+      }
+
+      if (result.violations.length > 0) {
+        process.stderr.write(`错误: issues:lint ${result.violations.length} 项违规｜存量豁免 ${result.suppressed}｜基线 ${result.baselineCount} 条\n`);
+        process.exit(1);
+      }
+
+      ok(`issues:lint 通过（0 新增违规｜存量豁免 ${result.suppressed}｜基线 ${result.baselineCount} 条）`);
+    },
+  });
+
+  /**
+   * numbering 三子命令
+   */
+  const numberingSchema = z
+    .object({
+      scope: z.string().optional(),
+      dir: z.string().optional(),
+      config: z.string().optional(),
+    })
+    .passthrough();
+
+  /**
+   * numbering 父命令（子命令 next/check/audit）
+   */
+  const numbering = program.command('numbering').description('编号门禁（next 取号 / check 判定 / audit 覆盖面审计）');
+
+  defineCommand(numbering, {
+    name: 'next',
+    description: '取号（--scope <key> 或 --dir <目录> 互斥；只读不写）',
+    options: [
+      { flags: '--scope <scope>', description: '目标 scope key' },
+      { flags: '--dir <dir>', description: '目标注册表目录' },
+      { flags: '--config <path>', description: '显式配置路径' },
+    ],
+    schema: numberingSchema,
+    action: async (opts) => {
+      const root = repoRoot();
+      const { config } = await loadConfigOrExit(opts.config);
+
+      const result = runNumberingNext({ root, config, scopeKey: opts.scope, dirRel: opts.dir });
+
+      if (!result.ok) {
+        fail(result.error);
+      }
+
+      info(`${result.target} 下一可用编号：${result.number}（已跳过保留号与已占用号）`);
+    },
+  });
+
+  defineCommand(numbering, {
+    name: 'check',
+    description: '编号门禁判定（缺省全量；--dir 目录增量）',
+    options: [
+      { flags: '--dir <dir>', description: '目录增量档' },
+      { flags: '--config <path>', description: '显式配置路径' },
+    ],
+    schema: numberingSchema,
+    action: async (opts) => {
+      const root = repoRoot();
+      const { config } = await loadConfigOrExit(opts.config);
+
+      const result = runNumberingCheck({ root, config, dirRel: opts.dir });
+
+      for (const f of result.findings) {
+        violation(`[${f.kind}] ${f.message}`);
+      }
+
+      if (result.findings.length > 0) {
+        process.stderr.write(`错误: numbering:check ${result.findings.length} 项违规（scope ${result.scopeCount} 个 / 扫描面 ${result.scannedFiles} 文件）\n`);
+        process.exit(1);
+      }
+
+      ok(`numbering:check 通过（scope ${result.scopeCount} 个 / 扫描面 ${result.scannedFiles} 文件 / 零违规）`);
+    },
+  });
+
+  defineCommand(numbering, {
+    name: 'audit',
+    description: '覆盖面审计（未登记编号区 / pending 失效）',
+    options: [{ flags: '--config <path>', description: '显式配置路径' }],
+    schema: numberingSchema,
+    action: async (opts) => {
+      const root = repoRoot();
+      const { config } = await loadConfigOrExit(opts.config);
+
+      const result = runNumberingAudit({ root, config });
+
+      for (const f of result.findings) {
+        violation(`[${f.kind}] ${f.message}`);
+      }
+
+      if (result.findings.length > 0) {
+        process.stderr.write(`错误: numbering:audit ${result.findings.length} 项违规（扫描面 ${result.scannedFiles} 文件）\n`);
+        process.exit(1);
+      }
+
+      ok(`numbering:audit 通过（扫描面 ${result.scannedFiles} 文件 / 零未登记编号区）`);
+    },
+  });
+
+  /**
+   * docs 两子命令
+   */
+  /**
+   * docs 父命令（子命令 check / fix）
+   */
+  const docs = program.command('docs').description('文档 issue 引用检查与机械修复');
+
+  defineCommand(docs, {
+    name: 'check',
+    description: '文档 issue 引用检查（不完整 slug 前缀唯一解析 / 棘轮基线）',
+    options: [
+      { flags: '--write-baseline', description: '再生 docs 基线（须配 --issue）' },
+      { flags: '--issue <issue>', description: '收编指针' },
+      { flags: '--config <path>', description: '显式配置路径' },
+    ],
+    schema: z.object({ writeBaseline: z.boolean().optional(), issue: z.string().optional(), config: z.string().optional() }).passthrough(),
+    action: async (opts) => {
+      const root = repoRoot();
+      const { config, configFilePath } = await loadConfigOrExit(opts.config);
+
+      if (opts.writeBaseline === true) {
+        try {
+          const regen = runWriteDocsBaseline({ root, config, issuePointer: opts.issue ?? '' });
+
+          if (!regen.ok) {
+            fail(regen.error);
+          }
+
+          writeFileSync(configFilePath, regen.content);
+          ok(`docs 基线已再生（${regen.entryCount} 条）`);
+          return;
+        } catch (error) {
+          fail(error instanceof Error ? error.message : String(error));
+        }
+      }
+
+      try {
+        const result = runDocsCheck({ root, config });
+
+        for (const v of result.violations) {
+          violation(`${v.file}:${v.line} [${v.rule}] ${v.message}`);
+        }
+
+        if (result.violations.length > 0) {
+          process.stderr.write(`错误: docs:check ${result.violations.length} 项违规（扫描面 ${result.scannedFiles} 文件 / 豁免 ${result.suppressed}）\n`);
+          process.exit(1);
+        }
+
+        ok(`docs:check 通过（扫描面 ${result.scannedFiles} 文件 / 零违规）`);
+      } catch (error) {
+        fail(error instanceof Error ? error.message : String(error));
+      }
+    },
+  });
+
+  defineCommand(program, {
+    name: 'health',
+    description: '黄灯巡检（状态分布 / 最老账龄 / A-B-C 分类，JSON）',
+    options: [{ flags: '--config <path>', description: '显式配置路径' }],
+    schema: z.object({ config: z.string().optional() }).passthrough(),
+    action: async (opts) => {
+      const root = repoRoot();
+      const { config } = await loadConfigOrExit(opts.config);
+
+      process.stdout.write(`${JSON.stringify(runHealth({ root, config }), null, 2)}\n`);
+    },
+  });
+
+  defineCommand(program, {
+    name: 'triage',
+    description: '黄灯分诊台账（append-only 落 .lzi/issues/runs/ledger/）',
+    options: [{ flags: '--config <path>', description: '显式配置路径' }],
+    schema: z.object({ config: z.string().optional() }).passthrough(),
+    action: async (opts) => {
+      const root = repoRoot();
+      const { config } = await loadConfigOrExit(opts.config);
+
+      const { ledgerPath, ledger } = runTriage({ root, config });
+
+      ok(`issues:triage 台账已落盘: ${ledgerPath}（黄灯 ${ledger.items.length} 项）`);
+    },
+  });
+}

package/src/commands/index.ts

@@ -0,0 +1,29 @@
+/**
+ * 命令注册入口
+ *
+ * 四组：脚手架（init/template）、议题（create/list/show）、门禁与观测
+ * （lint/numbering/docs/health/triage）、收口与冻结（verify-close/freeze/
+ * unfreeze/normalize-header/prompts）。
+ */
+
+import type { Command } from '@longzai-intelligence-cli/core';
+
+import { registerCloseCommands } from './close.commands.js';
+import { registerGateCommands } from './gate.commands.js';
+import { registerIssueCommands } from './issue.commands.js';
+import { registerScaffoldCommands } from './scaffold.commands.js';
+
+/**
+ * 注册全部命令
+ *
+ * @param program - CLI 程序实例
+ */
+export function registerCommands(program: Command): void {
+  registerScaffoldCommands(program);
+
+  registerIssueCommands(program);
+
+  registerGateCommands(program);
+
+  registerCloseCommands(program);
+}

package/src/commands/issue.commands.ts

@@ -0,0 +1,252 @@
+import type { Command } from '@longzai-intelligence-cli/core';
+
+import { defineCommand } from '@longzai-intelligence-cli/core';
+import { renderIssueTemplate } from '@longzai-intelligence-issues/ledger';
+import { runNumberingNext, scanRegistryDir } from '@longzai-intelligence-issues/ledger';
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import * as z from 'zod';
+
+import { fail, info, loadConfigOrExit, ok, repoRoot, resolveScopeFromCwd } from './context.utils.js';
+
+/**
+ * create / list / show 命令组：建档与查询
+ */
+export function registerIssueCommands(program: Command): void {
+  defineCommand(program, {
+    name: 'create',
+    description: '建档（门禁取号 → 标准模板落盘 → 编号自检）',
+    options: [
+      { flags: '--title <title>', description: '一句话标题（必填）' },
+      { flags: '--slug <slug>', description: 'slug（缺省由标题派生）' },
+      { flags: '--priority <priority>', description: 'P1 | P2 | P3（缺省 P2）' },
+      { flags: '--type <type>', description: '议题类型（缺省 task）' },
+      { flags: '--scope <scope>', description: 'scope key（缺省按 cwd 解析）' },
+      { flags: '--source <source>', description: '来源说明' },
+      { flags: '--dry-run', description: '只呈现不落盘' },
+      { flags: '--config <path>', description: '显式配置路径' },
+    ],
+    schema: z
+      .object({
+        title: z.string(),
+        slug: z.string().optional(),
+        priority: z.string().optional(),
+        type: z.string().optional(),
+        scope: z.string().optional(),
+        source: z.string().optional(),
+        dryRun: z.boolean().optional(),
+        config: z.string().optional(),
+      })
+      .passthrough(),
+    action: async (opts) => {
+      /**
+       * 仓库根与配置
+       */
+      const root = repoRoot();
+      const { config } = await loadConfigOrExit(opts.config);
+
+      /**
+       * scope key（显式 > cwd 最长前缀 > 全部列出退出）
+       */
+      const cwdRel = relative(root, process.cwd());
+      const scopeKey =
+        opts.scope ??
+        resolveScopeFromCwd(config, cwdRel) ??
+        fail(`cwd「${cwdRel}」未命中任何 scope 覆盖面——候选：${config.scopes.map((s) => s.key).join('、')}（或显式 --scope）`);
+
+      /**
+       * 目标 scope
+       */
+      const scope = config.scopes.find((s) => s.key === scopeKey) ?? fail(`scope「${scopeKey}」未登记`);
+
+      /**
+       * 写入时刻取号（落盘前现算最新值）
+       */
+      const next = runNumberingNext({ root, config, scopeKey });
+
+      if (!next.ok) {
+        fail(next.error);
+      }
+
+      /**
+       * slug（缺省标题派生 kebab）
+       */
+      /**
+       * slug（缺省由标题派生 ASCII kebab——中文标题无法派生，须显式 --slug）
+       */
+      const derivedSlug =
+        opts.slug ??
+        opts.title
+          .toLowerCase()
+          .replace(/[\s_]+/g, '-')
+          .replace(/[^a-z0-9-]/g, '')
+          .replace(/-+/g, '-')
+          .replace(/^-|-$/g, '');
+
+      const slug = /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(derivedSlug)
+        ? derivedSlug
+        : fail('slug 须为纯 ASCII kebab（小写字母/数字/连字符，禁中文）——中文标题请显式提供 --slug <slug>');
+
+      /**
+       * 标准模板落盘（instance 渲染）
+       */
+      const content = renderIssueTemplate({
+        number: next.ok ? next.number : '0001',
+        slug,
+        title: opts.title,
+        priority: (opts.priority === 'P1' || opts.priority === 'P3' ? opts.priority : 'P2') as 'P1' | 'P2' | 'P3',
+        scopeTitle: scope.title,
+        date: new Date().toISOString().slice(0, 10),
+        source: opts.source ?? 'CLI 建档',
+      });
+
+      /**
+       * 文件路径（注册表目录缺席自创建——init 的轻量等价）
+       */
+      const registryAbs = join(root, scope.registryDir);
+      const filePath = join(registryAbs, `${next.ok ? next.number : '0001'}-${slug}.md`);
+
+      if (opts.dryRun === true) {
+        info(`（dry-run）将落盘：${relative(root, filePath)}`);
+        process.stdout.write(content);
+        return;
+      }
+
+      mkdirSync(registryAbs, { recursive: true });
+
+      if (existsSync(filePath)) {
+        fail(`文件已存在：${filePath}`);
+      }
+
+      writeFileSync(filePath, content);
+      ok(`已建档：${relative(root, filePath)}`);
+
+      /**
+       * 落盘后目录增量自检
+       */
+      const check = runNumberingNext({ root, config, scopeKey });
+
+      info(`编号自检：下一可用编号 ${check.ok ? check.number : '—'}（${scope.registryDir} 目录口径）`);
+
+      /**
+       * 编号撞号即让号提示
+       */
+      const duplicates = scanRegistryDir(registryAbs).length;
+      void duplicates;
+    },
+  });
+
+  defineCommand(program, {
+    name: 'list',
+    description: '列出注册表 issue（按 scope 分组）',
+    options: [
+      { flags: '--scope <scope>', description: '限定 scope' },
+      { flags: '--status <status>', description: '限定状态灯位（red/yellow/green/frozen/canceled）' },
+      { flags: '--config <path>', description: '显式配置路径' },
+    ],
+    schema: z.object({ scope: z.string().optional(), status: z.string().optional(), config: z.string().optional() }).passthrough(),
+    action: async (opts) => {
+      const root = repoRoot();
+      const { config } = await loadConfigOrExit(opts.config);
+
+      for (const scope of config.scopes) {
+        if (opts.scope !== undefined && scope.key !== opts.scope) {
+          continue;
+        }
+
+        /**
+         * 注册表记录
+         */
+        const records = scanRegistryDir(join(root, scope.registryDir));
+
+        /**
+         * 状态过滤
+         */
+        const filtered = opts.status === undefined ? records : records.filter((r) => r.status === opts.status);
+
+        process.stdout.write(`# ${scope.key}（${scope.title}）— ${filtered.length} 项\n`);
+
+        for (const record of filtered) {
+          process.stdout.write(`${record.id} ${record.status.padEnd(7)} ${record.title}\n`);
+        }
+      }
+    },
+  });
+
+  defineCommand(program, {
+    name: 'show',
+    description: '展示单份 issue（ref 支持 编号 / 编号-slug / 不完整前缀；多义列候选）',
+    arguments: [{ signature: '<ref>', description: 'issue 引用' }],
+    options: [{ flags: '--config <path>', description: '显式配置路径' }],
+    schema: z.object({ ref: z.string() }).passthrough(),
+    action: async (rawOpts) => {
+      /**
+       * 位置参数（defineCommand 位置参数注入 opts）
+       */
+      const opts = rawOpts as unknown as { ref?: string; config?: string; _: string[] };
+
+      /**
+       * ref 取值（位置参数或 ref 字段）
+       */
+      const ref = opts.ref ?? opts._?.[0] ?? fail('缺少 issue 引用（show <ref>）');
+
+      const root = repoRoot();
+      const { config } = await loadConfigOrExit(opts.config);
+
+      /**
+       * ref 解析（编号 / 编号-slug）
+       */
+      const match = /^(\d{3,4})(?:-([a-z0-9-]+))?$/.exec(ref);
+
+      if (match === null) {
+        fail(`引用「${ref}」不合法（编号或 编号-slug 形态）`);
+      }
+
+      /**
+       * 全 scope 候选收集
+       */
+      const candidates: Array<{ scopeKey: string; file: string; slug: string; title: string; record: ReturnType<typeof scanRegistryDir>[number] }> = [];
+
+      for (const scope of config.scopes) {
+        for (const record of scanRegistryDir(join(root, scope.registryDir))) {
+          if (record.id === match[1] && (match[2] === undefined || record.slug === match[2])) {
+            candidates.push({ scopeKey: scope.key, file: `${scope.registryDir}/${record.file}`, slug: record.slug, title: record.title, record });
+          }
+        }
+      }
+
+      if (candidates.length === 0) {
+        /**
+         * 前缀兜底（不完整 slug 唯一命中）
+         */
+        for (const scope of config.scopes) {
+          for (const record of scanRegistryDir(join(root, scope.registryDir))) {
+            if (record.id === match[1] && match[2] !== undefined && record.slug.startsWith(match[2])) {
+              candidates.push({ scopeKey: scope.key, file: `${scope.registryDir}/${record.file}`, slug: record.slug, title: record.title, record });
+            }
+          }
+        }
+      }
+
+      if (candidates.length === 0) {
+        fail(`引用「${ref}」无命中`);
+      }
+
+      if (candidates.length > 1) {
+        process.stderr.write(`错误: 引用「${ref}」命中不唯一——候选：\n`);
+        for (const c of candidates) {
+          process.stderr.write(`  ${c.scopeKey}/${c.record.id}-${c.slug}（${c.file}）\n`);
+        }
+        process.exit(1);
+      }
+
+      /**
+       * 唯一命中输出全文
+       */
+      const hit = candidates[0]!;
+
+      info(`命中：${hit.scopeKey} ${hit.file}`);
+      process.stdout.write(hit.record.rawContent);
+    },
+  });
+}

package/src/commands/scaffold.commands.ts

@@ -0,0 +1,140 @@
+import type { Command } from '@longzai-intelligence-cli/core';
+
+import { defineCommand } from '@longzai-intelligence-cli/core';
+import { appendScopeToConfigText, renderConfigScaffoldFile } from '@longzai-intelligence-issues/config';
+import { TEMPLATE_FIELDS, renderCriteriaBlockExample, renderIssueTemplateSkeleton, renderRegistryReadmeStub } from '@longzai-intelligence-issues/ledger';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import * as z from 'zod';
+
+import { fail, info, loadConfigOrExit, ok, repoRoot } from './context.utils.js';
+
+/**
+ * init / template 命令组：标准格式的「提供 + 初始化」入口
+ */
+export function registerScaffoldCommands(program: Command): void {
+  defineCommand(program, {
+    name: 'init',
+    description: '初始化 lzi-issues：生成/追加 lzi-issues.config.ts、创建注册表目录并落格式存根',
+    options: [
+      { flags: '--key <key>', description: 'scope key（缺省按 package.json 名推导）' },
+      { flags: '--title <title>', description: 'scope 人类可读名' },
+      { flags: '--registry-dir <dir>', description: '注册表目录（缺省 docs/issues）' },
+      { flags: '--paths <paths...>', description: '覆盖路径 glob（缺省 .）' },
+    ],
+    schema: z
+      .object({
+        key: z.string().optional(),
+        title: z.string().optional(),
+        registryDir: z.string().optional(),
+        paths: z.array(z.string()).optional(),
+      })
+      .passthrough(),
+    action: async (opts) => {
+      /**
+       * 仓库根
+       */
+      const root = repoRoot();
+
+      /**
+       * 配置文件路径
+       */
+      const configPath = join(root, 'lzi-issues.config.ts');
+
+      /**
+       * scope key 推导（显式 > package.json 名 > 目录名）
+       */
+      const key =
+        opts.key ??
+        (existsSync(join(root, 'package.json'))
+          ? (() => {
+              try {
+                /**
+                 * package.json 名
+                 */
+                const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8')) as { name?: string };
+
+                return (pkg.name ?? 'root').replace(/^@[^/]+\//, '').replace(/[^a-z0-9-]/g, '-');
+              } catch {
+                return 'root';
+              }
+            })()
+          : 'root');
+
+      /**
+       * scope 入参
+       */
+      const scope = {
+        key,
+        title: opts.title ?? `${key} 域`,
+        paths: opts.paths ?? ['.'],
+        registryDir: opts.registryDir ?? 'docs/issues',
+      };
+
+      if (existsSync(configPath)) {
+        /**
+         * 追加模式（不动其他节）
+         */
+        try {
+          const appended = appendScopeToConfigText(readFileSync(configPath, 'utf8'), scope);
+          writeFileSync(configPath, appended);
+          info(`已追加 scope「${key}」到 ${configPath}`);
+        } catch (error) {
+          fail(error instanceof Error ? error.message : String(error));
+        }
+      } else {
+        writeFileSync(configPath, renderConfigScaffoldFile(scope));
+        ok(`已生成 ${configPath}`);
+      }
+
+      /**
+       * 注册表目录 + README 存根
+       */
+      const registryAbs = join(root, scope.registryDir);
+      const readmePath = join(registryAbs, 'README.md');
+
+      mkdirSync(registryAbs, { recursive: true });
+
+      if (!existsSync(readmePath)) {
+        writeFileSync(readmePath, renderRegistryReadmeStub(scope.title, '../../docs/guides/issue-file-format.md'));
+        ok(`已创建注册表目录 ${scope.registryDir} 并落格式存根 README.md`);
+      } else {
+        info(`注册表 README 已存在，跳过（幂等不覆盖）`);
+      }
+
+      ok('后续：lzi-issues template 查看标准模板；lzi-issues create --title <标题> 建档');
+    },
+  });
+
+  defineCommand(program, {
+    name: 'template',
+    description: '输出 issue 标准格式模板（--with-criteria 附判据块示例）',
+    options: [
+      { flags: '--with-criteria', description: '附 criteria 判据块示例' },
+      { flags: '--format <format>', description: 'text | json（json 返回字段契约）' },
+    ],
+    schema: z.object({ withCriteria: z.boolean().optional(), format: z.string().optional() }).passthrough(),
+    action: async (opts) => {
+      /**
+       * 骨架全文（渲染真源产物）
+       */
+      const skeleton = renderIssueTemplateSkeleton();
+
+      if (opts.format === 'json') {
+        process.stdout.write(`${JSON.stringify({ template: skeleton, fields: TEMPLATE_FIELDS }, null, 2)}\n`);
+        return;
+      }
+
+      process.stdout.write(skeleton);
+
+      if (opts.withCriteria === true) {
+        process.stdout.write(`\n${renderCriteriaBlockExample()}`);
+      }
+    },
+  });
+
+  /**
+   * 保留 context.utils 的导入占位使用（loadConfigOrExit 在 init 不需要配置——生成方）
+   */
+  void loadConfigOrExit;
+}