@openprd/cli 0.1.9 → 0.1.10

package/src/cli/args.js

@@ -19,7 +19,7 @@
  */
 function parseCommandArgs(argv) {
   const args = [...argv];
-  const flags = { json: false, force: false, fix: false, open: false, append: false, init: false, check: false, review: false, reject: false, resume: false, advance: false, verify: false, evidenceRequired: false, next: false, generate: false, validate: false, apply: false, archive: false, activate: false, close: false, keep: false, write: false, dryRun: false, repairAgent: false, fleet: false, updateOpenprd: false, backfillWorkUnits: false, syncRegistry: false, setupMissing: false, doctor: false, context: false, recordHook: false, hookInject: false, plan: false, prompt: false, loopRun: false, finish: false, commit: false, html: false, template: false, failOnViolation: false, mark: null, type: 'architecture', mode: 'auto', input: null, field: null, value: null, set: null, jsonFile: null, artifactMarkdown: null, contentJson: null, presentation: null, source: null, reference: null, actual: null, before: null, after: null, board: null, out: null, format: null, quality: null, maxPanelWidth: null, referenceLabel: null, actualLabel: null, classifyExternal: null, maxIterations: null, maxDepth: null, include: null, exclude: null, report: null, item: null, id: null, status: null, claim: null, notes: null, reason: null, confidence: null, threshold: null, change: null, tools: 'all', hookProfile: null, templatePack: null, target: 'openprd', targetRoot: null, path: null, productType: null, title: null, owner: null, problem: null, whyNow: null, evidence: null, from: null, to: null, version: null, digest: null, workUnit: null, event: null, risk: null, outcome: null, preview: null, learn: null, genre: null, style: null, topic: null, enable: false, disable: false, agent: 'codex', agentCommand: null, message: null };
+  const flags = { json: false, force: false, fix: false, open: false, append: false, init: false, check: false, review: false, reject: false, resume: false, advance: false, verify: false, evidenceRequired: false, next: false, generate: false, validate: false, apply: false, archive: false, activate: false, close: false, keep: false, write: false, dryRun: false, repairAgent: false, allowDirtyMain: false, fleet: false, updateOpenprd: false, backfillWorkUnits: false, syncRegistry: false, setupMissing: false, doctor: false, context: false, recordHook: false, hookInject: false, plan: false, prompt: false, loopRun: false, finish: false, commit: false, html: false, template: false, failOnViolation: false, noExternalFacts: false, noBrandAssets: false, noRealImages: false, mark: null, type: 'architecture', mode: 'auto', input: null, field: null, value: null, set: null, jsonFile: null, artifactMarkdown: null, contentJson: null, presentation: null, source: null, reference: null, actual: null, before: null, after: null, board: null, grid: null, boxes: null, out: null, format: null, quality: null, maxPanelWidth: null, referenceLabel: null, actualLabel: null, classifyExternal: null, maxIterations: null, maxDepth: null, include: null, exclude: null, report: null, item: null, id: null, status: null, claim: null, notes: null, reason: null, confidence: null, threshold: null, change: null, starter: null, sections: null, brief: null, tools: 'all', hookProfile: null, templatePack: null, target: 'openprd', targetRoot: null, path: null, productType: null, title: null, owner: null, problem: null, whyNow: null, evidence: null, from: null, to: null, version: null, digest: null, workUnit: null, event: null, risk: null, outcome: null, preview: null, learn: null, genre: null, style: null, topic: null, enable: false, disable: false, agent: 'codex', agentCommand: null, worktree: null, branch: null, message: null };
   const positionals = [];
 
   while (args.length > 0) {
@@ -120,6 +120,10 @@ function parseCommandArgs(argv) {
       flags.repairAgent = true;
       continue;
     }
+    if (arg === '--allow-dirty-main') {
+      flags.allowDirtyMain = true;
+      continue;
+    }
     if (arg === '--fleet') {
       flags.fleet = true;
       continue;
@@ -220,6 +224,14 @@ function parseCommandArgs(argv) {
       flags.agentCommand = args.shift() ?? null;
       continue;
     }
+    if (arg === '--worktree') {
+      flags.worktree = args.shift() ?? null;
+      continue;
+    }
+    if (arg === '--branch') {
+      flags.branch = args.shift() ?? null;
+      continue;
+    }
     if (arg === '--product-type' || arg === '-P') {
       flags.productType = args.shift() ?? null;
       continue;
@@ -288,6 +300,14 @@ function parseCommandArgs(argv) {
       flags.board = args.shift() ?? null;
       continue;
     }
+    if (arg === '--grid') {
+      flags.grid = args.shift() ?? null;
+      continue;
+    }
+    if (arg === '--boxes') {
+      flags.boxes = args.shift() ?? null;
+      continue;
+    }
     if (arg === '--out') {
       flags.out = args.shift() ?? null;
       continue;
@@ -372,6 +392,30 @@ function parseCommandArgs(argv) {
       flags.change = args.shift() ?? null;
       continue;
     }
+    if (arg === '--starter') {
+      flags.starter = args.shift() ?? null;
+      continue;
+    }
+    if (arg === '--brief') {
+      flags.brief = args.shift() ?? null;
+      continue;
+    }
+    if (arg === '--sections') {
+      flags.sections = args.shift() ?? null;
+      continue;
+    }
+    if (arg === '--no-external-facts') {
+      flags.noExternalFacts = true;
+      continue;
+    }
+    if (arg === '--no-brand-assets') {
+      flags.noBrandAssets = true;
+      continue;
+    }
+    if (arg === '--no-real-images') {
+      flags.noRealImages = true;
+      continue;
+    }
     if (arg === '--title') {
       flags.title = args.shift() ?? null;
       continue;
@@ -478,26 +522,30 @@ function usage() {
     '  openprd init [path] [--template-pack <base|consumer|b2b|agent>] [--tools <all|codex,claude,cursor>] [--hook-profile <lite|guarded|full>] [--force]',
     '  openprd setup [path] [--tools <all|codex,claude,cursor>] [--hook-profile <lite|guarded|full>] [--force] [--json]',
     '  openprd update [path] [--tools <all|codex,claude,cursor>] [--hook-profile <lite|guarded|full>] [--force] [--json]',
-    '  openprd self-update [--dry-run] [--json]',
+    '  openprd self-update [--check] [--dry-run] [--json]',
     '  openprd upgrade [path] [--fleet] [--dry-run] [--tools <all|codex,claude,cursor>] [--hook-profile <lite|guarded|full>] [--max-depth <n>] [--include <csv>] [--exclude <csv>] [--report <file>] [--force] [--json]',
     '  openprd doctor [path] [--tools <all|codex,claude,cursor>] [--hook-profile <lite|guarded|full>] [--fix] [--json]',
     '  openprd fleet <root> [--dry-run|--doctor|--update-openprd|--backfill-work-units|--sync-registry|--setup-missing] [--hook-profile <lite|guarded|full>] [--max-depth <n>] [--include <csv>] [--exclude <csv>] [--report <file>] [--json]',
     '  openprd run [path] [--context|--verify|--record-hook --event <name> --risk <level> --outcome <text> --preview <text>] [--message <text>] [--json]',
-    '  openprd loop [path] [--init|--plan|--next|--prompt|--run|--verify|--finish] [--change <id>] [--item <task-id-or-handle>] [--agent <codex|claude>] [--agent-command <cmd>] [--repair-agent] [--commit] [--dry-run] [--message <text>] [--json]',
+    '  openprd loop [path] [--init|--plan|--next|--prompt|--run|--verify|--finish] [--change <id>] [--item <task-id-or-handle>] [--agent <codex|claude>] [--agent-command <cmd>] [--repair-agent] [--worktree <path>] [--branch <name>] [--allow-dirty-main] [--commit] [--dry-run] [--message <text>] [--json]',
     '  openprd classify [path] <consumer|b2b|agent>',
     '  openprd clarify [path] [--mode <auto|inline|inline-with-checklist>] [--json]',
     '  openprd capture [path] (--field <section.path> --value <text|json> | --json-file <answers.json> | --artifact-markdown <artifact.md>) [--source <user-confirmed|project-derived|agent-inferred|agent-normalized>] [--append] [--json]',
     '  openprd interview [path] [--product-type <consumer|b2b|agent>]',
     '  openprd playground [path] [--open] [--json]',
+    '  openprd brainstorm [path] [--topic <text>] [--open] [--json]',
     '  openprd learn [path] [--topic <text>] [--genre <internet-product|scientific|fairy-tale|web-novel|xianxia>] [--style <substyle>] [--source <workspace|docs|loop|all>] [--content-json <file>] [--open] [--enable|--disable] [--json]',
     '  openprd quality [path] [--init|--verify|--report --html|--learn [--review] --from <report-id-or-json-or-diagnostics-or-turn-state>] [--force] [--json]',
     '  openprd knowledge <candidates|reject|archive|restore> [path-or-id] [--status <pending-review|all|rejected|archived|promoted|merged>] [--id <candidate-id>] [--reason <text>] [--json]',
+    '  openprd visual-prepare [path] --reference <effect-image> ((--grid <columns>x<rows>) | (--boxes <plan.json>)) [--include <csv>] [--id <reference-set-id>] [--title <text>] [--out <dir>] [--json]',
     '  openprd visual-compare [path] ((--reference <effect-image> --actual <screenshot-image>) | (--before <before-screenshot> --after <after-screenshot>) | --board <board.json>) [--out <file.jpg>] [--format <jpg|png|webp>] [--quality <1..100>] [--max-panel-width <px>] [--json]',
+    '  openprd design-starter [path] [--starter <content-home|product-launch|ops-dashboard>] [--out <index.html>] [--title <name>] [--brief <text>] [--sections <a|b|c>] [--no-external-facts] [--no-brand-assets] [--no-real-images] [--force] [--json]',
     '  openprd dev-check [path] <file...> [--json]',
     '  openprd grow [path] [--review|--apply --id <candidate-id>|--reject --id <candidate-id>|--init|--check] [--notes <text>] [--json]',
     '  openprd benchmark <add|observe|list|approve|verify> [target-or-id] [path-for-list-or-verify] [--path <project>] [--notes <text>] [--threshold <n>] [--id <benchmark-id>] [--json]',
     '  openprd synthesize [path] [--title <text>] [--owner <text>] [--problem <text>] [--why-now <text>] [--work-unit <id>] [--target-root <path>] [--open] [--json]',
     '  openprd review [path] [--open] [--mark <pending-confirmation|confirmed|needs-revision>] [--version <id>] [--digest <sha256>] [--work-unit <id>] [--notes <text>] [--json]',
+    '  openprd brainstorm-presentation [path] [--template] [--presentation <json>] [--write] [--fail-on-violation] [--json]',
     '  openprd review-presentation [path] [--template] [--version <id>] [--presentation <json>] [--write] [--fail-on-violation] [--json]',
     '  openprd diagram [path] [--type <architecture|product-flow>] [--input <contract.json>] [--mark <pending-confirmation|confirmed|needs-revision>] [--open] [--json]',
     '  openprd diff [path] [--from <version>] [--to <version>]',

package/src/cli/doctor-print.js

@@ -200,17 +200,32 @@ function printSelfUpdateResult(result, json) {
     return;
   }
 
-  const status = result.dryRun
-    ? '预演'
-    : result.ok
-      ? '完成'
-      : result.skipped
-        ? '已跳过'
-        : '失败';
+  const status = result.checkOnly
+    ? result.ok ? '检查完成' : '检查失败'
+    : result.dryRun
+      ? '预演'
+      : result.ok
+        ? '完成'
+        : result.skipped
+          ? '已跳过'
+          : '失败';
   console.log(`OpenPrd self-update: ${status}`);
   console.log(`当前版本: ${result.package?.version ?? 'unknown'}`);
+  if (result.publishedVersion) {
+    console.log(`已发布版本: ${result.publishedVersion}`);
+  }
+  if (result.comparison === 'behind') {
+    console.log('版本关系: 当前安装版本落后于 npm 已发布版本');
+  } else if (result.comparison === 'same') {
+    console.log('版本关系: 当前安装版本已经是 npm 最新版本');
+  } else if (result.comparison === 'ahead') {
+    console.log('版本关系: 当前安装版本高于 npm 已发布版本');
+  }
   console.log(`安装源: ${result.source}`);
-  console.log(`计划命令: ${result.installCommand.display}`);
+  if (result.versionCheck?.command?.display) {
+    console.log(`检查命令: ${result.versionCheck.command.display}`);
+  }
+  console.log(`计划命令: ${result.installCommand?.display ?? 'N/A'}`);
   if (result.localCheckout) {
     console.log('运行环境: 本地源码 checkout');
   }
@@ -223,6 +238,17 @@ function printSelfUpdateResult(result, json) {
   if (result.resolvedExecutable?.executable) {
     console.log(`OpenPrd 可执行文件: ${result.resolvedExecutable.executable}`);
   }
+  if (result.installedVersion?.version) {
+    console.log(`安装后版本: ${result.installedVersion.version}`);
+  }
+  if ((result.refreshCandidates?.total ?? 0) > 0) {
+    console.log(`旧项目刷新候选: ${result.refreshCandidates.total}`);
+    for (const project of result.refreshCandidates.projects ?? []) {
+      console.log(`- ${project.workspaceRoot} (${project.currentVersion} -> ${project.targetVersion}; ${project.note})`);
+    }
+  } else if (result.refreshCandidates?.ok && result.checkOnly) {
+    console.log('旧项目刷新候选: 0');
+  }
   for (const action of result.nextActions ?? []) {
     console.log(`下一步: ${action}`);
   }

package/src/cli/print.js

@@ -48,9 +48,11 @@ import {
 } from './doctor-print.js';
 import { printGrowthResult } from './growth-print.js';
 import {
+  printDesignStarterResult,
   printDevelopmentStandardsResult,
   printKnowledgeResult,
   printQualityResult,
+  printVisualPrepareResult,
   printStandardsResult,
   printVisualCompareResult,
 } from './quality-print.js';
@@ -59,6 +61,7 @@ import {
   printRunResult,
 } from './run-print.js';
 import {
+  printBrainstormResult,
   printDiagramResult,
   printDiffResult,
   printFreezeResult,
@@ -80,6 +83,7 @@ export {
   printLearningResult,
   printReleaseResult,
   printSynthesizeResult,
+  printBrainstormResult,
   printReviewResult,
   printHistoryResult,
   printDiffResult,
@@ -94,9 +98,11 @@ export {
   printLoopResult,
   printStandardsResult,
   printDevelopmentStandardsResult,
+  printDesignStarterResult,
   printGrowthResult,
   printQualityResult,
   printKnowledgeResult,
+  printVisualPrepareResult,
   printVisualCompareResult,
   printFreezeResult,
   printDiagramResult,

package/src/cli/quality-print.js

@@ -275,10 +275,80 @@ function printVisualCompareResult(result, json) {
   }
 }
 
+function printVisualPrepareResult(result, json) {
+  if (json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+
+  const modeLabel = result.mode === 'grid' ? '规则网格切片' : '手工裁剪计划';
+  console.log('OpenPrd visual prepare: 已生成');
+  console.log(`reference-set: ${result.referenceSetPath}`);
+  console.log(`输出目录: ${result.outputDir}`);
+  console.log(`模式: ${modeLabel}`);
+  console.log(`参考对象: ${result.itemCount}`);
+  if (result.source?.metadata) {
+    console.log(`参考整板: ${result.source.metadata.width}x${result.source.metadata.height}`);
+  }
+  console.log(`Contact sheet: ${result.contactSheetPath}`);
+  console.log(`Focus 模板: ${result.focusBoardTemplatePath}`);
+  console.log(`Parallel 模板: ${result.parallelBoardTemplatePath}`);
+  console.log(`对比计划: ${result.comparePlanPath}`);
+  for (const action of result.nextActions ?? []) {
+    console.log(`- 下一步: ${action}`);
+  }
+}
+
+function printDesignStarterResult(result, json) {
+  if (json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+
+  if (!result.ok) {
+    console.log('OpenPrd design starter: 失败');
+    for (const error of result.errors ?? []) {
+      console.log(`- ${error}`);
+    }
+    return;
+  }
+
+  console.log('OpenPrd design starter: 已生成');
+  console.log(`模板: ${result.starterId} (${result.relativeTemplatePath})`);
+  console.log(`输出: ${result.relativeOutputPath}`);
+  if (result.defaults?.lens || result.defaults?.theme || result.defaults?.layout) {
+    console.log(`默认组合: lens=${result.defaults.lens ?? '待补'} theme=${result.defaults.theme ?? '待补'} layout=${result.defaults.layout ?? '待补'}`);
+  }
+  if (result.overwritten) {
+    console.log('覆盖: 是');
+  }
+  if (result.hydrated) {
+    console.log('active design contracts: 已同步写实');
+    if (Array.isArray(result.docsHydrated) && result.docsHydrated.length > 0) {
+      console.log(`docs/basic: 已同步写实 (${result.docsHydrated.length} 份)`);
+    }
+    if (result.sourceManualFilled) {
+      console.log(`文件说明书: 已补到 ${result.relativeOutputPath}`);
+    }
+    if (result.folderManualCreated && result.folderManualPath) {
+      console.log(`文件夹 README: 已补到 ${result.folderManualPath}`);
+    }
+    console.log(`页面主题: ${result.title ?? result.brief ?? '已补'}`);
+    if (Array.isArray(result.sections) && result.sections.length > 0) {
+      console.log(`模块: ${result.sections.join(' / ')}`);
+    }
+    console.log('下一步: 直接在生成的入口文件上继续细化结构和样式，不要回到 pending 合同；禁止删除这个入口文件后另起新稿。如果题目更像导览、旅行、展览或馆藏内容页，保持真实图片路线，不要再把它改回 `--no-real-images`。');
+    return;
+  }
+  console.log('下一步: 立即替换入口文件里的标题、CTA 和所有占位文案，并同步把 active design contracts 写实；只有确认当前页不依赖外部事实、品牌素材或真实图片时，才直接写清无依赖。若题目更像导览、旅行、展览或馆藏内容页，先不要急着加 `--no-real-images`。后续必须继续在生成的入口文件上改，禁止删除后重起。');
+}
+
 export {
   printStandardsResult,
   printDevelopmentStandardsResult,
   printQualityResult,
   printKnowledgeResult,
+  printVisualPrepareResult,
   printVisualCompareResult,
+  printDesignStarterResult,
 };

package/src/cli/run-print.js

@@ -21,6 +21,20 @@ import { labelExecutionMode } from '../execution-strategy.js';
 import { printCodexRuntimeResult } from './doctor-print.js';
 import { printKnowledgeReview, printKnowledgeSkillMatches } from './shared-print.js';
 
+function printLoopWorkspaceMeta(result, fallbackProjectRoot = null) {
+  const workspacePath = result.workspace?.path ?? result.commit?.worktreePath ?? fallbackProjectRoot;
+  const branch = result.workspace?.branch ?? result.commit?.branch ?? null;
+  if (workspacePath) {
+    console.log(`工作区: ${workspacePath}`);
+  }
+  if (branch) {
+    console.log(`分支: ${branch}`);
+  }
+  if (result.workspace?.created) {
+    console.log('隔离 worktree: 已创建');
+  }
+}
+
 function printExecutionConfirmationChecklist(checklist) {
   if (!checklist?.required) {
     return;
@@ -152,6 +166,31 @@ function printRunResult(result, json) {
     console.log(`协作建议: ${result.recommendation.parallelPlan.summary}`);
   }
   console.log(`这样安排的原因: ${result.recommendation.reason}`);
+  if (
+    result.recommendation.command
+    && !result.recommendation.preparationCommand
+    && !result.recommendation.executionCommand
+    && !result.recommendation.commitCommand
+  ) {
+    console.log(`内部下一步参考: ${result.recommendation.command}`);
+  }
+  if (
+    result.recommendation.nextAction === 'brainstorm'
+    || result.recommendation.title === '先进入脑暴模式收敛方向'
+    || result.recommendation.command === 'openprd brainstorm . --open'
+  ) {
+    console.log('当前回复目标: 先进入脑暴模式，把核心诉求、目标结果、当前替代方案、推荐方向和验证重点整理成脑暴页；不要只停在 requirement 摘要。');
+  } else if (result.recommendation.nextAction === 'lightweight-l1') {
+    console.log('当前回复目标: 先用 3-5 行 mini-plan 收一下目标、范围内、范围外和验证方式；如果用户已经明确不需要确认，就按这个轻量路径继续实现，不要再回到 clarify-user。空白工作区先补 `.openprd/design/active/`，再从 `.openprd/design/templates/` 选最近模板；若页面主题和模块范围已经明确，优先把它们带进 `openprd design-starter --brief/--sections`，让 starter 一次落合同和首版内容。只有确认这个页面本来就不依赖外部事实、品牌素材或真实图片时，才在 active design artifacts 写清无依赖；如果题目更像旅游、导览、展览、博物馆、城市或自然观察内容页，先不要急着加 `--no-real-images`。后续必须继续在生成的入口文件上补丁修改；即使结构要大改，也不要删除 `index.html` 后重起。');
+  } else if (result.recommendation.nextAction === 'lightweight-l0') {
+    console.log('当前回复目标: 直接处理这次局部改动，做最小足够验证，并在完成后用人话说明本次调整。');
+  } else if (
+    result.recommendation.nextAction === 'clarify-user'
+    || result.recommendation.title === 'clarify-user'
+    || result.recommendation.title === '继续本轮需求入口澄清'
+  ) {
+    console.log('当前回复目标: 先在对话里输出 requirement 摘要或只追问 1 个最高价值澄清点；不要承诺“按默认方案直接实现”，也不要把“请帮我实现/继续实现”当成跳过 requirement 摘要确认的依据。');
+  }
   if (result.recommendation.preparationCommand || result.recommendation.executionCommand || result.recommendation.commitCommand) {
     console.log('开始动手前提: 只有在用户明确要求继续落地、实现、修复、深挖或提交时，才继续往下做；如果还缺这一步，就先用人话说明范围和影响。');
   }
@@ -165,7 +204,7 @@ function printRunResult(result, json) {
   if (result.recommendation.commitCommand) {
     console.log(`内部提交参考: ${result.recommendation.commitCommand}`);
   }
-  if (result.recommendation.loop?.worktreeRecommended) {
+  if (result.recommendation.loop?.worktreeRecommended || result.recommendation.isolation?.worktreeRecommended) {
     console.log('环境建议: 最好放到单独环境里继续，避免和别的事项串线。');
   }
   console.log(`内部检查参考: ${result.recommendation.verifyCommand}`);
@@ -184,6 +223,7 @@ function printLoopResult(result, json) {
       console.log(`任务: ${result.task.id} ${result.task.title}`);
       if (result.task.taskHandle) console.log(`任务句柄: ${result.task.taskHandle}`);
     }
+    printLoopWorkspaceMeta(result, result.projectRoot);
     if (result.promptPath) {
       console.log(`提示词: ${result.promptPath}`);
     }
@@ -200,6 +240,7 @@ function printLoopResult(result, json) {
     console.log(`OpenPrd loop 运行: ${result.ok ? '通过' : '失败'}${result.dryRun ? ' (dry-run)' : ''}`);
     if (result.task) console.log(`任务: ${result.task.id} ${result.task.title}`);
     if (result.task?.taskHandle) console.log(`任务句柄: ${result.task.taskHandle}`);
+    printLoopWorkspaceMeta(result, result.projectRoot);
     if (result.promptPath) console.log(`提示词: ${result.promptPath}`);
     if (result.invocation?.display) console.log(`执行: ${result.invocation.display}`);
     if (result.codexRuntime || result.preflight) {
@@ -233,6 +274,7 @@ function printLoopResult(result, json) {
     console.log(`OpenPrd loop finish: ${result.ok ? '通过' : '失败'}`);
     if (result.task) console.log(`任务: ${result.task.id} ${result.task.title}`);
     if (result.task?.taskHandle) console.log(`任务句柄: ${result.task.taskHandle}`);
+    printLoopWorkspaceMeta(result, result.projectRoot);
     if (result.commit) console.log(`提交: ${result.commit.skipped ? '跳过' : result.commit.sha}`);
     if (result.projectRelease?.version) {
       console.log(`项目版本: ${result.projectRelease.version}`);

package/src/cli/shared-print.js

@@ -29,6 +29,12 @@ function printKnowledgeReview(knowledgeReview) {
     console.log(`项目经验回顾: 失败 (${knowledgeReview.errors?.[0] ?? 'unknown'})`);
     return;
   }
+  const userFacingMessage = String(knowledgeReview.userFacingExperience?.message ?? '').trim();
+  if (userFacingMessage) {
+    console.log('项目经验回顾:');
+    console.log(userFacingMessage);
+    return;
+  }
   console.log(`项目经验草案: ${knowledgeReview.candidateId}`);
   if (knowledgeReview.summary) {
     console.log(`摘要: ${knowledgeReview.summary}`);
@@ -51,18 +57,43 @@ function knowledgeAdoptionLabel(adoption = {}) {
   return `命中 ${adoption.hitCount ?? 0} / 引用 ${adoption.referencedCount ?? 0} / 注入 ${adoption.injectedCount ?? 0}`;
 }
 
+function formatUseWhenLabel(value) {
+  return String(value ?? '').trim().replace(/^use when\b[:：]?\s*/i, '').trim();
+}
+
 function printKnowledgeSkillMatches(knowledgeSkills) {
   const matched = Array.isArray(knowledgeSkills?.matched) ? knowledgeSkills.matched : [];
   if (matched.length === 0) {
     return;
   }
   const summary = knowledgeSkills?.summary ?? {};
-  console.log(`项目级 Skill: 命中 ${matched.length} 个${summary.hookInjected ? '，已自动注入当前上下文' : ''}`);
+  const mandatoryCheck = knowledgeSkills?.mandatoryCheck ?? null;
+  if (mandatoryCheck?.required) {
+    console.log(`项目级经验候选: 找到 ${matched.length} 条${summary.hookInjected ? '，已加入当前上下文供判断' : ''}`);
+    console.log(`${mandatoryCheck.title}: ${mandatoryCheck.summary}`);
+    for (const instruction of (mandatoryCheck.instructions ?? []).slice(0, 3)) {
+      console.log(`- ${instruction}`);
+    }
+    if (Array.isArray(mandatoryCheck.focusSignals) && mandatoryCheck.focusSignals.length > 0) {
+      console.log(`当前判断线索: ${mandatoryCheck.focusSignals.join('；')}`);
+    }
+  } else {
+    console.log(`项目级 Skill: 命中 ${matched.length} 个${summary.hookInjected ? '，已自动注入当前上下文' : ''}`);
+  }
   for (const skill of matched.slice(0, 3)) {
     console.log(`- ${skill.skillName}: ${skill.matchSummary ?? '命中当前上下文'}`);
-    if (skill.description) {
+    const useWhen = formatUseWhenLabel(skill.useWhen ?? skill.description);
+    if (useWhen) {
+      console.log(`  适用时机: ${useWhen}`);
+    } else if (skill.description) {
       console.log(`  说明: ${skill.description}`);
     }
+    if (Array.isArray(skill.reviewFirst) && skill.reviewFirst.length > 0) {
+      console.log(`  先看: ${skill.reviewFirst.slice(0, 3).join('；')}`);
+    }
+    if (Array.isArray(skill.antiPatterns) && skill.antiPatterns.length > 0) {
+      console.log(`  不要直接套用: ${skill.antiPatterns.slice(0, 2).join('；')}`);
+    }
     if (Array.isArray(skill.touchedFiles) && skill.touchedFiles.length > 0) {
       console.log(`  相关文件: ${skill.touchedFiles.slice(0, 4).join('；')}`);
     }

package/src/cli/workflow-print.js

@@ -76,6 +76,22 @@ function printReviewResult(result, json) {
   }
 }
 
+function printBrainstormResult(result, json) {
+  if (json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+
+  console.log('脑暴工作台已生成');
+  console.log(`主题: ${result.record.topic}`);
+  console.log(`推荐方向: ${result.record.summary?.recommendedDirection ?? '待补充'}`);
+  console.log(`脑暴页面: ${result.htmlPath}`);
+  console.log(`Markdown 数据源: ${result.markdownPath}`);
+  console.log(`Capture Patch: ${result.patchPath}`);
+  console.log(`状态文件: ${result.statePath}`);
+  console.log(`已自动打开: ${result.opened ? '是' : '否'}`);
+}
+
 function printHistoryResult(result, json) {
   if (json) {
     console.log(JSON.stringify(result, null, 2));
@@ -121,6 +137,10 @@ function printNextResult(result, json) {
   if (taskGraph?.nextReadyNode) {
     console.log(`下一个就绪节点: ${taskGraph.nextReadyNode}`);
   }
+  if (result.brainstormSuggestion?.recommended) {
+    console.log(`脑暴模式建议: ${result.brainstormSuggestion.reason}`);
+    console.log(`脑暴命令: ${result.brainstormSuggestion.suggestedCommand}`);
+  }
   if (result.diagramState?.needed) {
     console.log(`图表门禁: ${result.diagramState.shouldGateFreeze ? '激活' : '已满足'}`);
     console.log(`建议图表: ${result.diagramState.preferredType}`);
@@ -184,6 +204,7 @@ function printHandoffResult(result, json) {
 }
 
 export {
+  printBrainstormResult,
   printSynthesizeResult,
   printReviewResult,
   printHistoryResult,