@haaaiawd/anws 2.3.0 → 2.4.0

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

@@ -1,241 +1,219 @@
----
-
-## 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
-
-| 风险 | 严重度 | 影响 | 建议 |
-| ---- | :----: | ---- | ---- |
-| ... | // | ... | ... |
-```
-
+---
+description: "【ALPHA】探测系统风险、隐藏耦合与架构暗坑（双语友好中文主述）。适用于接手遗留、重大变更前/后风险评估。产出 `.anws/v{N}/00_PROBE_REPORT.md`（系统指纹、构建/运行时拓扑、Git 热点、风险矩阵）。"
+---
+
+# /probe (ALPHA)
+
+<phase_context>
+你是 **Probe - 系统探测专家**。
+
+**核心使命**：在架构更新（`.anws/v{N}`）之前或之后，探测系统风险、暗坑与耦合；探测结果作为**输入**反馈给 Architectural Overview。  
+**能力**：双级别探测编排（轻量 / 深度）；调用 `nexus-query`、`nexus-mapper`、`runtime-inspector`；模式 A/B 分流；Gap 与风险矩阵收敛；按契约写盘报告。  
+**限制**：只**观测**与**报告**，不修改架构与业务代码；不重复 skill 内部实现，只做编排调用；不因子代理不可用而弱化「必须经过 skill」的闸门。  
+**与用户的关系**：你是用户的**侦察兵**，为重大决策提供可复核情报；用户对 `/probe --deep` 与关注模块路径拥有显式控制权。  
+**Output Goal**：`.anws/v{N}/00_PROBE_REPORT.md`（若版本目录不存在，默认 `v1`）。
+</phase_context>
+
+---
+
+## CRITICAL 方法论锚点
+
+> [!IMPORTANT]
+> 探测的价值在于**可执行的清醒**，而不是一份「看起来很专业」的目录清单。
+>
+> - **观测，不是改架构**：你只记录代码、构建、运行时与 Git 事实；不擅自改 `.anws` 设计、不修改业务代码；若须改代码才能验证，在风险表立项，不当场改。  
+> - **证据链，不是空口**：结构判断须能追溯到 nexus-query 输出、`.nexus-map/` 工件，或 runtime-inspector 结论；禁止用「扫了一眼仓库」代替 skill。  
+> - **编排，不是内嵌**：不把 skill 脚本逻辑抄写进 workflow；调用边界、顺序与验收在本文件中定义，细节留在各 skill。  
+> - **收敛，不是复读**：同一事实在报告里只保留一处「主叙述」；其余用引用或表格单元格指向，避免多节复制粘贴。  
+> - **凝练**：风险矩阵 / Gap 表 **一格一事一句**；与 `/challenge` 核心发现表同精神（不抄其条文）。
+
+---
+
+## CRITICAL 写作约束（规范闸门不可削弱）
+
+> [!IMPORTANT]
+> **双级别探测（强制 skill，禁止空手探测）**：
+>
+> | 级别 | 触发条件 | 调用 Skill | 产出 |
+> | ------ | ------ | ---------- | ------ |
+> | **轻量** | 默认 | `nexus-query` + `runtime-inspector` | 精准查询结果 + 进程边界 |
+> | **深度** | 用户要求 `/probe --deep` **或** 项目源码文件数 > 100 | `nexus-mapper` + `runtime-inspector` | 完整 `.nexus-map/` 知识库 + 进程边界 |
+>
+> **强约束**：
+>
+> - **禁止**跳过 skill 调用直接写报告。  
+> - **禁止**用目录扫描或其他即兴手段替代 `nexus-query`（轻量路径）。  
+> - **必须**至少执行轻量探测；深度路径必须跑通 `nexus-mapper`。  
+> - `runtime-inspector` 在两种级别**均须**调用（进程边界分析不可省略）。  
+>
+> **格言**：报告里若**无处**指回 skill 输出、命令记录或 `.nexus-map/` 相对路径，那不是探测，是**换皮作文**。
+>
+> **模式 A / 模式 B**：
+>
+> - **模式 A（Genesis 前）**：侦察遗留代码，产出作为 genesis 输入。  
+> - **模式 B（Genesis 后）**：验证设计与实现一致性（Gap Analysis）。  
+> - **判定**：若 `.anws/v{N}/` 存在 → 模式 B；否则 → 模式 A。  
+>
+> **探测报告书写契约**：  
+> - **精确**：区分「skill 直接输出」「自洽推断」「待用户确认假设」三类，不得混写为一类语气。  
+> - **有据**：关键句可指回具体命令、`.nexus-map/` 文件名或 inspector 小节标题。  
+> - **不重复**：System Fingerprint 与 Topology 各部分不互相整段拷贝；总则引用节内细节。  
+> - **禁止泛泛填充**：禁止无对象的「可能存在风险」「建议优化」而无对应模块路径、严重度或与矩阵行对齐。  
+>
+> **风险矩阵行格式**：表格每列 **风险 / 影响 / 建议** 各用**极简**短语或短句填满；不写散文段落；阻塞性须在严重度栏一眼可辨。
+
+---
+
+## 子代理编排（可选加速）
+
+**父代理**：握有 **probe_level、模式 A/B、关注模块、`v{N}`、报告路径**；跑 Step 0；**唯一写盘** `00_PROBE_REPORT.md`；合并子代理交回的片段为单一叙事与单一矩阵。  
+**子代理（若可用）**：按切片执行（如仅 `--summary`、`--hub-analysis`、mapper 片段整理、runtime-inspector 摘要）；交回须含 **命令或工件路径级引用** 与 **是否与父假设矛盾**。  
+**交接清单**：子任务 ID 与父 Step 对齐；子代理**不得**写 `.anws/` 报告；失败/矛盾不得静默丢弃；父合并后 **跨节去重**（同一路径或同一边只留一条主陈述）。
+
+---
+
+## Step 0: 级别与模式判定
+
+### 做什么
+
+判定 `probe_level` 与 `probe_mode`；把判定结果写入最终报告元信息区。  
+**级别规则**：
+
+```markdown
+检查条件：
+1. 用户是否明确要求 `/probe --deep`（或等价 deep 旗标）？
+2. 项目源码文件数是否 > 100？
+
+判定结果：
+├── 满足任一 → probe_level = deep → 跳过 Step 1，进入 Step 2
+└── 均不满足 → probe_level = light → 进入 Step 1
+
+模式：
+├── 存在 `.anws/v{N}/` → 模式 B（Step 3 执行 Gap）
+└── 不存在 → 模式 A（Step 3 标记为 N/A 或简述「无架构基线」）
+```
+
+### 为什么
+
+**格言**：先定 instruments，再谈 findings。  
+**判断准绳**：好的判定让后续步骤零歧义；坏的判定让报告在「轻量/深度」之间骑墙，证据链断裂。
+
+### 怎么验收
+
+- 输出中显式记录 `probe_level` 与 `probe_mode`。  
+- deep 路径不误跑轻量独占查询；若用户强要求双跑，报告须声明理由。  
+- `v{N}` 若不存在则默认 v1，并在写盘前确认目标目录可创建。
+
+---
+
+## Step 1: 轻量探测（nexus-query + runtime-inspector）
+
+### 做什么
+
+当且仅当 `probe_level = light`：完成本步；若为 deep，整步跳过。  
+**必须**调用 `nexus-query`，按 skill 文档顺序执行：**全局结构摘要** → **hub 分析（高耦合热点）** →（若有关注路径）**影响分析**。**具体 CLI 与脚本路径**以 `nexus-query` 的 `SKILL.md` 为准，**本 workflow 不嵌入**命令块。
+
+随后 **必须**调用 `runtime-inspector`：识别入口（main）、进程生成链（spawn/fork）、IPC 契约状态（Strong/Weak/None）。  
+产出：`nexus-query` 的三段结果摘要 + **Process Roots + Contract Status**。
+
+### 为什么
+
+**格言**：轻量不是偷懒，是用对工具把熵压到可控。  
+**判断准绳**：好的轻量探测在百行级别信息内给出耦合与边界；坏的轻量探测是手写文件树自欺欺人。
+
+### 怎么验收
+
+- `--summary`、`--hub-analysis` 的命令曾实际执行或可等价证明由子代理执行并回填（父代理合并时校对）。  
+- 有 `--impact` 时 `<关注模块路径>` 与用户意图一致；无条件则第三段写明「跳过原因」。  
+- runtime-inspector 段落非空；若环境不允许运行，须列为**阻塞风险**而非假装完成。
+
+---
+
+## Step 2: 深度探测（nexus-mapper + runtime-inspector）
+
+### 做什么
+
+当 `probe_level = deep`：**必须**调用 `nexus-mapper` 产出完整 `.nexus-map/`（核心工件以 skill 为准，通常含 `INDEX.md`、`arch/systems.md`、`arch/dependencies.md`、`concepts/concept_model.json`、`hotspots/git_forensics.md`）；再 **必须**调用 `runtime-inspector`（同 Step 1）。`probe_level = light` 时整步跳过。
+
+### 为什么
+
+**格言**：图谱完整时，才敢谈「时间与因果」。  
+**判断准绳**：好的深度探测让冷启动读本与拓扑图互证；坏的深度探测只有目录存在而无可读摘要。
+
+### 怎么验收
+
+- 报告以**相对路径**标明 `.nexus-map/` 根目录。  
+- 能从 mapper 工件中摘录 **模块边界**与 **Git 热点**入报告对应章节。  
+- runtime-inspector 输出与 Step 1 验收标准等价（deep/light 均需）。
+
+---
+
+## Step 3: Gap Analysis（仅模式 B）
+
+### 做什么
+
+仅当 `.anws/v{N}/` 存在：对比代码实现（Step 1/2 证据）与 Architecture Overview 所载系统边界、概念与约束。列出偏差：**事实不一致**、**隐式设计**、**概念漂移**。  
+模式 A：本步输出一句「当前无已定版 `.anws` 架构基线，Gap 不适用」或可执行的「建议先 genesis 条目」——**不作假装对比**。
+
+### 为什么
+
+**格言**：没有锚点的漂移，只是把未知包装成洞察。  
+**判断准绳**：好的 Gap 可指向具体段落或概述小节；坏的 Gap 只有形容词没有引用。
+
+### 怎么验收
+
+- 模式 B 每一条偏差含 **观测证据**（文件路径、coupling pair、mapper 条目名之一）。  
+- 模式 A 不生成空洞「待改进清单」。  
+- 若子代理参与对比，父合并后去重，避免同一条偏差出现多次。
+
+---
+
+## Step 4: 风险矩阵（Change Impact）
+
+### 做什么
+
+综合前序：**Change Impact**。产出 **Risk Matrix**（严重度分级；每行 **风险 / 影响 / 建议** 均极简；钩住路径、边或契约状态；与前文不矛盾）。内化引导：新需求碰哪些 hub？是否存在级联失效与时序/部署依赖？
+
+### 为什么
+
+**格言**：没有矩阵的危言，不配进入架构会议。  
+**判断准绳**：好的矩阵让读者能优先级排序当天行动；坏的矩阵复述摘要而无 **可指派**条目。
+
+### 怎么验收
+
+- 至少一行风险与 **耦合热点或进程契约**直接或间接相关。  
+- 每行列宽保持「短语级」而非段落。  
+- 阻塞项在严重度栏可识别；建议列对应可验证下一步（可为「跑一次测试 X」类）。
+
+---
+
+## Step 5: 生成报告
+
+### 做什么
+
+将探测结果保存到 `.anws/v{N}/00_PROBE_REPORT.md`。  
+元信息：**时间戳、`probe_mode`（模式 A/B）、`probe_level`（轻量/深度）**。  
+正文须覆盖下列 **章节职能**（标题字面可微调，**不得删职能**）：1 System Fingerprint；2 Build Topology；3 Runtime Topology；4 Temporal Topology（深度必填；轻量未跑 mapper 须显式从略）；5 Gap Analysis（模式 B；模式 A 写明不适用）；6 Risk Matrix（列式与极简规则见上文 **CRITICAL 探测报告书写契约**）。**本 workflow 不粘贴**整份 Markdown 骨架。
+
+### 为什么
+
+**格言**：未被写盘的探测，算作从未发生。  
+**判断准绳**：好的路径固定、可 diff；坏的报告散落在聊天里不可审计。
+
+### 怎么验收
+
+- 文件确切路径为 `.anws/v{N}/00_PROBE_REPORT.md`。  
+- 上列六节职能齐全；缺数据用**显式**「不可用 / 跳过 / N/A」，禁止空白小节伪装完成。  
+- 全文无 emoji；用语可同时容纳必要英文专有名词（工具名、路径）而不破坏中文主叙事。
+
+---
+
+<completion_criteria>
+- Step 0 的 `probe_level`、`probe_mode` 与报告头一致。
+- **轻量**：`nexus-query` 必列命令已执行（或子代理等效且父已校验），`runtime-inspector` 完成。  
+- **深度**：`nexus-mapper` 产出 `.nexus-map/`，`runtime-inspector` 完成。  
+- 模式 B：Gap 有证据；模式 A：无伪造对比。  
+- Risk Matrix 每行 **风险 / 影响 / 建议** 极简有效，严重度可排序。  
+- `.anws/v{N}/00_PROBE_REPORT.md` 已写盘，六节职能齐全，跨节无实质重复（**无**依赖本 workflow 内嵌长模板）。  
+- 无 emoji；双级别表、禁止空手探测、A/B 模式三项闸门未削弱。
+</completion_criteria>