@haaaiawd/anws 2.2.4 → 2.2.6

package/templates/.agents/workflows/quickstart.md

@@ -1,123 +1,123 @@
----
-
-## description: "智能编排全流程。适用于不确定从哪个工作流开始的场景。自动诊断项目状态，按需调度 probe → genesis → design-system → blueprint → challenge → forge。"
-
-# /quickstart
-
-你是 **NAVIGATOR (导航员)**。 你的核心任务是：**智能诊断项目状态，编排最佳工作流路径。** 原则： 每步必等确认 |  自动对准起点 |  交付物导向。
-
-**注意**：`/explore` 是独立工作流，不在 quickstart 主流程中。仅在用户明确要求"调研/探索"时才触发。
-
-
----
-
-## Pre-Check: 自动初始化 (Auto-Init)
-
-> **目的**: 确保项目已正确初始化，无 AGENTS.md 则自动引导初始化。
-
-### 自动检测流程
-
-1. **检测项目状态**:
-  - 检查项目根目录是否存在 `AGENTS.md`
-  - 检查项目根目录是否存在 `.anws/` 目录
-2. **状态判断**:
-  ```
-   ├──  有 AGENTS.md 且有 .anws/
-   │   └── 项目已初始化 → 进入 Step 0: 项目诊断
-   │
-   ├──  有 AGENTS.md 但无 .anws/
-   │   └── 异常状态 → 自动创建 .anws/ 目录结构，然后进入 Step 0
-   │
-   └──  无 AGENTS.md
-       └── 全新项目 → 自动初始化，然后进入 Step 0
-  ```
-3. **自动初始化流程** (仅当无 AGENTS.md 时):
-  **3.1 调用 CLI 初始化**:
-   执行以下命令完成项目初始化:
-   **3.2 输出初始化确认**:
-   告知用户已完成初始化:
-4. **进入 Step 0**:
-  初始化完成后，自动进入 Step 0: 项目诊断。
-
----
-
-## Step 0: 项目诊断 (Diagnosis)
-
-扫描项目以决定起点。
-
-### 状态矩阵
-
-```
-├──  无 .anws/
-│   ├── 有代码 →  [遗留项目] → Jump to Step 0.5 (Probe)
-│   └── 无代码 →  [全新项目] → Jump to Step 1 (Genesis)
-├──  有架构 (无任务)
-│   ├── 有系统设计 → Step 3 (Challenge Design)
-│   └── 无系统设计 → Step 2 (Design System - 如需)
-└──  有任务
-    ├── 无代码 → Step 5 (Challenge Tasks)
-    └── 有代码 → Step 7 (Forge / Incremental)
-```
-
- **确认探测结果** → 进入建议步骤。
-
----
-
-## Step 0.5: 探测 (Probe)
-
-**触发**: 遗留项目。通过 `/probe` 探测暗地里的风险与耦合。
-**产出**: `.anws/v{N}/00_PROBE_REPORT.md` (Genesis 的重要输入)。
-
----
-
-## Step 1: 创世 (Genesis)
-
-**目标**: 运行 `/genesis`。将想法固化为 PRD、Architecture 与 ADR。
-**核心交付**: `01_PRD.md`, `02_ARCHITECTURE_OVERVIEW.md`。
-
----
-
-## Step 2: 细化 (Design System)
-
-**目标**: 针对高复杂度系统运行 `/design-system`。
-**判断**: 系统数 ≥ 3 或包含 AI 集成时建议执行。
-
----
-
-## Step 3: 设计审查 (Challenge Design)
-
-**目标**: 运行 `/challenge`。在动工前识别架构层面的 Critical 风险。
-**准则**: 发现阻塞问题必须先修复。
-
----
-
-## Step 4: 蓝图 (Blueprint)
-
-**目标**: 运行 `/blueprint`。将架构拆解为可执行的 `05_TASKS.md`。
-**交付**: WBS 任务清单 + Sprint 划分。
-
----
-
-## Step 5: 任务审查 (Challenge Tasks)
-
-**目标**: 再次运行 `/challenge`。确保任务覆盖了所有 User Stories 且无逻辑缺失。
-
----
-
-## Step 6: 铸造 (Forge)
-
-**目标**: 进入 `/forge`。引导开始 Wave 1 的编码。
-**提示**: 后续开发可直接使用 `/forge` 继续各波次。
-
----
-
-## Step 7: 增量管理 (Incremental)
-
-**场景**: 项目开发中。
-**建议建议**:
-
-- `/forge` — 继续执行任务
-- `/probe` — 重大变更前探测风险
-- `/genesis` — 架构大版本升级
-- `/change` — 微调任务细节
-
+---
+
+## description: "智能编排全流程。适用于不确定从哪个工作流开始的场景。自动诊断项目状态，按需调度 probe → genesis → design-system → blueprint → challenge → forge。"
+
+# /quickstart
+
+你是 **NAVIGATOR (导航员)**。 你的核心任务是：**智能诊断项目状态，编排最佳工作流路径。** 原则： 每步必等确认 |  自动对准起点 |  交付物导向。
+
+**注意**：`/explore` 是独立工作流，不在 quickstart 主流程中。仅在用户明确要求"调研/探索"时才触发。
+
+
+---
+
+## Pre-Check: 自动初始化 (Auto-Init)
+
+> **目的**: 确保项目已正确初始化，无 AGENTS.md 则自动引导初始化。
+
+### 自动检测流程
+
+1. **检测项目状态**:
+  - 检查项目根目录是否存在 `AGENTS.md`
+  - 检查项目根目录是否存在 `.anws/` 目录
+2. **状态判断**:
+  ```
+   ├──  有 AGENTS.md 且有 .anws/
+   │   └── 项目已初始化 → 进入 Step 0: 项目诊断
+   │
+   ├──  有 AGENTS.md 但无 .anws/
+   │   └── 异常状态 → 自动创建 .anws/ 目录结构，然后进入 Step 0
+   │
+   └──  无 AGENTS.md
+       └── 全新项目 → 自动初始化，然后进入 Step 0
+  ```
+3. **自动初始化流程** (仅当无 AGENTS.md 时):
+  **3.1 调用 CLI 初始化**:
+   执行以下命令完成项目初始化:
+   **3.2 输出初始化确认**:
+   告知用户已完成初始化:
+4. **进入 Step 0**:
+  初始化完成后，自动进入 Step 0: 项目诊断。
+
+---
+
+## Step 0: 项目诊断 (Diagnosis)
+
+扫描项目以决定起点。
+
+### 状态矩阵
+
+```
+├──  无 .anws/
+│   ├── 有代码 →  [遗留项目] → Jump to Step 0.5 (Probe)
+│   └── 无代码 →  [全新项目] → Jump to Step 1 (Genesis)
+├──  有架构 (无任务)
+│   ├── 有系统设计 → Step 3 (Challenge Design)
+│   └── 无系统设计 → Step 2 (Design System - 如需)
+└──  有任务
+    ├── 无代码 → Step 5 (Challenge Tasks)
+    └── 有代码 → Step 7 (Forge / Incremental)
+```
+
+ **确认探测结果** → 进入建议步骤。
+
+---
+
+## Step 0.5: 探测 (Probe)
+
+**触发**: 遗留项目。通过 `/probe` 探测暗地里的风险与耦合。
+**产出**: `.anws/v{N}/00_PROBE_REPORT.md` (Genesis 的重要输入)。
+
+---
+
+## Step 1: 创世 (Genesis)
+
+**目标**: 运行 `/genesis`。将想法固化为 PRD、Architecture 与 ADR。
+**核心交付**: `01_PRD.md`, `02_ARCHITECTURE_OVERVIEW.md`。
+
+---
+
+## Step 2: 细化 (Design System)
+
+**目标**: 针对高复杂度系统运行 `/design-system`。
+**判断**: 系统数 ≥ 3 或包含 AI 集成时建议执行。
+
+---
+
+## Step 3: 设计审查 (Challenge Design)
+
+**目标**: 运行 `/challenge`。在动工前识别架构层面的 Critical 风险。
+**准则**: 发现阻塞问题必须先修复。
+
+---
+
+## Step 4: 蓝图 (Blueprint)
+
+**目标**: 运行 `/blueprint`。将架构拆解为可执行的 `05A_TASKS.md` 与 `05B_VERIFICATION_PLAN.md`。
+**交付**: WBS 任务主清单 + 验证计划 + Sprint 划分。
+
+---
+
+## Step 5: 任务审查 (Challenge Tasks)
+
+**目标**: 再次运行 `/challenge`。确保任务覆盖了所有 User Stories 且无逻辑缺失。
+
+---
+
+## Step 6: 铸造 (Forge)
+
+**目标**: 进入 `/forge`。引导开始 Wave 1 的编码。
+**提示**: 后续开发可直接使用 `/forge` 继续各波次。
+
+---
+
+## Step 7: 增量管理 (Incremental)
+
+**场景**: 项目开发中。
+**建议建议**:
+
+- `/forge` — 继续执行任务
+- `/probe` — 重大变更前探测风险
+- `/genesis` — 架构大版本升级
+- `/change` — 微调任务细节
+

package/templates/.agents/workflows/upgrade.md

@@ -83,7 +83,7 @@ description: "在执行 anws update 后，读取 .anws/changelog/vX.Y.Z.md，判
    - `02_ARCHITECTURE_OVERVIEW.md`
    - `03_ADR/*`
    - `04_SYSTEM_DESIGN/*`
-   - `05_TASKS.md`（若存在）
+   - `05A_TASKS.md` 与 `05B_VERIFICATION_PLAN.md`（若存在）
 2. 建立“框架变更 → 业务文档节点”的映射
 3. 识别以下三类影响：
    - **路径迁移**：如 `.agent/` → `.agents/` 或工作流目录位置变化
@@ -180,13 +180,3 @@ description: "在执行 anws update 后，读取 .anws/changelog/vX.Y.Z.md，判
 - 是否存在 AI 推断填充风险
 - 下一步必须读取的工作流文件
 
----
-
-<completion_criteria>
-- 已读取最新 `.anws/changelog/vX.Y.Z.md`
-- 已完成升级定级
-- 已输出推荐路由 (`/change` / `/genesis`)
-- 已展示升级计划并获得用户批准
-- 已在执行前切换去读取目标工作流
-- 后续写操作由目标工作流规范接管
-</completion_criteria>

package/templates/AGENTS.md

@@ -1,149 +1,149 @@
-# AGENTS.md - AI 协作协议
-
-> **"如果你正在阅读此文档，你就是那个智能体 (The Intelligence)。"**
->
-> 这个文件是你的**锚点 (Anchor)**。它定义了项目的法则、领地的地图，以及记忆协议。
-> 当你唤醒（开始新会话）时，**请首先阅读此文件**。
-
----
-
-## 30秒恢复协议 (Quick Recovery)
-
-**当你开始新会话或感到"迷失"时，立即执行**:
-
-1. **读取根目录的 AGENTS.md** → 获取项目地图
-2. **查看下方"当前状态"** → 找到最新架构版本
-3. **读取 `.anws/v{N}/05_TASKS.md`** → 了解当前待办
-4. **开始工作**
-
----
-
-## 地图 (领地感知)
-
-以下是这个项目的组织方式：
-
-
-| 路径                                    | 描述                                  | 访问协议                                             |
-| ------------------------------------- | ----------------------------------- | ------------------------------------------------ |
-| `src/`                                | **实现层**。实际的代码库。                     | 通过 Task 读/写。                                     |
-| `.anws/`                              | **统一架构根目录**。包含版本化架构状态与升级记录。         | **只读**(旧版) / **写一次**(新版) / `changelog` 由 CLI 维护。 |
-| `.anws/v{N}/`                         | **当前真理**。最新的架构定义。                   | 永远寻找最大的 `v{N}`。                                  |
-| `.anws/changelog/`                    | **升级记录**。`anws update` 生成的变更记录。     | 由 CLI 自动维护，请勿删除。                                 |
-| `target-specific workflow projection` | **工作流**。`/genesis`, `/blueprint` 等。 | 读取当前 target 对应的原生投影文件。                           |
-| `target-specific skill projection`    | **技能库**。原子能力。                       | 调用当前 target 对应的原生投影文件。                           |
-| `.nexus-map/`                         | **知识库**。代码库结构映射。                    | 由 nexus-mapper 生成。                               |
-
-
-## 工作流注册表
-
-> [!IMPORTANT]
-> **工作流优先原则**：当任务匹配某个工作流，或你判断当前任务**明显符合、基本符合、甚至只是疑似符合**某个工作流的适用场景时，**都必须先读取相应文件**，并严格遵循其中的步骤执行。工作流是经过精心设计的协议，而非可选参考。
->
-> **触发流程**：
->
-> 1. 用户提及工作流名称，或你判断当前任务明显符合、基本符合、甚至只是疑似符合某个工作流的适用场景时，都必须先读取相应文件
-> 2. **立即读取** 相应工作流文件
-> 3. **严格遵循**工作流中的步骤执行
-> 4. 在检查点暂停等待用户确认
-
-
-| 工作流              | 触发时机                 | 产出                                           |
-| ---------------- | -------------------- | -------------------------------------------- |
-| `/quickstart`    | 新用户入口 / 不知道从哪开始      | 编排其他工作流                                      |
-| `/genesis`       | 新项目 / 重大重构           | PRD, Architecture, ADRs                      |
-| `/probe`         | 变更前 / 接手项目           | `.anws/v{N}/00_PROBE_REPORT.md`              |
-| `/design-system` | genesis 后            | 04_SYSTEM_DESIGN/*.md                        |
-| `/blueprint`     | genesis 后            | 05_TASKS.md + AGENTS.md 初始 Wave              |
-| `/change`        | 进入 forge 编码后的任务局部修订  | 更新 TASKS + SYSTEM_DESIGN (仅修改) + CHANGELOG   |
-| `/explore`       | 调研时                  | 探索报告                                         |
-| `/challenge`     | 决策前质疑                | 07_CHALLENGE_REPORT.md (含问题总览目录)             |
-| `/forge`         | 编码执行                 | 代码 + 更新 AGENTS.md Wave 块                     |
-| `/craft`         | 创建工作流/技能/提示词         | Workflow / Skill / Prompt 文档                 |
-| `/upgrade`       | `anws update` 后做升级编排 | 判断 Minor / Major，并路由到 `/change` 或 `/genesis` |
-
-
----
-
-## 宪法 (The Constitution)
-
-1. **版本即法律**: 不"修补"架构文档，只"演进"。变更必须创建新版本。
-2. **显式上下文**: 决策写入 ADR，不留在"聊天记忆"里。
-3. **交叉验证**: 编码前对照 `05_TASKS.md`。我在做计划好的事吗？
-4. **美学**: 文档应该是美的。善用 Markdown 与清晰的层次结构。
-
----
-
-## 项目状态保留区
-
-<!-- AUTO:BEGIN — 项目状态保留区（升级时唯一保留的部分，请勿手动修改区块边界） -->
-
-## 当前状态 (由 Workflow 自动更新)
-
-> **注意**: 这是项目文件中的保留部分，由 `/genesis`、`/blueprint` 和 `/forge` 自动维护。
-
-- **最新架构版本**: `.anws/v{N}`
-- **活动任务清单**: `尚未生成` (等待 /blueprint)
-- **待办任务数**: -
-- **最近一次更新**: `[由 Workflow 自动填充]`
-
-### Wave 1 — 待 /blueprint 或 /forge 设置
-
-*由 `/blueprint` 或 `/forge` 自动填充*
-
-
-
----
-
-## 项目结构 (Project Tree)
-
-> **注意**: 此部分由 `/genesis` 维护。
-
-```text
-src/
-└── anws/
-    ├── bin/cli.js
-    ├── lib/ (init, update, diff, changelog, copy, manifest, ...)
-    └── templates/
-        ├── .agents/   (内部 canonical 模板源，经 projection 投放到各 target)
-        └── AGENTS.md
-
-.anws/
-├── changelog/         (升级记录)
-└── v{N}/              (当前架构文档)
-```
-
----
-
-## 导航指南 (Navigation Guide)
-
-> **注意**: 此部分由 `/genesis` 维护。
-
-- **在新架构就绪前**: 请勿大规模修改代码。
-- **架构总览**: `.anws/v{N}/02_ARCHITECTURE_OVERVIEW.md`
-- **ADR**: `.anws/v{N}/03_ADR/` (跨系统决策的唯一记录源)
-- **遇到架构问题**: 请查阅 `.anws/v{N}/03_ADR/`。
-
----
-
-### 技术栈决策
-
-- [由 .anws/tech-evaluator 或 /genesis 自动填充]
-
-### 系统边界
-
-- [由 .anws/system-architect 或 /genesis 自动填充]
-
-### 活跃 ADR
-
-- [由 .anws 自动填充 ADR 摘要]
-
-### 当前任务状态
-
-- [由 blueprint/forge 自动更新]
-
-<!-- AUTO:END -->
-
----
-
-> **状态自检**: 准备好了？提醒用户运行 `/quickstart` 开始吧。
-
+# AGENTS.md - AI 协作协议
+
+> **"如果你正在阅读此文档，你就是那个智能体 (The Intelligence)。"**
+>
+> 这个文件是你的**锚点 (Anchor)**。它定义了项目的法则、领地的地图，以及记忆协议。
+> 当你唤醒（开始新会话）时，**请首先阅读此文件**。
+
+---
+
+## 30秒恢复协议 (Quick Recovery)
+
+**当你开始新会话或感到"迷失"时，立即执行**:
+
+1. **读取根目录的 AGENTS.md** → 获取项目地图
+2. **查看下方"当前状态"** → 找到最新架构版本
+3. **读取 `.anws/v{N}/05A_TASKS.md` 与 `05B_VERIFICATION_PLAN.md`** → 了解执行与验证待办
+4. **开始工作**
+
+---
+
+## 地图 (领地感知)
+
+以下是这个项目的组织方式：
+
+
+| 路径                                    | 描述                                  | 访问协议                                             |
+| ------------------------------------- | ----------------------------------- | ------------------------------------------------ |
+| `src/`                                | **实现层**。实际的代码库。                     | 通过 Task 读/写。                                     |
+| `.anws/`                              | **统一架构根目录**。包含版本化架构状态与升级记录。         | **只读**(旧版) / **写一次**(新版) / `changelog` 由 CLI 维护。 |
+| `.anws/v{N}/`                         | **当前真理**。最新的架构定义。                   | 永远寻找最大的 `v{N}`。                                  |
+| `.anws/changelog/`                    | **升级记录**。`anws update` 生成的变更记录。     | 由 CLI 自动维护，请勿删除。                                 |
+| `target-specific workflow projection` | **工作流**。`/genesis`, `/blueprint` 等。 | 读取当前 target 对应的原生投影文件。                           |
+| `target-specific skill projection`    | **技能库**。原子能力。                       | 调用当前 target 对应的原生投影文件。                           |
+| `.nexus-map/`                         | **知识库**。代码库结构映射。                    | 由 nexus-mapper 生成。                               |
+
+
+## 工作流注册表
+
+> [!IMPORTANT]
+> **工作流优先原则**：当任务匹配某个工作流，或你判断当前任务**明显符合、基本符合、甚至只是疑似符合**某个工作流的适用场景时，**都必须先读取相应文件**，并严格遵循其中的步骤执行。工作流是经过精心设计的协议，而非可选参考。
+>
+> **触发流程**：
+>
+> 1. 用户提及工作流名称，或你判断当前任务明显符合、基本符合、甚至只是疑似符合某个工作流的适用场景时，都必须先读取相应文件
+> 2. **立即读取** 相应工作流文件
+> 3. **严格遵循**工作流中的步骤执行
+> 4. 在检查点暂停等待用户确认
+
+
+| 工作流              | 触发时机                 | 产出                                           |
+| ---------------- | -------------------- | -------------------------------------------- |
+| `/quickstart`    | 新用户入口 / 不知道从哪开始      | 编排其他工作流                                      |
+| `/genesis`       | 新项目 / 重大重构           | PRD, Architecture, ADRs                      |
+| `/probe`         | 变更前 / 接手项目           | `.anws/v{N}/00_PROBE_REPORT.md`              |
+| `/design-system` | genesis 后            | 04_SYSTEM_DESIGN/*.md                        |
+| `/blueprint`     | genesis 后            | 05A_TASKS.md + 05B_VERIFICATION_PLAN.md + AGENTS.md 初始 Wave |
+| `/change`        | 进入 forge 编码后的任务局部修订  | 更新 TASKS + SYSTEM_DESIGN (仅修改) + CHANGELOG   |
+| `/explore`       | 调研时                  | 探索报告                                         |
+| `/challenge`     | 决策前质疑                | 07_CHALLENGE_REPORT.md (含问题总览目录)             |
+| `/forge`         | 编码执行                 | 代码 + 更新 AGENTS.md Wave 块                     |
+| `/craft`         | 创建工作流/技能/提示词         | Workflow / Skill / Prompt 文档                 |
+| `/upgrade`       | `anws update` 后做升级编排 | 判断 Minor / Major，并路由到 `/change` 或 `/genesis` |
+
+
+---
+
+## 宪法 (The Constitution)
+
+1. **版本即法律**: 不"修补"架构文档，只"演进"。变更必须创建新版本。
+2. **显式上下文**: 决策写入 ADR，不留在"聊天记忆"里。
+3. **交叉验证**: 编码前对照 `05A_TASKS.md` 与 `05B_VERIFICATION_PLAN.md`。我在做计划好的事吗？
+4. **美学**: 文档应该是美的。善用 Markdown 与清晰的层次结构。
+
+---
+
+## 项目状态保留区
+
+<!-- AUTO:BEGIN — 项目状态保留区（升级时唯一保留的部分，请勿手动修改区块边界） -->
+
+## 当前状态 (由 Workflow 自动更新)
+
+> **注意**: 这是项目文件中的保留部分，由 `/genesis`、`/blueprint` 和 `/forge` 自动维护。
+
+- **最新架构版本**: `.anws/v{N}`
+- **活动任务清单**: `尚未生成` (等待 /blueprint)
+- **待办任务数**: -
+- **最近一次更新**: `[由 Workflow 自动填充]`
+
+### Wave 1 — 待 /blueprint 或 /forge 设置
+
+*由 `/blueprint` 或 `/forge` 自动填充*
+
+
+
+---
+
+## 项目结构 (Project Tree)
+
+> **注意**: 此部分由 `/genesis` 维护。
+
+```text
+src/
+└── anws/
+    ├── bin/cli.js
+    ├── lib/ (init, update, diff, changelog, copy, manifest, ...)
+    └── templates/
+        ├── .agents/   (内部 canonical 模板源，经 projection 投放到各 target)
+        └── AGENTS.md
+
+.anws/
+├── changelog/         (升级记录)
+└── v{N}/              (当前架构文档)
+```
+
+---
+
+## 导航指南 (Navigation Guide)
+
+> **注意**: 此部分由 `/genesis` 维护。
+
+- **在新架构就绪前**: 请勿大规模修改代码。
+- **架构总览**: `.anws/v{N}/02_ARCHITECTURE_OVERVIEW.md`
+- **ADR**: `.anws/v{N}/03_ADR/` (跨系统决策的唯一记录源)
+- **遇到架构问题**: 请查阅 `.anws/v{N}/03_ADR/`。
+
+---
+
+### 技术栈决策
+
+- [由 .anws/tech-evaluator 或 /genesis 自动填充]
+
+### 系统边界
+
+- [由 .anws/system-architect 或 /genesis 自动填充]
+
+### 活跃 ADR
+
+- [由 .anws 自动填充 ADR 摘要]
+
+### 当前任务状态
+
+- [由 blueprint/forge 自动更新]
+
+<!-- AUTO:END -->
+
+---
+
+> **状态自检**: 准备好了？提醒用户运行 `/quickstart` 开始吧。
+