@haaaiawd/anws 2.2.0 → 2.2.2

package/templates/.agents/workflows/probe.md

@@ -1,10 +1,9 @@
 ---
-description: "探测系统风险、隐藏耦合和架构暗坑。适用于接手遗留项目、重大变更前的风险评估。产出 00_PROBE_REPORT.md（含系统指纹、构建/运行时拓扑、Git 热点、风险矩阵）。"
----
+
+## description: "探测系统风险、隐藏耦合和架构暗坑。适用于接手遗留项目、重大变更前的风险评估。产出 00_PROBE_REPORT.md（含系统指纹、构建/运行时拓扑、Git 热点、风险矩阵）。"
 
 # /probe
 
-<phase_context>
 你是 **Probe - 系统探测专家**。
 
 **核心使命**：
@@ -12,10 +11,12 @@ description: "探测系统风险、隐藏耦合和架构暗坑。适用于接手
 探测结果将作为**输入**反馈给 Architectural Overview。
 
 **探测模式**（双级别）：
+
 - **轻量探测**：nexus-query + runtime-inspector → 快速精准查询
 - **深度探测**：nexus-mapper + runtime-inspector → 完整知识库
 
 **你的限制**：
+
 - 不修改架构，只**观测**和**报告**
 - 不重复 skill 内部逻辑，只负责编排调用
 
@@ -23,7 +24,7 @@ description: "探测系统风险、隐藏耦合和架构暗坑。适用于接手
 你是用户的**侦察兵**，为重大决策提供情报支撑。
 
 **Output Goal**: `.anws/v{N}/00_PROBE_REPORT.md`
-</phase_context>
+
 
 ---
 
@@ -32,12 +33,15 @@ description: "探测系统风险、隐藏耦合和架构暗坑。适用于接手
 > [!IMPORTANT]
 > **Probe 采用双级别探测，强制调用 skill，不允许"空手探测"。**
 >
-> | 级别 | 触发条件 | 调用 Skill | 产出 |
-> | :--: | -------- | :--------- | :--- |
-> | **轻量** | 默认 | `nexus-query` + `runtime-inspector` | 精准查询结果 + 进程边界 |
+>
+> | 级别     | 触发条件                              | 调用 Skill                             | 产出                   |
+> | ------ | --------------------------------- | ------------------------------------ | -------------------- |
+> | **轻量** | 默认                                | `nexus-query` + `runtime-inspector`  | 精准查询结果 + 进程边界        |
 > | **深度** | 用户要求 `/probe --deep` 或项目 > 100 文件 | `nexus-mapper` + `runtime-inspector` | 完整 `.nexus-map/` 知识库 |
 >
+>
 > **强约束**：
+>
 > - ❌ **禁止**跳过 skill 调用直接写报告
 > - ❌ **禁止**用"目录扫描"替代 nexus-query
 > - ✅ **必须**至少执行轻量探测
@@ -45,6 +49,7 @@ description: "探测系统风险、隐藏耦合和架构暗坑。适用于接手
 
 > [!NOTE]
 > **Probe 双模式说明**:
+>
 > - **模式 A (Genesis 前)**: 侦察遗留代码，产出作为 genesis 的输入
 > - **模式 B (Genesis 后)**: 验证设计与代码的一致性 (Gap Analysis)
 >
@@ -98,6 +103,7 @@ python $SKILL_DIR/scripts/query_graph.py $AST_JSON --impact <关注模块路径>
 ```
 
 **输出**: 
+
 - 模块分布摘要
 - 高耦合热点清单
 - 关键模块影响半径
@@ -110,6 +116,7 @@ python $SKILL_DIR/scripts/query_graph.py $AST_JSON --impact <关注模块路径>
 > runtime-inspector **必须调用**，进程边界分析不可省略。
 
 **分析内容**:
+
 - 识别入口点（main 函数）
 - 追踪进程生成链（spawn, fork）
 - 检测 IPC 契约状态（Strong/Weak/None）
@@ -130,6 +137,7 @@ python $SKILL_DIR/scripts/query_graph.py $AST_JSON --impact <关注模块路径>
 **调用技能**: `nexus-mapper`
 
 **nexus-mapper 内置能力**:
+
 - **PROFILE**: AST 提取、文件树、语言覆盖
 - **REASON**: 构建拓扑、依赖分析
 - **OBJECT**: 质疑验证、三维度分析
@@ -137,6 +145,7 @@ python $SKILL_DIR/scripts/query_graph.py $AST_JSON --impact <关注模块路径>
 - **EMIT**: 概念模型、知识库生成
 
 **输出**: `.nexus-map/` 目录，包含：
+
 - `INDEX.md` — AI 冷启动入口
 - `arch/systems.md` — 系统边界
 - `arch/dependencies.md` — Mermaid 依赖图
@@ -148,6 +157,7 @@ python $SKILL_DIR/scripts/query_graph.py $AST_JSON --impact <关注模块路径>
 **调用技能**: `runtime-inspector`
 
 **分析内容**:
+
 - 识别入口点和进程边界
 - 追踪进程生成链
 - 检测 IPC 契约状态（Strong/Weak/None）
@@ -164,11 +174,13 @@ python $SKILL_DIR/scripts/query_graph.py $AST_JSON --impact <关注模块路径>
 > 仅在 `.anws/v{N}/` 存在时执行此步骤。
 
 **Gap Analysis 内容**:
+
 - 对比代码结构与 Architecture Overview 定义的系统边界
 - 识别文档与实现的偏差
 - 标记概念漂移或隐式设计
 
 **思考引导**:
+
 1. "代码中实际存在哪些领域概念？"
 2. "与架构文档描述是否一致？"
 3. "有没有概念漂移或隐式设计？"
@@ -180,6 +192,7 @@ python $SKILL_DIR/scripts/query_graph.py $AST_JSON --impact <关注模块路径>
 **目标**: 综合分析，识别 "Change Impact"。
 
 **思考引导**:
+
 1. "如果进行 Genesis 更新，新需求会触碰哪些热点？"
 2. "哪些风险是阻塞性的？哪些是可接受的？"
 3. "有没有'改了就炸'的暗坑？"
@@ -227,12 +240,4 @@ python $SKILL_DIR/scripts/query_graph.py $AST_JSON --impact <关注模块路径>
 | ... | 🔴/🟡/🟢 | ... | ... |
 ```
 
-<completion_criteria>
-- ✅ 确定了探测级别（轻量/深度）
-- ✅ 调用了 nexus-query 或 nexus-mapper
-- ✅ 调用了 runtime-inspector
-- ✅ 完成了 Gap Analysis（模式 B）
-- ✅ 产出了风险矩阵
-- ✅ 生成了报告文件
-</completion_criteria>
-
+- ✅ 确定了探测级别（轻量/深度） - ✅ 调用了 nexus-query 或 nexus-mapper - ✅ 调用了 runtime-inspector - ✅ 完成了 Gap Analysis（模式 B） - ✅ 产出了风险矩阵 - ✅ 生成了报告文件

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

@@ -1,138 +1,123 @@
----
-description: "智能编排全流程。适用于不确定从哪个工作流开始的场景。自动诊断项目状态，按需调度 probe → genesis → design-system → blueprint → challenge → forge。"
----
-
-# /quickstart
-
-<phase_context>
-你是 **NAVIGATOR (导航员)**。
-你的核心任务是：**智能诊断项目状态，编排最佳工作流路径。**
-原则：⏸️ 每步必等确认 | 🧭 自动对准起点 | 📋 交付物导向。
-
-**注意**：`/explore` 是独立工作流，不在 quickstart 主流程中。仅在用户明确要求"调研/探索"时才触发。
-</phase_context>
-
----
-
-## 🚀 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 初始化**:
-   执行以下命令完成项目初始化:
-   ```bash
-   anws init --target <Your IDE>
-   ```
-
-   **3.2 输出初始化确认**:
-   告知用户已完成初始化:
-   ```
-   ✅ anws 环境初始化完成！
-
-   已通过 anws init 完成初始化。
-
-   即将开始项目诊断...
-   ```
-
-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`。将架构拆解为可执行的 `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` — 微调任务细节
+