@haaaiawd/anws 1.2.5 → 2.0.0
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 +208 -172
- package/bin/cli.js +22 -9
- package/lib/adapters/index.js +157 -0
- package/lib/agents.js +136 -1
- package/lib/changelog.js +187 -0
- package/lib/copy.js +72 -1
- package/lib/diff.js +270 -0
- package/lib/init.js +143 -125
- package/lib/install-state.js +195 -0
- package/lib/manifest.js +184 -42
- package/lib/output.js +185 -13
- package/lib/prompt.js +284 -0
- package/lib/resources/index.js +27 -0
- package/lib/update.js +291 -83
- package/package.json +10 -6
- package/templates/.agents/skills/concept-modeler/SKILL.md +176 -0
- package/templates/{.agent → .agents}/skills/design-reviewer/SKILL.md +6 -6
- package/templates/.agents/skills/nexus-mapper/SKILL.md +306 -0
- package/templates/.agents/skills/nexus-mapper/references/language-customization.md +164 -0
- package/templates/.agents/skills/nexus-mapper/references/output-schema.md +298 -0
- package/templates/.agents/skills/nexus-mapper/references/probe-protocol.md +246 -0
- package/templates/.agents/skills/nexus-mapper/scripts/extract_ast.py +706 -0
- package/templates/.agents/skills/nexus-mapper/scripts/git_detective.py +194 -0
- package/templates/.agents/skills/nexus-mapper/scripts/languages.json +127 -0
- package/templates/.agents/skills/nexus-mapper/scripts/query_graph.py +556 -0
- package/templates/.agents/skills/nexus-mapper/scripts/requirements.txt +6 -0
- package/templates/{.agent → .agents}/skills/report-template/SKILL.md +11 -14
- package/templates/.agents/skills/report-template/references/REPORT_TEMPLATE.md +100 -0
- package/templates/{.agent → .agents}/skills/runtime-inspector/SKILL.md +1 -1
- package/templates/.agents/skills/sequential-thinking/SKILL.md +166 -0
- package/templates/.agents/skills/spec-writer/SKILL.md +108 -0
- package/templates/{.agent → .agents}/skills/spec-writer/references/prd_template.md +1 -1
- package/templates/{.agent → .agents}/skills/system-architect/SKILL.md +3 -3
- package/templates/.agents/skills/system-architect/references/rfc_template.md +59 -0
- package/templates/{.agent → .agents}/skills/system-designer/SKILL.md +6 -6
- package/templates/{.agent → .agents}/skills/system-designer/references/system-design-template.md +75 -25
- package/templates/{.agent → .agents}/skills/task-planner/SKILL.md +1 -1
- package/templates/.agents/skills/task-planner/references/TASK_TEMPLATE.md +144 -0
- package/templates/{.agent → .agents}/skills/task-reviewer/SKILL.md +4 -3
- package/templates/{.agent → .agents}/skills/tech-evaluator/SKILL.md +2 -2
- package/templates/{.agent → .agents}/skills/tech-evaluator/references/ADR_TEMPLATE.md +10 -0
- package/templates/{.agent → .agents}/workflows/blueprint.md +32 -27
- package/templates/{.agent → .agents}/workflows/challenge.md +21 -15
- package/templates/{.agent → .agents}/workflows/change.md +23 -14
- package/templates/{.agent → .agents}/workflows/craft.md +8 -19
- package/templates/{.agent → .agents}/workflows/design-system.md +81 -54
- package/templates/{.agent → .agents}/workflows/explore.md +6 -19
- package/templates/{.agent → .agents}/workflows/forge.md +30 -32
- package/templates/{.agent → .agents}/workflows/genesis.md +68 -56
- package/templates/.agents/workflows/probe.md +168 -0
- package/templates/{.agent → .agents}/workflows/quickstart.md +7 -12
- package/templates/.agents/workflows/upgrade.md +192 -0
- package/templates/AGENTS.md +66 -45
- package/templates/.agent/skills/build-inspector/SKILL.md +0 -83
- package/templates/.agent/skills/complexity-guard/SKILL.md +0 -71
- package/templates/.agent/skills/complexity-guard/references/anti_patterns.md +0 -21
- package/templates/.agent/skills/concept-modeler/SKILL.md +0 -112
- package/templates/.agent/skills/concept-modeler/prompts/GLOSSARY_PROMPT.md +0 -40
- package/templates/.agent/skills/concept-modeler/references/ENTITY_EXTRACTION_PROMPT.md +0 -299
- package/templates/.agent/skills/concept-modeler/scripts/glossary_gen.py +0 -66
- package/templates/.agent/skills/git-forensics/SKILL.md +0 -74
- package/templates/.agent/skills/git-forensics/references/ANALYSIS_METHODOLOGY.md +0 -193
- package/templates/.agent/skills/git-forensics/scripts/__pycache__/git_forensics.cpython-313.pyc +0 -0
- package/templates/.agent/skills/git-forensics/scripts/git_forensics.py +0 -615
- package/templates/.agent/skills/git-forensics/scripts/git_hotspots.py +0 -118
- package/templates/.agent/skills/report-template/references/REPORT_TEMPLATE.md +0 -100
- package/templates/.agent/skills/spec-writer/SKILL.md +0 -108
- package/templates/.agent/skills/system-architect/references/rfc_template.md +0 -59
- package/templates/.agent/skills/task-planner/references/TASK_TEMPLATE.md +0 -144
- package/templates/.agent/workflows/scout.md +0 -139
- /package/templates/{.agent → .agents}/skills/system-designer/references/system-design-detail-template.md +0 -0
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
# 任务拆解模板
|
|
2
|
+
|
|
3
|
+
**项目**: [项目名称]
|
|
4
|
+
**蓝图阶段**: 已批准
|
|
5
|
+
**RFC 参考**: `.anws/v{N}/02_ARCHITECTURE_OVERVIEW.md`
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 📋 任务清单
|
|
10
|
+
|
|
11
|
+
### 图例说明
|
|
12
|
+
- **ID**: 唯一任务标识符(T001, T002...)
|
|
13
|
+
- **[P]**: 可并行(可独立执行)
|
|
14
|
+
- **[验证]**: 检查点任务(人工 / E2E 验证)
|
|
15
|
+
- **用户故事**: 映射到 PRD(US01, US02...)
|
|
16
|
+
- **验收成立**: 验收成立条件
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
### 阶段 1:基础阶段
|
|
21
|
+
|
|
22
|
+
#### T001 - 数据库 Schema 初始化
|
|
23
|
+
- **用户故事**: US01
|
|
24
|
+
- **描述**: 创建 `users` 表,包含 `id`、`email`、`password_hash`、`created_at` 字段。
|
|
25
|
+
- **依赖**: 无
|
|
26
|
+
- **验收成立**: `psql -c "\d users"` 显示正确的表结构。
|
|
27
|
+
|
|
28
|
+
#### T002 - [P] 环境配置
|
|
29
|
+
- **用户故事**: US01
|
|
30
|
+
- **描述**: 添加包含 `DATABASE_URL`、`JWT_SECRET` 的 `.env` 文件。
|
|
31
|
+
- **依赖**: 无
|
|
32
|
+
- **验收成立**: `docker-compose up` 可以无报错启动数据库。
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
### 阶段 2:核心逻辑
|
|
38
|
+
|
|
39
|
+
#### T003 - 用户注册接口
|
|
40
|
+
- **用户故事**: US01
|
|
41
|
+
- **描述**: 实现 `POST /api/register`,对密码做哈希并保存用户。
|
|
42
|
+
- **依赖**: T001(数据库 Schema)
|
|
43
|
+
- **验收成立**: `curl -X POST /api
|
|
44
|
+
|
|
45
|
+
#### T004 - [P] JWT Token 生成
|
|
46
|
+
- **用户故事**: US01
|
|
47
|
+
- **描述**: 创建 `generate_token(user_id)` 辅助函数。
|
|
48
|
+
- **依赖**: T002(JWT_SECRET 已配置)
|
|
49
|
+
- **验收成立**: 单元测试 `test_generate_token()` 通过。
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## 📊 迭代路线图
|
|
54
|
+
|
|
55
|
+
| 迭代 | 代号 | 核心任务 | 退出标准 | 预估 |
|
|
56
|
+
|------|------|---------|---------|------|
|
|
57
|
+
| S1 | 基础阶段 | T001-T002 | DB 可连接 + 环境变量生效 | 1d |
|
|
58
|
+
| S2 | 核心逻辑 | T003-T005 | 完整认证流程可运行 | 2d |
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
### 阶段 3:集成阶段
|
|
63
|
+
|
|
64
|
+
#### T005 - 登录接口
|
|
65
|
+
- **用户故事**: US01
|
|
66
|
+
- **描述**: 实现 `POST /api/login`,校验凭证并返回 JWT。
|
|
67
|
+
- **依赖**: T003(用户表已有数据)、T004(JWT 生成器就绪)
|
|
68
|
+
- **输入**: T003 产出的 `users` 表 + T004 产出的 `generate_token()` 函数
|
|
69
|
+
- **输出**: `/api/login` 端点 (`src/routes/auth.js`)
|
|
70
|
+
- **验收成立**:
|
|
71
|
+
1. 合法登录返回 `{token: "..."}`。
|
|
72
|
+
2. 非法登录返回 401。
|
|
73
|
+
|
|
74
|
+
#### INT-S2 - [MILESTONE] S2 集成验证 — 核心逻辑
|
|
75
|
+
- **用户故事**: US01
|
|
76
|
+
- **类型**: 集成验证(迭代关卡)
|
|
77
|
+
- **描述**: 验证 S2 退出标准:完整认证流程可运行
|
|
78
|
+
- **依赖**: S2 的所有任务(T003-T005)
|
|
79
|
+
- **验收成立**:
|
|
80
|
+
1. 运行 `npm run dev` 或等价命令
|
|
81
|
+
2. 通过 `/api/register` 注册新用户
|
|
82
|
+
3. 使用合法凭证登录 → 收到 JWT 令牌
|
|
83
|
+
4. 使用非法凭证登录 → 收到 401 错误
|
|
84
|
+
5. 所有单元测试通过(`npm test`)
|
|
85
|
+
6. 无 Linter 错误(`npm run lint`)
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## 🔗 依赖图
|
|
90
|
+
|
|
91
|
+
```
|
|
92
|
+
T001 (数据库 Schema)
|
|
93
|
+
→ T003 (注册)
|
|
94
|
+
→ T005 (登录)
|
|
95
|
+
|
|
96
|
+
T002 (环境配置) [P]
|
|
97
|
+
→ T004 (JWT 辅助函数) [P]
|
|
98
|
+
→ T005 (登录)
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## 📊 汇总
|
|
104
|
+
|
|
105
|
+
| 阶段 | 任务总数 | 可并行数 |
|
|
106
|
+
|-------|---------|---------|
|
|
107
|
+
| 1 | 2 | 1 |
|
|
108
|
+
| 2 | 2 | 1 |
|
|
109
|
+
| 3 | 1 | 0 |
|
|
110
|
+
| **总计** | **5** | **2** |
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
## ✅ 验收标准
|
|
115
|
+
|
|
116
|
+
在将蓝图标记为完成前:
|
|
117
|
+
- [ ] 所有任务都有唯一 ID
|
|
118
|
+
- [ ] 依赖关系明确(使用 `→` 表示)
|
|
119
|
+
- [ ] 每个任务都有 `验收成立` 条件
|
|
120
|
+
- [ ] 任务中不包含实际代码(仅保留 <10 行描述)
|
|
121
|
+
- [ ] 总体估时合理
|
|
122
|
+
- [ ] 用户已确认该任务清单
|
|
123
|
+
|
|
124
|
+
---
|
|
125
|
+
|
|
126
|
+
## 🚫 需要避免的反模式
|
|
127
|
+
|
|
128
|
+
❌ **坏任务示例**:
|
|
129
|
+
```
|
|
130
|
+
T001 - 构建认证系统
|
|
131
|
+
- 把认证相关的一切都做完
|
|
132
|
+
- 让它安全又快速
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
✅ **好任务示例**:
|
|
136
|
+
```
|
|
137
|
+
T001 - 数据库 Schema 初始化
|
|
138
|
+
- 描述: 创建包含 `id`、`email`、`password_hash` 的 `users` 表。
|
|
139
|
+
- 验收成立: `psql -c "\d users"` 显示正确表结构。
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
**下一步**:进入 `/build` workflow,按顺序实现这些任务。
|
|
@@ -14,7 +14,7 @@ description: 系统性审查 05_TASKS.md 的质量与完备性。通过 6 大检
|
|
|
14
14
|
|
|
15
15
|
## ⚡ 任务目标
|
|
16
16
|
|
|
17
|
-
1. **加载文档 (必须)**: 读取
|
|
17
|
+
1. **加载文档 (必须)**: 读取 `.anws/v{N}/05_TASKS.md`、`01_PRD.md`、`02_ARCHITECTURE_OVERVIEW.md` 以及所有 `03_ADR/*.md`。
|
|
18
18
|
2. **构建语义模型**: 构建 3 个清单模型(见 §语义模型构建)。
|
|
19
19
|
3. **执行 6 大 Pass (A→F)**: 顺序执行每个检测 Pass——每个 Pass 在语义模型上操作。
|
|
20
20
|
4. **严重度分级**: 为每条发现分配严重度(CRITICAL / HIGH / MEDIUM / LOW)。
|
|
@@ -119,8 +119,9 @@ T{X.Y.Z}: 标题
|
|
|
119
119
|
| C3 | **幽灵引用** | 任务引用了 Architecture 文档中不存在的组件/接口/API |
|
|
120
120
|
| C4 | **缺失输入/输出** | 任务没有明确的输入或输出字段 |
|
|
121
121
|
| C5 | **缺失验证说明** | 任务没有说明如何验证完成 |
|
|
122
|
+
| C6 | **缺失验证类型** | 任务没有指定验证类型(单元测试/集成测试/E2E测试/手动验证/编译检查/Lint检查) |
|
|
122
123
|
|
|
123
|
-
**严重度规则**: C2 在 P0 任务上 → CRITICAL。C3 一律 → HIGH。
|
|
124
|
+
**严重度规则**: C2 在 P0 任务上 → CRITICAL。C3 一律 → HIGH。C6 在 P0 任务上 → HIGH。
|
|
124
125
|
|
|
125
126
|
---
|
|
126
127
|
|
|
@@ -185,7 +186,7 @@ T{X.Y.Z}: 标题
|
|
|
185
186
|
```markdown
|
|
186
187
|
## 📊 任务审查报告
|
|
187
188
|
|
|
188
|
-
> **审查文件**:
|
|
189
|
+
> **审查文件**: .anws/v{N}/05_TASKS.md
|
|
189
190
|
> **对照文档**: 01_PRD.md, 02_ARCHITECTURE_OVERVIEW.md, 03_ADR/*
|
|
190
191
|
> **日期**: {YYYY-MM-DD}
|
|
191
192
|
|
|
@@ -14,7 +14,7 @@ description: 评估技术栈选项,使用加权决策矩阵和 ATAM 方法论
|
|
|
14
14
|
## ⚠️ 强制深度思考
|
|
15
15
|
|
|
16
16
|
> [!IMPORTANT]
|
|
17
|
-
>
|
|
17
|
+
> 在进行评估之前,你**必须**使用 `sequential-thinking` skill,视复杂情况组织 **3—7 个 thought** 推理。
|
|
18
18
|
> 思考内容例如:
|
|
19
19
|
> 1. "用户的核心需求是什么?必须支持哪些场景?"
|
|
20
20
|
> 2. "团队目前熟悉什么技术?学习新技术的时间预算是多少?"
|
|
@@ -83,7 +83,7 @@ description: 评估技术栈选项,使用加权决策矩阵和 ATAM 方法论
|
|
|
83
83
|
|
|
84
84
|
### 第五步:产出 ADR (Generate ADR)
|
|
85
85
|
|
|
86
|
-
|
|
86
|
+
你**必须**创建 `ADR_001_TECH_STACK.md`,并将其写入 `.anws/v{N}/03_ADR/`。
|
|
87
87
|
|
|
88
88
|
---
|
|
89
89
|
|
|
@@ -55,6 +55,15 @@
|
|
|
55
55
|
|
|
56
56
|
## 参考资料
|
|
57
57
|
- [链接或引用]
|
|
58
|
+
|
|
59
|
+
## 影响范围
|
|
60
|
+
<!-- ⚠️ 记录哪些系统引用了本 ADR,便于修改时追踪影响 -->
|
|
61
|
+
|
|
62
|
+
本 ADR 被以下系统引用:
|
|
63
|
+
- [{系统名称}](../04_SYSTEM_DESIGN/{系统名称}.md) - §8 Trade-offs
|
|
64
|
+
- [待补充]
|
|
65
|
+
|
|
66
|
+
> **维护说明**: 当 SYSTEM_DESIGN 在 §8 引用本 ADR 时,应在此处添加引用记录。
|
|
58
67
|
```
|
|
59
68
|
|
|
60
69
|
---
|
|
@@ -66,3 +75,4 @@
|
|
|
66
75
|
3. **不可变**: 一旦接受,视为历史记录;如需更改,创建新 ADR
|
|
67
76
|
4. **版本控制**: 将 ADR 与代码一起存储在 Git 中
|
|
68
77
|
5. **团队协作**: 在最终确定前收集团队反馈
|
|
78
|
+
6. **追踪影响**: 在"影响范围"章节记录引用该 ADR 的系统,修改时能立即知道影响范围
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: 将架构设计拆解为可执行的 WBS
|
|
2
|
+
description: "将架构设计拆解为可执行的 WBS 任务清单。适用于已完成 /genesis 后的任务规划阶段。产出 05_TASKS.md(含验收标准、Sprint 划分、Mermaid 依赖图、User Story Overlay)。"
|
|
3
3
|
---
|
|
4
4
|
|
|
5
5
|
# /blueprint
|
|
@@ -8,14 +8,14 @@ description: 将架构设计拆解为可执行的 WBS 任务清单,每个任
|
|
|
8
8
|
你是 **TASK ARCHITECT (任务规划师)**。
|
|
9
9
|
|
|
10
10
|
**核心使命**:
|
|
11
|
-
读取最新的架构版本 (
|
|
11
|
+
读取最新的架构版本 (`.anws/v{N}`),将其拆解为**可执行的任务清单**。
|
|
12
12
|
|
|
13
13
|
**核心原则**:
|
|
14
14
|
- **验证驱动** - 每个任务必须有验证说明
|
|
15
15
|
- **需求追溯** - 每个任务关联 [REQ-XXX]
|
|
16
16
|
- **适度粒度** - 每个任务 2-8 小时工作量
|
|
17
17
|
|
|
18
|
-
**Output Goal**:
|
|
18
|
+
**Output Goal**: `.anws/v{N}/05_TASKS.md`
|
|
19
19
|
</phase_context>
|
|
20
20
|
|
|
21
21
|
---
|
|
@@ -34,10 +34,10 @@ description: 将架构设计拆解为可执行的 WBS 任务清单,每个任
|
|
|
34
34
|
**目标**: 找到 Source of Truth。
|
|
35
35
|
|
|
36
36
|
1. **扫描版本**:
|
|
37
|
-
扫描
|
|
37
|
+
扫描 `.anws/` 目录,找到最新版本号 `v{N}`
|
|
38
38
|
2. **确定最新版本**:
|
|
39
39
|
- 找到数字最大的文件夹 `v{N}` (例如 `v3`)。
|
|
40
|
-
- **TARGET_DIR** =
|
|
40
|
+
- **TARGET_DIR** = `.anws/v{N}`。
|
|
41
41
|
|
|
42
42
|
3. **检查必需文件**:
|
|
43
43
|
- [ ] `{TARGET_DIR}/01_PRD.md` 存在
|
|
@@ -81,11 +81,33 @@ description: 将架构设计拆解为可执行的 WBS 任务清单,每个任
|
|
|
81
81
|
- Given [前置条件]
|
|
82
82
|
- When [执行动作]
|
|
83
83
|
- Then [预期结果]
|
|
84
|
-
-
|
|
84
|
+
- **验证类型**: [单元测试 | 集成测试 | E2E测试 | 手动验证 | 编译检查 | Lint检查]
|
|
85
|
+
- **验证说明**: [如何检查完成,检查什么,具体命令或步骤]
|
|
85
86
|
- **估时**: Xh
|
|
86
87
|
- **依赖**: T{A}.{B}.{C} (如有)
|
|
87
88
|
```
|
|
88
89
|
|
|
90
|
+
### 验证类型说明
|
|
91
|
+
|
|
92
|
+
> [!IMPORTANT]
|
|
93
|
+
> **验证类型决定验证方式和证据要求**:
|
|
94
|
+
>
|
|
95
|
+
> | 验证类型 | 验证方式 | 证据要求 |
|
|
96
|
+
> |---------|---------|---------|
|
|
97
|
+
> | **单元测试** | 运行测试套件 | 终端输出:`X passed, 0 failed` |
|
|
98
|
+
> | **集成测试** | 运行集成测试或 API 调用 | 终端输出或日志截图 |
|
|
99
|
+
> | **E2E测试** | 运行端到端测试脚本 | 测试报告或录屏 |
|
|
100
|
+
> | **手动验证** | 人工检查 | 用户确认 ✅ |
|
|
101
|
+
> | **编译检查** | 构建命令 | 终端输出:`Build succeeded` |
|
|
102
|
+
> | **Lint检查** | Lint 命令 | 终端输出:`0 problems` |
|
|
103
|
+
|
|
104
|
+
**验证类型选择指南**:
|
|
105
|
+
- 纯逻辑/算法任务 → 单元测试
|
|
106
|
+
- 跨模块/跨系统任务 → 集成测试
|
|
107
|
+
- 用户交互/前端任务 → E2E测试 或 手动验证
|
|
108
|
+
- 配置/基础设施任务 → 编译检查 或 手动验证
|
|
109
|
+
- 代码质量任务 → Lint检查
|
|
110
|
+
|
|
89
111
|
### 接口追溯规则
|
|
90
112
|
|
|
91
113
|
> [!IMPORTANT]
|
|
@@ -174,16 +196,7 @@ graph TD
|
|
|
174
196
|
|
|
175
197
|
---
|
|
176
198
|
|
|
177
|
-
## Step 5:
|
|
178
|
-
|
|
179
|
-
调用 `complexity-guard` 确保:
|
|
180
|
-
- 单个任务 ≤ 8 小时
|
|
181
|
-
- 依赖关系不超过 5 层
|
|
182
|
-
- 无循环依赖
|
|
183
|
-
|
|
184
|
-
---
|
|
185
|
-
|
|
186
|
-
## Step 5.5: User Story Overlay (交叉验证)
|
|
199
|
+
## Step 5: User Story Overlay (交叉验证)
|
|
187
200
|
|
|
188
201
|
**目标**: 从**用户价值维度**验证任务完备性。WBS 按系统拆解,这一步从 User Story 视角交叉检查。
|
|
189
202
|
|
|
@@ -234,10 +247,10 @@ graph TD
|
|
|
234
247
|
|
|
235
248
|
**目标**: 保存最终的任务清单,并**更新 AGENTS.md**。
|
|
236
249
|
|
|
237
|
-
1. **保存**: 将内容保存到
|
|
250
|
+
1. **保存**: 将内容保存到 `.anws/v{N}/05_TASKS.md`
|
|
238
251
|
2. **验证**: 确保文件包含所有任务、验收标准和依赖图。
|
|
239
252
|
3. **更新 AGENTS.md "当前状态"**:
|
|
240
|
-
- 活动任务清单:
|
|
253
|
+
- 活动任务清单: `.anws/v{N}/05_TASKS.md`
|
|
241
254
|
- 最近一次更新: `{Today}`
|
|
242
255
|
- 写入初始波次建议,让 `/forge` 可以直接启动:
|
|
243
256
|
```markdown
|
|
@@ -288,7 +301,7 @@ graph TD
|
|
|
288
301
|
|
|
289
302
|
```markdown
|
|
290
303
|
### 当前任务状态
|
|
291
|
-
- 任务清单:
|
|
304
|
+
- 任务清单: .anws/v{N}/05_TASKS.md
|
|
292
305
|
- 总任务数: {N}, P0: {X}, P1: {Y}, P2: {Z}
|
|
293
306
|
- Sprint 数: {S}
|
|
294
307
|
- Wave 1 建议: T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
|
|
@@ -310,11 +323,3 @@ graph TD
|
|
|
310
323
|
- ✅ 用户已确认
|
|
311
324
|
</completion_criteria>
|
|
312
325
|
|
|
313
|
-
---
|
|
314
|
-
|
|
315
|
-
## 🔀 Handoffs
|
|
316
|
-
|
|
317
|
-
完成本工作流后,根据情况选择:
|
|
318
|
-
|
|
319
|
-
- **质疑设计与任务** → `/challenge` — 对设计和任务清单进行系统性审查
|
|
320
|
-
- **开始编码执行** → `/forge` — 按任务清单开始波次执行
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
2
|
+
description: "对项目决策进行系统性挑战,用证据证明风险真实存在。适用于架构设计完成后、编码执行前的质量把关。产出 07_CHALLENGE_REPORT.md(含分级问题清单、Pre-Mortem 分析、假设验证)。"
|
|
3
3
|
---
|
|
4
4
|
|
|
5
5
|
# /challenge
|
|
@@ -22,14 +22,14 @@ description: 对项目决策进行系统性挑战,通过三维度审查框架
|
|
|
22
22
|
2. **运行模拟维度** - 时序正确性、状态同步、边界条件
|
|
23
23
|
3. **工程实现维度** - 可测试性、可维护性、性能、安全
|
|
24
24
|
|
|
25
|
-
**Output Goal**:
|
|
25
|
+
**Output Goal**: `.anws/v{N}/07_CHALLENGE_REPORT.md`
|
|
26
26
|
|
|
27
27
|
---
|
|
28
28
|
|
|
29
29
|
## ⚠️ CRITICAL 强制深度思考
|
|
30
30
|
|
|
31
31
|
> [!IMPORTANT]
|
|
32
|
-
> **为什么必须使用 `
|
|
32
|
+
> **为什么必须使用 `sequential-thinking`?**
|
|
33
33
|
>
|
|
34
34
|
> 质疑不是"扫一眼文档然后列问题"。质疑需要**深度思考**:
|
|
35
35
|
> - 你需要理解设计者的意图,才能找到他们遗漏的部分
|
|
@@ -61,9 +61,9 @@ description: 对项目决策进行系统性挑战,通过三维度审查框架
|
|
|
61
61
|
|
|
62
62
|
**目标**: 找到当前活动的架构版本。
|
|
63
63
|
|
|
64
|
-
1. **扫描版本**: `list_dir
|
|
64
|
+
1. **扫描版本**: `list_dir .anws/`
|
|
65
65
|
2. **确定最新版本**: 找到数字最大的文件夹 `v{N}`(例如 `v3`)。
|
|
66
|
-
3. **TARGET_DIR** =
|
|
66
|
+
3. **TARGET_DIR** = `.anws/v{N}`。
|
|
67
67
|
|
|
68
68
|
---
|
|
69
69
|
|
|
@@ -105,7 +105,7 @@ description: 对项目决策进行系统性挑战,通过三维度审查框架
|
|
|
105
105
|
**目标**: 从未来回看,分析可能的失败原因——**但必须有逻辑依据**。
|
|
106
106
|
|
|
107
107
|
> [!IMPORTANT]
|
|
108
|
-
> 你**必须**使用 `
|
|
108
|
+
> 你**必须**使用 `sequential-thinking` skill 组织 **3-5 个 thought**进行深度思考。
|
|
109
109
|
>
|
|
110
110
|
> **为什么?** Pre-Mortem 的本质是**模拟推演**。你需要:
|
|
111
111
|
> - 在脑中"运行"这个项目
|
|
@@ -331,7 +331,8 @@ description: 对项目决策进行系统性挑战,通过三维度审查框架
|
|
|
331
331
|
### C1. [问题标题]
|
|
332
332
|
|
|
333
333
|
**严重度**: Critical
|
|
334
|
-
**文档**: [文档位置]
|
|
334
|
+
**文档**: [文档位置]
|
|
335
|
+
**ADR 影响**: [如涉及 ADR 修改,列出需要修改的 ADR 文件和引用该 ADR 的 SYSTEM_DESIGN 列表]
|
|
335
336
|
|
|
336
337
|
**问题描述**:
|
|
337
338
|
[详细描述,引用具体代码或设计]
|
|
@@ -394,6 +395,19 @@ description: 对项目决策进行系统性挑战,通过三维度审查框架
|
|
|
394
395
|
| 假设 | 验证方法 | 结果 | 风险 |
|
|
395
396
|
|------|---------|------|:----:|
|
|
396
397
|
| ... | ... | ... | ✅/⚠️/❌ |
|
|
398
|
+
|
|
399
|
+
### C. ADR 影响追踪
|
|
400
|
+
|
|
401
|
+
> **提醒**: 如果本次审查发现需要修改 ADR,请检查以下引用链:
|
|
402
|
+
|
|
403
|
+
| ADR 文件 | 引用该 ADR 的 SYSTEM_DESIGN | 影响说明 |
|
|
404
|
+
|---------|---------------------------|---------|
|
|
405
|
+
| [ADR-XXX](../03_ADR/ADR_XXX.md) | [system-1.md](../04_SYSTEM_DESIGN/system-1.md) §8 | [说明] |
|
|
406
|
+
|
|
407
|
+
**修改 ADR 后的行动**:
|
|
408
|
+
1. 更新 ADR 文件
|
|
409
|
+
2. 检查上表中所有引用该 ADR 的 SYSTEM_DESIGN
|
|
410
|
+
3. 确认这些系统设计是否需要相应调整
|
|
397
411
|
```
|
|
398
412
|
|
|
399
413
|
---
|
|
@@ -443,11 +457,3 @@ description: 对项目决策进行系统性挑战,通过三维度审查框架
|
|
|
443
457
|
- ✅ 用户已阅读并决定下一步
|
|
444
458
|
</completion_criteria>
|
|
445
459
|
|
|
446
|
-
---
|
|
447
|
-
|
|
448
|
-
## 🔀 Handoffs
|
|
449
|
-
|
|
450
|
-
完成本工作流后,根据情况选择:
|
|
451
|
-
|
|
452
|
-
- **修复发现的问题** → `/change` — 根据 challenge 报告修复问题 *(存在需要修复的问题时)*
|
|
453
|
-
- **开始编码执行** → `/forge` — 无阻塞问题,开始波次执行 *(无 CRITICAL 问题时)*
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
2
|
+
description: "处理微调级变更请求,仅允许修改已有任务的细节。适用于任务执行过程中发现描述不准确、验收标准需调整等场景。禁止创建新任务或添加新功能,超出范围时引导用户运行 /genesis。"
|
|
3
3
|
---
|
|
4
4
|
|
|
5
5
|
# /change
|
|
@@ -17,9 +17,9 @@ description: 处理微调级变更请求,通过 7 问题法严格评估,仅
|
|
|
17
17
|
- **可追溯** - 所有变更都记录在 CHANGELOG
|
|
18
18
|
|
|
19
19
|
**Output Goal**:
|
|
20
|
-
- 更新
|
|
21
|
-
- 更新
|
|
22
|
-
- (可选) 微调
|
|
20
|
+
- 更新 `.anws/v{N}/05_TASKS.md` (仅修改已有任务)
|
|
21
|
+
- 更新 `.anws/v{N}/06_CHANGELOG.md`
|
|
22
|
+
- (可选) 微调 `.anws/v{N}/04_SYSTEM_DESIGN/` 中已有文件的细节
|
|
23
23
|
|
|
24
24
|
---
|
|
25
25
|
|
|
@@ -78,10 +78,10 @@ description: 处理微调级变更请求,通过 7 问题法严格评估,仅
|
|
|
78
78
|
## Step 0: 定位当前版本
|
|
79
79
|
|
|
80
80
|
1. **扫描版本**:
|
|
81
|
-
扫描
|
|
81
|
+
扫描 `.anws/` 目录,找到最新版本号 `v{N}`
|
|
82
82
|
2. **确定当前版本**:
|
|
83
83
|
- 找到数字最大的文件夹 `v{N}`。
|
|
84
|
-
- **TARGET_DIR** =
|
|
84
|
+
- **TARGET_DIR** = `.anws/v{N}`。
|
|
85
85
|
|
|
86
86
|
3. **检查必需文件**:
|
|
87
87
|
- [ ] `{TARGET_DIR}/01_PRD.md` 存在
|
|
@@ -166,10 +166,26 @@ description: 处理微调级变更请求,通过 7 问题法严格评估,仅
|
|
|
166
166
|
- 仅当任务的修改涉及设计细节时才需要同步修改
|
|
167
167
|
- **只能修改已有文件,禁止创建新文件**
|
|
168
168
|
|
|
169
|
-
5.
|
|
169
|
+
5. **ADR 引用检测** (CRITICAL):
|
|
170
|
+
> [!IMPORTANT]
|
|
171
|
+
> **ADR 与 SYSTEM_DESIGN 的单向引用链**:
|
|
172
|
+
> - ADR 记录跨系统决策详情
|
|
173
|
+
> - SYSTEM_DESIGN §8 Trade-offs **只引用 ADR,不复制决策内容**
|
|
174
|
+
> - 修改时:ADR 是源头,SYSTEM_DESIGN 通过引用关联
|
|
175
|
+
|
|
176
|
+
**检测规则**:
|
|
177
|
+
- 如果修改 `04_SYSTEM_DESIGN/` 中的文件:
|
|
178
|
+
- 扫描文件中是否有 `[ADR-XXX]` 或 `../03_ADR/` 引用
|
|
179
|
+
- 如果有引用,**必须提醒用户**:该系统设计依赖 ADR 决策
|
|
180
|
+
- 如果用户请求修改 ADR:
|
|
181
|
+
- **禁止通过 /change 修改 ADR**(见权限边界表)
|
|
182
|
+
- 引导用户运行 `/genesis` 创建新版本
|
|
183
|
+
|
|
184
|
+
6. **确定修改内容**:
|
|
170
185
|
对每个受影响的文件,明确要修改什么:
|
|
171
186
|
- 05_TASKS.md: 描述调整? 验收标准修改? 估时调整? 优先级变更?
|
|
172
187
|
- 04_SYSTEM_DESIGN: 接口细节? 参数调整? 样式微调?
|
|
188
|
+
- **ADR 引用**: 如果修改涉及决策,确认是否需要更新 ADR 引用
|
|
173
189
|
|
|
174
190
|
---
|
|
175
191
|
|
|
@@ -293,10 +309,3 @@ description: 处理微调级变更请求,通过 7 问题法严格评估,仅
|
|
|
293
309
|
- ✅ 未添加任何 AI 自认为好的功能
|
|
294
310
|
</completion_criteria>
|
|
295
311
|
|
|
296
|
-
---
|
|
297
|
-
|
|
298
|
-
## 🔀 Handoffs
|
|
299
|
-
|
|
300
|
-
完成本工作流后,根据情况选择:
|
|
301
|
-
|
|
302
|
-
- **继续编码执行** → `/forge` — 变更完成,继续波次执行
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
2
|
+
description: "创建高质量的工作流、技能和提示词。适用于需要扩展 AI 能力、标准化团队协作流程的场景。支持 Workflow(端到端任务)、Skill(可复用能力)、Prompt(一次性指令)三种模式。"
|
|
3
3
|
---
|
|
4
4
|
|
|
5
5
|
# /craft
|
|
@@ -165,7 +165,7 @@ description: 创建高质量的工作流、技能和提示词,融合行业最
|
|
|
165
165
|
### 3.3 调研产出
|
|
166
166
|
|
|
167
167
|
> [!IMPORTANT]
|
|
168
|
-
>
|
|
168
|
+
> 你**必须**使用 `sequential-thinking` skill 组织 **3-5 个 thought**,整合调研结果。
|
|
169
169
|
|
|
170
170
|
**思考引导**:
|
|
171
171
|
1. "调研中发现了哪些值得借鉴的设计模式?"
|
|
@@ -351,7 +351,7 @@ description: 当用户需要 [具体触发场景] 时使用。[一句话核心
|
|
|
351
351
|
|
|
352
352
|
## 📤 输出格式
|
|
353
353
|
|
|
354
|
-
> **输出路径**: [明确说明产出文件的保存路径,包含版本化路径变量
|
|
354
|
+
> **输出路径**: [明确说明产出文件的保存路径,包含版本化路径变量 `.anws/v{N}/` 如适用]
|
|
355
355
|
|
|
356
356
|
\`\`\`markdown
|
|
357
357
|
### [输出标题]
|
|
@@ -407,7 +407,7 @@ description: 当用户需要 [具体触发场景] 时使用。[一句话核心
|
|
|
407
407
|
**目标**: 用具体内容填充框架。
|
|
408
408
|
|
|
409
409
|
> [!IMPORTANT]
|
|
410
|
-
>
|
|
410
|
+
> 你**必须**使用 `sequential-thinking` skill 组织 **3-5 个 thought**。
|
|
411
411
|
> 复杂模式可以循环多次。
|
|
412
412
|
>
|
|
413
413
|
> **为什么?** 内容质量决定工具质量。
|
|
@@ -492,7 +492,7 @@ description: 当用户需要 [具体触发场景] 时使用。[一句话核心
|
|
|
492
492
|
### 防护机制
|
|
493
493
|
- [ ] 有 `[!IMPORTANT]` 强制块
|
|
494
494
|
- [ ] 有具体的思考步数要求
|
|
495
|
-
- [ ] 有 `
|
|
495
|
+
- [ ] 有 `sequential-thinking` 调用要求
|
|
496
496
|
|
|
497
497
|
### 调研融合
|
|
498
498
|
- [ ] 融入了调研发现的最佳实践
|
|
@@ -510,7 +510,7 @@ description: 当用户需要 [具体触发场景] 时使用。[一句话核心
|
|
|
510
510
|
**目标**: 用批判眼光审视刚创建的工作流/技能,识别并修复缺陷。
|
|
511
511
|
|
|
512
512
|
> [!IMPORTANT]
|
|
513
|
-
>
|
|
513
|
+
> 你**必须**使用 `sequential-thinking` skill 组织 **3-5 个 thought**进行批判性思考。
|
|
514
514
|
> 发现问题时可以再次循环深入分析。
|
|
515
515
|
>
|
|
516
516
|
> **为什么?** 第一版永远有缺陷。自我批评是质量保证的最后一道防线。
|
|
@@ -531,7 +531,7 @@ description: 当用户需要 [具体触发场景] 时使用。[一句话核心
|
|
|
531
531
|
**思考引导 - 质量视角**:
|
|
532
532
|
6. "有没有隐含假设没有说明?"
|
|
533
533
|
7. "与调研中的最佳实践对比,还缺什么?"
|
|
534
|
-
8. "这个工作流/技能,能达到 genesis/challenge 的质量标准吗?"
|
|
534
|
+
8. "这个工作流/技能,能达到 `/genesis` / `/challenge` 的质量标准吗?"
|
|
535
535
|
|
|
536
536
|
### 8.2 产出审视清单
|
|
537
537
|
|
|
@@ -563,7 +563,7 @@ description: 当用户需要 [具体触发场景] 时使用。[一句话核心
|
|
|
563
563
|
- Prompt → 用户指定位置或 `prompts/[name].md`
|
|
564
564
|
|
|
565
565
|
**输出前检查**:
|
|
566
|
-
- [ ] 所有路径引用正确(特别是版本化路径
|
|
566
|
+
- [ ] 所有路径引用正确(特别是版本化路径 `.anws/v{N}/`)
|
|
567
567
|
- [ ] 输出位置在文档中明确声明
|
|
568
568
|
- [ ] 文件名遵循 kebab-case 命名规范
|
|
569
569
|
- [ ] Markdown 格式正确无误
|
|
@@ -662,14 +662,3 @@ description: 当用户需要 [具体触发场景] 时使用。[一句话核心
|
|
|
662
662
|
- ✅ 输出了最终文档
|
|
663
663
|
</completion_criteria>
|
|
664
664
|
|
|
665
|
-
---
|
|
666
|
-
|
|
667
|
-
## 🔀 Handoffs
|
|
668
|
-
|
|
669
|
-
完成本工作流后,根据情况选择:
|
|
670
|
-
|
|
671
|
-
- **测试新创建的工作流** → `/quickstart` — 用 quickstart 流程测试新工作流 *(创建完成后需要验证时)*
|
|
672
|
-
|
|
673
|
-
---
|
|
674
|
-
|
|
675
|
-
// turbo-all
|