@haaaiawd/anws 2.3.0 → 2.4.1
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/README.md +1 -1
- package/bin/cli.js +53 -23
- package/lib/diff.js +5 -2
- package/lib/init.js +217 -96
- package/lib/install-state.js +18 -3
- package/lib/manifest.js +364 -79
- package/lib/prompt.js +68 -0
- package/lib/resources/index.js +36 -2
- package/lib/update.js +12 -6
- package/package.json +48 -47
- package/templates/.agents/skills/anws-system/SKILL.md +107 -105
- package/templates/.agents/skills/code-reviewer/SKILL.md +171 -115
- package/templates/.agents/skills/concept-modeler/SKILL.md +230 -179
- package/templates/.agents/skills/craft-authoring/SKILL.md +186 -183
- package/templates/.agents/skills/craft-authoring/references/BUNDLE_POLICY.md +42 -0
- package/templates/.agents/skills/design-reviewer/SKILL.md +265 -190
- package/templates/.agents/skills/e2e-testing-guide/SKILL.md +246 -135
- package/templates/.agents/skills/nexus-mapper/SKILL.md +321 -321
- package/templates/.agents/skills/nexus-mapper/references/probe-protocol.md +1 -1
- package/templates/.agents/skills/nexus-query/SKILL.md +1 -1
- package/templates/.agents/skills/output-contract/SKILL.md +37 -0
- package/templates/.agents/skills/runtime-inspector/SKILL.md +150 -99
- package/templates/.agents/skills/sequential-thinking/SKILL.md +222 -225
- package/templates/.agents/skills/spec-writer/SKILL.md +75 -30
- package/templates/.agents/skills/system-architect/SKILL.md +538 -678
- package/templates/.agents/skills/system-designer/SKILL.md +124 -537
- package/templates/.agents/skills/task-planner/SKILL.md +1 -2
- package/templates/.agents/skills/task-planner/references/TASK_TEMPLATE_05A.md +2 -2
- package/templates/.agents/skills/task-reviewer/SKILL.md +421 -386
- package/templates/.agents/skills/tech-evaluator/SKILL.md +252 -144
- package/templates/.agents/workflows/blueprint.md +156 -68
- package/templates/.agents/workflows/challenge.md +322 -494
- package/templates/.agents/workflows/change.md +182 -339
- package/templates/.agents/workflows/craft.md +159 -197
- package/templates/.agents/workflows/design-system.md +202 -674
- package/templates/.agents/workflows/explore.md +187 -399
- package/templates/.agents/workflows/forge.md +650 -609
- package/templates/.agents/workflows/genesis.md +438 -351
- package/templates/.agents/workflows/probe.md +215 -240
- package/templates/.agents/workflows/quickstart.md +304 -123
- package/templates/.agents/workflows/upgrade.md +145 -182
- package/templates_en/.agents/skills/anws-system/SKILL.md +110 -0
- package/templates_en/.agents/skills/code-reviewer/SKILL.md +171 -0
- package/templates_en/.agents/skills/concept-modeler/SKILL.md +230 -0
- package/templates_en/.agents/skills/craft-authoring/SKILL.md +179 -0
- package/templates_en/.agents/skills/craft-authoring/references/BUNDLE_POLICY.md +42 -0
- package/templates_en/.agents/skills/craft-authoring/references/PROMPT_QUALITY_RUBRIC.md +92 -0
- package/templates_en/.agents/skills/craft-authoring/references/SCORECARD_TEMPLATE.md +52 -0
- package/templates_en/.agents/skills/design-reviewer/SKILL.md +264 -0
- package/templates_en/.agents/skills/e2e-testing-guide/SKILL.md +246 -0
- package/templates_en/.agents/skills/nexus-mapper/SKILL.md +306 -0
- package/templates_en/.agents/skills/nexus-mapper/references/language-customization.md +167 -0
- package/templates_en/.agents/skills/nexus-mapper/references/output-schema.md +311 -0
- package/templates_en/.agents/skills/nexus-mapper/references/probe-protocol.md +246 -0
- package/templates_en/.agents/skills/nexus-mapper/scripts/extract_ast.py +706 -0
- package/templates_en/.agents/skills/nexus-mapper/scripts/git_detective.py +194 -0
- package/templates_en/.agents/skills/nexus-mapper/scripts/languages.json +127 -0
- package/templates_en/.agents/skills/nexus-mapper/scripts/query_graph.py +556 -0
- package/templates_en/.agents/skills/nexus-mapper/scripts/requirements.txt +6 -0
- package/templates_en/.agents/skills/nexus-query/SKILL.md +114 -0
- package/templates_en/.agents/skills/nexus-query/scripts/extract_ast.py +706 -0
- package/templates_en/.agents/skills/nexus-query/scripts/git_detective.py +194 -0
- package/templates_en/.agents/skills/nexus-query/scripts/languages.json +127 -0
- package/templates_en/.agents/skills/nexus-query/scripts/query_graph.py +556 -0
- package/templates_en/.agents/skills/nexus-query/scripts/requirements.txt +6 -0
- package/templates_en/.agents/skills/output-contract/SKILL.md +37 -0
- package/templates_en/.agents/skills/runtime-inspector/SKILL.md +150 -0
- package/templates_en/.agents/skills/sequential-thinking/SKILL.md +214 -0
- package/templates_en/.agents/skills/spec-writer/SKILL.md +153 -0
- package/templates_en/.agents/skills/spec-writer/references/prd_template.md +177 -0
- package/templates_en/.agents/skills/system-architect/SKILL.md +538 -0
- package/templates_en/.agents/skills/system-architect/references/rfc_template.md +59 -0
- package/templates_en/.agents/skills/system-designer/SKILL.md +188 -0
- package/templates_en/.agents/skills/system-designer/references/system-design-detail-template.md +187 -0
- package/templates_en/.agents/skills/system-designer/references/system-design-template.md +605 -0
- package/templates_en/.agents/skills/task-planner/SKILL.md +251 -0
- package/templates_en/.agents/skills/task-planner/references/TASK_TEMPLATE_05A.md +109 -0
- package/templates_en/.agents/skills/task-planner/references/TASK_TEMPLATE_05B.md +176 -0
- package/templates_en/.agents/skills/task-reviewer/SKILL.md +422 -0
- package/templates_en/.agents/skills/tech-evaluator/SKILL.md +252 -0
- package/templates_en/.agents/skills/tech-evaluator/references/ADR_TEMPLATE.md +78 -0
- package/templates_en/.agents/workflows/blueprint.md +200 -0
- package/templates_en/.agents/workflows/challenge.md +326 -0
- package/templates_en/.agents/workflows/change.md +182 -0
- package/templates_en/.agents/workflows/craft.md +159 -0
- package/templates_en/.agents/workflows/design-system.md +202 -0
- package/templates_en/.agents/workflows/explore.md +187 -0
- package/templates_en/.agents/workflows/forge.md +651 -0
- package/templates_en/.agents/workflows/genesis.md +438 -0
- package/templates_en/.agents/workflows/probe.md +215 -0
- package/templates_en/.agents/workflows/quickstart.md +305 -0
- package/templates_en/.agents/workflows/upgrade.md +145 -0
- package/templates_en/AGENTS.md +149 -0
- package/templates/.agents/skills/report-template/SKILL.md +0 -92
- package/templates/.agents/skills/report-template/references/REPORT_TEMPLATE.md +0 -100
|
@@ -1,92 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
|
|
3
|
-
## name: report-template
|
|
4
|
-
description: 综合 Probe 阶段所有分析(nexus-mapper, runtime-inspector),生成决策就绪的系统风险报告。
|
|
5
|
-
|
|
6
|
-
# 综合者手册 (The Synthesizer's Manual)
|
|
7
|
-
|
|
8
|
-
> "数据不是信息。信息不是知识。知识不是智慧。" —— T.S. Eliot
|
|
9
|
-
|
|
10
|
-
你的目标是将原始分析数据转化为**架构师可用的智慧**。
|
|
11
|
-
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
## 强制自检 (Mandatory Self-Correction)
|
|
15
|
-
|
|
16
|
-
> [!IMPORTANT]
|
|
17
|
-
> 在生成报告之前,你**必须**进行自我检查:
|
|
18
|
-
>
|
|
19
|
-
> 1. "nexus-mapper 发现的构建边界和 runtime-inspector 发现的 IPC 边界是否一致?"
|
|
20
|
-
> 2. "nexus-mapper 发现的高耦合文件对是否跨越了构建边界?"
|
|
21
|
-
> 3. "nexus-mapper 识别的缺失组件是否与已发现的风险相关?"
|
|
22
|
-
> 4. "这份报告是否足够完整?"
|
|
23
|
-
|
|
24
|
-
---
|
|
25
|
-
|
|
26
|
-
## Quick Start
|
|
27
|
-
|
|
28
|
-
1. **读取模板 (MANDATORY)**: 读取 `references/REPORT_TEMPLATE.md`。你的报告**必须**完全匹配此结构。
|
|
29
|
-
2. **综合所有发现**: 汇总来自以下来源的输出:
|
|
30
|
-
- `nexus-mapper` → Build Roots, Topology, Coupling Pairs, Hotspots, Entities, Missing Components
|
|
31
|
-
- `runtime-inspector` → IPC Surfaces, Contract Status
|
|
32
|
-
3. **起草报告**: 按照模板组织逻辑连接。
|
|
33
|
-
4. **发布 (CRITICAL)**: 你**必须**创建 `.anws/v{N}/00_PROBE_REPORT.md` 并写入完整报告。**禁止**仅打印到聊天。确保 `.anws/v{N}/` 目录存在。
|
|
34
|
-
|
|
35
|
-
---
|
|
36
|
-
|
|
37
|
-
## 完成检查清单
|
|
38
|
-
|
|
39
|
-
在进入下一阶段之前,验证:
|
|
40
|
-
|
|
41
|
-
- 输出文件已创建: `.anws/v{N}/00_PROBE_REPORT.md`
|
|
42
|
-
- 包含: System Fingerprint, Component Map, Risk Matrix, Feature Landing Guide
|
|
43
|
-
- 用户已确认发现
|
|
44
|
-
|
|
45
|
-
---
|
|
46
|
-
|
|
47
|
-
## 综合仪式
|
|
48
|
-
|
|
49
|
-
### 1. 执行摘要 (Executive Summary)
|
|
50
|
-
|
|
51
|
-
- **电梯演讲**: 用 30 秒描述系统的健康状况。
|
|
52
|
-
- **聚焦点**: 技术债务、关键风险、可靠性。
|
|
53
|
-
|
|
54
|
-
### 2. 暗物质检测
|
|
55
|
-
|
|
56
|
-
- 不仅仅列出存在的东西。**列出缺失的东西**。
|
|
57
|
-
- 检查清单: 日志?错误处理?CI/CD?密钥管理?版本握手?
|
|
58
|
-
|
|
59
|
-
### 3. 交叉验证 (Cross-Verification)
|
|
60
|
-
|
|
61
|
-
- **nexus-mapper** 说 "Workspace 统一管理"?
|
|
62
|
-
- **nexus-mapper** 说 "高耦合跨越构建根"?
|
|
63
|
-
- **结论**: 发现隐藏逻辑耦合 → **重构目标**。
|
|
64
|
-
|
|
65
|
-
### 4. 人工检查点
|
|
66
|
-
|
|
67
|
-
- 强制用户确认: "这份报告完整吗?"
|
|
68
|
-
- **在此报告签字前,禁止进入 Blueprint 阶段**。
|
|
69
|
-
|
|
70
|
-
---
|
|
71
|
-
|
|
72
|
-
## 老师傅守则
|
|
73
|
-
|
|
74
|
-
1. **禁止幻觉**: 每个声明必须链接到源文件。
|
|
75
|
-
2. **残酷诚实**: 直言不讳。如果是一团糟,就说是一团糟。
|
|
76
|
-
3. **行动导向**: 列出的每个问题都必须暗示一个解决方案 (重构/重写/保留)。
|
|
77
|
-
|
|
78
|
-
---
|
|
79
|
-
|
|
80
|
-
## 工具箱
|
|
81
|
-
|
|
82
|
-
- `references/REPORT_TEMPLATE.md`: 报告主模板。
|
|
83
|
-
|
|
84
|
-
---
|
|
85
|
-
|
|
86
|
-
## Consumers (消费者)
|
|
87
|
-
|
|
88
|
-
这份报告的直接消费者是 `/blueprint` 阶段的:
|
|
89
|
-
|
|
90
|
-
- **System Architect**: 依赖你的风险清单来设计规避策略。
|
|
91
|
-
|
|
92
|
-
你的分析质量**直接决定**下一阶段的设计质量。
|
|
@@ -1,100 +0,0 @@
|
|
|
1
|
-
# 系统上下文报告
|
|
2
|
-
|
|
3
|
-
**生成日期**: {{DATE}}
|
|
4
|
-
**分析目标**: {{SCOPE}}
|
|
5
|
-
|
|
6
|
-
## 执行摘要
|
|
7
|
-
> [用一句话总结系统当前状态,例如:“一个总体稳健的 Python 后端,但 Auth 模块存在一定技术债。”]
|
|
8
|
-
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
## 1. 组件清单
|
|
12
|
-
|
|
13
|
-
### 1.1 现有组件
|
|
14
|
-
| 组件 | 类型 | 路径 | 描述 |
|
|
15
|
-
|---|---|---|---|
|
|
16
|
-
| [名称] | [Service/UI/DB] | [路径] | [简要描述] |
|
|
17
|
-
|
|
18
|
-
### 1.2 缺失组件(暗物质)
|
|
19
|
-
> [!WARNING]
|
|
20
|
-
> 以下组件当前缺失,但对生产可用性至关重要。
|
|
21
|
-
|
|
22
|
-
| 组件 | 类别 | 为什么需要 | 缺失影响 |
|
|
23
|
-
|---|---|---|---|
|
|
24
|
-
| 错误处理 | 基础设施 | 未发现统一错误边界 | 调试将非常困难 |
|
|
25
|
-
| 日志 | 可观测性 | 缺少结构化日志 | 线上将失明 |
|
|
26
|
-
| 配置管理 | 运维 | 检测到硬编码密钥 | 安全风险 |
|
|
27
|
-
|
|
28
|
-
---
|
|
29
|
-
|
|
30
|
-
## 2. 依赖拓扑
|
|
31
|
-
|
|
32
|
-
### 2.1 构建边界(Build Inspector)
|
|
33
|
-
> [插入来自 `build-inspector` 的发现:Build Roots、Topology、Sidecar Warnings]
|
|
34
|
-
|
|
35
|
-
```mermaid
|
|
36
|
-
graph TD
|
|
37
|
-
A[模块 A] --> B[模块 B]
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
### 2.2 逻辑耦合(Git Forensics)
|
|
41
|
-
> [插入热点矩阵或耦合表]
|
|
42
|
-
|
|
43
|
-
| 文件 A | 文件 B | 耦合度 | 风险 |
|
|
44
|
-
|---|---|---|---|
|
|
45
|
-
| auth.py | user_db.py | 85% | HIGH |
|
|
46
|
-
|
|
47
|
-
---
|
|
48
|
-
|
|
49
|
-
## 3. 风险与警告
|
|
50
|
-
|
|
51
|
-
### 3.1 IPC 契约风险(Runtime Inspector)
|
|
52
|
-
> [!CAUTION]
|
|
53
|
-
> [列出由 `runtime-inspector` 发现的 IPC 接口中契约薄弱或缺失的部分]
|
|
54
|
-
|
|
55
|
-
### 3.2 上帝模块
|
|
56
|
-
> [列出 Ca(传入耦合)过高的模块]
|
|
57
|
-
|
|
58
|
-
### 3.3 技术债热点
|
|
59
|
-
> [列出高变更频率 + 高复杂度的文件]
|
|
60
|
-
|
|
61
|
-
---
|
|
62
|
-
|
|
63
|
-
## 4. 隐式约束(Invariant Hunter)
|
|
64
|
-
|
|
65
|
-
### 4.1 业务不变量
|
|
66
|
-
> [永远不能被破坏的规则]
|
|
67
|
-
- 订单总额必须 >= 0
|
|
68
|
-
- 用户在支付前必须完成邮箱验证
|
|
69
|
-
|
|
70
|
-
### 4.2 假设
|
|
71
|
-
> [代码中存在但未被显式声明的假设]
|
|
72
|
-
- “网络总是可靠的”(没有重试逻辑)
|
|
73
|
-
- “ID 永远是整数”
|
|
74
|
-
|
|
75
|
-
### 4.3 硬编码值
|
|
76
|
-
- API 密钥
|
|
77
|
-
- 超时值
|
|
78
|
-
|
|
79
|
-
---
|
|
80
|
-
|
|
81
|
-
## 5. 概念模型(Concept Modeler)
|
|
82
|
-
|
|
83
|
-
### 5.1 统一语言
|
|
84
|
-
| 术语 | 定义 |
|
|
85
|
-
|---|---|
|
|
86
|
-
| 用户 | 已注册的终端用户(不是管理员) |
|
|
87
|
-
| 订单 | 一次购买请求 |
|
|
88
|
-
|
|
89
|
-
### 5.2 数据流
|
|
90
|
-
> [描述关键流程]
|
|
91
|
-
|
|
92
|
-
---
|
|
93
|
-
|
|
94
|
-
## 6. 人类检查点
|
|
95
|
-
> [!IMPORTANT]
|
|
96
|
-
> 在进入 Blueprint 阶段前,请确认以下事项:
|
|
97
|
-
|
|
98
|
-
- [ ] 组件清单是否完整?
|
|
99
|
-
- [ ] 当前识别出的风险是否可接受?
|
|
100
|
-
- [ ] 所有不变量是否都已捕获?
|