@haaaiawd/anws 1.2.2 → 1.2.4

package/bin/cli.js

@@ -34,11 +34,16 @@ const { values, positionals } = parseArgs({
   options: {
     version: { type: 'boolean', short: 'v', default: false },
     help:    { type: 'boolean', short: 'h', default: false },
+    yes:     { type: 'boolean', short: 'y', default: false },
   },
   strict: false,
   allowPositionals: true,
 });
 
+if (values.yes) {
+  global.__ANWS_FORCE_YES = true;
+}
+
 // ─── 命令路由 ─────────────────────────────────────────────────────────────────
 async function main() {
   if (values.version) {

package/lib/init.js

@@ -2,7 +2,6 @@
 
 const fs = require('node:fs/promises');
 const path = require('node:path');
-const crypto = require('node:crypto');
 const { copyDir } = require('./copy');
 const { MANAGED_FILES, USER_PROTECTED_FILES } = require('./manifest');
 const { success, warn, info, fileLine, skippedLine, blank, logo } = require('./output');
@@ -26,7 +25,6 @@ async function init() {
     }
     // 仅覆盖托管文件（用户自有文件不受影响）
     const { written: updated, skipped } = await overwriteManaged(srcRoot, cwd);
-    await storeAgentsTemplateHash(srcRoot, cwd);
     printSummary(updated, skipped, 'updated');
     return;
   }
@@ -36,10 +34,18 @@ async function init() {
   info('Initializing Antigravity Workflow System...');
   blank();
 
-  const written = await copyDir(srcRoot, destRoot);
+  const writtenFiles = await copyDir(srcRoot, destRoot);
+  const written = Array.isArray(writtenFiles) ? writtenFiles : [];
 
-  // 存储 agents.md 模板指纹，供后续 update 检测模板变化
-  await storeAgentsTemplateHash(srcRoot, cwd);
+  // 把外层的 AGENTS.md 拷贝出来
+  const srcAgents = path.join(__dirname, '..', 'templates', 'AGENTS.md');
+  const destAgents = path.join(cwd, 'AGENTS.md');
+  try {
+    await fs.copyFile(srcAgents, destAgents);
+    written.push(destAgents);
+  } catch (e) {
+    // 忽略
+  }
 
   // 打印文件列表
   for (const absPath of written) {
@@ -74,6 +80,8 @@ async function findConflicts(cwd) {
  * @returns {Promise<boolean>}
  */
 async function askOverwrite(count) {
+  if (global.__ANWS_FORCE_YES) return true;
+
   // 非 TTY 环境：默认不覆盖，防止 CI 挂起
   if (!process.stdin.isTTY) {
     warn(`${count} managed file(s) already exist. Non-TTY: skipping overwrite.`);
@@ -160,27 +168,8 @@ function printSummary(files, skipped = [], action) {
 function printNextSteps() {
   blank();
   info('Next steps:');
-  info('  1. Read .agent/rules/agents.md to understand the system');
+  info('  1. Read AGENTS.md to understand the system');
   info('  2. Run /quickstart in your AI assistant to analyze and start the workflow');
 }
 
-/**
- * 存储 agents.md 模板的 MD5 指纹。
- * 供 `anws update` 检测模板是否在版本间发生了变化。
- * @param {string} srcRoot  模板 .agent/ 目录绝对路径
- * @param {string} cwd      项目根目录
- */
-async function storeAgentsTemplateHash(srcRoot, cwd) {
-  const templatePath = path.join(srcRoot, 'rules', 'agents.md');
-  const hashPath = path.join(cwd, '.agent', 'rules', '.agents-template-hash');
-
-  try {
-    const content = await fs.readFile(templatePath, 'utf-8');
-    const hash = crypto.createHash('md5').update(content).digest('hex');
-    await fs.writeFile(hashPath, hash, 'utf-8');
-  } catch {
-    // 模板文件不存在时静默失败（不应该发生）
-  }
-}
-
 module.exports = init;

package/lib/manifest.js

@@ -6,7 +6,7 @@
  * 此数组列出 anws 包负责管理的所有文件路径（相对于目标项目根目录）。
  */
 const MANAGED_FILES = [
-  '.agent/rules/agents.md',
+  'AGENTS.md',
   '.agent/skills/build-inspector/SKILL.md',
   '.agent/skills/complexity-guard/references/anti_patterns.md',
   '.agent/skills/complexity-guard/SKILL.md',
@@ -14,6 +14,7 @@ const MANAGED_FILES = [
   '.agent/skills/concept-modeler/references/ENTITY_EXTRACTION_PROMPT.md',
   '.agent/skills/concept-modeler/scripts/glossary_gen.py',
   '.agent/skills/concept-modeler/SKILL.md',
+  '.agent/skills/design-reviewer/SKILL.md',
   '.agent/skills/git-forensics/references/ANALYSIS_METHODOLOGY.md',
   '.agent/skills/git-forensics/scripts/git_forensics.py',
   '.agent/skills/git-forensics/scripts/git_hotspots.py',
@@ -25,10 +26,12 @@ const MANAGED_FILES = [
   '.agent/skills/spec-writer/SKILL.md',
   '.agent/skills/system-architect/references/rfc_template.md',
   '.agent/skills/system-architect/SKILL.md',
+  '.agent/skills/system-designer/references/system-design-detail-template.md',
   '.agent/skills/system-designer/references/system-design-template.md',
   '.agent/skills/system-designer/SKILL.md',
   '.agent/skills/task-planner/references/TASK_TEMPLATE.md',
   '.agent/skills/task-planner/SKILL.md',
+  '.agent/skills/task-reviewer/SKILL.md',
   '.agent/skills/tech-evaluator/references/ADR_TEMPLATE.md',
   '.agent/skills/tech-evaluator/SKILL.md',
   '.agent/workflows/blueprint.md',
@@ -39,6 +42,7 @@ const MANAGED_FILES = [
   '.agent/workflows/explore.md',
   '.agent/workflows/forge.md',
   '.agent/workflows/genesis.md',
+  '.agent/workflows/quickstart.md',
   '.agent/workflows/scout.md'
 ];
 
@@ -49,10 +53,10 @@ const MANAGED_FILES = [
  * anws update 默认会跳过这些文件。
  */
 const USER_PROTECTED_FILES = [
-  '.agent/rules/agents.md'
+  'AGENTS.md'
 ];
 
 module.exports = {
   MANAGED_FILES,
   USER_PROTECTED_FILES
-};
+};

package/lib/update.js

@@ -2,7 +2,6 @@
 
 const fs = require('node:fs/promises');
 const path = require('node:path');
-const crypto = require('node:crypto');
 const { MANAGED_FILES, USER_PROTECTED_FILES } = require('./manifest');
 const { success, warn, error, info, fileLine, skippedLine, blank, logo } = require('./output');
 
@@ -33,10 +32,34 @@ async function update() {
   logo();
   // 仅覆盖托管文件；USER_PROTECTED_FILES 永远跳过
   const srcRoot = path.join(__dirname, '..', 'templates', '.agent');
+  let skipNewAgentsMd = false;
+  
+  const legacyAgentsPath = path.join(cwd, '.agent', 'rules', 'agents.md');
+  const legacyExists = await fs.access(legacyAgentsPath).then(() => true).catch(() => false);
+  const rootAgentsPath = path.join(cwd, 'AGENTS.md');
+  const rootExists = await fs.access(rootAgentsPath).then(() => true).catch(() => false);
+
+  if (legacyExists && !rootExists) {
+    const migrate = await askMigrate();
+    if (!migrate) {
+      skipNewAgentsMd = true;
+      info('Keeping legacy .agent/rules/agents.md. Will not pull root AGENTS.md.');
+    } else {
+      blank();
+      warn('Please manually copy your custom rules from .agent/rules/agents.md to the new root AGENTS.md');
+      warn('After copying, you can safely delete the old .agent/rules/agents.md file.');
+      blank();
+    }
+  }
+
   const updated = [];
   const skipped = [];
 
   for (const rel of MANAGED_FILES) {
+    if (skipNewAgentsMd && rel === 'AGENTS.md') {
+      continue;
+    }
+
     if (USER_PROTECTED_FILES.includes(rel)) {
       skipped.push(rel);
       continue;
@@ -68,29 +91,18 @@ async function update() {
     }
   }
 
-  // 检查 agents.md 模板是否有变更，提供 .new 文件供用户合并
-  const agentsMerged = await checkAgentsTemplate(cwd, srcRoot);
-
   blank();
   success(`Done! ${updated.length} file(s) updated${skipped.length > 0 ? `, ${skipped.length} skipped` : ''}.`);
   info('Managed files have been updated to the latest version.');
   info('Your custom files in .agent/ were not touched.');
-
-  if (agentsMerged) {
-    blank();
-    warn('agents.md template has changed!');
-    info('A new template has been saved to:');
-    info('  .agent/rules/agents.md.new');
-    blank();
-    info('Please review and merge the changes into your agents.md.');
-    info('After merging, delete agents.md.new.');
-  }
 }
 
 /**
  * 交互式确认更新操作（默认 N）。
  */
 async function askUpdate() {
+  if (global.__ANWS_FORCE_YES) return true;
+
   if (!process.stdin.isTTY) {
     warn('Non-TTY environment detected. Skipping update to avoid accidental overwrites.');
     return false;
@@ -111,43 +123,27 @@ async function askUpdate() {
 }
 
 /**
- * 检查 agents.md 模板是否相比上次安装/更新有变化。
- * 用 hash 文件记录上次模板指纹，与新模板比较。
- * 如果有变化 → 写入 agents.md.new + 更新 hash。
- *
- * @param {string} cwd       项目根目录
- * @param {string} srcRoot   模板 .agent/ 目录
- * @returns {Promise<boolean>} 是否产生了 .new 文件
+ * 询问用户是否同意迁移 agents.md
  */
-async function checkAgentsTemplate(cwd, srcRoot) {
-  const templatePath = path.join(path.dirname(srcRoot), '.agent', 'rules', 'agents.md');
-  const hashPath = path.join(cwd, '.agent', 'rules', '.agents-template-hash');
-  const newPath = path.join(cwd, '.agent', 'rules', 'agents.md.new');
-
-  const templateExists = await fs.access(templatePath).then(() => true).catch(() => false);
-  if (!templateExists) return false;
-
-  const templateContent = await fs.readFile(templatePath, 'utf-8');
-  const newHash = crypto.createHash('md5').update(templateContent).digest('hex');
-
-  // 读取上次存储的 hash
-  let oldHash = null;
-  try {
-    oldHash = (await fs.readFile(hashPath, 'utf-8')).trim();
-  } catch {
-    // hash 文件不存在（首次 update 或旧版本安装）
-  }
+async function askMigrate() {
+  if (global.__ANWS_FORCE_YES) return true;
 
-  if (oldHash === newHash) {
-    return false; // 模板没变化
+  if (!process.stdin.isTTY) {
+    return false;
   }
 
-  // 模板有变化 → 写入 .new 供用户合并
-  await fs.writeFile(newPath, templateContent, 'utf-8');
-  // 更新 hash 记录
-  await fs.writeFile(hashPath, newHash, 'utf-8');
+  const readline = require('node:readline');
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
 
-  return true;
+  return new Promise((resolve) => {
+    rl.question(
+      '\n\u26a0 Legacy .agent/rules/agents.md detected. Do you want to migrate to root AGENTS.md? [y/N] ',
+      (answer) => {
+        rl.close();
+        resolve(answer.trim().toLowerCase() === 'y');
+      }
+    );
+  });
 }
 
 module.exports = update;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haaaiawd/anws",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "description": "A spec-driven workflow framework for AI-assisted development. Empowers prompt engineers to build production-ready software through structured PRD → Architecture → Task decomposition. Designed for Antigravity to enforce design-first principles and prevent architectural drift in vibe coding.",
   "keywords": [
     "antigravity",

package/templates/{.agent/rules/agents.md → AGENTS.md}

@@ -1,112 +1,113 @@
-# AGENTS.md - AI 协作协议
-
-> **"如果你正在阅读此文档，你就是那个智能体 (The Intelligence)。"**
-> 
-> 这个文件是你的**锚点 (Anchor)**。它定义了项目的法则、领地的地图，以及记忆协议。
-> 当你唤醒（开始新会话）时，**请首先阅读此文件**。
-
----
-
-## 🧠 30秒恢复协议 (Quick Recovery)
-
-**当你开始新会话或感到"迷失"时，立即执行**:
-
-1. **读取 .agent/rules/agents.md** → 获取项目地图
-2. **查看下方"当前状态"** → 找到最新架构版本
-3. **读取 `genesis/v{N}/05_TASKS.md`** → 了解当前待办
-4. **开始工作**
-
----
-
-## 🗺️ 地图 (领地感知)
-
-以下是这个项目的组织方式：
-
-| 路径 | 描述 | 访问协议 |
-|------|------|----------|
-| `src/` | **实现层**。实际的代码库。 | 通过 Task 读/写。 |
-| `genesis/` | **设计演进史**。版本化架构状态 (v1, v2...)。 | **只读**(旧版) / **写一次**(新版)。 |
-| `genesis/v{N}/` | **当前真理**。最新的架构定义。 | 永远寻找最大的 `v{N}`。 |
-| `.agent/workflows/` | **工作流**。`/genesis`, `/blueprint` 等。 | 通过 `view_file` 阅读。 |
-| `.agent/skills/` | **技能库**。原子能力。 | 通过 `view_file` 调用。 |
-
----
-
-## 📍 当前状态 (由 Workflow 自动更新)
-
-> **注意**: 此部分由 `/genesis`、`/blueprint` 和 `/forge` 自动维护。
-
-- **最新架构版本**: `尚未初始化`
-- **活动任务清单**: `尚未生成`
-- **待办任务数**: -
-- **最近一次更新**: `-`
-
-### 🌊 Wave 1 — 待 /blueprint 或 /forge 设置
-_尚未开始执行_
-
----
-
-## 🌳 项目结构 (Project Tree)
-
-> **注意**: 此部分由 `/genesis` 维护。
-
-```text
-(等待 Genesis 初始化结构树...)
-```
-
----
-
-## 🧭 导航指南 (Navigation Guide)
-
-> **注意**: 此部分由 `/genesis` 维护。
-
-- **在新架构就绪前**: 请勿大规模修改代码。
-- **遇到架构问题**: 请查阅 `genesis/v{N}/03_ADR/`。
-
----
-
-## 🛠️ 工作流注册表
-
-| 工作流 | 触发时机 | 产出 |
-|--------|---------|------|
-| `/quickstart` | 新用户入口 / 不知道从哪开始 | 编排其他工作流 |
-| `/genesis` | 新项目 / 重大重构 | PRD, Architecture, ADRs |
-| `/scout` | 变更前 / 接手项目 | `genesis/v{N}/00_SCOUT_REPORT.md` |
-| `/design-system` | genesis 后 | 04_SYSTEM_DESIGN/*.md |
-| `/blueprint` | genesis 后 | 05_TASKS.md + agents.md 初始 Wave |
-| `/change` | 微调已有任务 | 更新 TASKS + SYSTEM_DESIGN (仅修改) + CHANGELOG |
-| `/explore` | 调研时 | 探索报告 |
-| `/challenge` | 决策前质疑 | 07_CHALLENGE_REPORT.md (含问题总览目录) |
-| `/forge` | 编码执行 | 代码 + 更新 agents.md Wave 块 |
-| `/craft` | 创建工作流/技能/提示词 | Workflow / Skill / Prompt 文档 |
-
----
-
-## 📜 宪法 (The Constitution)
-
-1. **版本即法律**: 不"修补"架构文档，只"演进"。变更必须创建新版本。
-2. **显式上下文**: 决策写入 ADR，不留在"聊天记忆"里。
-3. **交叉验证**: 编码前对照 `05_TASKS.md`。我在做计划好的事吗？
-4. **美学**: 文档应该是美的。善用 Markdown 和 Emoji。
-
----
-## 🔄 Auto-Updated Context
-
-<!-- AUTO:BEGIN — 由工作流自动维护，请勿手动编辑此区块 -->
-
-### 技术栈决策
-- [由 genesis/tech-evaluator 自动填充]
-
-### 系统边界
-- [由 genesis/system-architect 自动填充]
-
-### 活跃 ADR
-- [由 genesis 自动填充 ADR 摘要]
-
-### 当前任务状态
-- [由 blueprint/forge 自动更新]
-
-<!-- AUTO:END -->
-
----
-> **状态自检**: 准备好了？提醒用户运行 `/quickstart` 开始吧。
+# AGENTS.md - AI 协作协议
+
+> **"如果你正在阅读此文档，你就是那个智能体 (The Intelligence)。"**
+> 
+> 这个文件是你的**锚点 (Anchor)**。它定义了项目的法则、领地的地图，以及记忆协议。
+> 当你唤醒（开始新会话）时，**请首先阅读此文件**。
+
+---
+
+## 🧠 30秒恢复协议 (Quick Recovery)
+
+**当你开始新会话或感到"迷失"时，立即执行**:
+
+1. **读取根目录的 AGENTS.md** → 获取项目地图
+2. **查看下方"当前状态"** → 找到最新架构版本
+3. **读取 `genesis/v{N}/05_TASKS.md`** → 了解当前待办
+4. **开始工作**
+
+---
+
+## 🗺️ 地图 (领地感知)
+
+以下是这个项目的组织方式：
+
+| 路径 | 描述 | 访问协议 |
+|------|------|----------|
+| `src/` | **实现层**。实际的代码库。 | 通过 Task 读/写。 |
+| `genesis/` | **设计演进史**。版本化架构状态 (v1, v2...)。 | **只读**(旧版) / **写一次**(新版)。 |
+| `genesis/v{N}/` | **当前真理**。最新的架构定义。 | 永远寻找最大的 `v{N}`。 |
+| `.agent/workflows/` | **工作流**。`/genesis`, `/blueprint` 等。 | 通过 `view_file` 阅读。 |
+| `.agent/skills/` | **技能库**。原子能力。 | 通过 `view_file` 调用。 |
+
+---
+
+## 📍 当前状态 (由 Workflow 自动更新)
+
+> **注意**: 此部分由 `/genesis`、`/blueprint` 和 `/forge` 自动维护。
+
+- **最新架构版本**: `尚未初始化`
+- **活动任务清单**: `尚未生成`
+- **待办任务数**: -
+- **最近一次更新**: `-`
+
+### 🌊 Wave 1 — 待 /blueprint 或 /forge 设置
+_尚未开始执行_
+
+---
+
+## 🌳 项目结构 (Project Tree)
+
+> **注意**: 此部分由 `/genesis` 维护。
+
+```text
+(等待 Genesis 初始化结构树...)
+```
+
+---
+
+## 🧭 导航指南 (Navigation Guide)
+
+> **注意**: 此部分由 `/genesis` 维护。
+
+- **在新架构就绪前**: 请勿大规模修改代码。
+- **遇到架构问题**: 请查阅 `genesis/v{N}/03_ADR/`。
+
+---
+
+## 🛠️ 工作流注册表
+
+| 工作流 | 触发时机 | 产出 |
+|--------|---------|------|
+| `/quickstart` | 新用户入口 / 不知道从哪开始 | 编排其他工作流 |
+| `/genesis` | 新项目 / 重大重构 | PRD, Architecture, ADRs |
+| `/scout` | 变更前 / 接手项目 | `genesis/v{N}/00_SCOUT_REPORT.md` |
+| `/design-system` | genesis 后 | 04_SYSTEM_DESIGN/*.md |
+| `/blueprint` | genesis 后 | 05_TASKS.md + AGENTS.md 初始 Wave |
+| `/change` | 微调已有任务 | 更新 TASKS + SYSTEM_DESIGN (仅修改) + CHANGELOG |
+| `/explore` | 调研时 | 探索报告 |
+| `/challenge` | 决策前质疑 | 07_CHALLENGE_REPORT.md (含问题总览目录) |
+| `/forge` | 编码执行 | 代码 + 更新 AGENTS.md Wave 块 |
+| `/craft` | 创建工作流/技能/提示词 | Workflow / Skill / Prompt 文档 |
+
+---
+
+## 📜 宪法 (The Constitution)
+
+1. **版本即法律**: 不"修补"架构文档，只"演进"。变更必须创建新版本。
+2. **显式上下文**: 决策写入 ADR，不留在"聊天记忆"里。
+3. **交叉验证**: 编码前对照 `05_TASKS.md`。我在做计划好的事吗？
+4. **美学**: 文档应该是美的。善用 Markdown 和 Emoji。
+
+---
+## 🔄 Auto-Updated Context
+
+<!-- AUTO:BEGIN — 由工作流自动维护，请勿手动编辑此区块 -->
+
+### 技术栈决策
+- [由 genesis/tech-evaluator 自动填充]
+
+### 系统边界
+- [由 genesis/system-architect 自动填充]
+
+### 活跃 ADR
+- [由 genesis 自动填充 ADR 摘要]
+
+### 当前任务状态
+- [由 blueprint/forge 自动更新]
+
+<!-- AUTO:END -->
+
+---
+> **状态自检**: 准备好了？提醒用户运行 `/quickstart` 开始吧。
+\n# TEST NEW CONTENT\n