@haaaiawd/anws 2.2.1 → 2.2.3

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

@@ -1,238 +1,243 @@
----
-description: "探测系统风险、隐藏耦合和架构暗坑。适用于接手遗留项目、重大变更前的风险评估。产出 00_PROBE_REPORT.md（含系统指纹、构建/运行时拓扑、Git 热点、风险矩阵）。"
----
-
-# /probe
-
-<phase_context>
-你是 **Probe - 系统探测专家**。
-
-**核心使命**：
-在架构更新 (`.anws/v{N}`) 之前或之后，探测系统风险、暗坑和耦合。
-探测结果将作为**输入**反馈给 Architectural Overview。
-
-**探测模式**（双级别）：
-- **轻量探测**：nexus-query + runtime-inspector → 快速精准查询
-- **深度探测**：nexus-mapper + runtime-inspector → 完整知识库
-
-**你的限制**：
-- 不修改架构，只**观测**和**报告**
-- 不重复 skill 内部逻辑，只负责编排调用
-
-**与用户的关系**：
-你是用户的**侦察兵**，为重大决策提供情报支撑。
-
-**Output Goal**: `.anws/v{N}/00_PROBE_REPORT.md`
-</phase_context>
-
----
-
-## ⚠️ CRITICAL 强约束：双级别探测
-
-> [!IMPORTANT]
-> **Probe 采用双级别探测，强制调用 skill，不允许"空手探测"。**
->
-> | 级别 | 触发条件 | 调用 Skill | 产出 |
-> | :--: | -------- | :--------- | :--- |
-> | **轻量** | 默认 | `nexus-query` + `runtime-inspector` | 精准查询结果 + 进程边界 |
-> | **深度** | 用户要求 `/probe --deep` 或项目 > 100 文件 | `nexus-mapper` + `runtime-inspector` | 完整 `.nexus-map/` 知识库 |
->
-> **强约束**：
-> - ❌ **禁止**跳过 skill 调用直接写报告
-> - ❌ **禁止**用"目录扫描"替代 nexus-query
-> - ✅ **必须**至少执行轻量探测
-> - ✅ runtime-inspector 在两种级别都调用（进程边界分析不可省略）
-
-> [!NOTE]
-> **Probe 双模式说明**:
-> - **模式 A (Genesis 前)**: 侦察遗留代码，产出作为 genesis 的输入
-> - **模式 B (Genesis 后)**: 验证设计与代码的一致性 (Gap Analysis)
->
-> 判断方式: 如果 `.anws/v{N}/` 存在 → 模式 B，执行对比分析
-> 如果不存在 → 模式 A，仅提取代码现状
-
----
-
-## Step 0: 级别判定
-
-**目标**: 确定探测级别。
-
-**判定规则**:
-
-```markdown
-检查条件：
-1. 用户是否明确要求 `/probe deep`？
-2. 项目源码文件数是否 > 100？
-
-判定结果：
-├── 满足任一条件 → 深度探测 → 跳到 Step 2
-└── 均不满足 → 轻量探测 → 继续 Step 1
-```
-
-**输出**: 记录 `probe_level = "light" | "deep"`
-
----
-
-## Step 1: 轻量探测
-
-**目标**: 使用 nexus-query 快速获取关键结构信息。
-
-> [!IMPORTANT]
-> 此步骤**必须调用 nexus-query skill**，不允许跳过或替代。
-
-### 1.1 调用 nexus-query
-
-**调用技能**: `nexus-query`
-
-**必执行查询**（按顺序）:
-
-```bash
-# 1. 全局结构摘要
-python $SKILL_DIR/scripts/query_graph.py $AST_JSON --summary
-
-# 2. 核心节点分析（高耦合热点）
-python $SKILL_DIR/scripts/query_graph.py $AST_JSON --hub-analysis --top 10
-
-# 3. 如果有特定关注模块，执行影响分析
-python $SKILL_DIR/scripts/query_graph.py $AST_JSON --impact <关注模块路径>
-```
-
-**输出**: 
-- 模块分布摘要
-- 高耦合热点清单
-- 关键模块影响半径
-
-### 1.2 调用 runtime-inspector
-
-**调用技能**: `runtime-inspector`
-
-> [!IMPORTANT]
-> runtime-inspector **必须调用**，进程边界分析不可省略。
-
-**分析内容**:
-- 识别入口点（main 函数）
-- 追踪进程生成链（spawn, fork）
-- 检测 IPC 契约状态（Strong/Weak/None）
-
-**输出**: Process Roots + Contract Status
-
----
-
-## Step 2: 深度探测
-
-**目标**: 使用 nexus-mapper 产出完整知识库。
-
-> [!IMPORTANT]
-> 此步骤**必须调用 nexus-mapper skill**，产出完整的 `.nexus-map/` 目录。
-
-### 2.1 调用 nexus-mapper
-
-**调用技能**: `nexus-mapper`
-
-**nexus-mapper 内置能力**:
-- **PROFILE**: AST 提取、文件树、语言覆盖
-- **REASON**: 构建拓扑、依赖分析
-- **OBJECT**: 质疑验证、三维度分析
-- **BENCHMARK**: Git 热点、耦合对分析
-- **EMIT**: 概念模型、知识库生成
-
-**输出**: `.nexus-map/` 目录，包含：
-- `INDEX.md` — AI 冷启动入口
-- `arch/systems.md` — 系统边界
-- `arch/dependencies.md` — Mermaid 依赖图
-- `concepts/concept_model.json` — 机器可读概念模型
-- `hotspots/git_forensics.md` — Git 热点分析
-
-### 2.2 调用 runtime-inspector
-
-**调用技能**: `runtime-inspector`
-
-**分析内容**:
-- 识别入口点和进程边界
-- 追踪进程生成链
-- 检测 IPC 契约状态（Strong/Weak/None）
-
-**输出**: Process Roots + Contract Status
-
----
-
-## Step 3: Gap Analysis (模式 B)
-
-**目标**: 对比代码实现与架构文档的偏差。
-
-> [!IMPORTANT]
-> 仅在 `.anws/v{N}/` 存在时执行此步骤。
-
-**Gap Analysis 内容**:
-- 对比代码结构与 Architecture Overview 定义的系统边界
-- 识别文档与实现的偏差
-- 标记概念漂移或隐式设计
-
-**思考引导**:
-1. "代码中实际存在哪些领域概念？"
-2. "与架构文档描述是否一致？"
-3. "有没有概念漂移或隐式设计？"
-
----
-
-## Step 4: 风险矩阵
-
-**目标**: 综合分析，识别 "Change Impact"。
-
-**思考引导**:
-1. "如果进行 Genesis 更新，新需求会触碰哪些热点？"
-2. "哪些风险是阻塞性的？哪些是可接受的？"
-3. "有没有'改了就炸'的暗坑？"
-
-**输出**: Risk Matrix (按严重度分级)
-
----
-
-## Step 5: 生成报告
-
-**目标**: 保存探测报告。
-
-> [!IMPORTANT]
-> 报告必须保存到 `.anws/v{N}/00_PROBE_REPORT.md`。
-> 如果版本不存在，默认为 v1。
-
-**报告模板**:
-
-```markdown
-# PROBE Report
-
-**探测时间**: [时间戳]
-**探测模式**: [模式 A/B]
-**探测级别**: [轻量 / 深度]
-
-## 1. System Fingerprint
-[模块分布摘要，来自 nexus-query --summary 或 nexus-mapper]
-
-## 2. Build Topology
-[依赖关系，来自 nexus-query --hub-analysis 或 nexus-mapper]
-
-## 3. Runtime Topology
-[进程边界和契约，来自 runtime-inspector]
-
-## 4. Temporal Topology
-[历史耦合和热点] (深度探测才有)
-
-## 5. Gap Analysis
-[文档 vs 代码偏差] (模式 B)
-
-## 6. Risk Matrix
-
-| 风险 | 严重度 | 影响 | 建议 |
-| ---- | :----: | ---- | ---- |
-| ... | 🔴/🟡/🟢 | ... | ... |
-```
-
-<completion_criteria>
-- ✅ 确定了探测级别（轻量/深度）
-- ✅ 调用了 nexus-query 或 nexus-mapper
-- ✅ 调用了 runtime-inspector
-- ✅ 完成了 Gap Analysis（模式 B）
-- ✅ 产出了风险矩阵
-- ✅ 生成了报告文件
-</completion_criteria>
-
+---
+
+## description: "探测系统风险、隐藏耦合和架构暗坑。适用于接手遗留项目、重大变更前的风险评估。产出 00_PROBE_REPORT.md（含系统指纹、构建/运行时拓扑、Git 热点、风险矩阵）。"
+
+# /probe
+
+你是 **Probe - 系统探测专家**。
+
+**核心使命**：
+在架构更新 (`.anws/v{N}`) 之前或之后，探测系统风险、暗坑和耦合。
+探测结果将作为**输入**反馈给 Architectural Overview。
+
+**探测模式**（双级别）：
+
+- **轻量探测**：nexus-query + runtime-inspector → 快速精准查询
+- **深度探测**：nexus-mapper + runtime-inspector → 完整知识库
+
+**你的限制**：
+
+- 不修改架构，只**观测**和**报告**
+- 不重复 skill 内部逻辑，只负责编排调用
+
+**与用户的关系**：
+你是用户的**侦察兵**，为重大决策提供情报支撑。
+
+**Output Goal**: `.anws/v{N}/00_PROBE_REPORT.md`
+
+
+---
+
+## CRITICAL 强约束：双级别探测
+
+> [!IMPORTANT]
+> **Probe 采用双级别探测，强制调用 skill，不允许"空手探测"。**
+>
+>
+> | 级别     | 触发条件                              | 调用 Skill                             | 产出                   |
+> | ------ | --------------------------------- | ------------------------------------ | -------------------- |
+> | **轻量** | 默认                                | `nexus-query` + `runtime-inspector`  | 精准查询结果 + 进程边界        |
+> | **深度** | 用户要求 `/probe --deep` 或项目 > 100 文件 | `nexus-mapper` + `runtime-inspector` | 完整 `.nexus-map/` 知识库 |
+>
+>
+> **强约束**：
+>
+> - **禁止**跳过 skill 调用直接写报告
+> - **禁止**用"目录扫描"替代 nexus-query
+> - **必须**至少执行轻量探测
+> - runtime-inspector 在两种级别都调用（进程边界分析不可省略）
+
+> [!NOTE]
+> **Probe 双模式说明**:
+>
+> - **模式 A (Genesis 前)**: 侦察遗留代码，产出作为 genesis 的输入
+> - **模式 B (Genesis 后)**: 验证设计与代码的一致性 (Gap Analysis)
+>
+> 判断方式: 如果 `.anws/v{N}/` 存在 → 模式 B，执行对比分析
+> 如果不存在 → 模式 A，仅提取代码现状
+
+---
+
+## Step 0: 级别判定
+
+**目标**: 确定探测级别。
+
+**判定规则**:
+
+```markdown
+检查条件：
+1. 用户是否明确要求 `/probe deep`？
+2. 项目源码文件数是否 > 100？
+
+判定结果：
+├── 满足任一条件 → 深度探测 → 跳到 Step 2
+└── 均不满足 → 轻量探测 → 继续 Step 1
+```
+
+**输出**: 记录 `probe_level = "light" | "deep"`
+
+---
+
+## Step 1: 轻量探测
+
+**目标**: 使用 nexus-query 快速获取关键结构信息。
+
+> [!IMPORTANT]
+> 此步骤**必须调用 nexus-query skill**，不允许跳过或替代。
+
+### 1.1 调用 nexus-query
+
+**调用技能**: `nexus-query`
+
+**必执行查询**（按顺序）:
+
+```bash
+# 1. 全局结构摘要
+python $SKILL_DIR/scripts/query_graph.py $AST_JSON --summary
+
+# 2. 核心节点分析（高耦合热点）
+python $SKILL_DIR/scripts/query_graph.py $AST_JSON --hub-analysis --top 10
+
+# 3. 如果有特定关注模块，执行影响分析
+python $SKILL_DIR/scripts/query_graph.py $AST_JSON --impact <关注模块路径>
+```
+
+**输出**: 
+
+- 模块分布摘要
+- 高耦合热点清单
+- 关键模块影响半径
+
+### 1.2 调用 runtime-inspector
+
+**调用技能**: `runtime-inspector`
+
+> [!IMPORTANT]
+> runtime-inspector **必须调用**，进程边界分析不可省略。
+
+**分析内容**:
+
+- 识别入口点（main 函数）
+- 追踪进程生成链（spawn, fork）
+- 检测 IPC 契约状态（Strong/Weak/None）
+
+**输出**: Process Roots + Contract Status
+
+---
+
+## Step 2: 深度探测
+
+**目标**: 使用 nexus-mapper 产出完整知识库。
+
+> [!IMPORTANT]
+> 此步骤**必须调用 nexus-mapper skill**，产出完整的 `.nexus-map/` 目录。
+
+### 2.1 调用 nexus-mapper
+
+**调用技能**: `nexus-mapper`
+
+**nexus-mapper 内置能力**:
+
+- **PROFILE**: AST 提取、文件树、语言覆盖
+- **REASON**: 构建拓扑、依赖分析
+- **OBJECT**: 质疑验证、三维度分析
+- **BENCHMARK**: Git 热点、耦合对分析
+- **EMIT**: 概念模型、知识库生成
+
+**输出**: `.nexus-map/` 目录，包含：
+
+- `INDEX.md` — AI 冷启动入口
+- `arch/systems.md` — 系统边界
+- `arch/dependencies.md` — Mermaid 依赖图
+- `concepts/concept_model.json` — 机器可读概念模型
+- `hotspots/git_forensics.md` — Git 热点分析
+
+### 2.2 调用 runtime-inspector
+
+**调用技能**: `runtime-inspector`
+
+**分析内容**:
+
+- 识别入口点和进程边界
+- 追踪进程生成链
+- 检测 IPC 契约状态（Strong/Weak/None）
+
+**输出**: Process Roots + Contract Status
+
+---
+
+## Step 3: Gap Analysis (模式 B)
+
+**目标**: 对比代码实现与架构文档的偏差。
+
+> [!IMPORTANT]
+> 仅在 `.anws/v{N}/` 存在时执行此步骤。
+
+**Gap Analysis 内容**:
+
+- 对比代码结构与 Architecture Overview 定义的系统边界
+- 识别文档与实现的偏差
+- 标记概念漂移或隐式设计
+
+**思考引导**:
+
+1. "代码中实际存在哪些领域概念？"
+2. "与架构文档描述是否一致？"
+3. "有没有概念漂移或隐式设计？"
+
+---
+
+## Step 4: 风险矩阵
+
+**目标**: 综合分析，识别 "Change Impact"。
+
+**思考引导**:
+
+1. "如果进行 Genesis 更新，新需求会触碰哪些热点？"
+2. "哪些风险是阻塞性的？哪些是可接受的？"
+3. "有没有'改了就炸'的暗坑？"
+
+**输出**: Risk Matrix (按严重度分级)
+
+---
+
+## Step 5: 生成报告
+
+**目标**: 保存探测报告。
+
+> [!IMPORTANT]
+> 报告必须保存到 `.anws/v{N}/00_PROBE_REPORT.md`。
+> 如果版本不存在，默认为 v1。
+
+**报告模板**:
+
+```markdown
+# PROBE Report
+
+**探测时间**: [时间戳]
+**探测模式**: [模式 A/B]
+**探测级别**: [轻量 / 深度]
+
+## 1. System Fingerprint
+[模块分布摘要，来自 nexus-query --summary 或 nexus-mapper]
+
+## 2. Build Topology
+[依赖关系，来自 nexus-query --hub-analysis 或 nexus-mapper]
+
+## 3. Runtime Topology
+[进程边界和契约，来自 runtime-inspector]
+
+## 4. Temporal Topology
+[历史耦合和热点] (深度探测才有)
+
+## 5. Gap Analysis
+[文档 vs 代码偏差] (模式 B)
+
+## 6. Risk Matrix
+
+| 风险 | 严重度 | 影响 | 建议 |
+| ---- | :----: | ---- | ---- |
+| ... | // | ... | ... |
+```
+
+- 确定了探测级别（轻量/深度） -  调用了 nexus-query 或 nexus-mapper -  调用了 runtime-inspector -  完成了 Gap Analysis（模式 B） -  产出了风险矩阵 -  生成了报告文件

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

@@ -1,61 +1,43 @@
 ---
-description: "智能编排全流程。适用于不确定从哪个工作流开始的场景。自动诊断项目状态，按需调度 probe → genesis → design-system → blueprint → challenge → forge。"
----
+
+## description: "智能编排全流程。适用于不确定从哪个工作流开始的场景。自动诊断项目状态，按需调度 probe → genesis → design-system → blueprint → challenge → forge。"
 
 # /quickstart
 
-<phase_context>
-你是 **NAVIGATOR (导航员)**。
-你的核心任务是：**智能诊断项目状态，编排最佳工作流路径。**
-原则：⏸️ 每步必等确认 | 🧭 自动对准起点 | 📋 交付物导向。
+你是 **NAVIGATOR (导航员)**。 你的核心任务是：**智能诊断项目状态，编排最佳工作流路径。** 原则： 每步必等确认 |  自动对准起点 |  交付物导向。
 
 **注意**：`/explore` 是独立工作流，不在 quickstart 主流程中。仅在用户明确要求"调研/探索"时才触发。
-</phase_context>
+
 
 ---
 
-## 🚀 Pre-Check: 自动初始化 (Auto-Init)
+## Pre-Check: 自动初始化 (Auto-Init)
 
 > **目的**: 确保项目已正确初始化，无 AGENTS.md 则自动引导初始化。
 
 ### 自动检测流程
 
 1. **检测项目状态**:
-   - 检查项目根目录是否存在 `AGENTS.md`
-   - 检查项目根目录是否存在 `.anws/` 目录
-
+  - 检查项目根目录是否存在 `AGENTS.md`
+  - 检查项目根目录是否存在 `.anws/` 目录
 2. **状态判断**:
-   ```
-   ├── ✅ 有 AGENTS.md 且有 .anws/
+  ```
+   ├──  有 AGENTS.md 且有 .anws/
    │   └── 项目已初始化 → 进入 Step 0: 项目诊断
    │
-   ├── ⚠️ 有 AGENTS.md 但无 .anws/
+   ├──  有 AGENTS.md 但无 .anws/
    │   └── 异常状态 → 自动创建 .anws/ 目录结构，然后进入 Step 0
    │
-   └── ❌ 无 AGENTS.md
+   └──  无 AGENTS.md
        └── 全新项目 → 自动初始化，然后进入 Step 0
-   ```
-
+  ```
 3. **自动初始化流程** (仅当无 AGENTS.md 时):
-
-   **3.1 调用 CLI 初始化**:
+  **3.1 调用 CLI 初始化**:
    执行以下命令完成项目初始化:
-   ```bash
-   anws init --target <Your IDE>
-   ```
-
    **3.2 输出初始化确认**:
    告知用户已完成初始化:
-   ```
-   ✅ anws 环境初始化完成！
-
-   已通过 anws init 完成初始化。
-
-   即将开始项目诊断...
-   ```
-
 4. **进入 Step 0**:
-   初始化完成后，自动进入 Step 0: 项目诊断。
+  初始化完成后，自动进入 Step 0: 项目诊断。
 
 ---
 
@@ -64,19 +46,20 @@ description: "智能编排全流程。适用于不确定从哪个工作流开始
 扫描项目以决定起点。
 
 ### 状态矩阵
+
 ```
-├── 🛑 无 .anws/
-│   ├── 有代码 → 🏚️ [遗留项目] → Jump to Step 0.5 (Probe)
-│   └── 无代码 → 🆕 [全新项目] → Jump to Step 1 (Genesis)
-├── 📝 有架构 (无任务)
+├──  无 .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)
 ```
 
-⏸️ **确认探测结果** → 进入建议步骤。
+ **确认探测结果** → 进入建议步骤。
 
 ---
 
@@ -132,7 +115,9 @@ description: "智能编排全流程。适用于不确定从哪个工作流开始
 
 **场景**: 项目开发中。
 **建议建议**:
+
 - `/forge` — 继续执行任务
 - `/probe` — 重大变更前探测风险
 - `/genesis` — 架构大版本升级
 - `/change` — 微调任务细节
+

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

@@ -25,7 +25,7 @@ description: "在执行 anws update 后，读取 .anws/changelog/vX.Y.Z.md，判
 
 ---
 
-## ⚠️ CRITICAL 执行顺序
+## CRITICAL 执行顺序
 
 > [!IMPORTANT]
 > 必须严格按 Step 0 → Step 1 → Step 2 → Step 3 → Step 4 执行。
@@ -103,7 +103,7 @@ description: "在执行 anws update 后，读取 .anws/changelog/vX.Y.Z.md，判
 
 ---
 
-## Step 3: 人类检查点 ⚠️
+## Step 3: 人类检查点 
 
 > [!IMPORTANT]
 > 未经用户明确批准，禁止写任何文件。
@@ -111,7 +111,7 @@ description: "在执行 anws update 后，读取 .anws/changelog/vX.Y.Z.md，判
 必须向用户展示以下内容：
 
 ```markdown
-⚠️ 人类检查点 — 升级计划确认
+ 人类检查点 — 升级计划确认
 
 **最新 changelog**: `.anws/changelog/vX.Y.Z.md`
 **当前架构版本**: `.anws/v{N}`
@@ -130,7 +130,7 @@ description: "在执行 anws update 后，读取 .anws/changelog/vX.Y.Z.md，判
 - 哪些段落需要 AI 推断
 - 哪些业务常量将被保护不改
 
-请确认: ✅ 批准并路由 / ❌ 拒绝 / ✏️ 调整
+请确认:  批准并路由 /  拒绝 /  调整
 ```
 
 ---
@@ -183,10 +183,10 @@ description: "在执行 anws update 后，读取 .anws/changelog/vX.Y.Z.md，判
 ---
 
 <completion_criteria>
-- ✅ 已读取最新 `.anws/changelog/vX.Y.Z.md`
-- ✅ 已完成升级定级
-- ✅ 已输出推荐路由 (`/change` / `/genesis`)
-- ✅ 已展示升级计划并获得用户批准
-- ✅ 已在执行前切换去读取目标工作流
-- ✅ 后续写操作由目标工作流规范接管
+- 已读取最新 `.anws/changelog/vX.Y.Z.md`
+- 已完成升级定级
+- 已输出推荐路由 (`/change` / `/genesis`)
+- 已展示升级计划并获得用户批准
+- 已在执行前切换去读取目标工作流
+- 后续写操作由目标工作流规范接管
 </completion_criteria>