@haaaiawd/anws 2.0.4 → 2.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -14,6 +14,8 @@
14
14
  - **[验证]**: 检查点任务(人工 / E2E 验证)
15
15
  - **用户故事**: 映射到 PRD(US01, US02...)
16
16
  - **验收成立**: 验收成立条件
17
+ - **📎 ADR**: 关联的架构决策记录
18
+ - **📎 System**: 关联的系统设计文档
17
19
 
18
20
  ---
19
21
 
@@ -22,12 +24,17 @@
22
24
  #### T001 - 数据库 Schema 初始化
23
25
  - **用户故事**: US01
24
26
  - **描述**: 创建 `users` 表,包含 `id`、`email`、`password_hash`、`created_at` 字段。
27
+ - **输入**: `04_SYSTEM_DESIGN/database.md` §用户表设计
28
+ - **输出**: `migrations/001_create_users.sql`
25
29
  - **依赖**: 无
26
30
  - **验收成立**: `psql -c "\d users"` 显示正确的表结构。
31
+ - **📎 ADR**: ADR-003 (密码存储方案)
27
32
 
28
33
  #### T002 - [P] 环境配置
29
34
  - **用户故事**: US01
30
35
  - **描述**: 添加包含 `DATABASE_URL`、`JWT_SECRET` 的 `.env` 文件。
36
+ - **输入**: `02_ARCHITECTURE_OVERVIEW.md` §环境配置
37
+ - **输出**: `.env.example`, `docker-compose.yml`
31
38
  - **依赖**: 无
32
39
  - **验收成立**: `docker-compose up` 可以无报错启动数据库。
33
40
 
@@ -39,14 +46,20 @@
39
46
  #### T003 - 用户注册接口
40
47
  - **用户故事**: US01
41
48
  - **描述**: 实现 `POST /api/register`,对密码做哈希并保存用户。
42
- - **依赖**: T001(数据库 Schema)
43
- - **验收成立**: `curl -X POST /api
49
+ - **输入**: `04_SYSTEM_DESIGN/auth.md` §注册流程, T001 产出的 `users` 表
50
+ - **输出**: `src/routes/auth.js`, `src/services/user.service.js`
51
+ - **依赖**: T001
52
+ - **验收成立**: `curl -X POST /api/register` 返回 201。
53
+ - **📎 ADR**: ADR-003 (密码存储方案)
44
54
 
45
55
  #### T004 - [P] JWT Token 生成
46
56
  - **用户故事**: US01
47
57
  - **描述**: 创建 `generate_token(user_id)` 辅助函数。
48
- - **依赖**: T002JWT_SECRET 已配置)
58
+ - **输入**: `04_SYSTEM_DESIGN/auth.md` §JWT 签发, T002 产出的 `JWT_SECRET` 配置
59
+ - **输出**: `src/utils/jwt.js`
60
+ - **依赖**: T002
49
61
  - **验收成立**: 单元测试 `test_generate_token()` 通过。
62
+ - **📎 ADR**: ADR-004 (JWT 认证方案)
50
63
 
51
64
  ---
52
65
 
@@ -64,18 +77,21 @@
64
77
  #### T005 - 登录接口
65
78
  - **用户故事**: US01
66
79
  - **描述**: 实现 `POST /api/login`,校验凭证并返回 JWT。
67
- - **依赖**: T003(用户表已有数据)、T004(JWT 生成器就绪)
68
- - **输入**: T003 产出的 `users` 表 + T004 产出的 `generate_token()` 函数
80
+ - **输入**: `04_SYSTEM_DESIGN/auth.md` §登录流程, T003 产出的 `users` 表, T004 产出的 `generate_token()` 函数
69
81
  - **输出**: `/api/login` 端点 (`src/routes/auth.js`)
82
+ - **依赖**: T003, T004
70
83
  - **验收成立**:
71
84
  1. 合法登录返回 `{token: "..."}`。
72
85
  2. 非法登录返回 401。
86
+ - **📎 ADR**: ADR-004 (JWT 认证方案)
73
87
 
74
88
  #### INT-S2 - [MILESTONE] S2 集成验证 — 核心逻辑
75
89
  - **用户故事**: US01
76
90
  - **类型**: 集成验证(迭代关卡)
77
91
  - **描述**: 验证 S2 退出标准:完整认证流程可运行
78
- - **依赖**: S2 的所有任务(T003-T005)
92
+ - **输入**: `02_ARCHITECTURE_OVERVIEW.md` §认证流程, S2 所有任务的产出
93
+ - **输出**: 集成验证报告
94
+ - **依赖**: T003, T004, T005
79
95
  - **验收成立**:
80
96
  1. 运行 `npm run dev` 或等价命令
81
97
  2. 通过 `/api/register` 注册新用户
@@ -117,6 +133,7 @@ T002 (环境配置) [P]
117
133
  - [ ] 所有任务都有唯一 ID
118
134
  - [ ] 依赖关系明确(使用 `→` 表示)
119
135
  - [ ] 每个任务都有 `验收成立` 条件
136
+ - [ ] **每个任务的「输入」都引用了设计文档**(ADR/System Design/PRD/Architecture)
120
137
  - [ ] 任务中不包含实际代码(仅保留 <10 行描述)
121
138
  - [ ] 总体估时合理
122
139
  - [ ] 用户已确认该任务清单
@@ -135,8 +152,10 @@ T001 - 构建认证系统
135
152
  ✅ **好任务示例**:
136
153
  ```
137
154
  T001 - 数据库 Schema 初始化
155
+ - 输入: `04_SYSTEM_DESIGN/database.md` §用户表设计
138
156
  - 描述: 创建包含 `id`、`email`、`password_hash` 的 `users` 表。
139
157
  - 验收成立: `psql -c "\d users"` 显示正确表结构。
158
+ - 📎 ADR: ADR-003 (密码存储方案)
140
159
  ```
141
160
 
142
161
  ---
@@ -75,8 +75,9 @@ description: "将架构设计拆解为可执行的 WBS 任务清单。适用于
75
75
  ```markdown
76
76
  - [ ] **T{X}.{Y}.{Z}** [REQ-XXX]: 任务标题
77
77
  - **描述**: 具体要做什么
78
- - **输入**: 依赖的文件/接口(如依赖前置任务,必须引用其具体输出产物)
78
+ - **输入**: 设计文档引用 + 前置任务产出(必须包含至少一个文档引用)
79
79
  - **输出**: 产出的文件/组件/接口
80
+ - **📎 参考**: ADR_XXX_*.md 或 System Design 章节(如有)
80
81
  - **验收标准**:
81
82
  - Given [前置条件]
82
83
  - When [执行动作]
@@ -87,6 +88,13 @@ description: "将架构设计拆解为可执行的 WBS 任务清单。适用于
87
88
  - **依赖**: T{A}.{B}.{C} (如有)
88
89
  ```
89
90
 
91
+ > [!IMPORTANT]
92
+ > **输入字段强制要求**:
93
+ > - 每个任务的「输入」必须引用至少一个设计文档
94
+ > - 可引用:`02_ARCHITECTURE_OVERVIEW.md`、`01_PRD.md`、`03_ADR/ADR_XXX_*.md`、`04_SYSTEM_DESIGN/*.md`
95
+ > - 禁止模糊描述如"相关设计"、"需求文档"——必须具体到文件和章节
96
+ > - ADR 引用格式统一为 `ADR_XXX_*.md`(与 genesis 保持一致)
97
+
90
98
  ### 验证类型说明
91
99
 
92
100
  > [!IMPORTANT]
@@ -26,19 +26,20 @@ description: "对项目决策进行系统性挑战,用证据证明风险真实
26
26
 
27
27
  ---
28
28
 
29
- ## ⚠️ CRITICAL 强制深度思考
29
+ ## ⚠️ CRITICAL 深度思考要求
30
30
 
31
31
  > [!IMPORTANT]
32
- > **为什么必须使用 `sequential-thinking`?**
32
+ > **质疑需要深度思考,思考方式基于模型能力和任务复杂度。**
33
+ >
34
+ > **核心判断规则**:
35
+ > - **无 CoT 模型** → **必须调用** `sequential-thinking` CLI
36
+ > - **有 CoT 模型 + 简单质疑**(问题明确、步骤 < 5)→ 用思考引导问题组织自然 CoT
37
+ > - **有 CoT 模型 + 复杂质疑**(需要多方案比较、修正前提)→ 调用 `sequential-thinking` CLI
33
38
  >
34
39
  > 质疑不是"扫一眼文档然后列问题"。质疑需要**深度思考**:
35
40
  > - 你需要理解设计者的意图,才能找到他们遗漏的部分
36
41
  > - 你需要推演因果链,才能证明问题真实存在
37
42
  > - 你需要模拟系统运行,才能发现隐藏的故障模式
38
- >
39
- > **直觉式质疑 = 空想问题 = 无效质疑**
40
- >
41
- > 只有经过 3-5 步的系统性思考,你的质疑才有价值。
42
43
 
43
44
  ---
44
45
 
@@ -170,7 +170,10 @@ description: "为单个系统设计详细的技术文档。适用于架构拆解
170
170
  ### 1.6 生成上下文摘要
171
171
 
172
172
  > [!IMPORTANT]
173
- > 你**必须**使用 `sequential-thinking` skill 组织 3-5 个 thought 生成上下文摘要。
173
+ > **思考方式选择**(基于模型能力和任务复杂度):
174
+ > - **无 CoT 模型** → **必须调用** `sequential-thinking` CLI
175
+ > - **有 CoT 模型 + 简单系统**(职责清晰)→ 用思考引导问题组织自然 CoT
176
+ > - **有 CoT 模型 + 复杂系统**(需要多方案比较、修正前提)→ 调用 `sequential-thinking` CLI
174
177
 
175
178
  **思考引导**:
176
179
  1. "该系统关联哪些PRD需求?[REQ-XXX]"
@@ -245,9 +248,12 @@ description: "为单个系统设计详细的技术文档。适用于架构拆解
245
248
  **目标**: 深度理解该系统的职责和边界
246
249
 
247
250
  > [!IMPORTANT]
248
- > 你**必须**使用 `sequential-thinking` skill 组织 3-5 个 thought 进行系统理解。
251
+ > **思考方式选择**(基于模型能力和任务复杂度):
252
+ > - **无 CoT 模型** → **必须调用** `sequential-thinking` CLI
253
+ > - **有 CoT 模型 + 简单系统**(职责清晰)→ 用思考引导问题组织自然 CoT
254
+ > - **有 CoT 模型 + 复杂系统**(需要多方案比较、修正前提)→ 调用 `sequential-thinking` CLI
249
255
  >
250
- > **为什么?** 深度理解是良好设计的前提。
256
+ > **为什么需要深度理解?** 深度理解是良好设计的前提。
251
257
 
252
258
  **思考引导**:
253
259
  1. "这个系统的核心职责是什么?(用一句话概括)"
@@ -320,9 +326,12 @@ description: "为单个系统设计详细的技术文档。适用于架构拆解
320
326
  **目标**: 基于调研和上下文,深度设计系统架构
321
327
 
322
328
  > [!IMPORTANT]
323
- > 你**必须**使用 `sequential-thinking` skill 组织 5-7 个 thought 进行设计思考。
329
+ > **思考方式选择**(基于模型能力和任务复杂度):
330
+ > - **无 CoT 模型** → **必须调用** `sequential-thinking` CLI
331
+ > - **有 CoT 模型 + 简单设计**(模式明确、步骤 < 5)→ 用思考引导问题组织自然 CoT
332
+ > - **有 CoT 模型 + 复杂设计**(需要多方案比较、修正前提)→ 调用 `sequential-thinking` CLI
324
333
  >
325
- > **为什么?** 好的设计需要深度思考,不是拍脑袋决定。
334
+ > **为什么需要深度思考?** 好的设计需要深度思考,不是拍脑袋决定。
326
335
 
327
336
  **思考引导**:
328
337
 
@@ -21,10 +21,35 @@ description: "深度探索复杂问题,产出结构化洞察。适用于技术
21
21
 
22
22
  ---
23
23
 
24
+ ## ⚠️ CRITICAL 触发条件
25
+
26
+ > [!IMPORTANT]
27
+ > **明确何时触发 /explore,避免滥用或漏用。**
28
+ >
29
+ > **触发条件**(满足任一):
30
+ > - 用户明确说"调研"、"探索"、"技术选型"、"方案对比"、"头脑风暴"
31
+ > - `design-system` Step 3 自动调用(调研业界最佳实践)
32
+ > - `genesis` Step 3 技术选型时(可选)
33
+ > - 用户需要深度了解某个技术领域
34
+ >
35
+ > **不触发**:
36
+ > - 用户直接说"开始设计"、"写代码"、"实现功能"
37
+ > - `quickstart` 流程中不主动推荐
38
+ > - 简单问题(单步即可回答)
39
+ >
40
+ > **为什么需要明确触发条件?** explore 是重量级工作流,滥用会拖慢节奏,漏用会导致设计缺乏调研支撑。
41
+
42
+ ---
43
+
24
44
  ## ⚠️ CRITICAL 深度思考要求
25
45
 
26
46
  > [!IMPORTANT]
27
- > **为什么必须使用 `sequential-thinking`?**
47
+ > **探索需要深度思考,思考方式基于模型能力和任务复杂度。**
48
+ >
49
+ > **核心判断规则**:
50
+ > - **无 CoT 模型** → **必须调用** `sequential-thinking` CLI
51
+ > - **有 CoT 模型 + 简单探索**(子问题 < 3)→ 自然 CoT 即可
52
+ > - **有 CoT 模型 + 复杂探索**(需要修正前提、多方案比较)→ 调用 `sequential-thinking` CLI
28
53
  >
29
54
  > 探索不是"搜一下 + 想一下"。真正的探索需要:
30
55
  > - **分解问题**:找到正确的问题比找到答案更重要
@@ -32,7 +57,7 @@ description: "深度探索复杂问题,产出结构化洞察。适用于技术
32
57
  > - **交叉验证**:不同来源的信息需要整合
33
58
  > - **收敛提炼**:从混乱中提取结构化洞察
34
59
  >
35
- > **浅层思考 = 浅层答案 = 无效探索**
60
+ > **判断口诀**:要修正?要比较?要回放?→ CLI;否则 自然 CoT
36
61
 
37
62
  ---
38
63
 
@@ -57,9 +82,12 @@ description: "深度探索复杂问题,产出结构化洞察。适用于技术
57
82
  **目标**: 真正理解问题,将其分解为可探索的子问题。
58
83
 
59
84
  > [!IMPORTANT]
60
- > 你**必须**使用 `sequential-thinking` skill 组织 **3-5 个 thought**。
85
+ > **思考方式选择**(基于模型能力和任务复杂度):
86
+ > - **无 CoT 模型** → **必须调用** `sequential-thinking` CLI
87
+ > - **有 CoT 模型 + 简单问题**(子问题 < 3)→ 用思考引导问题组织自然 CoT
88
+ > - **有 CoT 模型 + 复杂问题**(需要修正前提、多方案比较)→ 调用 `sequential-thinking` CLI
61
89
  >
62
- > **为什么?** 问题分解的质量决定了整个探索的方向。错误的分解会导致:
90
+ > **为什么需要深度思考?** 问题分解的质量决定了整个探索的方向。错误的分解会导致:
63
91
  > - 搜索了不相关的信息
64
92
  > - 发散了错误的方向
65
93
  > - 浪费时间在无效探索上
@@ -124,9 +152,12 @@ description: "深度探索复杂问题,产出结构化洞察。适用于技术
124
152
  用于:产生创意、探索可能性、突破常规
125
153
 
126
154
  > [!IMPORTANT]
127
- > 你**必须**使用 `sequential-thinking` skill 组织 **5-8 个 thought**进行发散思考。
155
+ > **思考方式选择**(基于模型能力和任务复杂度):
156
+ > - **无 CoT 模型** → **必须调用** `sequential-thinking` CLI
157
+ > - **有 CoT 模型 + 简单发散**(技巧 < 3)→ 用发散技巧组织自然 CoT
158
+ > - **有 CoT 模型 + 复杂发散**(需要多方案比较、修正前提)→ 调用 `sequential-thinking` CLI
128
159
  >
129
- > **为什么?** 第一个想法通常是最普通的。突破需要:
160
+ > **为什么需要深度发散?** 第一个想法通常是最普通的。突破需要:
130
161
  > - 强迫自己继续想
131
162
  > - 尝试不同角度
132
163
  > - 连接不相关的概念
@@ -185,9 +216,12 @@ description: "深度探索复杂问题,产出结构化洞察。适用于技术
185
216
  **目标**: 整合所有发现,验证一致性,收敛到核心洞察。
186
217
 
187
218
  > [!IMPORTANT]
188
- > 你**必须**使用 `sequential-thinking` skill 组织 **3-5 个 thought**进行收敛思考。
219
+ > **思考方式选择**(基于模型能力和任务复杂度):
220
+ > - **无 CoT 模型** → **必须调用** `sequential-thinking` CLI
221
+ > - **有 CoT 模型 + 简单综合**(子问题 < 3,无矛盾)→ 用思考引导问题组织自然 CoT
222
+ > - **有 CoT 模型 + 复杂综合**(需要解决矛盾、修正前提)→ 调用 `sequential-thinking` CLI
189
223
  >
190
- > **为什么?** 原始发现是碎片化的。你需要:
224
+ > **为什么需要深度收敛?** 原始发现是碎片化的。你需要:
191
225
  > - 识别模式和主题
192
226
  > - 解决矛盾信息
193
227
  > - 提炼核心洞察
@@ -239,7 +239,12 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
239
239
  ### 3.2 Think Before Code (编码前思考)
240
240
 
241
241
  > [!IMPORTANT]
242
- > **编码前必须先思考,不要直接开始写代码。**
242
+ > **编码前必须先思考,思考方式基于模型能力和任务复杂度。**
243
+ >
244
+ > **核心判断规则**:
245
+ > - **无 CoT 模型** → **必须调用** `sequential-thinking` CLI
246
+ > - **有 CoT 模型 + 简单任务**(步骤 < 5,无歧义)→ 用思考引导问题组织自然 CoT
247
+ > - **有 CoT 模型 + 复杂任务**(需要多方案比较、修正前提)→ 调用 `sequential-thinking` CLI
243
248
  >
244
249
  > **为什么?** 错误的理解导致返工,提前发现问题比事后修复便宜 10 倍。
245
250
 
@@ -11,10 +11,9 @@ description: "探测系统风险、隐藏耦合和架构暗坑。适用于接手
11
11
  在架构更新 (`.anws/v{N}`) 之前或之后,探测系统风险、暗坑和耦合。
12
12
  探测结果将作为**输入**反馈给 Architectural Overview。
13
13
 
14
- **核心能力**:
15
- - 调用 `nexus-mapper` 执行完整 PROBE 五阶段协议
16
- - 调用 `runtime-inspector` 补充进程边界分析
17
- - 产出风险矩阵和 Gap Analysis
14
+ **探测模式**(双级别):
15
+ - **轻量探测**:nexus-query + runtime-inspector → 快速精准查询
16
+ - **深度探测**:nexus-mapper + runtime-inspector → 完整知识库
18
17
 
19
18
  **你的限制**:
20
19
  - 不修改架构,只**观测**和**报告**
@@ -28,13 +27,21 @@ description: "探测系统风险、隐藏耦合和架构暗坑。适用于接手
28
27
 
29
28
  ---
30
29
 
31
- ## ⚠️ CRITICAL 流程约束
30
+ ## ⚠️ CRITICAL 强约束:双级别探测
32
31
 
33
32
  > [!IMPORTANT]
34
- > Probe 不修改架构,只**观测**和**报告**。
35
- > 你的报告应该被 Genesis 过程参考。
33
+ > **Probe 采用双级别探测,强制调用 skill,不允许"空手探测"。**
36
34
  >
37
- > **为什么?** 探测的目的是发现问题,而非解决问题。混在一起会导致视角偏差。
35
+ > | 级别 | 触发条件 | 调用 Skill | 产出 |
36
+ > | :--: | -------- | :--------- | :--- |
37
+ > | **轻量** | 默认 | `nexus-query` + `runtime-inspector` | 精准查询结果 + 进程边界 |
38
+ > | **深度** | 用户要求 `/probe --deep` 或项目 > 100 文件 | `nexus-mapper` + `runtime-inspector` | 完整 `.nexus-map/` 知识库 |
39
+ >
40
+ > **强约束**:
41
+ > - ❌ **禁止**跳过 skill 调用直接写报告
42
+ > - ❌ **禁止**用"目录扫描"替代 nexus-query
43
+ > - ✅ **必须**至少执行轻量探测
44
+ > - ✅ runtime-inspector 在两种级别都调用(进程边界分析不可省略)
38
45
 
39
46
  > [!NOTE]
40
47
  > **Probe 双模式说明**:
@@ -46,23 +53,88 @@ description: "探测系统风险、隐藏耦合和架构暗坑。适用于接手
46
53
 
47
54
  ---
48
55
 
49
- ## Step 1: 执行 nexus-mapper PROBE 协议
56
+ ## Step 0: 级别判定
57
+
58
+ **目标**: 确定探测级别。
59
+
60
+ **判定规则**:
61
+
62
+ ```markdown
63
+ 检查条件:
64
+ 1. 用户是否明确要求 `/probe deep`?
65
+ 2. 项目源码文件数是否 > 100?
66
+
67
+ 判定结果:
68
+ ├── 满足任一条件 → 深度探测 → 跳到 Step 2
69
+ └── 均不满足 → 轻量探测 → 继续 Step 1
70
+ ```
71
+
72
+ **输出**: 记录 `probe_level = "light" | "deep"`
73
+
74
+ ---
75
+
76
+ ## Step 1: 轻量探测
50
77
 
51
- **目标**: 完成项目深度探测,产出 `.nexus-map/` 知识库。
78
+ **目标**: 使用 nexus-query 快速获取关键结构信息。
52
79
 
53
80
  > [!IMPORTANT]
54
- > 你**必须**调用 `nexus-mapper` 执行完整的 PROBE 五阶段协议。
55
- >
56
- > **为什么?** nexus-mapper 已整合了构建拓扑、Git 热点、领域概念分析能力,一次调用即可获得完整的项目认知。
81
+ > 此步骤**必须调用 nexus-query skill**,不允许跳过或替代。
82
+
83
+ ### 1.1 调用 nexus-query
84
+
85
+ **调用技能**: `nexus-query`
86
+
87
+ **必执行查询**(按顺序):
88
+
89
+ ```bash
90
+ # 1. 全局结构摘要
91
+ python $SKILL_DIR/scripts/query_graph.py $AST_JSON --summary
92
+
93
+ # 2. 核心节点分析(高耦合热点)
94
+ python $SKILL_DIR/scripts/query_graph.py $AST_JSON --hub-analysis --top 10
95
+
96
+ # 3. 如果有特定关注模块,执行影响分析
97
+ python $SKILL_DIR/scripts/query_graph.py $AST_JSON --impact <关注模块路径>
98
+ ```
99
+
100
+ **输出**:
101
+ - 模块分布摘要
102
+ - 高耦合热点清单
103
+ - 关键模块影响半径
104
+
105
+ ### 1.2 调用 runtime-inspector
106
+
107
+ **调用技能**: `runtime-inspector`
108
+
109
+ > [!IMPORTANT]
110
+ > runtime-inspector **必须调用**,进程边界分析不可省略。
111
+
112
+ **分析内容**:
113
+ - 识别入口点(main 函数)
114
+ - 追踪进程生成链(spawn, fork)
115
+ - 检测 IPC 契约状态(Strong/Weak/None)
116
+
117
+ **输出**: Process Roots + Contract Status
118
+
119
+ ---
120
+
121
+ ## Step 2: 深度探测
122
+
123
+ **目标**: 使用 nexus-mapper 产出完整知识库。
124
+
125
+ > [!IMPORTANT]
126
+ > 此步骤**必须调用 nexus-mapper skill**,产出完整的 `.nexus-map/` 目录。
127
+
128
+ ### 2.1 调用 nexus-mapper
57
129
 
58
130
  **调用技能**: `nexus-mapper`
59
131
 
60
132
  **nexus-mapper 内置能力**:
61
133
  - **PROFILE**: AST 提取、文件树、语言覆盖
62
- - **REASON**: 构建拓扑、依赖分析(原 build-inspector 功能)
134
+ - **REASON**: 构建拓扑、依赖分析
63
135
  - **OBJECT**: 质疑验证、三维度分析
64
- - **BENCHMARK**: Git 热点、耦合对分析(原 git-forensics 功能)
65
- - **EMIT**: 概念模型、知识库生成(原 concept-modeler 功能)
136
+ - **BENCHMARK**: Git 热点、耦合对分析
137
+ - **EMIT**: 概念模型、知识库生成
66
138
 
67
139
  **输出**: `.nexus-map/` 目录,包含:
68
140
  - `INDEX.md` — AI 冷启动入口
@@ -71,18 +143,14 @@ description: "探测系统风险、隐藏耦合和架构暗坑。适用于接手
71
143
  - `concepts/concept_model.json` — 机器可读概念模型
72
144
  - `hotspots/git_forensics.md` — Git 热点分析
73
145
 
74
- ---
75
-
76
- ## Step 2: 补充运行时拓扑分析
77
-
78
- **目标**: 追踪进程间通信和契约状态(nexus-mapper 不覆盖此领域)。
146
+ ### 2.2 调用 runtime-inspector
79
147
 
80
148
  **调用技能**: `runtime-inspector`
81
149
 
82
- **思考引导**:
83
- 1. "进程边界在哪里?通信协议是什么?"
84
- 2. "有没有僵尸进程或协议漂移风险?"
85
- 3. "契约是强类型还是隐式约定?"
150
+ **分析内容**:
151
+ - 识别入口点和进程边界
152
+ - 追踪进程生成链
153
+ - 检测 IPC 契约状态(Strong/Weak/None)
86
154
 
87
155
  **输出**: Process Roots + Contract Status
88
156
 
@@ -96,7 +164,7 @@ description: "探测系统风险、隐藏耦合和架构暗坑。适用于接手
96
164
  > 仅在 `.anws/v{N}/` 存在时执行此步骤。
97
165
 
98
166
  **Gap Analysis 内容**:
99
- - `.nexus-map/concepts/concept_model.json` `.anws/v{N}/` 中的架构定义对比
167
+ - 对比代码结构与 Architecture Overview 定义的系统边界
100
168
  - 识别文档与实现的偏差
101
169
  - 标记概念漂移或隐式设计
102
170
 
@@ -135,21 +203,22 @@ description: "探测系统风险、隐藏耦合和架构暗坑。适用于接手
135
203
 
136
204
  **探测时间**: [时间戳]
137
205
  **探测模式**: [模式 A/B]
206
+ **探测级别**: [轻量 / 深度]
138
207
 
139
208
  ## 1. System Fingerprint
140
- [项目结构概览]
209
+ [模块分布摘要,来自 nexus-query --summary 或 nexus-mapper]
141
210
 
142
211
  ## 2. Build Topology
143
- [构建边界和依赖]
212
+ [依赖关系,来自 nexus-query --hub-analysis 或 nexus-mapper]
144
213
 
145
214
  ## 3. Runtime Topology
146
- [进程边界和契约]
215
+ [进程边界和契约,来自 runtime-inspector]
147
216
 
148
217
  ## 4. Temporal Topology
149
- [历史耦合和热点]
218
+ [历史耦合和热点] (深度探测才有)
150
219
 
151
220
  ## 5. Gap Analysis
152
- [文档 vs 代码偏差]
221
+ [文档 vs 代码偏差] (模式 B)
153
222
 
154
223
  ## 6. Risk Matrix
155
224
 
@@ -159,10 +228,11 @@ description: "探测系统风险、隐藏耦合和架构暗坑。适用于接手
159
228
  ```
160
229
 
161
230
  <completion_criteria>
162
- - ✅ 建立了系统指纹
163
- - ✅ 识别了构建和运行时拓扑
164
- - ✅ 发现了历史耦合热点
165
- - ✅ 完成了 Gap Analysis
231
+ - ✅ 确定了探测级别(轻量/深度)
232
+ - ✅ 调用了 nexus-query 或 nexus-mapper
233
+ - ✅ 调用了 runtime-inspector
234
+ - ✅ 完成了 Gap Analysis(模式 B)
166
235
  - ✅ 产出了风险矩阵
236
+ - ✅ 生成了报告文件
167
237
  </completion_criteria>
168
238
 
@@ -8,6 +8,8 @@ description: "智能编排全流程。适用于不确定从哪个工作流开始
8
8
  你是 **NAVIGATOR (导航员)**。
9
9
  你的核心任务是:**智能诊断项目状态,编排最佳工作流路径。**
10
10
  原则:⏸️ 每步必等确认 | 🧭 自动对准起点 | 📋 交付物导向。
11
+
12
+ **注意**:`/explore` 是独立工作流,不在 quickstart 主流程中。仅在用户明确要求"调研/探索"时才触发。
11
13
  </phase_context>
12
14
 
13
15
  ---