@haaaiawd/anws 2.2.5 → 2.3.0

package/README.md

@@ -4,7 +4,7 @@
 <img src="assets/logo-cli.png" width="260" alt="Anws">
 
 [![License: MIT](https://opensource.org/licenses/MIT)](https://opensource.org/licenses/MIT)
-[![Version](https://img.shields.io/badge/version-v2.2.5-7FB5B6)](https://github.com/Haaaiawd/ANWS/releases)
+[![Version](https://img.shields.io/badge/version-v2.3.0--WIP-7FB5B6)](https://github.com/Haaaiawd/ANWS/releases)
 [![Targets](https://img.shields.io/badge/Targets-Windsurf%20%7C%20Claude%20Code%20%7C%20Copilot%20%7C%20Cursor%20%7C%20Codex%20Preview%20%7C%20OpenCode%20%7C%20Trae%20%7C%20Qoder%20%7C%20Kilo%20Code-blueviolet)](https://github.com/Haaaiawd/ANWS)
 
 [English](./README.md) | [中文](./README_CN.md)

package/lib/manifest.js

@@ -1,212 +1,213 @@
-'use strict';
-
-const { getTarget } = require('./adapters');
-
-/**
- * MANAGED_FILES — anws 托管文件清单
- *
- * 此数组列出 anws 包负责管理的所有文件路径（相对于目标项目根目录）。
- */
-const RESOURCE_REGISTRY = [
-  { id: 'blueprint', type: 'workflow', source: '.agents/workflows/blueprint.md', fileName: 'blueprint.md' },
-  { id: 'challenge', type: 'workflow', source: '.agents/workflows/challenge.md', fileName: 'challenge.md' },
-  { id: 'change', type: 'workflow', source: '.agents/workflows/change.md', fileName: 'change.md' },
-  { id: 'craft', type: 'workflow', source: '.agents/workflows/craft.md', fileName: 'craft.md' },
-  { id: 'design-system', type: 'workflow', source: '.agents/workflows/design-system.md', fileName: 'design-system.md' },
-  { id: 'explore', type: 'workflow', source: '.agents/workflows/explore.md', fileName: 'explore.md' },
-  { id: 'forge', type: 'workflow', source: '.agents/workflows/forge.md', fileName: 'forge.md' },
-  { id: 'genesis', type: 'workflow', source: '.agents/workflows/genesis.md', fileName: 'genesis.md' },
-  { id: 'probe', type: 'workflow', source: '.agents/workflows/probe.md', fileName: 'probe.md' },
-  { id: 'quickstart', type: 'workflow', source: '.agents/workflows/quickstart.md', fileName: 'quickstart.md' },
-  { id: 'upgrade', type: 'workflow', source: '.agents/workflows/upgrade.md', fileName: 'upgrade.md' },
-  { id: 'anws-system', type: 'skill', source: '.agents/skills/anws-system/SKILL.md', fileName: 'anws-system/SKILL.md', targets: ['codex', 'trae'] },
-  { id: 'concept-modeler', type: 'skill', source: '.agents/skills/concept-modeler/SKILL.md', fileName: 'concept-modeler/SKILL.md' },
-  { id: 'code-reviewer', type: 'skill', source: '.agents/skills/code-reviewer/SKILL.md', fileName: 'code-reviewer/SKILL.md' },
-  { id: 'design-reviewer', type: 'skill', source: '.agents/skills/design-reviewer/SKILL.md', fileName: 'design-reviewer/SKILL.md' },
-  { id: 'nexus-mapper', type: 'skill', source: '.agents/skills/nexus-mapper/SKILL.md', fileName: 'nexus-mapper/SKILL.md' },
-  { id: 'nexus-mapper-language-customization', type: 'skill', source: '.agents/skills/nexus-mapper/references/language-customization.md', fileName: 'nexus-mapper/references/language-customization.md' },
-  { id: 'nexus-mapper-output-schema', type: 'skill', source: '.agents/skills/nexus-mapper/references/output-schema.md', fileName: 'nexus-mapper/references/output-schema.md' },
-  { id: 'nexus-mapper-probe-protocol', type: 'skill', source: '.agents/skills/nexus-mapper/references/probe-protocol.md', fileName: 'nexus-mapper/references/probe-protocol.md' },
-  { id: 'nexus-mapper-extract-ast', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/extract_ast.py', fileName: 'nexus-mapper/scripts/extract_ast.py' },
-  { id: 'nexus-mapper-git-detective', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/git_detective.py', fileName: 'nexus-mapper/scripts/git_detective.py' },
-  { id: 'nexus-mapper-languages', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/languages.json', fileName: 'nexus-mapper/scripts/languages.json' },
-  { id: 'nexus-mapper-query-graph', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/query_graph.py', fileName: 'nexus-mapper/scripts/query_graph.py' },
-  { id: 'nexus-mapper-requirements', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/requirements.txt', fileName: 'nexus-mapper/scripts/requirements.txt' },
-  { id: 'report-template', type: 'skill', source: '.agents/skills/report-template/SKILL.md', fileName: 'report-template/SKILL.md' },
-  { id: 'report-template-reference', type: 'skill', source: '.agents/skills/report-template/references/REPORT_TEMPLATE.md', fileName: 'report-template/references/REPORT_TEMPLATE.md' },
-  { id: 'runtime-inspector', type: 'skill', source: '.agents/skills/runtime-inspector/SKILL.md', fileName: 'runtime-inspector/SKILL.md' },
-  { id: 'sequential-thinking', type: 'skill', source: '.agents/skills/sequential-thinking/SKILL.md', fileName: 'sequential-thinking/SKILL.md' },
-  { id: 'spec-writer', type: 'skill', source: '.agents/skills/spec-writer/SKILL.md', fileName: 'spec-writer/SKILL.md' },
-  { id: 'spec-writer-prd-template', type: 'skill', source: '.agents/skills/spec-writer/references/prd_template.md', fileName: 'spec-writer/references/prd_template.md' },
-  { id: 'system-architect', type: 'skill', source: '.agents/skills/system-architect/SKILL.md', fileName: 'system-architect/SKILL.md' },
-  { id: 'system-architect-rfc-template', type: 'skill', source: '.agents/skills/system-architect/references/rfc_template.md', fileName: 'system-architect/references/rfc_template.md' },
-  { id: 'system-designer', type: 'skill', source: '.agents/skills/system-designer/SKILL.md', fileName: 'system-designer/SKILL.md' },
-  { id: 'system-designer-detail-template', type: 'skill', source: '.agents/skills/system-designer/references/system-design-detail-template.md', fileName: 'system-designer/references/system-design-detail-template.md' },
-  { id: 'system-designer-template', type: 'skill', source: '.agents/skills/system-designer/references/system-design-template.md', fileName: 'system-designer/references/system-design-template.md' },
-  { id: 'task-planner', type: 'skill', source: '.agents/skills/task-planner/SKILL.md', fileName: 'task-planner/SKILL.md' },
-  { id: 'task-planner-template', type: 'skill', source: '.agents/skills/task-planner/references/TASK_TEMPLATE.md', fileName: 'task-planner/references/TASK_TEMPLATE.md' },
-  { id: 'task-reviewer', type: 'skill', source: '.agents/skills/task-reviewer/SKILL.md', fileName: 'task-reviewer/SKILL.md' },
-  { id: 'tech-evaluator', type: 'skill', source: '.agents/skills/tech-evaluator/SKILL.md', fileName: 'tech-evaluator/SKILL.md' },
-  { id: 'tech-evaluator-adr-template', type: 'skill', source: '.agents/skills/tech-evaluator/references/ADR_TEMPLATE.md', fileName: 'tech-evaluator/references/ADR_TEMPLATE.md' },
-  { id: 'e2e-testing-guide', type: 'skill', source: '.agents/skills/e2e-testing-guide/SKILL.md', fileName: 'e2e-testing-guide/SKILL.md' },
-  { id: 'craft-authoring', type: 'skill', source: '.agents/skills/craft-authoring/SKILL.md', fileName: 'craft-authoring/SKILL.md' }
-];
-
-function toArray(value) {
-  return Array.isArray(value) ? value : [value];
-}
-
-function toProjectionFileName(resource, projectionType, targetId) {
-  if ((targetId === 'codex' || targetId === 'trae') && projectionType === 'skills' && resource.type === 'workflow') {
-    return `anws-system/references/${resource.id}.md`;
-  }
-  if (projectionType === 'commands') {
-    return `${resource.id}.md`;
-  }
-  if (projectionType === 'prompts') {
-    return targetId === 'copilot' ? `${resource.id}.prompt.md` : `${resource.id}.md`;
-  }
-  if (projectionType === 'agents') {
-    return `${resource.id}.md`;
-  }
-  return resource.fileName;
-}
-
-function buildProjectionEntries(targetId) {
-  const target = getTarget(targetId);
-  const typeMap = target.projectionTypes;
-
-  return RESOURCE_REGISTRY.flatMap((resource) => {
-    if (resource.targets && !resource.targets.includes(target.id)) {
-      return [];
-    }
-    const projectionTypes = typeMap[resource.type];
-    if (!projectionTypes) {
-      return [];
-    }
-
-    return toArray(projectionTypes).map((projectionType) => {
-      const outputFileName = toProjectionFileName(resource, projectionType, target.id);
-      return {
-        ...resource,
-        projectionType,
-        outputRoot: target.projections[projectionType],
-        outputPath: `${target.projections[projectionType]}/${outputFileName}`
-      };
-    });
-  });
-}
-
-function buildManagedManifest(targetIds = ['antigravity']) {
-  return toArray(targetIds).flatMap((targetId) => {
-    const target = getTarget(targetId);
-    const entries = buildProjectionEntries(target.id).map((entry) => ({
-      ...entry,
-      targetId: target.id,
-      targetLabel: target.label,
-      ownershipKey: `${target.id}:${entry.outputPath}`
-    }));
-
-    if (!target.rootAgentFile) {
-      return entries;
-    }
-
-    return [
-      {
-        id: 'root-agents',
-        type: 'root',
-        source: 'AGENTS.md',
-        fileName: 'AGENTS.md',
-        projectionType: 'rootAgentFile',
-        outputRoot: '.',
-        outputPath: 'AGENTS.md',
-        targetId: target.id,
-        targetLabel: target.label,
-        ownershipKey: `${target.id}:AGENTS.md`
-      },
-      ...entries
-    ];
-  });
-}
-
-function buildProjectionPlan(targetIds = ['antigravity'], resources = RESOURCE_REGISTRY) {
-  return toArray(targetIds).map((targetId) => {
-    const target = getTarget(targetId);
-    const typeMap = target.projectionTypes;
-    const projectionEntries = resources.flatMap((resource) => {
-      if (resource.targets && !resource.targets.includes(target.id)) {
-        return [];
-      }
-      const projectionTypes = typeMap[resource.type];
-      if (!projectionTypes) {
-        return [];
-      }
-
-      return toArray(projectionTypes).map((projectionType) => {
-        const outputFileName = toProjectionFileName(resource, projectionType, target.id);
-        const outputPath = `${target.projections[projectionType]}/${outputFileName}`;
-        return {
-          ...resource,
-          projectionType,
-          outputRoot: target.projections[projectionType],
-          outputPath,
-          targetId: target.id,
-          targetLabel: target.label,
-          ownershipKey: `${target.id}:${outputPath}`
-        };
-      });
-    });
-
-    const managedFiles = target.rootAgentFile
-      ? ['AGENTS.md', ...projectionEntries.map((item) => item.outputPath)]
-      : projectionEntries.map((item) => item.outputPath);
-
-    return {
-      target,
-      targetId: target.id,
-      targetLabel: target.label,
-      managedFiles,
-      userProtectedFiles: buildUserProtectedFiles(target.id),
-      projectionEntries,
-      ownership: projectionEntries.map((item) => item.ownershipKey)
-    };
-  });
-}
-
-function buildManagedFiles(targetId = 'antigravity') {
-  return buildManagedManifest(targetId).map((item) => item.outputPath);
-}
-
-function buildUserProtectedFiles(targetId = 'antigravity') {
-  const target = getTarget(targetId);
-  return target.rootAgentFile ? ['AGENTS.md'] : [];
-}
-
-function findByType(type) {
-  return RESOURCE_REGISTRY.filter((item) => item.type === type);
-}
-
-const MANAGED_FILES = buildManagedFiles('antigravity');
-
-/**
- * USER_PROTECTED_FILES — 用户保护文件
- *
- * 这些文件在项目初始化后通常会包含特定于项目的配置。
- * anws update 默认会跳过这些文件。
- */
-const USER_PROTECTED_FILES = buildUserProtectedFiles('antigravity');
-
-module.exports = {
-  RESOURCE_REGISTRY,
-  buildManagedManifest,
-  buildProjectionPlan,
-  buildManagedFiles,
-  buildProjectionEntries,
-  buildUserProtectedFiles,
-  findByType,
-  MANAGED_FILES,
-  USER_PROTECTED_FILES
-};
-
-
-
+'use strict';
+
+const { getTarget } = require('./adapters');
+
+/**
+ * MANAGED_FILES — anws 托管文件清单
+ *
+ * 此数组列出 anws 包负责管理的所有文件路径（相对于目标项目根目录）。
+ */
+const RESOURCE_REGISTRY = [
+  { id: 'blueprint', type: 'workflow', source: '.agents/workflows/blueprint.md', fileName: 'blueprint.md' },
+  { id: 'challenge', type: 'workflow', source: '.agents/workflows/challenge.md', fileName: 'challenge.md' },
+  { id: 'change', type: 'workflow', source: '.agents/workflows/change.md', fileName: 'change.md' },
+  { id: 'craft', type: 'workflow', source: '.agents/workflows/craft.md', fileName: 'craft.md' },
+  { id: 'design-system', type: 'workflow', source: '.agents/workflows/design-system.md', fileName: 'design-system.md' },
+  { id: 'explore', type: 'workflow', source: '.agents/workflows/explore.md', fileName: 'explore.md' },
+  { id: 'forge', type: 'workflow', source: '.agents/workflows/forge.md', fileName: 'forge.md' },
+  { id: 'genesis', type: 'workflow', source: '.agents/workflows/genesis.md', fileName: 'genesis.md' },
+  { id: 'probe', type: 'workflow', source: '.agents/workflows/probe.md', fileName: 'probe.md' },
+  { id: 'quickstart', type: 'workflow', source: '.agents/workflows/quickstart.md', fileName: 'quickstart.md' },
+  { id: 'upgrade', type: 'workflow', source: '.agents/workflows/upgrade.md', fileName: 'upgrade.md' },
+  { id: 'anws-system', type: 'skill', source: '.agents/skills/anws-system/SKILL.md', fileName: 'anws-system/SKILL.md', targets: ['codex', 'trae'] },
+  { id: 'concept-modeler', type: 'skill', source: '.agents/skills/concept-modeler/SKILL.md', fileName: 'concept-modeler/SKILL.md' },
+  { id: 'code-reviewer', type: 'skill', source: '.agents/skills/code-reviewer/SKILL.md', fileName: 'code-reviewer/SKILL.md' },
+  { id: 'design-reviewer', type: 'skill', source: '.agents/skills/design-reviewer/SKILL.md', fileName: 'design-reviewer/SKILL.md' },
+  { id: 'nexus-mapper', type: 'skill', source: '.agents/skills/nexus-mapper/SKILL.md', fileName: 'nexus-mapper/SKILL.md' },
+  { id: 'nexus-mapper-language-customization', type: 'skill', source: '.agents/skills/nexus-mapper/references/language-customization.md', fileName: 'nexus-mapper/references/language-customization.md' },
+  { id: 'nexus-mapper-output-schema', type: 'skill', source: '.agents/skills/nexus-mapper/references/output-schema.md', fileName: 'nexus-mapper/references/output-schema.md' },
+  { id: 'nexus-mapper-probe-protocol', type: 'skill', source: '.agents/skills/nexus-mapper/references/probe-protocol.md', fileName: 'nexus-mapper/references/probe-protocol.md' },
+  { id: 'nexus-mapper-extract-ast', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/extract_ast.py', fileName: 'nexus-mapper/scripts/extract_ast.py' },
+  { id: 'nexus-mapper-git-detective', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/git_detective.py', fileName: 'nexus-mapper/scripts/git_detective.py' },
+  { id: 'nexus-mapper-languages', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/languages.json', fileName: 'nexus-mapper/scripts/languages.json' },
+  { id: 'nexus-mapper-query-graph', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/query_graph.py', fileName: 'nexus-mapper/scripts/query_graph.py' },
+  { id: 'nexus-mapper-requirements', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/requirements.txt', fileName: 'nexus-mapper/scripts/requirements.txt' },
+  { id: 'report-template', type: 'skill', source: '.agents/skills/report-template/SKILL.md', fileName: 'report-template/SKILL.md' },
+  { id: 'report-template-reference', type: 'skill', source: '.agents/skills/report-template/references/REPORT_TEMPLATE.md', fileName: 'report-template/references/REPORT_TEMPLATE.md' },
+  { id: 'runtime-inspector', type: 'skill', source: '.agents/skills/runtime-inspector/SKILL.md', fileName: 'runtime-inspector/SKILL.md' },
+  { id: 'sequential-thinking', type: 'skill', source: '.agents/skills/sequential-thinking/SKILL.md', fileName: 'sequential-thinking/SKILL.md' },
+  { id: 'spec-writer', type: 'skill', source: '.agents/skills/spec-writer/SKILL.md', fileName: 'spec-writer/SKILL.md' },
+  { id: 'spec-writer-prd-template', type: 'skill', source: '.agents/skills/spec-writer/references/prd_template.md', fileName: 'spec-writer/references/prd_template.md' },
+  { id: 'system-architect', type: 'skill', source: '.agents/skills/system-architect/SKILL.md', fileName: 'system-architect/SKILL.md' },
+  { id: 'system-architect-rfc-template', type: 'skill', source: '.agents/skills/system-architect/references/rfc_template.md', fileName: 'system-architect/references/rfc_template.md' },
+  { id: 'system-designer', type: 'skill', source: '.agents/skills/system-designer/SKILL.md', fileName: 'system-designer/SKILL.md' },
+  { id: 'system-designer-detail-template', type: 'skill', source: '.agents/skills/system-designer/references/system-design-detail-template.md', fileName: 'system-designer/references/system-design-detail-template.md' },
+  { id: 'system-designer-template', type: 'skill', source: '.agents/skills/system-designer/references/system-design-template.md', fileName: 'system-designer/references/system-design-template.md' },
+  { id: 'task-planner', type: 'skill', source: '.agents/skills/task-planner/SKILL.md', fileName: 'task-planner/SKILL.md' },
+  { id: 'task-planner-template-05a', type: 'skill', source: '.agents/skills/task-planner/references/TASK_TEMPLATE_05A.md', fileName: 'task-planner/references/TASK_TEMPLATE_05A.md' },
+  { id: 'task-planner-template-05b', type: 'skill', source: '.agents/skills/task-planner/references/TASK_TEMPLATE_05B.md', fileName: 'task-planner/references/TASK_TEMPLATE_05B.md' },
+  { id: 'task-reviewer', type: 'skill', source: '.agents/skills/task-reviewer/SKILL.md', fileName: 'task-reviewer/SKILL.md' },
+  { id: 'tech-evaluator', type: 'skill', source: '.agents/skills/tech-evaluator/SKILL.md', fileName: 'tech-evaluator/SKILL.md' },
+  { id: 'tech-evaluator-adr-template', type: 'skill', source: '.agents/skills/tech-evaluator/references/ADR_TEMPLATE.md', fileName: 'tech-evaluator/references/ADR_TEMPLATE.md' },
+  { id: 'e2e-testing-guide', type: 'skill', source: '.agents/skills/e2e-testing-guide/SKILL.md', fileName: 'e2e-testing-guide/SKILL.md' },
+  { id: 'craft-authoring', type: 'skill', source: '.agents/skills/craft-authoring/SKILL.md', fileName: 'craft-authoring/SKILL.md' }
+];
+
+function toArray(value) {
+  return Array.isArray(value) ? value : [value];
+}
+
+function toProjectionFileName(resource, projectionType, targetId) {
+  if ((targetId === 'codex' || targetId === 'trae') && projectionType === 'skills' && resource.type === 'workflow') {
+    return `anws-system/references/${resource.id}.md`;
+  }
+  if (projectionType === 'commands') {
+    return `${resource.id}.md`;
+  }
+  if (projectionType === 'prompts') {
+    return targetId === 'copilot' ? `${resource.id}.prompt.md` : `${resource.id}.md`;
+  }
+  if (projectionType === 'agents') {
+    return `${resource.id}.md`;
+  }
+  return resource.fileName;
+}
+
+function buildProjectionEntries(targetId) {
+  const target = getTarget(targetId);
+  const typeMap = target.projectionTypes;
+
+  return RESOURCE_REGISTRY.flatMap((resource) => {
+    if (resource.targets && !resource.targets.includes(target.id)) {
+      return [];
+    }
+    const projectionTypes = typeMap[resource.type];
+    if (!projectionTypes) {
+      return [];
+    }
+
+    return toArray(projectionTypes).map((projectionType) => {
+      const outputFileName = toProjectionFileName(resource, projectionType, target.id);
+      return {
+        ...resource,
+        projectionType,
+        outputRoot: target.projections[projectionType],
+        outputPath: `${target.projections[projectionType]}/${outputFileName}`
+      };
+    });
+  });
+}
+
+function buildManagedManifest(targetIds = ['antigravity']) {
+  return toArray(targetIds).flatMap((targetId) => {
+    const target = getTarget(targetId);
+    const entries = buildProjectionEntries(target.id).map((entry) => ({
+      ...entry,
+      targetId: target.id,
+      targetLabel: target.label,
+      ownershipKey: `${target.id}:${entry.outputPath}`
+    }));
+
+    if (!target.rootAgentFile) {
+      return entries;
+    }
+
+    return [
+      {
+        id: 'root-agents',
+        type: 'root',
+        source: 'AGENTS.md',
+        fileName: 'AGENTS.md',
+        projectionType: 'rootAgentFile',
+        outputRoot: '.',
+        outputPath: 'AGENTS.md',
+        targetId: target.id,
+        targetLabel: target.label,
+        ownershipKey: `${target.id}:AGENTS.md`
+      },
+      ...entries
+    ];
+  });
+}
+
+function buildProjectionPlan(targetIds = ['antigravity'], resources = RESOURCE_REGISTRY) {
+  return toArray(targetIds).map((targetId) => {
+    const target = getTarget(targetId);
+    const typeMap = target.projectionTypes;
+    const projectionEntries = resources.flatMap((resource) => {
+      if (resource.targets && !resource.targets.includes(target.id)) {
+        return [];
+      }
+      const projectionTypes = typeMap[resource.type];
+      if (!projectionTypes) {
+        return [];
+      }
+
+      return toArray(projectionTypes).map((projectionType) => {
+        const outputFileName = toProjectionFileName(resource, projectionType, target.id);
+        const outputPath = `${target.projections[projectionType]}/${outputFileName}`;
+        return {
+          ...resource,
+          projectionType,
+          outputRoot: target.projections[projectionType],
+          outputPath,
+          targetId: target.id,
+          targetLabel: target.label,
+          ownershipKey: `${target.id}:${outputPath}`
+        };
+      });
+    });
+
+    const managedFiles = target.rootAgentFile
+      ? ['AGENTS.md', ...projectionEntries.map((item) => item.outputPath)]
+      : projectionEntries.map((item) => item.outputPath);
+
+    return {
+      target,
+      targetId: target.id,
+      targetLabel: target.label,
+      managedFiles,
+      userProtectedFiles: buildUserProtectedFiles(target.id),
+      projectionEntries,
+      ownership: projectionEntries.map((item) => item.ownershipKey)
+    };
+  });
+}
+
+function buildManagedFiles(targetId = 'antigravity') {
+  return buildManagedManifest(targetId).map((item) => item.outputPath);
+}
+
+function buildUserProtectedFiles(targetId = 'antigravity') {
+  const target = getTarget(targetId);
+  return target.rootAgentFile ? ['AGENTS.md'] : [];
+}
+
+function findByType(type) {
+  return RESOURCE_REGISTRY.filter((item) => item.type === type);
+}
+
+const MANAGED_FILES = buildManagedFiles('antigravity');
+
+/**
+ * USER_PROTECTED_FILES — 用户保护文件
+ *
+ * 这些文件在项目初始化后通常会包含特定于项目的配置。
+ * anws update 默认会跳过这些文件。
+ */
+const USER_PROTECTED_FILES = buildUserProtectedFiles('antigravity');
+
+module.exports = {
+  RESOURCE_REGISTRY,
+  buildManagedManifest,
+  buildProjectionPlan,
+  buildManagedFiles,
+  buildProjectionEntries,
+  buildUserProtectedFiles,
+  findByType,
+  MANAGED_FILES,
+  USER_PROTECTED_FILES
+};
+
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haaaiawd/anws",
-  "version": "2.2.5",
+  "version": "2.3.0",
   "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/code-reviewer/SKILL.md

@@ -2,7 +2,7 @@
 
 ## name: code-reviewer
 
-description: 纯静态「契约忠实度 / 实现侧证据」审查：对照 PRD、ADR、系统设计、05A_TASKS 与 05B_VERIFICATION_PLAN，围绕契约闭合、任务兑现、架构健康、安全边界、验证证据与回流一致性产出可追溯结论；供 /challenge（CODE/FULL）与 /forge（Step 3 §3.4.5 波末）共用。
+description: 纯静态「契约忠实度 / 实现侧证据」审查：对照 PRD、ADR、系统设计、05A_TASKS 与 05B_VERIFICATION_PLAN，围绕契约闭合、任务兑现、架构健康、安全边界、验证证据与回流一致性产出可追溯结论；供 /challenge（CODE/FULL）与 /forge（Step 3 §3.6 波末）共用。
 
 # Code Reviewer — 实现侧证据层
 
@@ -24,12 +24,24 @@ description: 纯静态「契约忠实度 / 实现侧证据」审查：对照 PRD
 ## 激活时机
 
 - `**/challenge`**：`REVIEW_MODE` = `CODE` / `FULL`，或从 design/task 审查**自适应升级**到实现侧。
-- `**/forge`**：Step 3 §3.4.5 波末门禁（本波最后一项任务、§3.4 自动侧通过后，§3.4.6 之前；默认**每波一次**）。`/forge` 在 §3.4.5 之后另有 **§3.4.5.1 极简交付索引表**（workflow 规定，**非**本 skill 的报告体，不得用该表替代正文）。
+- `**/forge`**：Step 3 **§3.6 波末门禁**（本波最后一项任务的 §3.5 提交完成后，强制执行；默认**每波一次**）。`/forge` 在 §3.6 之后另有 **§3.8 交付索引表**（workflow 规定，**非**本 skill 的报告体，**不得**用该表替代审查正文）。
 
-## 执行形态（宿主能力）
+## 执行形态（默认：当前会话完整执行）
 
-- **有子代理**：若环境提供子代理 / Task / 并行会话等能力，**优先**启动**子代理**专职跑本 skill（与编码/导航会话隔离上下文，减少串话）；**产出格式、Lens、证据规则仍以本文件为准**，子代理不得自行删减。
-- **无子代理**：由**当前会话**按本 skill **完整**执行；**不得**以「没有子代理」为理由降低证据或跳过 Lens。
+- **默认路径**：由**当前会话**按本 skill **完整**执行 Lens 1–6，按「输出结构（精简）」六段输出审查全文。这是 baseline，没有任何前置条件。
+- **可选优化**：若宿主明确提供子代理 / Task / 并行会话能力，**可**委派子代理跑本 skill 以隔离上下文。但子代理只是执行容器，**产出格式、Lens、证据规则仍以本文件为准**，子代理不得自行删减。
+- **禁止借口**：**不得**以「没有子代理」「上下文不够」「改动不大」「时间紧」等理由降低证据要求、跳过 Lens 或跳过执行。`/forge` 中的豁免**只能**由用户在波次签名时明示。
+
+## 落盘要求（`/forge` 路径强制）
+
+由 `/forge` §3.6 触发时，审查全文**必须**写入物理文件：
+
+- **路径**：`{TARGET_DIR}/wave-reviews/wave-{N}-review.md`（`{N}` 为当前 Wave 序号）
+- **首行**：以 `# Wave {N} Code Review — {YYYY-MM-DD}` 开头
+- **不落盘 = §4.0 硬阻塞**，无任何例外（含 AUTO 模式）。表格自填、口头声称"已审查"一律视为未执行。
+- 用户豁免时**不写**审查文件，改为创建 `{TARGET_DIR}/wave-reviews/wave-{N}-WAIVED.md`（详见 `/forge` §3.6 豁免协议）。
+
+由 `/challenge` 触发时，按 `/challenge` 工作流的报告路径写入（默认进入 `07_CHALLENGE_REPORT.md` 的对应章节），不强制独立落盘到 `wave-reviews/`。
 
 ## 必读输入