@haaaiawd/anws 2.0.1 → 2.0.2

package/README.md

@@ -3,8 +3,8 @@
 <img src="assets/logo-cli.png" width="260" alt="Anws">
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-[![Version](https://img.shields.io/badge/version-v2.0.0-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-blueviolet)](https://github.com/Haaaiawd/Anws)
+[![Version](https://img.shields.io/badge/version-v2.0.2-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)
 
@@ -79,8 +79,13 @@ Anws addresses those problems with:
 - **Codex projection strategy update**
   - Codex is now treated as **Preview**
   - because Codex prompts are no longer available, Anws now packages workflow guidance into `.codex/skills/anws-system/`
-  - `/quickstart` maps to `SKILL.md`
-  - the rest of the workflow docs are exposed as `references/*.md` under the same aggregated skill
+  - `SKILL.md` is the navigation shell for the bundle
+  - workflow details, including `/quickstart`, now live under `references/*.md`
+
+- **Trae / Qoder / Kilo Code support**
+  - Trae follows the same skills-only bundle family as Codex via `.trae/skills/anws-system/`
+  - Qoder adds native `.qoder/commands/` + `.qoder/skills/`
+  - Kilo Code adds native `.kilocode/workflows/` + `.kilocode/skills/`
 
 - **OpenCode support**
   - adds native projection support for `.opencode/commands/` and `.opencode/skills/`
@@ -135,6 +140,7 @@ anws update
 - **State source**
   - `anws update` reads `.anws/install-lock.json`
   - if the lock is missing or invalid, it falls back to directory scan
+  - a real `anws update` can rebuild `.anws/install-lock.json` from detected targets when fallback is active
 
 - **`AGENTS.md` behavior**
   - marker-based file -> update stable sections, preserve `AUTO` block
@@ -179,7 +185,7 @@ Every supported target now receives:
   - `workflows`
   - `commands`
   - `prompts`
-  - aggregated `skills` for Codex Preview
+  - aggregated `skills` for Codex / Trae skills-only bundles
 
 | Environment | Status | Layout |
 | --- | --- | --- |
@@ -190,6 +196,9 @@ Every supported target now receives:
 | **Cursor** | ✅ Supported | `AGENTS.md` + `.cursor/commands/` + `.cursor/skills/` |
 | **Codex** | ⚠️ Preview | `AGENTS.md` + `.codex/skills/anws-system/` + `.codex/skills/<skill>/` |
 | **OpenCode** | ✅ Supported | `AGENTS.md` + `.opencode/commands/` + `.opencode/skills/` |
+| **Trae** | ✅ Supported | `AGENTS.md` + `.trae/skills/anws-system/` + `.trae/skills/<skill>/` |
+| **Qoder** | ✅ Supported | `AGENTS.md` + `.qoder/commands/` + `.qoder/skills/` |
+| **Kilo Code** | ✅ Supported | `AGENTS.md` + `.kilocode/workflows/` + `.kilocode/skills/` |
 
 ---
 
@@ -262,6 +271,19 @@ your-project/
 ├── .opencode/
 │   ├── commands/
 │   └── skills/
+├── .qoder/
+│   ├── commands/
+│   └── skills/
+├── .kilocode/
+│   ├── workflows/
+│   └── skills/
+├── .trae/
+│   └── skills/
+│       ├── anws-system/
+│       │   ├── SKILL.md
+│       │   └── references/
+│       └── <skill>/
+│           └── SKILL.md
 └── .codex/
     ├── skills/
     │   ├── anws-system/

package/bin/cli.js

@@ -23,12 +23,24 @@ 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 install-lock state
+  --check         Preview grouped update diffs without writing files or rebuilding install-lock state
+
+SUPPORTED TARGETS
+  windsurf     workflows + skills
+  antigravity  workflows + skills
+  cursor       commands + skills
+  claude       commands + skills
+  copilot      prompts + skills
+  codex        preview, skills-only bundle via anws-system
+  opencode     commands + skills
+  trae         skills-only bundle via anws-system
+  qoder        commands + skills
+  kilo         workflows + skills
 
 EXAMPLES
   anws init                       # Choose target IDEs and install their managed workflow projections
-  anws init --target windsurf,codex
-  anws update                     # Update all matched targets from install-lock or directory scan
+  anws init --target windsurf,codex,opencode
+  anws update                     # Update all matched targets from install-lock or directory scan fallback
   anws update --check             # Preview grouped changes per target without writing files
 `.trimStart();
 

package/lib/adapters/index.js

@@ -87,6 +87,47 @@ const TARGETS = {
     },
     detect: ['.codex/skills/anws-system/SKILL.md']
   },
+  trae: {
+    id: 'trae',
+    label: 'Trae (Preview)',
+    rootAgentFile: true,
+    projectionTypes: {
+      workflow: ['skills'],
+      skill: ['skills']
+    },
+    projections: {
+      skills: '.trae/skills'
+    },
+    detect: ['.trae/skills/anws-system/SKILL.md']
+  },
+  qoder: {
+    id: 'qoder',
+    label: 'Qoder',
+    rootAgentFile: true,
+    projectionTypes: {
+      workflow: ['commands'],
+      skill: ['skills']
+    },
+    projections: {
+      commands: '.qoder/commands',
+      skills: '.qoder/skills'
+    },
+    detect: ['.qoder/commands/genesis.md']
+  },
+  kilo: {
+    id: 'kilo',
+    label: 'Kilo Code',
+    rootAgentFile: true,
+    projectionTypes: {
+      workflow: ['workflows'],
+      skill: ['skills']
+    },
+    projections: {
+      workflows: '.kilocode/workflows',
+      skills: '.kilocode/skills'
+    },
+    detect: ['.kilocode/workflows/genesis.md']
+  },
   opencode: {
     id: 'opencode',
     label: 'OpenCode',

package/lib/init.js

@@ -1,9 +1,10 @@
 'use strict';
 
 const path = require('node:path');
+const fs = require('node:fs/promises');
 const { buildProjectionPlan } = require('./manifest');
 const { getTarget, listTargets } = require('./adapters');
-const { resolveAgentsInstall, printLegacyMigrationWarning, pathExists } = require('./agents');
+const { planAgentsUpdate, resolveAgentsInstall, printLegacyMigrationWarning, pathExists } = require('./agents');
 const { ensureChangelogDir } = require('./changelog');
 const { ROOT_AGENTS_FILE, resolveCanonicalSource } = require('./resources');
 const { writeTargetFiles } = require('./copy');
@@ -39,6 +40,7 @@ async function init() {
 
   for (const targetPlan of targetPlans) {
     const target = getTarget(targetPlan.targetId);
+    const rootAgentsExists = await pathExists(path.join(cwd, 'AGENTS.md'));
     const agentsDecision = target.id === 'antigravity'
       ? await resolveAgentsInstall({
         cwd,
@@ -47,9 +49,17 @@ async function init() {
       })
       : {
         shouldWriteRootAgents: true,
-        shouldWarnMigration: false
+        shouldWarnMigration: false,
+        rootExists: rootAgentsExists
       };
 
+    let agentsUpdatePlan = null;
+    if (agentsDecision.shouldWriteRootAgents && agentsDecision.rootExists) {
+      const templateContent = await fs.readFile(srcAgents, 'utf8');
+      const existingContent = await fs.readFile(path.join(cwd, 'AGENTS.md'), 'utf8');
+      agentsUpdatePlan = planAgentsUpdate({ templateContent, existingContent });
+    }
+
     const conflicting = await findConflicts(cwd, targetPlan.managedFiles, sessionWrittenFiles);
     if (conflicting.length > 0) {
       const confirmed = await askOverwrite(conflicting.length, target.label);
@@ -69,6 +79,7 @@ async function init() {
       protectedFiles: targetPlan.userProtectedFiles,
       srcAgents,
       shouldWriteRootAgents: agentsDecision.shouldWriteRootAgents,
+      agentsUpdatePlan,
       resolveCanonicalSource
     });
 

package/lib/install-state.js

@@ -166,16 +166,24 @@ async function detectInstallState(cwd) {
   const lockResult = await readInstallLock(cwd);
   const scannedTargets = await detectInstalledTargets(cwd);
   const lockTargets = lockResult.lock?.targets || [];
+  const needsFallback = !lockResult.exists || !!lockResult.error;
+  const fallbackReason = !needsFallback
+    ? null
+    : (!lockResult.exists ? 'missing_lock' : 'invalid_lock');
   const selectedTargets = lockTargets.length > 0
     ? lockTargets.map((item) => item.targetId)
     : scannedTargets.map((item) => item.id);
+  const drift = detectLockDrift(lockResult.lock, scannedTargets);
 
   return {
     lockResult,
     scannedTargets,
     selectedTargets,
-    drift: detectLockDrift(lockResult.lock, scannedTargets),
-    needsFallback: !lockResult.exists || !!lockResult.error
+    drift,
+    needsFallback,
+    fallbackReason,
+    stateSource: needsFallback ? 'directory_scan_fallback' : 'install_lock',
+    canRebuildLock: needsFallback && selectedTargets.length > 0
   };
 }
 

package/lib/manifest.js

@@ -19,6 +19,7 @@ const RESOURCE_REGISTRY = [
   { 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: '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' },
@@ -53,10 +54,8 @@ function toArray(value) {
 }
 
 function toProjectionFileName(resource, projectionType, targetId) {
-  if (targetId === 'codex' && projectionType === 'skills' && resource.type === 'workflow') {
-    return resource.id === 'quickstart'
-      ? 'anws-system/SKILL.md'
-      : `anws-system/references/${resource.id}.md`;
+  if ((targetId === 'codex' || targetId === 'trae') && projectionType === 'skills' && resource.type === 'workflow') {
+    return `anws-system/references/${resource.id}.md`;
   }
   if (projectionType === 'commands') {
     return `${resource.id}.md`;
@@ -75,6 +74,9 @@ function buildProjectionEntries(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 [];
@@ -129,6 +131,9 @@ function buildProjectionPlan(targetIds = ['antigravity'], resources = RESOURCE_R
     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 [];

package/lib/update.js

@@ -128,6 +128,21 @@ async function update(options = {}) {
       logo();
       blank();
     }
+    printTargetSelection(installState, targetContexts.map((context) => context.target));
+    if (!check && installState.needsFallback && selectedTargetIds.length > 0) {
+      const generatedAt = new Date().toISOString();
+      await writeInstallLock(cwd, createInstallLock({
+        cliVersion: version,
+        generatedAt,
+        targets: dedupeTargets(targetPlans.map((targetPlan) => summarizeTargetState(targetPlan, version))),
+        lastUpdateSummary: {
+          successfulTargets: [],
+          failedTargets: [],
+          updatedAt: generatedAt
+        }
+      }));
+      info('Rebuilt .anws/install-lock.json from the detected target layout.');
+    }
     info(`Already up to date. Latest recorded version is v${versionState.latestVersion || version}.`);
     return;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haaaiawd/anws",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "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/anws-system/SKILL.md

@@ -0,0 +1,106 @@
+---
+name: anws-system
+description: 当用户在 skills-only 环境中需要判断应该从哪个 anws 工作流开始，或需要在 forge / change / genesis / probe / blueprint / challenge / upgrade 之间路由时使用。它是 anws 工作流集合的导航入口。
+---
+
+# ANWS System Router Manual
+
+你是 **ANWS Router**。
+
+你的职责不是直接替代所有工作流，而是作为 **skills-only 模式** 下的统一导航入口：
+
+- 判断当前请求应路由到哪个工作流
+- 告诉模型还需要读取哪个 `references/*.md`
+- 在开始执行前明确权限边界，避免把 `/forge`、`/change`、`/genesis` 混用
+
+## 激活规则
+
+出现以下任一情况时使用本 Skill：
+
+1. 用户不知道该从哪个工作流开始
+2. 用户明确提到 `/quickstart`、`/forge`、`/change`、`/genesis` 等工作流，但当前环境只有 skills
+3. 用户请求涉及“下一步该走哪个流程”
+4. 用户请求跨越设计、任务、实现多个阶段，需要先判断阶段边界
+
+## 首次激活的强制步骤
+
+1. 先读取 `references/quickstart.md`
+2. 判断当前请求更接近哪一种场景
+3. 再按需读取对应 workflow reference
+4. 没有读完对应 reference 前，不得直接执行该 workflow 的写操作
+
+## Workflow Map
+
+- `references/quickstart.md`
+  - 用途：总入口。用于判断项目目前处于哪一阶段，以及应先调用哪个工作流
+- `references/probe.md`
+  - 用途：接手遗留项目、重大改动前做系统风险探测
+- `references/genesis.md`
+  - 用途：新项目、重大重构、架构升级、需要新版本时使用
+- `references/design-system.md`
+  - 用途：为单个系统补详细设计文档
+- `references/blueprint.md`
+  - 用途：将架构设计拆成可执行的 `05_TASKS.md`
+- `references/challenge.md`
+  - 用途：在编码前系统性挑战设计或任务清单
+- `references/forge.md`
+  - 用途：按 `05_TASKS.md` 执行编码任务，并维护 Wave 进度
+- `references/change.md`
+  - 用途：只微调已有任务定义，不创建新任务，不推进实现状态
+- `references/explore.md`
+  - 用途：做调研、探索、方案发散与收敛
+- `references/craft.md`
+  - 用途：创建新的 workflow、skill 或 prompt
+- `references/upgrade.md`
+  - 用途：处理 `anws update` 之后的升级编排
+
+## 路由规则
+
+### Route 1: 不确定起点
+
+如果用户不知道从哪里开始，或你对当前阶段没有把握：
+
+1. 读取 `references/quickstart.md`
+2. 根据项目状态判断入口
+3. 给出建议 workflow，并说明理由
+4. 等待用户确认
+
+### Route 2: 请求是“开始编码 / 继续实现 / 做当前波次”
+
+1. 读取 `references/forge.md`
+2. 检查 `.anws/v{N}/05_TASKS.md` 是否存在且任务已定义
+3. 若缺任务清单，不得直接实现，先回到 `blueprint` 或 `genesis`
+
+### Route 3: 请求是“微调现有任务 / 修正文案 / 调整验收标准”
+
+1. 读取 `references/change.md`
+2. 确认只修改已有任务，不新增任务
+3. 若需要新增任务或超出 PRD，改走 `genesis`
+
+### Route 4: 请求是“新项目 / 大重构 / 新版本 / 架构升级”
+
+1. 读取 `references/genesis.md`
+2. 进入版本化架构流程
+
+### Route 5: 请求是“先调研 / 先探测风险”
+
+- 遗留项目或重大变更前 → `references/probe.md`
+- 技术调研或方案发散 → `references/explore.md`
+
+## 边界守则
+
+1. 你是导航层，不是所有 workflow 的替身
+2. 每次只路由到一个主 workflow；如需串联，必须说明顺序
+3. 未读取目标 workflow reference 前，不得假装已经遵循该流程
+4. 若用户请求同时跨越设计与实现，先收敛边界，再决定 `/change` 或 `/genesis`
+5. skills-only 模式下，workflow 详情全部位于 `references/`
+
+## 输出格式
+
+当你完成路由判断时，输出应包含：
+
+- 当前判断的阶段
+- 建议读取的 reference
+- 建议进入的 workflow
+- 为什么不是其他 workflow
+- 是否需要等待用户确认

package/templates/.agents/workflows/change.md

@@ -15,6 +15,7 @@ description: "处理微调级变更请求，仅允许修改已有任务的细节
 - **忠于 Blueprint** - 所有修改必须在 `01_PRD.md` 已定义的需求范围内
 - **人类审批** - 所有写操作必须先展示计划，经人类确认后才能执行
 - **可追溯** - 所有变更都记录在 CHANGELOG
+- **不维护完成状态** - `/change` 只修改任务定义，不负责回填 `05_TASKS.md` checkbox
 
 **Output Goal**: 
 - 更新 `.anws/v{N}/05_TASKS.md` (仅修改已有任务)
@@ -35,6 +36,8 @@ description: "处理微调级变更请求，仅允许修改已有任务的细节
 > | 调整已有任务的估时 | ✅ | |
 > | 标记任务阻塞/重分优先级 | ✅ | |
 > | 微调 `04_SYSTEM_DESIGN/` 中已有文件的细节 | ✅ | |
+> | 更新任务说明字段，但不改变完成状态 | ✅ | |
+> | **回填 `05_TASKS.md` checkbox** | | ❌ |
 > | **创建新任务 (T{X}.{Y}.{Z})** | | ❌ |
 > | **创建新文件** | | ❌ |
 > | **添加 AI 自认为好的功能** | | ❌ |
@@ -43,8 +46,6 @@ description: "处理微调级变更请求，仅允许修改已有任务的细节
 > | **修改 `02_ARCHITECTURE_OVERVIEW.md`** | | ❌ |
 > | **修改 `03_ADR/` 中的任何文件** | | ❌ |
 >
-> **单次 /change 最多影响 3 个已有任务 + 对应的设计文件微调。**
->
 > **违反以上任何一条 → 变更无效，引导用户运行 `/genesis`。**
 
 ---
@@ -158,8 +159,8 @@ description: "处理微调级变更请求，仅允许修改已有任务的细节
 
 3.  **定位任务**:
     - 找到与变更相关的已有任务 (如 `T2.1.3`)
-    - **最多 3 个任务**受影响
-    - 如果超过 3 个 → 跳转 Step 4
+    - 记录所有实际受影响的已有任务
+    - 如果需要创建新任务才能承接变更 → 跳转 Step 4
 
 4.  **定位相关设计文件** (如需要):
     - 检查 `{TARGET_DIR}/04_SYSTEM_DESIGN/` 中是否有对应的系统设计文件
@@ -230,7 +231,9 @@ description: "处理微调级变更请求，仅允许修改已有任务的细节
 ### Step 3.1: 执行修改 (仅在人类批准后)
 
 1.  **修改任务清单**:
-    使用 `replace_file_content` 修改 `{TARGET_DIR}/05_TASKS.md` 中的对应任务
+    使用 `replace_file_content` 修改 `{TARGET_DIR}/05_TASKS.md` 中的对应任务定义
+    - 仅允许修改任务描述、验收标准、估时、优先级、阻塞说明等定义字段
+    - **禁止**在 `/change` 中将 `- [ ]` 改为 `- [x]` 或反向修改 checkbox
 
 2.  **记录变更日志**:
     读取并追加到 `{TARGET_DIR}/06_CHANGELOG.md`:

package/templates/.agents/workflows/forge.md

@@ -225,6 +225,15 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
 读取该任务 `**输入**` 字段指定的文档和章节。
 如果任务依赖已完成的前置任务，浏览相关已有代码了解接口。
 
+> [!IMPORTANT]
+> **开始写代码前，必须对本波次每个任务都完成一次依赖读取。**
+>
+> - 至少读取该任务 `**输入**` 字段指定的文档/章节
+> - 如任务依赖其他任务，补读前置任务相关接口或实现代码
+> - 未完成该任务的依赖读取，不得开始该任务编码
+>
+> **为什么？** `/forge` 允许按本波次批量推进和批量回填 checkbox，但前提是每个任务都已完成最小上下文装载，不能只看标题就动手。
+
 ---
 
 ### 3.2 Think Before Code (编码前思考)
@@ -331,7 +340,10 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
    > 下次加载 TASKS.md 就能看到精确进度。
    > 配合 AGENTS.md 的 Wave 块形成**双层恢复机制**: 粗粒度(Wave) + 细粒度(Task checkbox)。
 
-   - 将该任务的 `- [ ]` 改为 `- [x]`
+   - 本波次允许批量回填已全部验证通过的任务 checkbox
+   - 仅按 **Task ID** 精确定位并更新状态，禁止按标题模糊匹配
+   - 将对应任务的 `- [ ]` 改为 `- [x]`
+   - 不得顺手修改未完成、未验证或不在当前波次内的任务
    - 确保回写后的 `05_TASKS.md` 与实际进度一致
 
 3. **继续下一个任务** → 回到 3.1