@haaaiawd/anws 2.1.0 → 2.1.1

package/bin/cli.js

@@ -22,8 +22,7 @@ COMMANDS
 OPTIONS
   -v, --version   Print version number
   -h, --help      Show this help message
-  --target        Target AI IDE(s) for \`init\`, comma-separated (${TARGET_IDS.join(', ')})
-  --check         Preview grouped update diffs without writing files or rebuilding install-lock state
+  --target        Target AI IDE(s) for init, comma-separated (${TARGET_IDS.join(', ')})
 
 SUPPORTED TARGETS
   windsurf     workflows + skills
@@ -40,8 +39,7 @@ SUPPORTED TARGETS
 EXAMPLES
   anws init                       # Choose target IDEs and install their managed workflow projections
   anws init --target windsurf,codex,opencode
-  anws update                     # Update all matched targets from install-lock, fallback scan, or drift repair
-  anws update --check             # Preview grouped changes per target without writing files
+  anws update                     # One-click update for all matched targets from install-lock, fallback scan, or drift repair
 `.trimStart();
 
 // ─── 参数解析 ─────────────────────────────────────────────────────────────────
@@ -90,7 +88,15 @@ async function main() {
       break;
 
     case 'update':
-      await require('../lib/update')({ check: values.check });
+      if (values.target !== undefined) {
+        error('`anws update --target` has been removed. Use `anws update` to update all matched targets.');
+        process.exit(1);
+      }
+      if (values.check) {
+        error('`anws update --check` has been removed. Use `anws update` directly.');
+        process.exit(1);
+      }
+      await require('../lib/update')();
       break;
 
     default:

package/lib/changelog.js

@@ -55,6 +55,61 @@ function compareSemver(a, b) {
   return 0;
 }
 
+function normalizeText(text) {
+  return String(text || '').replace(/\r\n/g, '\n');
+}
+
+function buildMergedChangeKey(item) {
+  const canonicalPath = item.source || item.file;
+  const summaryKey = JSON.stringify(item.summary || []);
+  const contentKey = item.type === 'modified'
+    ? summaryKey
+    : `${normalizeText(item.oldContent)}\n<<<ANWS_CHANGE_SPLIT>>>\n${normalizeText(item.newContent)}`;
+
+  return `${item.type}::${canonicalPath}::${item.resourceId || canonicalPath}::${contentKey}`;
+}
+
+function mergeChanges(changes) {
+  const grouped = new Map();
+
+  for (const item of changes) {
+    const canonicalPath = item.source || item.file;
+    const key = buildMergedChangeKey(item);
+    const affectedFile = {
+      file: item.file,
+      targetId: item.targetId || null,
+      targetLabel: item.targetLabel || null
+    };
+
+    if (!grouped.has(key)) {
+      grouped.set(key, {
+        ...item,
+        canonicalPath,
+        affectedFiles: [affectedFile]
+      });
+      continue;
+    }
+
+    const current = grouped.get(key);
+    current.affectedFiles.push(affectedFile);
+  }
+
+  return Array.from(grouped.values()).map((item) => ({
+    ...item,
+    affectedFiles: item.affectedFiles.sort((left, right) => left.file.localeCompare(right.file))
+  }));
+}
+
+function formatAffectedTargetList(item) {
+  const targets = Array.from(new Set(
+    item.affectedFiles
+      .filter((entry) => entry.targetId && entry.targetLabel)
+      .map((entry) => `${entry.targetLabel} (${entry.targetId})`)
+  ));
+
+  return targets.length > 0 ? targets.join(', ') : '无';
+}
+
 function formatFileList(title, items) {
   const lines = [`### ${title}`];
   if (items.length === 0) {
@@ -63,7 +118,10 @@ function formatFileList(title, items) {
   }
 
   for (const item of items) {
-    lines.push(`- \`${item.file}\``);
+    lines.push(`- \`${item.canonicalPath}\` — 影响 Targets: ${formatAffectedTargetList(item)}`);
+    for (const affectedFile of item.affectedFiles) {
+      lines.push(`  - \`${affectedFile.file}\``);
+    }
   }
 
   return lines.join('\n');
@@ -72,7 +130,10 @@ function formatFileList(title, items) {
 function formatDetail(item) {
   if (item.type === 'added') {
     return [
-      `### \`${item.file}\``,
+      `### \`${item.canonicalPath}\``,
+      `- **影响 Targets**: ${formatAffectedTargetList(item)}`,
+      '- **影响文件**:',
+      ...item.affectedFiles.map((entry) => `  - \`${entry.file}\``),
       '- **新增文件**',
       '- **说明**: 该文件在旧版本中不存在，因此无前后逐行对比。'
     ].join('\n');
@@ -80,7 +141,10 @@ function formatDetail(item) {
 
   if (item.type === 'deleted') {
     return [
-      `### \`${item.file}\``,
+      `### \`${item.canonicalPath}\``,
+      `- **影响 Targets**: ${formatAffectedTargetList(item)}`,
+      '- **影响文件**:',
+      ...item.affectedFiles.map((entry) => `  - \`${entry.file}\``),
       '- **删除文件**',
       '- **说明**: 该文件在新版本中不存在，因此无前后逐行对比。'
     ].join('\n');
@@ -88,13 +152,19 @@ function formatDetail(item) {
 
   if (item.summary.length === 0) {
     return [
-      `### \`${item.file}\``,
+      `### \`${item.canonicalPath}\``,
+      `- **影响 Targets**: ${formatAffectedTargetList(item)}`,
+      '- **影响文件**:',
+      ...item.affectedFiles.map((entry) => `  - \`${entry.file}\``),
       '- **说明**: 检测到内容变更，但未能提取到摘要。'
     ].join('\n');
   }
 
   return [
-    `### \`${item.file}\``,
+    `### \`${item.canonicalPath}\``,
+    `- **影响 Targets**: ${formatAffectedTargetList(item)}`,
+    '- **影响文件**:',
+    ...item.affectedFiles.map((entry) => `  - \`${entry.file}\``),
     '```diff',
     ...item.summary.flatMap((pair) => [
       `- [old:${pair.oldLineNumber === null ? '-' : pair.oldLineNumber}] ${pair.oldText}`,
@@ -106,7 +176,8 @@ function formatDetail(item) {
 
 async function generateChangelog({ cwd, version, changes, targetSummary = null }) {
   const changelogDir = await ensureChangelogDir(cwd);
-  const grouped = groupChanges(changes);
+  const mergedChanges = mergeChanges(changes);
+  const grouped = groupChanges(mergedChanges);
   const now = new Date();
   const timestamp = now.toISOString().replace('T', ' ').slice(0, 19);
   const filePath = path.join(changelogDir, `v${version}.md`);
@@ -143,7 +214,7 @@ async function generateChangelog({ cwd, version, changes, targetSummary = null }
     '',
     '## 内容级变更详情',
     '',
-    ...(changes.length > 0 ? changes.map(formatDetail).flatMap((section) => [section, '']) : ['- 无变更', ''])
+    ...(mergedChanges.length > 0 ? mergedChanges.map(formatDetail).flatMap((section) => [section, '']) : ['- 无变更', ''])
   ].join('\n');
 
   await fs.writeFile(filePath, content, 'utf8');

package/lib/diff.js

@@ -137,6 +137,7 @@ async function collectManagedFileDiffs({
     ? managedFiles
     : projectionPlan.flatMap((item) => item.managedFiles || []);
   const projectionMap = new Map(normalizedProjectionEntries.map((item) => [item.outputPath, item]));
+  const fallbackTarget = projectionPlan[0] || null;
 
   for (const rel of normalizedManagedFiles) {
     if (rel === 'AGENTS.md' && !shouldWriteRootAgents) {
@@ -144,6 +145,19 @@ async function collectManagedFileDiffs({
     }
 
     const entry = projectionMap.get(rel);
+    const metadata = entry
+      ? {
+          source: entry.source,
+          resourceId: entry.id,
+          targetId: entry.targetId,
+          targetLabel: entry.targetLabel
+        }
+      : {
+          source: rel,
+          resourceId: rel === 'AGENTS.md' ? 'root-agents' : rel,
+          targetId: fallbackTarget?.targetId || null,
+          targetLabel: fallbackTarget?.targetLabel || null
+        };
     const srcPath = rel === 'AGENTS.md'
       ? srcAgents
       : path.join(path.join(__dirname, '..', 'templates'), entry.source);
@@ -160,6 +174,7 @@ async function collectManagedFileDiffs({
     if (srcExists && !destExists) {
       results.push({
         file: rel,
+        ...metadata,
         type: 'added',
         summary: [],
         oldContent: '',
@@ -171,6 +186,7 @@ async function collectManagedFileDiffs({
     if (!srcExists && destExists) {
       results.push({
         file: rel,
+        ...metadata,
         type: 'deleted',
         summary: [],
         oldContent: await readTextOrEmpty(destPath),
@@ -193,6 +209,7 @@ async function collectManagedFileDiffs({
 
     results.push({
       file: rel,
+      ...metadata,
       type: 'modified',
       summary: createLineDiff(oldContent, newContent),
       oldContent,

package/lib/update.js

@@ -5,32 +5,33 @@ const path = require('node:path');
 const { buildProjectionPlan } = require('./manifest');
 const { getTarget } = require('./adapters');
 const { planAgentsUpdate, resolveAgentsInstall, printLegacyMigrationWarning, pathExists } = require('./agents');
-const { collectManagedFileDiffs, printPreview } = require('./diff');
+const { collectManagedFileDiffs } = require('./diff');
 const { detectUpgrade, generateChangelog } = require('./changelog');
 const { writeTargetFiles } = require('./copy');
 const { createInstallLock, dedupeTargets, detectInstallState, summarizeTargetState, writeInstallLock } = require('./install-state');
 const { confirm } = require('./prompt');
 const { ROOT_AGENTS_FILE, resolveCanonicalSource } = require('./resources');
-const { success, warn, error, info, fileLine, skippedLine, blank, logo, section } = require('./output');
+const { warn, error, info, fileLine, skippedLine, blank, logo, section } = require('./output');
 
-async function update(options = {}) {
+async function update() {
   const cwd = process.cwd();
-  const check = !!options.check;
   const legacyAgentDir = path.join(cwd, '.agent');
   const { version } = require(path.join(__dirname, '..', 'package.json'));
   const installState = await detectInstallState(cwd);
   const legacyAgentExists = await pathExists(legacyAgentDir);
   const isLegacyMigration = installState.selectedTargets.length === 0 && legacyAgentExists;
-  const selectedTargetIds = isLegacyMigration ? ['antigravity'] : installState.selectedTargets;
-  const targetPlans = buildProjectionPlan(selectedTargetIds);
+  const detectedTargetIds = isLegacyMigration ? ['antigravity'] : installState.selectedTargets;
 
-  if (selectedTargetIds.length === 0 && !legacyAgentExists) {
+  if (detectedTargetIds.length === 0 && !legacyAgentExists) {
     logo();
     error('No supported Anws target layout found in current directory.');
     info('Run `anws init` first to set up the workflow system.');
     process.exit(1);
   }
 
+  const targetPlans = buildProjectionPlan(detectedTargetIds);
+  const detectedTargetPlans = buildProjectionPlan(detectedTargetIds);
+
   const srcAgents = ROOT_AGENTS_FILE;
 
   if (isLegacyMigration) {
@@ -100,41 +101,18 @@ async function update(options = {}) {
 
   const changes = targetContexts.flatMap((context) => context.changes);
 
-  if (check) {
-    if (!versionState.needUpgrade) {
-      if (!isLegacyMigration) {
-        logo();
-        blank();
-      }
-      info(`Already up to date. Latest recorded version is v${versionState.latestVersion || version}.`);
-      printTargetSelection(installState, targetContexts.map((context) => context.target));
-      return;
-    }
-    if (!isLegacyMigration) {
-      logo();
-      blank();
-    }
-    printTargetSelection(installState, targetContexts.map((context) => context.target));
-    printPreview({
-      fromVersion: versionState.fromVersion,
-      toVersion: versionState.toVersion,
-      changes
-    });
-    return;
-  }
-
   if (!versionState.needUpgrade) {
     if (!isLegacyMigration) {
       logo();
       blank();
     }
     printTargetSelection(installState, targetContexts.map((context) => context.target));
-    if (!check && installState.canRebuildLock && selectedTargetIds.length > 0) {
+    if (installState.canRebuildLock && detectedTargetIds.length > 0) {
       const generatedAt = new Date().toISOString();
       await writeInstallLock(cwd, createInstallLock({
         cliVersion: version,
         generatedAt,
-        targets: dedupeTargets(targetPlans.map((targetPlan) => summarizeTargetState(targetPlan, version))),
+        targets: dedupeTargets(detectedTargetPlans.map((targetPlan) => summarizeTargetState(targetPlan, version))),
         lastUpdateSummary: {
           successfulTargets: [],
           failedTargets: [],
@@ -152,15 +130,7 @@ async function update(options = {}) {
     blank();
   }
 
-  const confirmed = await askUpdate({
-    installState,
-    targets: targetContexts.map((context) => context.target)
-  });
-  if (!confirmed) {
-    blank();
-    info('Aborted. No files were changed.');
-    return;
-  }
+  printTargetSelection(installState, targetContexts.map((context) => context.target));
 
   const updated = [];
   const skipped = [];
@@ -217,6 +187,12 @@ async function update(options = {}) {
     }
   });
   const generatedAt = new Date().toISOString();
+  const successfulTargetIdSet = new Set(successfulTargets.map((item) => item.targetId));
+  const retainedDetectedTargets = installState.canRebuildLock
+    ? detectedTargetPlans
+        .filter((targetPlan) => !successfulTargetIdSet.has(targetPlan.targetId))
+        .map((targetPlan) => summarizeTargetState(targetPlan, version))
+    : [];
   const existingLockTargets = installState.canRebuildLock
     ? []
     : (installState.lockResult.lock?.targets || []);
@@ -225,6 +201,7 @@ async function update(options = {}) {
     generatedAt,
     targets: dedupeTargets([
       ...existingLockTargets,
+      ...retainedDetectedTargets,
       ...successfulTargets
     ]),
     lastUpdateSummary: {
@@ -251,23 +228,6 @@ async function update(options = {}) {
   });
 }
 
-async function askUpdate({ installState, targets }) {
-  if (global.__ANWS_FORCE_YES) return true;
-
-  if (!process.stdin.isTTY) {
-    warn('Non-TTY environment detected. Skipping update to avoid accidental overwrites.');
-    return false;
-  }
-
-  return confirm({
-    message: buildUpdateConfirmationMessage(targets),
-    contextLines: buildUpdateConfirmationContextLines(installState, targets),
-    confirmLabel: 'Continue',
-    cancelLabel: 'Cancel',
-    defaultValue: false
-  });
-}
-
 async function askMigrate() {
   if (global.__ANWS_FORCE_YES) return true;
 
@@ -308,23 +268,8 @@ async function maybeDeleteLegacyDir(legacyAgentDir) {
   return true;
 }
 
-function buildUpdateConfirmationMessage(targets) {
-  const labels = targets.map((target) => target.label).filter(Boolean);
-  if (labels.length === 0) {
-    return 'This will overwrite all managed files for the detected target layout.';
-  }
-  return `This will overwrite all managed files for: ${labels.join(', ')}.`;
-}
-
-function buildUpdateConfirmationContextLines(installState, targets) {
-  const lines = [
-    `Matched targets: ${targets.map((target) => `${target.label} (${target.id})`).join(', ') || 'none'}`,
-    installState.needsFallback ? 'State source: directory scan fallback' : 'State source: install-lock + directory scan'
-  ];
-  if (installState.drift.hasDrift) {
-    lines.push(`State drift detected. Missing on disk: ${installState.drift.missingOnDisk.join(', ') || 'none'}; untracked on disk: ${installState.drift.untrackedOnDisk.join(', ') || 'none'}.`);
-  }
-  return lines;
+function buildSelectionModeLine() {
+  return 'Selection mode: detected target layout';
 }
 
 function printLegacyMigrationNotice() {
@@ -338,6 +283,7 @@ function printLegacyMigrationNotice() {
 function printTargetSelection(installState, targets) {
   blank();
   section('Target selection', [
+    buildSelectionModeLine(),
     `Matched targets: ${targets.map((target) => `${target.label} (${target.id})`).join(', ') || 'none'}`,
     installState.needsFallback ? 'State source: directory scan fallback' : 'State source: install-lock + directory scan',
     ...(installState.drift.hasDrift

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haaaiawd/anws",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Anws — A spec-driven workflow framework for AI-assisted development. Empowers prompt engineers to build production-ready software through structured PRD → Architecture → Task decomposition. Works with Claude Code, GitHub Copilot, Cursor, Windsurf, and any tool that reads AGENTS.md.",
   "keywords": [
     "anws",

package/templates/.agents/skills/design-reviewer/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: design-reviewer
-description: 使用三维框架（系统设计、运行模拟、工程实现）系统性审查架构和系统设计文档。产出按严重度分级的发现，关联到具体文档段落。
+description: 使用三维框架（系统设计、运行模拟、工程实现）系统性审查架构和系统设计文档，作为 challenge 工作流中的规范契约设计证据层。产出按严重度分级的发现，关联到具体文档段落。
 ---
 
 # 设计审查大师手册
@@ -9,6 +9,8 @@ description: 使用三维框架（系统设计、运行模拟、工程实现）
 > 对设计严厉，代码才能优雅。"
 
 你是**设计审查大师**，负责系统性审查架构和系统设计文档。你的三维框架确保没有任何一类风险被遗漏。
+在 `/challenge` 工作流中，你的角色是：**为规范契约是否闭合提供设计侧证据**，而不是单独给出脱离上下文的最终裁决。
+你优先要证明的是：哪些契约在**系统边界、接口、状态、时序、错误路径**上没有闭合。
 
 ---
 
@@ -126,15 +128,28 @@ description: 使用三维框架（系统设计、运行模拟、工程实现）
 | 工程实现 | — | — | — | — | — |
 | **合计** | **—** | **—** | **—** | **—** | **—** |
 
+**高信号结论**: [用 1-3 句概括最值得进入 challenge 主报告的问题]
+
 ---
 
-### [维度] — [ID]: [标题]
+### 核心发现清单
 
-**严重度**: Critical / High / Medium / Low
-**文档位置**: [精确的文件和章节引用]
+| ID | 维度 | 严重度 | 文档位置 | 发现 | 影响 | 建议 |
+|----|------|--------|----------|------|------|------|
+| DR-01 | 系统设计 | Critical | 02_ARCHITECTURE_OVERVIEW.md §X | 边界定义冲突，两个系统职责重叠 | 实现阶段职责漂移、返工风险高 | 重新划清系统边界并更新引用 |
+| DR-02 | 运行模拟 | High | 04_SYSTEM_DESIGN/... §Y | 故障传播路径未定义 | 级联失败时无法收敛 | 增加超时/降级/重试策略 |
+| DR-03 | 工程实现 | Medium | ADR-00X / System Design §Z | 可测试接缝不足 | 后续验证成本高 | 增加接口隔离或 mock 接缝 |
+
+> 仅输出真正影响设计判断的问题。低价值措辞、重复担忧不要进入清单。
+
+---
+
+### Top Findings 详情（仅展开 Critical / High）
 
-**问题**:
-[详细描述，引用具体文档内容]
+#### DR-01 [标题]
+
+**严重度**: Critical  
+**文档位置**: [精确的文件和章节引用]
 
 **证据**:
 - 文档分析: [来自 PRD/Architecture/ADR 的具体内容]
@@ -145,7 +160,7 @@ description: 使用三维框架（系统设计、运行模拟、工程实现）
 - [不修复会发生什么]
 
 **建议**:
-[修复方式，可提供多个选项]
+- [最小修复方向]
 ```
 
 ---

package/templates/.agents/skills/system-designer/references/system-design-template.md

@@ -537,14 +537,31 @@ classDiagram
 - **RBAC (Role-Based Access Control)**: 基于角色的访问控制
 - **p95**: 95th percentile，95%的请求响应时间小于该值
 
-### 14.2 References (参考资料)
+### 14.2 Optional Skills & Reference Resources (可选 Skills 与参考资源)
+>
+> 本节用于记录在设计过程中实际参考过的 skill、组件库、方法论或外部资料。
+> 这些内容是辅助输入，不是系统事实来源；最终方案仍以本项目的 PRD、ADR、Architecture Overview 和本文档自身为准。
+>
+> **记录建议**:
+> - 写明资源名称
+> - 写明它帮助了哪个设计决策
+> - 写明最终采纳了什么，舍弃了什么
+>
+> **示例（前端系统）**:
+> - `vercel-react-best-practices`: 用于校验 React 组件边界、渲染策略、性能优化建议
+> - `frontend-design`: 用于参考排版、配色、层级和动效方向
+> - `shadcn/ui`: 用于基础组件模式参考
+> - `Aceternity UI`: 用于展示型区块和交互动效灵感
+> - `Magic UI`: 用于 Tailwind-first 的视觉与动画参考
+
+### 14.3 References (参考资料)
 - [FastAPI Documentation](https://fastapi.tiangolo.com/)
 - [PostgreSQL Best Practices](https://wiki.postgresql.org/wiki/Don%27t_Do_This)
 - [JWT Best Practices](https://tools.ietf.org/html/rfc8725)
 - [Architecture Overview](../02_ARCHITECTURE_OVERVIEW.md)
 - [ADR001: Tech Stack](../03_ADR/ADR001_TECH_STACK.md)
 
-### 14.3 Change Log (变更日志)
+### 14.4 Change Log (变更日志)
 
 | Version | Date       | Changes  | Author |
 | ------- | ---------- | -------- | ------ |

package/templates/.agents/skills/task-reviewer/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: task-reviewer
-description: 系统性审查 05_TASKS.md 的质量与完备性。通过 6 大检测 Pass 在语义模型上运行，检测重复、歧义、欠详述、不一致、覆盖缺口和质量问题。
+description: 系统性审查 05_TASKS.md 的质量与完备性，作为 challenge 工作流中的规范契约任务承接证据层。通过 6 大检测 Pass 在语义模型上运行，检测重复、歧义、欠详述、不一致、覆盖缺口和质量问题。
 ---
 
 # 任务审查大师手册
@@ -9,10 +9,11 @@ description: 系统性审查 05_TASKS.md 的质量与完备性。通过 6 大检
 > 在代码暴露问题之前，找到裂缝。"
 
 你是**任务审查大师**，负责对 `05_TASKS.md` 进行系统性审计——以 PRD、Architecture 和 ADR 文档为基准，运行 **6 大检测 Pass**。你的武器是**语义模型**，而非朴素的字符串匹配。
+在 `/challenge` 工作流中，你的角色是：**为规范契约是否被任务承接、覆盖和验证提供证据**，而不是单独替代 challenge 的总判断。
+你优先要证明的是：关键承诺是否有实现任务、验证任务、边界/失败路径任务，以及是否存在幽灵任务稀释主轴。
 
 ---
-
-## ⚡ 任务目标
+## 任务目标
 
 1. **加载文档 (必须)**: 读取 `.anws/v{N}/05_TASKS.md`、`01_PRD.md`、`02_ARCHITECTURE_OVERVIEW.md` 以及所有 `03_ADR/*.md`。
 2. **构建语义模型**: 构建 3 个清单模型（见 §语义模型构建）。
@@ -21,7 +22,7 @@ description: 系统性审查 05_TASKS.md 的质量与完备性。通过 6 大检
 5. **生成报告**: 输出任务审查报告（见 §输出格式）。
 6. **展示摘要**: 向用户展示检测汇总表 + 前 10 条发现。
 
-## 🛑 硬约束
+## 硬约束
 
 - **发现上限**: 最多 50 条。超出时按严重度排序 → 截断 → 追加溢出摘要。
 - **只报告不修复**: 本技能**仅输出报告**。修复由用户或其他工作流完成。
@@ -29,8 +30,7 @@ description: 系统性审查 05_TASKS.md 的质量与完备性。通过 6 大检
 - **客观性**: 仅标记客观可检测的问题。不要为了填满报告而捏造问题。
 
 ---
-
-## 🧠 语义模型构建
+## 语义模型构建
 
 > 在执行任何 Pass 之前，先构建以下 3 个模型。所有 Pass 在模型上操作，而非原始文本。
 
@@ -206,6 +206,8 @@ T{X.Y.Z}: 标题
 
 **整体健康度**: 🟢 健康 / 🟡 需关注 / 🔴 阻塞
 
+**高信号结论**: [用 1-3 句概括最值得进入 challenge 主报告的问题]
+
 ---
 
 ### REQ 覆盖率
@@ -248,14 +250,36 @@ graph LR
 
 ---
 
-### 问题清单
+### 核心发现清单
+
+| ID | 严重度 | Pass | 位置 | 发现 | 影响 | 建议 |
+|----|:------:|:----:|------|------|------|------|
+| TR-01 | CRITICAL | E1 | REQ-003 / 05_TASKS.md §X | P0 需求无对应任务 | 核心能力无法落地 | 在对应 Sprint 增加实现与验证任务 |
+| TR-02 | HIGH | B1 | T4.1.3 | 验收标准使用“正确处理”等模糊措辞 | 任务不可验证 | 量化错误码、兜底行为和验证方式 |
+| TR-03 | HIGH | D1 | PRD / Architecture / Tasks | 术语漂移导致任务引用不一致 | 实施与对齐成本上升 | 按 ADR 统一术语 |
 
-| ID | 严重度 | Pass | 描述 | 建议 |
-|----|:------:|:----:|------|------|
-| TR-01 | CRITICAL | E | REQ-003 无对应任务 | 在 S2 增加 T2.2.6 |
-| TR-02 | HIGH | B | T4.1.3 验收标准使用"正确处理" | 量化：指明具体错误码+兜底行为 |
-| TR-03 | HIGH | D | "game core" vs "核心引擎" 术语漂移 | 按 ADR 统一为 "Core Engine" |
-| ... | ... | ... | ... | ... |
+> 仅输出真正影响执行和验收的问题。低价值措辞润色不要淹没核心发现。
+
+---
+
+### Top Findings 详情（仅展开 Critical / High）
+
+#### TR-01 [标题]
+
+**Pass**: E1  
+**严重度**: CRITICAL  
+**位置**: [REQ-ID / Task ID / 文档章节]
+
+**证据**:
+- 需求来源: [PRD 中的 REQ / US]
+- 任务映射: [哪些任务缺失 / 不完整]
+- 交叉验证: [与 Architecture / ADR 的不一致点，如适用]
+
+**影响**:
+- [不修复会导致什么执行或交付问题]
+
+**建议**:
+- [最小修复方向]
 
 ---
 
@@ -268,14 +292,17 @@ graph LR
 
 ## 🎚️ 严重度分级
 
-| 等级 | 判定标准 | 典型示例 |
+| 等级 | 判定标准 | 所需行动 |
 |:----:|---------|---------|
-| **CRITICAL** | 阻塞执行或遗漏核心功能 | PRD 需求零覆盖；Sprint 依赖环；核心文档缺失 |
-| **HIGH** | 导致返工或产出不可验证 | 重复任务；模糊的安全/性能验收；不可测标准；技术栈冲突 |
-| **MEDIUM** | 影响质量但不阻塞 | 术语漂移；NFR 覆盖缺失；边界情况欠详细 |
-| **LOW** | 润色项，不影响执行 | 措辞改进；轻微冗余；仅供参考 |
+| **Critical** 🔴 | 根本性矛盾或不可能实现。不解决无法继续。 | P0 — 必须在 blueprint/forge 之前修复 |
+| **High** 🟠 | 大概率导致返工或失败的严重风险。 | P1 — 在 forge 之前修复 |
+| **Medium** 🟡 | 有变通方案的质量隐患。 | P2 — 实现阶段修复 |
+| **Low** 🟢 | 润色项或轻微不一致。 | P3 — 后续跟踪 |
+
+**健康度规则**: Critical ≥ 1 → 整体健康度设为 🔴 阻塞。High ≥ 5 → 🟡 需关注。其余 → 🟢 健康。
 
-**升级规则**: CRITICAL ≥ 1 → 整体健康度设为 🔴 阻塞。HIGH ≥ 5 → 🟡 需关注。其余 → 🟢 健康。
+> [!NOTE]
+> 输出时优先保留 Critical / High。Medium / Low 仅在确实影响执行判断或有稳定改进价值时保留。
 
 ---