@openprd/cli 0.1.11 → 0.1.19

package/src/design-starter-support.js

@@ -157,8 +157,8 @@ function normalizeTheme(theme) {
   }
   return {
     ...theme,
-    bodyFont: String(theme.bodyFont ?? '"Inter", "PingFang SC", sans-serif'),
-    headlineFont: String(theme.headlineFont ?? '"Inter", "PingFang SC", sans-serif'),
+    bodyFont: String(theme.bodyFont ?? '"Avenir Next", "Noto Sans SC", "PingFang SC", sans-serif'),
+    headlineFont: String(theme.headlineFont ?? '"Avenir Next", "Noto Sans SC", "PingFang SC", sans-serif'),
     surfacePreset: String(theme.surfacePreset ?? 'paper-grid'),
   };
 }

package/src/design-starter.js

@@ -41,6 +41,8 @@ const STARTER_CATALOG = [
       lens: 'editorial-contrast',
       theme: 'warm-editorial',
       layout: 'story-map',
+      aesthetic: '温暖编辑式内容首页，用标题字体、图文节奏和章节停顿建立可长期阅读的气质。',
+      memoryPoint: '第一眼记住清楚的主题入口和像杂志目录一样的内容节奏。',
       components: ['editorial-hero', 'stat-row', 'story-section', 'feature-grid', 'timeline', 'cta-banner'],
     },
     directions: [
@@ -50,6 +52,8 @@ const STARTER_CATALOG = [
         lens: 'editorial-contrast',
         theme: 'warm-editorial',
         layout: 'story-map',
+        aesthetic: '温暖编辑感，靠标题字体和章节节奏组织内容。',
+        memoryPoint: '像一本打开的专题目录，用户知道从哪里开始读。',
         suitable: '长期写作首页、专题内容页、个人博客首页',
         risk: '如果信息密度控制不好，首屏会显得偏满。',
       },
@@ -59,6 +63,8 @@ const STARTER_CATALOG = [
         lens: 'catalog-clarity',
         theme: 'quiet-sand',
         layout: 'editorial-rail',
+        aesthetic: '克制资料库感，靠清楚分类和可比较信息单元建立秩序。',
+        memoryPoint: '用户能快速回到分类、筛选和上一次浏览位置。',
         suitable: '知识整理页、文章归档页、资源导航页',
         risk: '如果目录层级太重，会削弱阅读感。',
       },
@@ -68,6 +74,8 @@ const STARTER_CATALOG = [
         lens: 'immersive-showcase',
         theme: 'deep-launch',
         layout: 'story-map',
+        aesthetic: '沉浸展示感，靠强主视觉和少量文字信号制造记忆。',
+        memoryPoint: '首屏真实场景或关键视觉成为页面锚点。',
         suitable: '需要更强个人风格的内容展示页',
         risk: '容易更像展示页而不是稳定阅读首页。',
       },
@@ -84,6 +92,8 @@ const STARTER_CATALOG = [
       lens: 'product-launch',
       theme: 'deep-launch',
       layout: 'product-spec-runway',
+      aesthetic: '暗色发布叙事，用产品状态、规格跑道和强对比动作建立发布感。',
+      memoryPoint: '用户记住一个明确承诺和一个可验证的产品状态。',
       components: ['spec-hero', 'stat-row', 'feature-grid', 'logo-wall', 'cta-banner'],
     },
     directions: [
@@ -93,6 +103,8 @@ const STARTER_CATALOG = [
         lens: 'product-launch',
         theme: 'deep-launch',
         layout: 'product-spec-runway',
+        aesthetic: '深色电影感发布页，强调新能力、证明材料和决策动作。',
+        memoryPoint: '一个强主视觉承载发布承诺，而不是一组泛泛功能卡片。',
         suitable: '正式发布页、版本更新页、关键能力介绍页',
         risk: '如果证据不足，会只剩氛围没有事实。',
       },
@@ -102,6 +114,8 @@ const STARTER_CATALOG = [
         lens: 'editorial-contrast',
         theme: 'warm-editorial',
         layout: 'pricing-and-proof',
+        aesthetic: '编辑型解释页，降低销售感，用证据、价格或适用对象帮助决策。',
+        memoryPoint: '用户记住“为什么现在值得用”和“适合谁”。',
         suitable: '要兼顾解释与决策的介绍页',
         risk: '可能不够强势，发布感会偏弱。',
       },
@@ -111,6 +125,8 @@ const STARTER_CATALOG = [
         lens: 'immersive-showcase',
         theme: 'deep-launch',
         layout: 'immersive-hero-stack',
+        aesthetic: '沉浸式产品故事，靠媒体层级和少量强文本拉开情绪。',
+        memoryPoint: '首屏像一段产品片头，但仍保留下一步动作。',
         suitable: '视觉驱动型发布叙事',
         risk: '容易把页面做成纯展示而削弱可扫描性。',
       },
@@ -127,6 +143,8 @@ const STARTER_CATALOG = [
       lens: 'operational-density',
       theme: 'tool-neutral',
       layout: 'ops-density-grid',
+      aesthetic: '安静工作台，用稳定密度、清楚状态和短路径体现专业感。',
+      memoryPoint: '用户记住这是一个能反复使用、快速扫描的控制台。',
       components: ['filter-rail', 'summary-panel', 'dense-table', 'settings-group'],
     },
     directions: [
@@ -136,6 +154,8 @@ const STARTER_CATALOG = [
         lens: 'operational-density',
         theme: 'tool-neutral',
         layout: 'ops-density-grid',
+        aesthetic: '克制工具感，靠密度、对齐、状态和控件层级让用户快速完成工作。',
+        memoryPoint: '首屏一眼知道待处理、关键指标和下一步动作。',
         suitable: '后台首页、运营看板、任务工作台',
         risk: '如果主次不清，扫描效率会下降。',
       },
@@ -145,6 +165,8 @@ const STARTER_CATALOG = [
         lens: 'catalog-clarity',
         theme: 'quiet-sand',
         layout: 'catalog-browser',
+        aesthetic: '资料浏览器感，靠分类、筛选和可比较对象减少重复判断。',
+        memoryPoint: '用户记住清楚的浏览结构和稳定的回看路径。',
         suitable: '对象浏览与筛选更重的系统首页',
         risk: '容易太像列表页，动作感不足。',
       },
@@ -154,6 +176,8 @@ const STARTER_CATALOG = [
         lens: 'operational-density',
         theme: 'deep-launch',
         layout: 'settings-split',
+        aesthetic: '深色控制中心感，适合高风险配置和集中监控。',
+        memoryPoint: '关键状态像仪表盘一样醒目，但操作仍克制。',
         suitable: '偏控制中心与配置中枢的场景',
         risk: '暗色高密度更考验层级控制。',
       },
@@ -269,6 +293,7 @@ function buildStarterContext(starter, defaults, options = {}) {
     noRealImages: Boolean(options.noRealImages),
     themeConfig: null,
     imageBundle: null,
+    selectedDirection: starter.selectedDirection,
   };
 }
 
@@ -383,8 +408,12 @@ function buildGenericAssetSpec(context) {
 | logo | ${normalizePathForMarkdown(context.noBrandAssets ? '无外部 logo，优先用文字字标' : '待补品牌字标或官方 logo')} | ${context.noBrandAssets ? 'n/a' : '待确认'} | ${context.noBrandAssets ? 'not-needed' : 'defined'} | ${normalizePathForMarkdown(assetLine)} |
 | 产品图 | ${normalizePathForMarkdown(context.noBrandAssets ? '无' : '按任务需要补产品图')} | ${context.noBrandAssets ? 'n/a' : '待确认'} | ${context.noBrandAssets ? 'not-needed' : 'defined'} | ${normalizePathForMarkdown(imageLine)} |
 | UI 图 | ${normalizePathForMarkdown(context.starterId === 'ops-dashboard' ? '如需现有界面截图再补' : '无必需 UI 截图')} | ${context.starterId === 'ops-dashboard' ? '待确认' : 'n/a'} | ${context.starterId === 'ops-dashboard' ? 'defined' : 'not-needed'} |  |
+| 功能图标 | ${normalizePathForMarkdown('新入口/按钮/空态默认配图标；先复用项目已有图标体系，缺失时按最佳实践路由自动补')} | ${normalizePathForMarkdown('UI 图标 Phosphor；实现库 Lucide/Tabler/React Icons；AI 品牌 LobeHub；技术栈 Tech Icons')} | defined | 接入后把图标名与用途登记到本行备注，不等用户要求 |
 | 摄影 / 插图 | ${normalizePathForMarkdown(context.noRealImages ? '无' : '按任务需要补真实图片或插图')} | ${context.noRealImages ? 'n/a' : '待确认'} | ${context.noRealImages ? 'not-needed' : 'defined'} | ${normalizePathForMarkdown(imageLine)} |
 | 色板 / 字体 | ${normalizePathForMarkdown(`${context.defaults.theme ?? 'starter-default'} 对应的默认 tokens`)} | implementation | defined | 先锁定 starter 默认组合，再按页面细化 |
+| 动效节奏 | ${normalizePathForMarkdown('一段关键 reveal / 状态反馈 / 滚动节奏，按审美主张控制复杂度')} | implementation | defined | 不到处散落无意义 hover |
+| 背景 / 表面 | ${normalizePathForMarkdown(`${context.defaults.theme ?? 'starter-default'} 对应表面预设`)} | implementation | defined | 背景和纹理服务内容，不替代真实素材 |
+| 构图记忆点 | ${normalizePathForMarkdown(context.selectedDirection?.memoryPoint ?? '按当前方向继续补记忆点')} | implementation | defined | 进入 Patch Mode 时优先保住 |
 
 ${fetchedImageRows.length > 0 ? `
 ## 已补真实图片
@@ -399,6 +428,8 @@ ${fetchedImageRows.join('\n')}
 - lens: ${context.defaults.lens ?? context.starterId}
 - theme: ${context.defaults.theme ?? '待补'}
 - layout: ${context.defaults.layout ?? '待补'}
+- aesthetic: ${normalizePathForMarkdown(context.selectedDirection?.aesthetic ?? '待补')}
+- memory-point: ${normalizePathForMarkdown(context.selectedDirection?.memoryPoint ?? '待补')}
 ${imageBundle?.succeeded ? `- image-query: ${normalizePathForMarkdown(imageBundle.query)}\n- image-manifest: ${normalizePathForMarkdown(imageBundle.relativeManifestPath ?? '待补')}` : ''}
 `;
 }
@@ -456,11 +487,11 @@ function buildGenericImagePreflight(context) {
 }
 
 function buildGenericDirectionPlan(starter, context) {
-  const lines = starter.directions.map((direction) => `| ${direction.label} | ${direction.logic} | ${direction.lens} | ${direction.theme} | ${direction.layout} | ${normalizePathForMarkdown(`${context.brief} 下刻意拉开气质和信息组织方式`)} | ${normalizePathForMarkdown(direction.suitable)} | ${normalizePathForMarkdown(direction.risk)} |`);
+  const lines = starter.directions.map((direction) => `| ${direction.label} | ${direction.logic} | ${direction.lens} | ${direction.theme} | ${direction.layout} | ${normalizePathForMarkdown(direction.aesthetic ?? `${context.brief} 下刻意拉开气质和信息组织方式`)} | ${normalizePathForMarkdown(direction.memoryPoint ?? '当前方向的首屏视觉锚点和任务路径')} | ${normalizePathForMarkdown(`${context.brief} 下刻意拉开气质和信息组织方式`)} | ${normalizePathForMarkdown(direction.suitable)} | ${normalizePathForMarkdown(direction.risk)} |`);
   return `# Direction Plan
 
-| 方向 | 生成逻辑 | lens | theme | layout | 为什么不同 | 适用场景 | 主要风险 |
-| --- | --- | --- | --- | --- | --- | --- | --- |
+| 方向 | 生成逻辑 | lens | theme | layout | 审美主张 | 记忆点 | 为什么不同 | 适用场景 | 主要风险 |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
 ${lines.join('\n')}
 `;
 }
@@ -474,11 +505,14 @@ function buildGenericSelectedDirection(starter) {
 - lens: ${selected.lens}
 - theme: ${selected.theme}
 - layout: ${selected.layout}
+- aesthetic: ${normalizePathForMarkdown(selected.aesthetic ?? '当前方向需要在实现前补充审美主张')}
+- memory-point: ${normalizePathForMarkdown(selected.memoryPoint ?? '当前方向需要在实现前补充记忆点')}
 - components:
 ${selected.components.map((component) => `  - ${component}`).join('\n')}
 - follow-up risks:
   - 进入实现时继续控制信息密度，避免局部突然换轨
   - 页面文案要保留当前任务语气，不要把模板示例话术原样带入交付
+  - 进入 Patch Mode 前用 anti-slop 自检，避免回到通用字体、紫白渐变或均匀卡片堆叠
 `;
 }
 
@@ -586,6 +620,8 @@ function buildBasicDocMap(projectRoot, starter, context, relativeOutputPath) {
 - 把最后一批必要的查事实、查图、读模板动作放在口头宣布之前做完；一旦已经说“开始覆盖入口文件”或“开始整页重写”，下一步必须是对 \`${relativeOutputPath}\` 或 sibling draft 的实际写入，不要继续只读扫描、压图或停在口头承诺；必要时 hook 会把这类非写入动作挡回去。
 - 主要区块固定为: ${sections.join('、')}。
 - 当前视觉方向锁定为 \`${context.defaults.lens ?? starter.id}\`，主题采用 \`${context.defaults.theme ?? 'starter-default'}\`，页面骨架采用 \`${context.defaults.layout ?? 'starter-layout'}\`。
+- 当前审美主张和记忆点记录在 \`.openprd/design/active/selected-direction.md\`；后续样式细化必须保住这个气质，而不是回到通用模板。
+- 进入样式细化前，用 \`.openprd/design/anti-slop.md\` 排除默认紫白渐变、通用字体栈、白底卡片堆叠和无语境装饰。
 - 优先使用稳定的信息层级、卡片、标签、导航锚点和纯文字表达；不通过花哨装饰替代真实结构。
 
 ## 交互规范

package/src/dev-standards.js

@@ -8,7 +8,8 @@ import { recordKnowledgeReviewSignal, reviewKnowledgeWorkspace } from './knowled
 
 const DEVELOPMENT_STANDARDS_CONFIG = cjoin('.openprd', 'standards', 'config.json');
 const DEV_CHECK_WRAPUP_COPY_SCRIPT = fileURLToPath(new URL('../scripts/dev-check-wrapup-copy.mjs', import.meta.url));
-const DEV_CHECK_WRAPUP_FIELDS = ['规模信号', '预警原因', '本次处理结果', '后续建议'];
+const DEV_CHECK_WRAPUP_FIELDS_AUTO = ['源文件规模', '优化原因', '本次处理结果', '后续建议'];
+const DEV_CHECK_WRAPUP_FIELDS_RECOMMEND = ['规模信号', '预警原因', '本次处理结果', '后续建议'];
 const CODE_FILE_EXTENSIONS = new Set([
   '.c',
   '.cc',
@@ -68,8 +69,25 @@ export const DEFAULT_DEVELOPMENT_STANDARDS = {
     attentionMax: 1500,
     appliesTo: 'agent-touched-code-files',
   },
+  autoRefactor: {
+    enabled: true,
+  },
 };
 
+const UI_FILE_EXTENSIONS = new Set([
+  '.css',
+  '.html',
+  '.jsx',
+  '.scss',
+  '.svelte',
+  '.tsx',
+  '.vue',
+  '.wxml',
+  '.wxss',
+]);
+const VISUAL_REVIEWS_DIR = cjoin('.openprd', 'harness', 'visual-reviews');
+const VISUAL_EVIDENCE_FRESH_MS = 24 * 60 * 60 * 1000;
+
 function normalizePathForReport(value) {
   return String(value ?? '').split(path.sep).join('/');
 }
@@ -167,6 +185,7 @@ function normalizeLineConfig(config = {}) {
     exemptFilePatterns: [...EXEMPT_FILE_PATTERNS, ...customPatterns],
     growthEnabled: config?.growth?.enabled !== false,
     growthAutoApply: config?.growth?.autoApply,
+    autoRefactorEnabled: (config?.developmentStandards?.autoRefactor ?? config?.autoRefactor)?.enabled !== false,
   };
 }
 
@@ -212,13 +231,20 @@ function fileStatus(lineCount, lineConfig) {
 }
 
 function nextActionForStatus(status, lineConfig) {
+  const autoMode = lineConfig?.autoRefactorEnabled !== false;
   if (status === 'ok') {
     return `本轮没有显著维护风险；最终回复可简要说明已回顾本次改动文件。`;
   }
   if (status === 'attention') {
+    if (autoMode) {
+      return `本轮若为该文件新增了职责，直接按入口、状态、渲染或数据边界完成小步拆分（保持行为不变、测试通过）；若只是小修，说明没有继续扩展职责即可。`;
+    }
     return `本轮只做当前目标相关的小范围改动，并说明没有继续扩展该文件职责。`;
   }
   if (status === 'warning') {
+    if (autoMode) {
+      return `本轮直接执行拆分：先确认现有测试可保住行为，再按职责边界拆出独立模块（高内聚低耦合、不丢任何功能），拆完重跑测试与 dev-check，并把拆分产出写进最终回复的“OpenPRD 自动优化报告”。`;
+    }
     return `先判断这次是否新增职责；如果新增了，优先拆分或解耦后再收尾；如果只是小修，说明暂不拆的原因和后续拆分建议。`;
   }
   if (status === 'exempt') {
@@ -321,9 +347,10 @@ function countDisplayChars(value) {
   return Array.from(String(value ?? '')).length;
 }
 
-function buildCompactWrapUpRows(files) {
+function buildCompactWrapUpRows(files, options = {}) {
   const result = spawnSync(process.execPath, [DEV_CHECK_WRAPUP_COPY_SCRIPT], {
     input: JSON.stringify({
+      autoRefactor: Boolean(options.autoRefactor),
       files: files.map((file) => ({
         status: file.status,
         lineCount: file.lineCount,
@@ -351,8 +378,9 @@ function buildCompactWrapUpRows(files) {
   if (!rows || rows.length !== files.length) {
     throw new Error('Compact dev-check wrap-up copy returned an unexpected row count.');
   }
+  const expectedFields = options.autoRefactor ? DEV_CHECK_WRAPUP_FIELDS_AUTO : DEV_CHECK_WRAPUP_FIELDS_RECOMMEND;
   for (const row of rows) {
-    for (const field of DEV_CHECK_WRAPUP_FIELDS) {
+    for (const field of expectedFields) {
       if (typeof row[field] !== 'string') {
         throw new Error(`Compact dev-check wrap-up copy is missing field: ${field}`);
       }
@@ -364,29 +392,78 @@ function buildCompactWrapUpRows(files) {
   return rows;
 }
 
-function buildDevCheckWrapUp(files) {
-  const title = '后续建议';
-  const columns = ['影响对象', '关注程度', '规模信号', '预警原因', '本次处理结果', '后续建议'];
+function buildDevCheckWrapUp(files, lineConfig = {}) {
+  const autoMode = lineConfig?.autoRefactorEnabled !== false;
+  const title = autoMode ? 'OpenPRD 自动优化报告' : '后续建议';
+  const statusColumn = autoMode ? '问题级别' : '关注程度';
+  const columns = autoMode
+    ? ['影响对象', '问题级别', '源文件规模', '优化原因', '本次处理结果', '后续建议']
+    : ['影响对象', '关注程度', '规模信号', '预警原因', '本次处理结果', '后续建议'];
   const attentionFiles = files
     .filter((file) => ['attention', 'warning', 'error'].includes(file.status))
     .sort((left, right) => devCheckConcernRank(right) - devCheckConcernRank(left));
-  const compactRows = attentionFiles.length > 0 ? buildCompactWrapUpRows(attentionFiles) : [];
+  const compactRows = attentionFiles.length > 0
+    ? buildCompactWrapUpRows(attentionFiles, { autoRefactor: autoMode })
+    : [];
   const rows = attentionFiles.map((file, index) => ({
       影响对象: file.path,
-      关注程度: devCheckStatusLabel(file.status),
+      [statusColumn]: devCheckStatusLabel(file.status),
       ...compactRows[index],
     }));
   const markdownTable = renderMarkdownTable(columns, rows);
+  const switchHint = autoMode
+    ? '自动代码结构优化当前默认开启。如果下次不需要 Agent 自动优化，回复“关闭自动优化”，Agent 会运行 `openprd dev-check . --auto-refactor off` 转为仅推荐。'
+    : '自动代码结构优化当前已关闭（仅推荐模式）。要恢复 Agent 自动优化，运行 `openprd dev-check . --auto-refactor on`。';
   return {
     required: rows.length > 0,
+    mode: autoMode ? 'auto-refactor' : 'recommend',
     reason: rows.length > 0
-      ? '存在需要用户关注的影响对象；最终回复需要用“后续建议”说明本次处理结果和后续建议。'
+      ? (autoMode
+        ? '存在超行影响对象；本轮 Agent 应先按“本次处理结果”完成高内聚低耦合拆分（不丢功能、测试保住行为），再在最终回复用“OpenPRD 自动优化报告”呈现优化完成的结果，并附一句自动优化开关确认。'
+        : '存在需要用户关注的影响对象；最终回复需要用“后续建议”说明本次处理结果和后续建议。')
       : '本轮改动文件未触发影响范围提醒；最终回复可简要说明已完成改动对象回顾。',
     title,
     columns,
     rows,
     markdownTable,
     markdownBlock: markdownTable ? `**${title}**\n\n${markdownTable}` : '',
+    switchHint: rows.length > 0 ? switchHint : null,
+  };
+}
+
+async function buildVisualEvidenceReminder(projectRoot, files) {
+  const uiFiles = files
+    .filter((file) => file.status !== 'error' && UI_FILE_EXTENSIONS.has(path.extname(file.path).toLowerCase()))
+    .map((file) => file.path);
+  if (uiFiles.length === 0) {
+    return { required: false, uiFiles: [] };
+  }
+  const reviewsDir = cjoin(projectRoot, VISUAL_REVIEWS_DIR);
+  let freshEvidence = [];
+  const entries = await fs.readdir(reviewsDir).catch(() => []);
+  const now = Date.now();
+  for (const entry of entries) {
+    if (!/\.(jpe?g|png|webp)$/i.test(entry)) continue;
+    const stat = await fs.stat(path.join(reviewsDir, entry)).catch(() => null);
+    if (stat && now - stat.mtimeMs <= VISUAL_EVIDENCE_FRESH_MS) {
+      freshEvidence.push(normalizePathForReport(path.join(VISUAL_REVIEWS_DIR, entry)));
+    }
+  }
+  freshEvidence = freshEvidence.slice(-5);
+  const required = freshEvidence.length === 0;
+  return {
+    required,
+    uiFiles,
+    freshEvidence,
+    reason: required
+      ? '本轮触达界面文件，但最近 24 小时没有任何拼图证据板产出；用户可见变化需要视觉证据，不能只靠构建通过或单张截图。'
+      : '本轮触达界面文件，最近已有拼图证据板产出；确认它覆盖了本轮改动，并把证据图嵌入对话流。',
+    suggestedCommands: [
+      'openprd visual-compare . --before <改前截图> --after <改后截图>',
+      'openprd visual-compare . --board <alignment-board.json>（同构列表/卡片/网格/表格对齐，含容器轨道与内容槽位）',
+      'openprd visual-compare . --board <centering-board.json>（单素材内部居中/视觉重心）',
+    ],
+    chatEmbedHint: '生成后把证据图用 `![视觉证据](<输出路径>)` 直接嵌入最终回复，让用户在对话流里看到对齐效果。',
   };
 }
 
@@ -526,6 +603,10 @@ export async function checkDevelopmentStandardsWorkspace(projectRoot, options =
     action: 'dev-check',
     projectRoot,
     enabled: lineConfig.enabled,
+    autoRefactor: {
+      enabled: lineConfig.autoRefactorEnabled,
+      mode: lineConfig.autoRefactorEnabled ? 'auto-refactor' : 'recommend',
+    },
     thresholds: {
       okMax: lineConfig.okMax,
       attentionMax: lineConfig.attentionMax,
@@ -538,8 +619,42 @@ export async function checkDevelopmentStandardsWorkspace(projectRoot, options =
       warning: statusCounts.warning ?? 0,
     },
     files,
-    wrapUp: buildDevCheckWrapUp(files),
+    wrapUp: buildDevCheckWrapUp(files, lineConfig),
+    visualEvidence: await buildVisualEvidenceReminder(projectRoot, files),
     knowledgeReview,
     errors,
   };
 }
+
+export async function setDevCheckAutoRefactor(projectRoot, enabled) {
+  const configPath = cjoin(projectRoot, DEVELOPMENT_STANDARDS_CONFIG);
+  const config = (await exists(configPath)) ? await readJson(configPath).catch(() => ({})) : {};
+  const developmentStandards = config.developmentStandards && typeof config.developmentStandards === 'object'
+    ? config.developmentStandards
+    : {};
+  const autoRefactor = developmentStandards.autoRefactor && typeof developmentStandards.autoRefactor === 'object'
+    ? developmentStandards.autoRefactor
+    : {};
+  const next = {
+    ...config,
+    developmentStandards: {
+      ...developmentStandards,
+      autoRefactor: {
+        ...autoRefactor,
+        enabled: Boolean(enabled),
+      },
+    },
+  };
+  await fs.mkdir(path.dirname(configPath), { recursive: true });
+  await fs.writeFile(configPath, `${JSON.stringify(next, null, 2)}\n`, 'utf8');
+  return {
+    ok: true,
+    action: 'dev-check-auto-refactor',
+    projectRoot,
+    configPath: normalizePathForReport(path.relative(projectRoot, configPath)),
+    autoRefactor: {
+      enabled: Boolean(enabled),
+      mode: enabled ? 'auto-refactor' : 'recommend',
+    },
+  };
+}

package/src/diagram-core.js

@@ -1,4 +1,5 @@
 import { timestamp } from './time.js';
+import { isEnglishHeavyText, normalizeOutputLocale } from './language-policy.js';
 
 function escapeHtml(value) {
   return `${value ?? ''}`
@@ -120,28 +121,13 @@ function normalizePanel(panel, fallbackTitle = '评审备注', fallbackColor = '
 }
 
 function normalizeLocale(contract) {
-  return pickValue(contract?.locale, contract?.lang ?? 'zh-CN');
+  return normalizeOutputLocale(pickValue(contract?.locale, contract?.lang ?? 'zh-CN'));
 }
 
 function normalizeReviewStatus(value) {
   return pickValue(value, 'pending-confirmation');
 }
 
-function hasCjk(text) {
-  return /[\u3400-\u9fff]/.test(text);
-}
-
-function englishWords(text) {
-  return `${text ?? ''}`.match(/[A-Za-z][A-Za-z0-9+_.-]*/g) ?? [];
-}
-
-function isEnglishHeavyText(text) {
-  const value = `${text ?? ''}`.trim();
-  if (!value || hasCjk(value)) return false;
-  const words = englishWords(value);
-  return words.length >= 4;
-}
-
 function collectDiagramTexts(model) {
   const entries = [];
   const push = (path, value) => {
@@ -181,7 +167,7 @@ function collectDiagramTexts(model) {
 }
 
 export function validateDiagramLanguage(model) {
-  const locale = `${model?.locale ?? 'zh-CN'}`.toLowerCase();
+  const locale = normalizeOutputLocale(model?.locale ?? 'zh-CN').toLowerCase();
   if (!locale.startsWith('zh')) {
     return { valid: true, errors: [] };
   }
@@ -609,7 +595,7 @@ function resolveProductLayerTitle(productType) {
 
 function buildArchitectureComponents(snapshot) {
   const { sections } = snapshot;
-  const reviewTarget = sections.handoff.targetSystem ?? 'OpenSpec';
+  const reviewTarget = sections.handoff.targetSystem ?? 'OpenPrd';
   return [
     {
       id: 'users',
@@ -733,7 +719,7 @@ export function buildArchitectureDiagramModel(snapshot) {
       productType: snapshot.productType ?? '未分类',
       owner: snapshot.owner,
       versionId: snapshot.versionId,
-      targetSystem: snapshot.sections.handoff.targetSystem ?? 'OpenSpec',
+      targetSystem: snapshot.sections.handoff.targetSystem ?? 'OpenPrd',
       reviewStatus: normalizeReviewStatus(snapshot?.reviewStatus),
     },
   };
@@ -926,7 +912,7 @@ export function buildProductFlowDiagramModel(snapshot) {
       productType: snapshot.productType ?? '未分类',
       owner: snapshot.owner,
       versionId: snapshot.versionId,
-      targetSystem: snapshot.sections.handoff.targetSystem ?? 'OpenSpec',
+      targetSystem: snapshot.sections.handoff.targetSystem ?? 'OpenPrd',
       reviewStatus: normalizeReviewStatus(snapshot?.reviewStatus),
     },
   };

package/src/discovery.js

@@ -3,7 +3,7 @@ import path from 'node:path';
 import { analyzePrdSnapshot, buildPrdSnapshot, formatVersionId } from './prd-core.js';
 import { formatProductTypeDisplay } from './product-type-copy.js';
 import { analyzeOpenSpecTaskVolumes } from './openspec/tasks.js';
-import { legacyOpenSpecDiscoveryDir, openPrdDiscoveryDir, readDiscoveryConfig } from './openspec/paths.js';
+import { openPrdDiscoveryDir, readDiscoveryConfig } from './openspec/paths.js';
 import { appendJsonl, cjoin, exists, readJson, readJsonl, writeJson, writeText } from './fs-utils.js';
 import { collectSourceInventory, shouldIgnoreSourceDirectory } from './source-inventory.js';
 import { compactTimestamp, timestamp } from './time.js';
@@ -391,13 +391,7 @@ async function openspecDiscoveryWorkspaceImpl(projectRoot, options = {}, depende
 }
 
 async function loadOpenSpecDiscoveryRun(projectRoot) {
-  let discoveryRoot = openPrdDiscoveryDir(projectRoot);
-  if (!(await exists(cjoin(discoveryRoot, 'current.json')))) {
-    const legacyRoot = legacyOpenSpecDiscoveryDir(projectRoot);
-    if (await exists(cjoin(legacyRoot, 'current.json'))) {
-      discoveryRoot = legacyRoot;
-    }
-  }
+  const discoveryRoot = openPrdDiscoveryDir(projectRoot);
   const currentPath = cjoin(discoveryRoot, 'current.json');
   if (!(await exists(currentPath))) {
     throw new Error(`Missing OpenPrd discovery state: ${currentPath}`);

package/src/docs-compact.js

@@ -0,0 +1,125 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import {
+  DOC_MEGA_LINE_CHARS,
+  DOC_STALE_VERSION_THRESHOLD,
+  STANDARD_DOCS,
+  STANDARD_DOCS_ROOT,
+  analyzeDocQuality,
+  analyzeDocStaleness,
+} from './standards.js';
+
+const PREVIEW_CHARS = 80;
+const MAX_LINE_SUGGESTIONS_PER_DOC = 8;
+
+function lineSuggestion(lineNumber, line) {
+  const preview = Array.from(line.trim()).slice(0, PREVIEW_CHARS).join('');
+  const separators = (line.match(/[；;。]/gu) ?? []).length;
+  const hint = separators >= 2
+    ? `含 ${separators + 1} 个句段，建议拆成分点列表（每点一行）`
+    : '建议拆成小节或分点，删除重复叙述';
+  return {
+    line: lineNumber,
+    chars: Array.from(line).length,
+    preview: `${preview}…`,
+    hint,
+  };
+}
+
+export async function docsCompactWorkspace(projectRoot, options = {}) {
+  const resolvedRoot = path.resolve(projectRoot);
+  const docs = [];
+  let totalMegaLines = 0;
+
+  for (const doc of STANDARD_DOCS) {
+    const docPath = path.join(resolvedRoot, STANDARD_DOCS_ROOT, doc.fileName);
+    const text = await fs.readFile(docPath, 'utf8').catch(() => null);
+    if (text === null) {
+      continue;
+    }
+    const relativePath = path.relative(resolvedRoot, docPath);
+    const quality = analyzeDocQuality(relativePath, text);
+    const lines = text.split('\n');
+    const suggestions = [];
+    lines.forEach((line, index) => {
+      if (Array.from(line).length > DOC_MEGA_LINE_CHARS && suggestions.length < MAX_LINE_SUGGESTIONS_PER_DOC) {
+        suggestions.push(lineSuggestion(index + 1, line));
+      }
+    });
+    totalMegaLines += quality.megaLines;
+
+    const entry = {
+      ...quality,
+      suggestions,
+      status: quality.megaLines > 0 ? 'needs-compaction' : 'ok',
+    };
+
+    if (doc.fileName === 'prd.md') {
+      const stat = await fs.stat(docPath).catch(() => null);
+      if (stat) {
+        const staleness = await analyzeDocStaleness(resolvedRoot, stat.mtimeMs);
+        entry.versionsBehind = staleness.versionsBehind;
+        entry.totalVersions = staleness.totalVersions;
+        if (staleness.versionsBehind > DOC_STALE_VERSION_THRESHOLD) {
+          entry.status = entry.status === 'needs-compaction' ? 'needs-compaction-and-backfill' : 'needs-backfill';
+        }
+      }
+    }
+
+    docs.push(entry);
+  }
+
+  const needsAttention = docs.filter((doc) => doc.status !== 'ok');
+  const recommendations = [];
+  if (needsAttention.length > 0) {
+    recommendations.push('压缩原则：同一事实只保留一处最新版本；把巨行拆成分点；过时段落直接删除而不是追加“更新：”。');
+    recommendations.push('压缩后运行 openprd standards . --verify 确认警告消除，再运行 openprd dev-check . 收口。');
+  }
+  for (const doc of needsAttention) {
+    if (doc.status.includes('backfill')) {
+      recommendations.push(`${doc.path}: 已落后 ${doc.versionsBehind} 个 requirement 版本，需要按最新已确认需求回填基线，再删除已失效内容。`);
+    }
+    if (doc.megaLines > 0) {
+      recommendations.push(`${doc.path}: ${doc.megaLines} 行巨行（阈值 ${DOC_MEGA_LINE_CHARS} 字符），按 suggestions 列出的行号拆分。`);
+    }
+  }
+
+  return {
+    ok: true,
+    action: 'docs-compact',
+    projectRoot: resolvedRoot,
+    docsRoot: STANDARD_DOCS_ROOT,
+    analyzedDocs: docs.length,
+    docsNeedingAttention: needsAttention.length,
+    totalMegaLines,
+    docs,
+    recommendations,
+  };
+}
+
+export function printDocsCompactResult(result, json) {
+  if (json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(`docs/basic 压缩体检: ${result.docsNeedingAttention === 0 ? '健康' : `${result.docsNeedingAttention} 个文档需要处理`}`);
+  console.log(`- 已分析文档: ${result.analyzedDocs}`);
+  console.log(`- 巨行总数（> ${DOC_MEGA_LINE_CHARS} 字符）: ${result.totalMegaLines}`);
+  for (const doc of result.docs) {
+    if (doc.status === 'ok') {
+      console.log(`- ${doc.path}: 健康（${doc.lines} 行，平均 ${doc.avgLineChars} 字符/行）`);
+      continue;
+    }
+    console.log(`- ${doc.path}: ${doc.status}（${doc.lines} 行，巨行 ${doc.megaLines}，最长 ${doc.maxLineChars} 字符${doc.versionsBehind != null ? `，落后 ${doc.versionsBehind} 版本` : ''}）`);
+    for (const suggestion of doc.suggestions) {
+      console.log(`  · L${suggestion.line}（${suggestion.chars} 字符）: ${suggestion.preview}`);
+      console.log(`    ${suggestion.hint}`);
+    }
+  }
+  if (result.recommendations.length > 0) {
+    console.log('建议:');
+    for (const item of result.recommendations) {
+      console.log(`- ${item}`);
+    }
+  }
+}

package/src/execution-strategy.js

@@ -85,7 +85,7 @@ function inferParallelGroup(text, type, phase) {
 
 function inferWriteScope(parallelGroup) {
   const scopeByGroup = {
-    governance: ['openprd/changes/**', '.openprd/**'],
+    governance: ['.openprd/changes/**', '.openprd/**'],
     contracts: ['src/**', 'test/**', 'docs/basic/backend-structure.md'],
     domain: ['src/**', 'test/**'],
     surface: ['src/cli/**', 'src/**', 'test/**'],