@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.
- package/package.json +1 -1
- package/templates/.agents/skills/nexus-query/SKILL.md +114 -0
- package/templates/.agents/skills/nexus-query/scripts/extract_ast.py +706 -0
- package/templates/.agents/skills/nexus-query/scripts/git_detective.py +194 -0
- package/templates/.agents/skills/nexus-query/scripts/languages.json +127 -0
- package/templates/.agents/skills/nexus-query/scripts/query_graph.py +556 -0
- package/templates/.agents/skills/nexus-query/scripts/requirements.txt +6 -0
- package/templates/.agents/skills/runtime-inspector/SKILL.md +8 -2
- package/templates/.agents/skills/sequential-thinking/SKILL.md +44 -7
- package/templates/.agents/skills/task-planner/SKILL.md +25 -1
- package/templates/.agents/skills/task-planner/references/TASK_TEMPLATE.md +25 -6
- package/templates/.agents/workflows/blueprint.md +9 -1
- package/templates/.agents/workflows/challenge.md +7 -6
- package/templates/.agents/workflows/design-system.md +14 -5
- package/templates/.agents/workflows/explore.md +42 -8
- package/templates/.agents/workflows/forge.md +6 -1
- package/templates/.agents/workflows/probe.md +105 -35
- package/templates/.agents/workflows/quickstart.md +2 -0
|
@@ -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
|
-
-
|
|
43
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
>
|
|
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
|
-
>
|
|
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
|
-
>
|
|
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
|
-
>
|
|
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
|
-
>
|
|
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
|
-
>
|
|
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
|
-
>
|
|
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
|
-
>
|
|
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
|
-
-
|
|
16
|
-
-
|
|
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
|
|
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
|
-
**目标**:
|
|
78
|
+
**目标**: 使用 nexus-query 快速获取关键结构信息。
|
|
52
79
|
|
|
53
80
|
> [!IMPORTANT]
|
|
54
|
-
>
|
|
55
|
-
|
|
56
|
-
|
|
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**:
|
|
134
|
+
- **REASON**: 构建拓扑、依赖分析
|
|
63
135
|
- **OBJECT**: 质疑验证、三维度分析
|
|
64
|
-
- **BENCHMARK**: Git
|
|
65
|
-
- **EMIT**:
|
|
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
|
-
|
|
84
|
-
|
|
85
|
-
|
|
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
|
-
-
|
|
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
|
|