@haaaiawd/anws 2.0.5 → 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.0.5",
+  "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-planner/SKILL.md

@@ -18,8 +18,10 @@ description: 使用WBS方法将系统设计文档分解为层次化任务。支
 2. **加载必需文档**：读取 Architecture Overview + PRD
 3. **加载可选文档**：扫描 ADR 目录 + System Design 目录
 4. **缺失检查**：必需文档缺失则报错退出
-5. **执行拆解**：按 WBS 方法拆解任务
-6. **输出**：保存到 `.anws/v{N}/05_TASKS.md`
+5. **加载测试约束**：如果 Workflow 或 ADR 提供测试策略、质量门禁、Sprint 边界，必须一并纳入任务生成输入
+6. **执行拆解**：按 WBS 方法拆解任务
+7. **应用验证类型选择逻辑**：为每个任务分配“最轻但足够”的验证类型，避免默认升级为 E2E
+8. **输出**：保存到 `.anws/v{N}/05_TASKS.md`
 
 ---
 
@@ -33,6 +35,13 @@ description: 使用WBS方法将系统设计文档分解为层次化任务。支
 > 3. **可验证** - 每个Task有明确的Done When标准
 > 4. **可追溯** - 每个Task关联PRD需求 [REQ-XXX]
 
+> [!IMPORTANT]
+> **测试规划附加原则**：
+> - 优先选择**最轻但足够**的验证类型
+> - 如 Workflow / ADR 已声明测试策略，必须优先遵循，不得自行改重
+> - **冒烟测试默认仅用于 `INT-S{N}` 或极少数里程碑任务**
+> - **回归测试仅在已有关键能力可能被破坏时生成**，不是所有任务的默认要求
+
 ❌ **错误做法**：
 - 平铺任务列表（无层次）
 - 任务过大（如"实现整个后端"）
@@ -114,6 +123,7 @@ description: 使用WBS方法将系统设计文档分解为层次化任务。支
   - **验收标准**: 
     - [ ] Done When 1
     - [ ] Done When 2
+  - **验证类型**: 单元测试 | 集成测试 | E2E测试 | 冒烟测试 | 回归测试 | 手动验证 | 编译检查 | Lint检查
   - **验证说明**: 如何确认任务完成 (检查什么，如何确认)
   - **估时**: 预估工时（如: 2h, 1d, 1w）
   - **依赖**: T{X}.{Y}.{Z} (依赖的Task ID)
@@ -130,11 +140,39 @@ description: 使用WBS方法将系统设计文档分解为层次化任务。支
     - [ ] `npm run dev` 正常启动
     - [ ] 页面显示"Hello World"
     - [ ] TypeScript类型检查通过
+  - **验证类型**: 编译检查
   - **估时**: 2h
   - **依赖**: 无
   - **优先级**: P0
 ```
 
+### 验证类型选择逻辑
+
+> [!IMPORTANT]
+> **如果 Workflow 未给出更具体约束，按以下默认顺序决策：**
+
+1. **局部逻辑 / 纯算法 / 数据变换** → 单元测试
+2. **跨模块 / 接口 / 数据库 / 多服务协作** → 集成测试
+3. **直接面向终端用户的关键路径** → E2E测试 或 手动验证
+4. **Sprint 退出标准 / 里程碑 gate** → 冒烟测试
+5. **修改可能影响已完成关键能力** → 回归测试
+6. **配置、脚手架、基础设施** → 编译检查 / Lint检查 / 手动验证
+
+**选择细则**:
+- 不要因为任务“看起来重要”就默认选择 E2E测试
+- 如果集成测试足以证明任务完成，就不要升级为 E2E测试
+- 如果只是里程碑 readiness 检查，优先使用少量冒烟测试，而不是新建大量 E2E任务
+- 如果只是验证旧能力未被破坏，优先复用已有测试集合作为回归测试
+
+### Sprint 与冒烟测试绑定规则
+
+> [!IMPORTANT]
+> **只有在 Workflow 已提供 Sprint 路线图 / INT 任务语义时，才应生成里程碑级冒烟测试。**
+
+- 如果上游 Workflow 已定义 `INT-S{N}`，则将冒烟测试优先绑定到这些 INT 任务
+- 不要为每个普通 Level 3 开发任务单独生成冒烟测试
+- 若没有明确 Sprint / 里程碑边界，则优先退回单元测试、集成测试、手动验证，而不是滥造冒烟任务
+
 ### 接口追溯规则
 
 > [!IMPORTANT]