@haaaiawd/anws 2.2.6 → 2.4.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 +1 -1
- package/bin/cli.js +52 -22
- package/lib/diff.js +5 -2
- package/lib/init.js +217 -96
- package/lib/install-state.js +18 -3
- package/lib/manifest.js +510 -213
- 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 +108 -108
- package/templates/.agents/skills/code-reviewer/SKILL.md +170 -103
- package/templates/.agents/skills/concept-modeler/SKILL.md +230 -179
- package/templates/.agents/skills/craft-authoring/SKILL.md +112 -49
- package/templates/.agents/skills/craft-authoring/references/BUNDLE_POLICY.md +61 -0
- package/templates/.agents/skills/craft-authoring/references/PROMPT_QUALITY_RUBRIC.md +99 -0
- package/templates/.agents/skills/craft-authoring/references/SCORECARD_TEMPLATE.md +64 -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/output-contract/SKILL.md +37 -0
- package/templates/.agents/skills/report-template/SKILL.md +92 -92
- 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 +601 -601
- package/templates/.agents/skills/task-planner/SKILL.md +1 -2
- package/templates/.agents/skills/task-reviewer/SKILL.md +428 -388
- package/templates/.agents/skills/tech-evaluator/SKILL.md +252 -144
- package/templates/.agents/workflows/blueprint.md +166 -43
- package/templates/.agents/workflows/challenge.md +331 -497
- package/templates/.agents/workflows/change.md +182 -339
- package/templates/.agents/workflows/craft.md +159 -236
- package/templates/.agents/workflows/design-system.md +202 -674
- package/templates/.agents/workflows/explore.md +187 -399
- package/templates/.agents/workflows/forge.md +650 -550
- package/templates/.agents/workflows/genesis.md +439 -351
- package/templates/.agents/workflows/probe.md +219 -241
- package/templates/.agents/workflows/quickstart.md +302 -123
- package/templates/.agents/workflows/upgrade.md +145 -182
- package/templates_en/.agents/skills/anws-system/SKILL.md +108 -0
- package/templates_en/.agents/skills/code-reviewer/SKILL.md +170 -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 +60 -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 +265 -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/report-template/SKILL.md +85 -0
- package/templates_en/.agents/skills/report-template/references/REPORT_TEMPLATE.md +100 -0
- package/templates_en/.agents/skills/runtime-inspector/SKILL.md +101 -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 +534 -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 +428 -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 +331 -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 +439 -0
- package/templates_en/.agents/workflows/probe.md +219 -0
- package/templates_en/.agents/workflows/quickstart.md +303 -0
- package/templates_en/.agents/workflows/upgrade.md +145 -0
- package/templates_en/AGENTS.md +149 -0
|
@@ -1,339 +1,182 @@
|
|
|
1
|
-
---
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
# /change
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
>
|
|
48
|
-
>
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
>
|
|
55
|
-
>
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
2
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
---
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
>
|
|
183
|
-
|
|
184
|
-
1. **读取当前任务清单**:
|
|
185
|
-
读取 `{TARGET_DIR}/05A_TASKS.md`
|
|
186
|
-
- 如涉及验证责任调整,读取 `{TARGET_DIR}/05B_VERIFICATION_PLAN.md`
|
|
187
|
-
2. **读取 PRD (交叉验证)**:
|
|
188
|
-
读取 `{TARGET_DIR}/01_PRD.md`,确认变更在需求范围内
|
|
189
|
-
3. **定位任务**:
|
|
190
|
-
- 找到与变更相关的已有任务 (如 `T2.1.3`)
|
|
191
|
-
- 记录所有实际受影响的已有任务
|
|
192
|
-
- 如现有任务无法承接,但变更仍属当前版本内局部修订,可补充少量新任务并在 Step 3 明确展示
|
|
193
|
-
- 如仅需在当前 ADR 前提下重排任务、调整 Sprint/Wave 归属或补充少量承接项,仍由 `/change` 处理
|
|
194
|
-
- 如需要重做任务结构的根因是 ADR 已不成立或系统边界已变化 → 跳转 Step 4
|
|
195
|
-
4. **定位相关设计文件** (如需要):
|
|
196
|
-
- 检查 `{TARGET_DIR}/04_SYSTEM_DESIGN/` 中是否有对应的系统设计文件
|
|
197
|
-
- 仅当任务的修改涉及设计细节时才需要同步修改
|
|
198
|
-
- 如为了承接当前版本内的契约补全或测试约束,需要新增少量设计/附录文件,允许创建,但必须在 Step 3 显式展示
|
|
199
|
-
5. **ADR 引用检测** (CRITICAL):
|
|
200
|
-
> [!IMPORTANT]
|
|
201
|
-
> **ADR 与 SYSTEM_DESIGN 的单向引用链**:
|
|
202
|
-
>
|
|
203
|
-
> - ADR 记录跨系统决策详情
|
|
204
|
-
> - SYSTEM_DESIGN §8 Trade-offs **只引用 ADR,不复制决策内容**
|
|
205
|
-
> - 修改时:ADR 是源头,SYSTEM_DESIGN 通过引用关联
|
|
206
|
-
> **检测规则**:
|
|
207
|
-
- 如果修改 `04_SYSTEM_DESIGN/` 中的文件:
|
|
208
|
-
- 扫描文件中是否有 `[ADR-XXX]` 或 `../03_ADR/` 引用
|
|
209
|
-
- 如果有引用,**必须提醒用户**:该系统设计依赖 ADR 决策
|
|
210
|
-
- 如果用户请求修改 ADR:
|
|
211
|
-
- 先判断是否只是命名同步、接口补全、表达澄清或测试约束补充
|
|
212
|
-
- 如不改变 ADR 核心决策前提 → 允许通过 `/change` 修改
|
|
213
|
-
- 如改变 ADR 核心决策前提 → 升级 `/genesis`
|
|
214
|
-
6. **契约与验证承接检查**:
|
|
215
|
-
- 如变更涉及公共契约(接口、CLI 参数、配置结构、文件格式、错误语义、跨系统协议)
|
|
216
|
-
- 明确这些契约是否已有任务承接
|
|
217
|
-
- 如无验证承接,确定是否需要补充验证任务、验收标准或验证说明
|
|
218
|
-
7. **确定修改内容**:
|
|
219
|
-
对每个受影响的文件,明确要修改什么:
|
|
220
|
-
- 05A_TASKS.md: 描述调整? 验收标准修改? 估时调整? 优先级变更?
|
|
221
|
-
- 05B_VERIFICATION_PLAN.md: 验证方法? 证据要求? 追溯矩阵条目?
|
|
222
|
-
- 04_SYSTEM_DESIGN: 接口细节? 参数调整? 样式微调?
|
|
223
|
-
- 01_PRD / 02_ARCHITECTURE_OVERVIEW / 03_ADR: 命名同步? 契约补全? 表达澄清? 测试约束补充?
|
|
224
|
-
- **验证承接**: 是否需要新增/调整验证类型、验证说明或补充测试任务
|
|
225
|
-
- **ADR 引用**: 如果修改涉及决策,确认是否需要更新 ADR 引用
|
|
226
|
-
|
|
227
|
-
---
|
|
228
|
-
|
|
229
|
-
## Step 3: 签名检查点
|
|
230
|
-
|
|
231
|
-
**目标**: 展示变更计划,获得签名后才能执行。
|
|
232
|
-
|
|
233
|
-
> [!IMPORTANT]
|
|
234
|
-
> **这是强制检查点。未经签名,禁止修改任何文件。**
|
|
235
|
-
> 普通模式下等待用户签名;如本次 `/change` 明确来自 `/forge自动` 的连续回流,则保留完整检查点展示,并以 `AUTO` 作为签名继续执行。
|
|
236
|
-
|
|
237
|
-
**展示变更计划**:
|
|
238
|
-
|
|
239
|
-
```markdown
|
|
240
|
-
签名检查点 — 变更确认
|
|
241
|
-
|
|
242
|
-
**变更级别**: 局部修订 / 受控扩展
|
|
243
|
-
**用户原始请求**: "{用户原话}"
|
|
244
|
-
**受影响任务**: {N} 个
|
|
245
|
-
**签名**: 用户 / AUTO
|
|
246
|
-
|
|
247
|
-
### 修改预览
|
|
248
|
-
|
|
249
|
-
**任务 T{X}.{Y}.{Z}: {任务标题}**
|
|
250
|
-
| 字段 | 修改前 | 修改后 |
|
|
251
|
-
|------|--------|--------|
|
|
252
|
-
| 验收标准 | Given... Then 跳转首页 | Given... Then 跳转 Dashboard |
|
|
253
|
-
|
|
254
|
-
**任务 T{A}.{B}.{C}: {任务标题}** (如有)
|
|
255
|
-
| 字段 | 修改前 | 修改后 |
|
|
256
|
-
|------|--------|--------|
|
|
257
|
-
| 估时 | 4h | 6h |
|
|
258
|
-
|
|
259
|
-
---
|
|
260
|
-
|
|
261
|
-
请签名: 批准 / 拒绝 / 调整 / AUTO
|
|
262
|
-
```
|
|
263
|
-
|
|
264
|
-
- **批准** → 继续 Step 3.1 执行修改
|
|
265
|
-
- **拒绝** → 终止,不做任何修改
|
|
266
|
-
- **调整** → 根据反馈重新制定计划,重新进入 Step 3
|
|
267
|
-
- **AUTO** → 仅当本次来自 `/forge自动` 且仍在 `/change` 权限范围内时有效;保留检查点仪式,自动继续执行
|
|
268
|
-
|
|
269
|
-
### Step 3.1: 执行修改 (仅在签名后)
|
|
270
|
-
|
|
271
|
-
1. **修改任务清单**:
|
|
272
|
-
使用 `replace_file_content` 修改 `{TARGET_DIR}/05A_TASKS.md` 中的对应任务定义
|
|
273
|
-
- 仅允许修改任务描述、验收标准、估时、优先级、阻塞说明等定义字段
|
|
274
|
-
- 如 Step 1 判定为受控扩展,可补充少量与用户原话直接对应的新任务
|
|
275
|
-
- **禁止**在 `/change` 中将 `- [ ]` 改为 `- [x]` 或反向修改 checkbox
|
|
276
|
-
2. **记录变更日志**:
|
|
277
|
-
读取并追加到 `{TARGET_DIR}/06_CHANGELOG.md`:
|
|
278
|
-
3. **更新 AGENTS.md**:
|
|
279
|
-
- 更新 `最近一次更新` 日期。
|
|
280
|
-
- (注意: 局部修订不改变待办任务数)
|
|
281
|
-
4. **报告**: 告知用户变更已完成。
|
|
282
|
-
5. **回到 `/forge` 前的衔接说明(非静态代码审查)**:
|
|
283
|
-
- `**/change` 不运行、不替代 `code-reviewer`。** 静态忠实度审查只属于 `**/forge` 3.4.5** 与 `**/challenge`(CODE/FULL)**;不得在本次变更报告中声称「代码已完成静态审查」。
|
|
284
|
-
- 若本次变更触及 `契约承接`、`验证类型` / `验证说明`、`04_SYSTEM_DESIGN/` 或公共接口语义:在报告中 **列表说明触达项**,便于 `/forge` 规划门禁与任务执行。
|
|
285
|
-
- **可选(文档侧)**:若任务表或设计措辞需要可读性复核,可 **建议** 用户使用 `task-reviewer` 或 `design-reviewer`;**不得**将 `/change` 写成与 `**/forge` Step 0**(含 `07_CHALLENGE_REPORT.md`)同等效力的「Critical/High 阻塞回到编码」门禁。
|
|
286
|
-
|
|
287
|
-
---
|
|
288
|
-
|
|
289
|
-
## Step 4: 升级到 /genesis
|
|
290
|
-
|
|
291
|
-
**目标**: 告知用户当前变更已经改变版本前提,必须升级到 `/genesis`。
|
|
292
|
-
|
|
293
|
-
> [!IMPORTANT]
|
|
294
|
-
> **只有当变更改变当前版本的需求前提、架构前提或任务树承接性时,才升级到 `/genesis`。**
|
|
295
|
-
> 不要把普通命名同步、契约补全、测试责任补全过度升级为 `/genesis`,也不要把前提演进伪装成 `/change`。
|
|
296
|
-
|
|
297
|
-
> [!IMPORTANT]
|
|
298
|
-
> **Git 换轨动作**:
|
|
299
|
-
> 如果本次是从现有 `feature/`* 分支中途升级到 `/genesis`,先冻结当前分支;必要时先创建一个 checkpoint / freeze commit,再从最新 `main` 开新的 `feature/`*` 承接新版本。不要继续在旧分支上混做新版本实现。
|
|
300
|
-
|
|
301
|
-
```markdown
|
|
302
|
-
此变更**已超出当前版本可承接范围**。
|
|
303
|
-
|
|
304
|
-
**评估结果**:
|
|
305
|
-
- [问题 X]: 是 — {理由}
|
|
306
|
-
|
|
307
|
-
**为什么 /change 不能处理?**
|
|
308
|
-
/change 的职责是处理当前版本内的受控修订与回流,
|
|
309
|
-
但当前变更已经改变了本版本的需求/架构前提,继续原地修补会破坏版本真相。
|
|
310
|
-
|
|
311
|
-
**这能防止什么?**
|
|
312
|
-
- AI 自行添加"觉得好"的功能
|
|
313
|
-
- 架构文档与实现不一致
|
|
314
|
-
- 绕过 PRD → 架构 → 任务的完整链条
|
|
315
|
-
|
|
316
|
-
**建议**: 升级到 `/genesis` 创建新的架构版本 `v{N+1}`。
|
|
317
|
-
|
|
318
|
-
下一步: `/genesis` (将自动创建 v{N+1})
|
|
319
|
-
```
|
|
320
|
-
|
|
321
|
-
---
|
|
322
|
-
|
|
323
|
-
## Step 5: AI 发现的改进建议 (可选)
|
|
324
|
-
|
|
325
|
-
**目标**: 如果 AI 在分析过程中发现了值得改进的地方,以"建议"形式告知用户。
|
|
326
|
-
|
|
327
|
-
> [!IMPORTANT]
|
|
328
|
-
> **这些建议仅供参考,AI 不得自行执行。**
|
|
329
|
-
> 用户需要自行决定是否通过 `/genesis` 处理。
|
|
330
|
-
|
|
331
|
-
```markdown
|
|
332
|
-
**AI 发现的改进建议** (仅供参考,不在本次变更范围内):
|
|
333
|
-
|
|
334
|
-
1. [建议1]: {描述} — 如需实施,请运行 `/genesis`
|
|
335
|
-
2. [建议2]: {描述} — 如需实施,请运行 `/genesis`
|
|
336
|
-
|
|
337
|
-
以上建议**不会被自动执行**,请自行决定是否采纳。
|
|
338
|
-
```
|
|
339
|
-
|
|
1
|
+
---
|
|
2
|
+
description: "【ALPHA】/change:当前版本内受控变更与 05A/05B 回流;权限与十问闸门不减;与 task-planner 字段对齐;大段签名样例不注入宿主。"
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# /change (ALPHA)
|
|
6
|
+
|
|
7
|
+
<phase_context>
|
|
8
|
+
你是 **CHANGE MANAGER(变更管理师)— ALPHA 线**。
|
|
9
|
+
|
|
10
|
+
**使命**:在**已进入 `/forge` 编码阶段之后**,处理当前 `v{N}` 内的受控变更、契约与任务/验证回流;仅当**前提演进**时升级到 `/genesis`。
|
|
11
|
+
**能力**:版本定位、十问分级、影响面定位、签名后改 `05A`/`05B`/`06`、ADR↔04 引用检测、与 `task-planner` 口径对齐的字段编辑。
|
|
12
|
+
**限制**:**禁止**回填 `05A` checkbox、**禁止**改 `[REQ-*]` 绑定、**禁止**越权改前提;**不**在宿主粘贴完整「签名检查点」Markdown 样例(只列**须含职能**)。
|
|
13
|
+
**与用户的关系**:先计划后写;普通模式须用户签名,`/forge` 自动回流可用 `AUTO`(仍展示计划)。
|
|
14
|
+
**Output Goal**:更新 `{TARGET_DIR}/05A_TASKS.md`、按需 `{TARGET_DIR}/05B_VERIFICATION_PLAN.md`、追加 `{TARGET_DIR}/06_CHANGELOG.md`;**不**替代 `code-reviewer` / forge §3.6。
|
|
15
|
+
</phase_context>
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## CRITICAL 凝练与版式(/craft + /challenge 思想)
|
|
20
|
+
|
|
21
|
+
> [!IMPORTANT]
|
|
22
|
+
> **craft**:改稿前 Read shipped `.agents/skills/craft-authoring/SKILL.md` 与 `.agents/workflows/craft.md`;各 `## Step …` 使用 **`### 做什么` / `### 为什么` / `### 怎么验收`**;`<completion_criteria>` 必填。
|
|
23
|
+
> **凝练**:对用户的计划与报告 **一句一事**;与 shipped `templates/.../change.md` 重复的十问逻辑 **不得删减为暗示**,可收紧仅为重复叙事。
|
|
24
|
+
> **不注入**:不在本文件展开完整「变更评估表」「签名检查点」长 fence——**须含字段/职能**在 Step 1、Step 3 以列表指明的为准。
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## CRITICAL 权限边界(闸门不可削弱)
|
|
29
|
+
|
|
30
|
+
> [!IMPORTANT]
|
|
31
|
+
> 以「**是否改变当前版本核心前提**」为准,**不以**所触文件类型为准。下列表格与 shipped `.agents/workflows/change.md` **语义等价**;若冲突以 shipped 为准并回修 alpha。
|
|
32
|
+
|
|
33
|
+
| 能力 | 允许 | 禁止 |
|
|
34
|
+
|------|:----:|:----:|
|
|
35
|
+
| 改已有任务描述、验收、估时、阻塞/优先级 | 是 | |
|
|
36
|
+
| 微调 `04/`、当前版普通文档细节 | 是 | |
|
|
37
|
+
| 在**不改前提**下改 `01`/`02`/`03` 的表述、命名、契约补全、澄清 | 是 | |
|
|
38
|
+
| 为已明确请求的局部修订**少量**补任务或重排 Sprint/Wave(不改 ADR 前提) | 是 | |
|
|
39
|
+
| **回填 `05A` checkbox**、**自加功能**、**改 `[REQ-*]`**、**改需求/架构/ADR 核心前提**、**整树失效须重建** | | 是 |
|
|
40
|
+
|
|
41
|
+
**一旦命中禁止列 → Step 4 升级 `/genesis`(勿原地硬扛)。**
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## CRITICAL 反自由发挥
|
|
46
|
+
|
|
47
|
+
> [!IMPORTANT]
|
|
48
|
+
> 只执行用户**明确**提出的变更;每项须可追溯到用户**原话**。超出范围的想法 → Step 5「建议」列出,**不得**自行落盘为需求。
|
|
49
|
+
|
|
50
|
+
---
|
|
51
|
+
|
|
52
|
+
## CRITICAL 与 task-planner / blueprint 对齐
|
|
53
|
+
|
|
54
|
+
> [!IMPORTANT]
|
|
55
|
+
> 修改 `05A`/`05B` 的字段名、追溯列、验证引用格式时:**进入 Step 3.1 前**读取 **`.agents/skills/task-planner/SKILL.md`** 与对应 **`TASK_TEMPLATE_05A` / `05B`**,保证与 **blueprint** 产出结构一致;**禁止**凭记忆手搓与模板不一致的列。
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
## Step 0: 定位当前版本
|
|
60
|
+
|
|
61
|
+
### 做什么
|
|
62
|
+
|
|
63
|
+
1. 扫描 `.anws/` 取最大 `v{N}` → `TARGET_DIR`。
|
|
64
|
+
2. 校验存在:`01_PRD.md`、`05A_TASKS.md`、`06_CHANGELOG.md`;缺则提示先 `/genesis` + `/blueprint`。
|
|
65
|
+
3. 说明 Git:仍在当前版本与同一交付主题下沿用现有 `feature/*`(不负责切主题分支)。
|
|
66
|
+
|
|
67
|
+
### 为什么
|
|
68
|
+
|
|
69
|
+
无 `05A` 则无受控任务回流锚点。
|
|
70
|
+
|
|
71
|
+
### 怎么验收
|
|
72
|
+
|
|
73
|
+
- 会话写出 `TARGET_DIR`;缺件时已停止。
|
|
74
|
+
|
|
75
|
+
---
|
|
76
|
+
|
|
77
|
+
## Step 1: 变更影响评估(分级)
|
|
78
|
+
|
|
79
|
+
### 做什么
|
|
80
|
+
|
|
81
|
+
须**逐条**回答下列 10 问(答案写入会话或短表;**本 workflow 不嵌** shipped 中的完整示例表):
|
|
82
|
+
|
|
83
|
+
1. 是否改变需求目标/用户故事集合/边界?
|
|
84
|
+
2. 是否改变系统边界/关键执行模型/架构基线?
|
|
85
|
+
3. 是否推翻 ADR **核心**决策前提?
|
|
86
|
+
4. 是否仅为表达、命名、接口、契约、示例、测试要求或澄清层修订?
|
|
87
|
+
5. 是否影响多系统接口(仍不改前提)?
|
|
88
|
+
6. 是否新增外部依赖(大改或改前提 → 否)?
|
|
89
|
+
7. 用户是否明确要求**新版本**?
|
|
90
|
+
8. 是否需在 `05A` **少量**新增承接任务(须与用户原话或 `/forge` 回流原因**直接对应**)?
|
|
91
|
+
9. 是否新增/修改公共契约并须补验证承接(须**显式**影响范围)?
|
|
92
|
+
10. 当前 `05A` **是否仍**可局部承接?
|
|
93
|
+
|
|
94
|
+
**结论**:局部修订 / 受控扩展 → 继续 Step 2;**前提演进**(Q1–3、Q10 等触禁止)→ **Step 4**。
|
|
95
|
+
|
|
96
|
+
### 为什么
|
|
97
|
+
|
|
98
|
+
分级错误会把该进 genesis 的变更留在 change 里烂掉。
|
|
99
|
+
|
|
100
|
+
### 怎么验收
|
|
101
|
+
|
|
102
|
+
- 十问均有答案;结论与答案一致;触禁止列时已指向 Step 4 而非继续 Step 2。
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## Step 2: 定位受影响任务与文档
|
|
107
|
+
|
|
108
|
+
### 做什么
|
|
109
|
+
|
|
110
|
+
1. 读 `05A`(及涉验证时 `05B`);读 `01` 交叉验证范围。
|
|
111
|
+
2. 标出受影响任务 ID;**优先复用**已有任务——仅当无法承接时才**少量**新任务(受控扩展须在 Step 3 展示影响面)。
|
|
112
|
+
3. 涉 `04` 时:遵守 **ADR → SYSTEM_DESIGN 单向引用**;若动 ADR,先判断是否仅命名/接口补全/澄清(可 change)还是核心前提变了(genesis)。
|
|
113
|
+
4. 涉公共契约时:检查 05A/05B 是否已有实现与验证承接,缺则在本版本内补**最小**闭环说明。
|
|
114
|
+
|
|
115
|
+
### 为什么
|
|
116
|
+
|
|
117
|
+
契约与任务不同步则 forge 继续产出假进度。
|
|
118
|
+
|
|
119
|
+
### 怎么验收
|
|
120
|
+
|
|
121
|
+
- 受影响任务/文件列表完整;无「整树重写」却仍留在 change 的路径。
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
## Step 3: 签名检查点与执行
|
|
126
|
+
|
|
127
|
+
### 做什么
|
|
128
|
+
|
|
129
|
+
1. **未签名禁止写盘**。展示计划须至少含:**分级**、**用户原话**、**受影响任务列表**、**每处修改字段意图**(可用小表或 diff 描述,**不**依赖本 workflow 内嵌长模板)。`AUTO` 仅当来自 **`/forge` 自动**回流且仍在权限内。
|
|
130
|
+
2. **拒绝/调整** → 终止或回到本步重拟。
|
|
131
|
+
3. **签名通过后(Step 3.1)**:按 `task-planner`/模板改 `05A`/`05B` 定义字段;**不得**改 checkbox 完成态;追加 `06_CHANGELOG.md`;更新 `AGENTS.md` 日期等轻量元数据。
|
|
132
|
+
4. 报告中声明:**不**运行 `code-reviewer`;若触契约/验证/`04`/接口语义,**列表**说明供 `/forge` 规划;可选建议 `task-reviewer`/`design-reviewer`**不得**冒充 forge/challenge 阻塞门禁。
|
|
133
|
+
|
|
134
|
+
### 为什么
|
|
135
|
+
|
|
136
|
+
签名是写盘唯一合法前序。
|
|
137
|
+
|
|
138
|
+
### 怎么验收
|
|
139
|
+
|
|
140
|
+
- 写盘前存在用户可见计划;CHANGELOG 有对应条目;`05A` 无非法 checkbox 变更。
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
## Step 4: 升级到 `/genesis`
|
|
145
|
+
|
|
146
|
+
### 做什么
|
|
147
|
+
|
|
148
|
+
按 shipped `change` 的叙事向用户说明:**为何**超出 `/change`、须新版本与换轨(Git 冻结 + 自 `main` 新 `feature/*`);**不**在本文件嵌长通知模板。
|
|
149
|
+
|
|
150
|
+
### 为什么
|
|
151
|
+
|
|
152
|
+
前提演进必须版本化,不能打补丁式覆盖真相。
|
|
153
|
+
|
|
154
|
+
### 怎么验收
|
|
155
|
+
|
|
156
|
+
- 用户收到明确升级指令与下一步 `/genesis`;**未**在越权情况下继续改 `05A`。
|
|
157
|
+
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
## Step 5: AI 改进建议(可选)
|
|
161
|
+
|
|
162
|
+
### 做什么
|
|
163
|
+
|
|
164
|
+
将非本次范围内的想法列为**编号建议**,声明不自动执行。
|
|
165
|
+
|
|
166
|
+
### 为什么
|
|
167
|
+
|
|
168
|
+
与 CRITICAL 反自由发挥一致。
|
|
169
|
+
|
|
170
|
+
### 怎么验收
|
|
171
|
+
|
|
172
|
+
- 建议块与用户请求变更有边界。
|
|
173
|
+
|
|
174
|
+
---
|
|
175
|
+
|
|
176
|
+
<completion_criteria>
|
|
177
|
+
- **凝练与版式**:各 Step 三小节齐备;十问已答且分级正确。
|
|
178
|
+
- **权限**:未出现禁止列操作;未回填 `05A` checkbox、未改 `[REQ-*]`。
|
|
179
|
+
- Step 3 签名(或合规 `AUTO`)后写盘;`06` 已记;`05A/05B` 与 **task-planner** 模板字段一致。
|
|
180
|
+
- 未将 `/change` 冒充为 forge 静态审查或 challenge 阻塞链。
|
|
181
|
+
- 前提演进已走 Step 4 而非硬改。
|
|
182
|
+
</completion_criteria>
|