@haaaiawd/anws 2.2.2 → 2.2.3

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

@@ -1,243 +1,243 @@
----
-
-## 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） - ✅ 产出了风险矩阵 - ✅ 生成了报告文件
+---
+
+## 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） -  产出了风险矩阵 -  生成了报告文件