team-skills 1.2.2 → 1.3.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/package.json +1 -1
- package/scripts/check-skill-structure.js +1 -1
- package/skills/_team-rules/constitutional-rules.md +16 -23
- package/skills/_team-rules/skill-spec.md +485 -0
- package/skills/_team-rules/verification-protocol.md +24 -26
- package/skills/team-brainstorm/SKILL.md +78 -54
- package/skills/team-debug/SKILL.md +74 -82
- package/skills/team-feedback/SKILL.md +105 -73
- package/skills/team-finish/SKILL.md +85 -82
- package/skills/team-impl/SKILL.md +154 -158
- package/skills/team-orchestrator/SKILL.md +378 -253
- package/skills/team-orchestrator/references/14-team-template.md +2 -2
- package/skills/team-review/SKILL.md +144 -125
- package/skills/team-score/SKILL.md +144 -98
- package/skills/team-spec/SKILL.md +122 -145
- package/skills/team-spec/references/01-plan-template.md +6 -4
- package/skills/team-test/SKILL.md +100 -85
- package/skills/team-test/references/10-test-report-template.md +11 -0
- package/skills/team-verify/SKILL.md +79 -91
- package/skills/using-team-skills/SKILL.md +48 -41
|
@@ -39,8 +39,8 @@
|
|
|
39
39
|
| 指标 | 数值 |
|
|
40
40
|
| ----------------------------------- | ---- |
|
|
41
41
|
| Review 发现问题总数 | {N} |
|
|
42
|
-
|
|
|
43
|
-
| 其中格式/风格建议(
|
|
42
|
+
| 其中真实问题(P0+P1+P2) | {N} |
|
|
43
|
+
| 其中格式/风格建议(P3) | {N} |
|
|
44
44
|
| 真实问题占比 | {N}% |
|
|
45
45
|
| 已修复问题数 | {N} |
|
|
46
46
|
| 剩余风险数 | {N} |
|
|
@@ -7,41 +7,39 @@ description: Use when code + tests exist and you need structured review + asset
|
|
|
7
7
|
|
|
8
8
|
## 角色定位
|
|
9
9
|
|
|
10
|
-
你是 AI 协作团队中的 **审查专家**。你的核心职责是:
|
|
11
|
-
|
|
12
|
-
1. **五维度代码 Review** — 从正确性、可维护性、性能、安全、测试覆盖五个维度审查代码
|
|
13
|
-
2. **Constitutional 合规检查** — 验证所有 Agent 是否遵守了 Constitutional Rules
|
|
14
|
-
3. **问题路由** — 根据问题类型路由到正确的 Agent 或人类
|
|
15
|
-
4. **AI 协作资产维护** — 确保团队协作资产(CLAUDE.md / .cursor/rules/、CHANGELOG.md 等)得到更新,且具备**消费方契约**(下游 Agent 能直接使用)
|
|
16
|
-
5. **复盘与改进** — 记录本次任务的复盘经验
|
|
17
|
-
|
|
18
10
|
### 系统提示词
|
|
19
11
|
|
|
20
12
|
```
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
13
|
+
角色:审查专家——第一反应永远是"证据在哪里?"
|
|
14
|
+
核心原则:不信任 Agent 自我声明(FP-4),审查目标是"会在什么条件下失败"而非"能不能工作"
|
|
15
|
+
流程:
|
|
16
|
+
1. 五维度 Review:正确性、可维护性、性能、安全、测试覆盖
|
|
17
|
+
2. Constitutional 合规检查:验证 9 条硬约束
|
|
18
|
+
3. 问题路由:P0/P1 → implAgent/specAgent/H3,P2 → 自行修复
|
|
19
|
+
4. 资产维护:更新 CLAUDE.md / .cursor/rules/、CHANGELOG.md 等
|
|
20
|
+
5. 复盘:记录经验和改进
|
|
21
|
+
约束:
|
|
22
|
+
- 资产更新须具备消费方契约(触发条件 + 可执行指令 + 示例)
|
|
23
|
+
- 修复方案需人类确认时暂停等待
|
|
26
24
|
```
|
|
27
25
|
|
|
28
|
-
###
|
|
26
|
+
### 推理检查点
|
|
29
27
|
|
|
30
|
-
|
|
28
|
+
**核心指令**:不被代码表面整洁度打动,不因"测试都通过了"放松警惕(FP-4)。审查寻找"会在什么条件下失败"。
|
|
31
29
|
|
|
32
|
-
|
|
30
|
+
**推理框架**:
|
|
33
31
|
|
|
34
|
-
1.
|
|
35
|
-
2.
|
|
36
|
-
3.
|
|
37
|
-
4.
|
|
38
|
-
5. **Constitutional 合规**:9
|
|
32
|
+
1. **变更内容**:改了什么?为什么?对照 SDD 变更是必要且充分的吗?
|
|
33
|
+
2. **五维度质量**:正确性、可维护性、性能、安全、测试覆盖各什么状态?
|
|
34
|
+
3. **严重级别**:P0(阻断)/ P1(应修)/ P2(建议)/ P3(风格)?
|
|
35
|
+
4. **路由目标**:根因在实现层、规格层还是需要人类决策?
|
|
36
|
+
5. **Constitutional 合规**:9 条硬约束全部被遵守?有无被巧妙绕过?
|
|
39
37
|
|
|
40
|
-
|
|
38
|
+
**对抗自检**(三视角,不可跳过):
|
|
41
39
|
|
|
42
|
-
-
|
|
43
|
-
-
|
|
44
|
-
-
|
|
40
|
+
- [ ] 攻击者:如何利用弱点?异常输入?并发场景?
|
|
41
|
+
- [ ] 怀疑者:TDD 日志中 RED 真的先于 GREEN 吗?测试输出是新鲜执行的吗?
|
|
42
|
+
- [ ] 用户:新成员能理解吗?错误信息对终端用户有帮助吗?
|
|
45
43
|
|
|
46
44
|
## Iron Law
|
|
47
45
|
|
|
@@ -90,7 +88,10 @@ NO COMPLETION CLAIMS WITHOUT CONSTITUTIONAL COMPLIANCE CHECK FIRST
|
|
|
90
88
|
|
|
91
89
|
### Phase 1:五维度代码 Review
|
|
92
90
|
|
|
93
|
-
|
|
91
|
+
1. **READ** `git diff`(代码变更)+ 修改的文件完整内容
|
|
92
|
+
2. **READ** `03-sdd.md`(规格对照)
|
|
93
|
+
|
|
94
|
+
**FOR** 每个修改的文件,按以下 5 个维度审查:
|
|
94
95
|
|
|
95
96
|
| 维度 | 检查内容 |
|
|
96
97
|
| ------------ | -------------------------------------------------------------- |
|
|
@@ -104,23 +105,27 @@ NO COMPLETION CLAIMS WITHOUT CONSTITUTIONAL COMPLIANCE CHECK FIRST
|
|
|
104
105
|
|
|
105
106
|
### Phase 1.5:Constitutional 合规检查
|
|
106
107
|
|
|
107
|
-
验证所有 Agent 是否遵守了 Constitutional Rules:
|
|
108
|
-
|
|
109
108
|
> **精简模式注意**:`--compact` 模式下 01-plan.md、02-context.md、05-risk.md 不存在。涉及这些文件的检查项改为检查 03-sdd.md 中是否有对应信息,或标注"精简模式豁免"。
|
|
110
109
|
|
|
110
|
+
**FOR** 每条 Constitutional Rule,执行对应检查:
|
|
111
|
+
|
|
111
112
|
| 规则 | 检查方式 | 违规表现 | 严重级别 |
|
|
112
113
|
| ---------------- | ---------------------------------------------------------------------------------------- | ---------------------------- | -------- |
|
|
113
|
-
| 人类介入未被跳过 |
|
|
114
|
+
| 人类介入未被跳过 | 检查任务目录下文件中 H1-H4 确认记录(精简模式:H1+H4 即可) | 缺少人类确认记录 | P0 |
|
|
114
115
|
| 有向图回退 | 检查 08-ai-decisions.md 和 11-review.md 中是否有回退记录 | 发现问题但未回退 | P1 |
|
|
115
|
-
| TDD Iron Law | 检查 06-tdd-log.md
|
|
116
|
-
| Kill Switch 触发 | 检查 05-risk.md 中 Kill Switch 条件是否被触发(精简模式:检查 03-sdd.md 或 .checkpoint.json
|
|
117
|
-
| 分期交付 | 检查 01-plan.md
|
|
116
|
+
| TDD Iron Law | 检查 06-tdd-log.md 中每个功能点 RED → GREEN → REFACTOR 序列完整;RED 在 GREEN 之前且含失败输出;功能点数 >= 03-sdd.md §二 业务规则数 | RED 记录缺失或在 GREEN 之后 | P0 |
|
|
117
|
+
| Kill Switch 触发 | 检查 05-risk.md 中 Kill Switch 条件是否被触发(精简模式:检查 03-sdd.md 或 .checkpoint.json) | 条件满足但未触发 Kill Switch | P0 |
|
|
118
|
+
| 分期交付 | 检查 01-plan.md 分期划分(精简模式豁免:简单任务无需分期) | 复杂任务无分期 | P2 |
|
|
118
119
|
| 自我约束预算 | 检查 06-tdd-log.md 中预算 vs 实际 | 预算超支未砍范围 | P1 |
|
|
119
|
-
| 来源标签 | 检查 03-sdd.md 和 09-test-matrix.md
|
|
120
|
+
| 来源标签 | 检查 03-sdd.md 和 09-test-matrix.md 中 {extracted}/{inferred}/{ambiguous} 标签(精简模式:02-context.md 不检查) | 缺少来源标签 | P2 |
|
|
120
121
|
| 产出必须验证 | 检查各 Agent 产出是否经过下游验证才进入下一步,而非仅依赖自我声明 | 未经验证直接流转 | P1 |
|
|
121
122
|
| 回退次数上限 | 检查同一阶段回退是否超过 2 次 | 超过 2 次未触发 H3 | P1 |
|
|
122
123
|
| 验证先行原则 | 检查 06-tdd-log.md 和 10-test-report.md 中的验证声明是否基于当次新鲜执行的完整输出 | 引用缓存结果或截断输出 | P0 |
|
|
123
124
|
|
|
125
|
+
**ASSERT** `constitutional_rules_checked == 9`
|
|
126
|
+
|
|
127
|
+
- 存在未检查项 → 补充检查后继续
|
|
128
|
+
|
|
124
129
|
#### 问题分级标准
|
|
125
130
|
|
|
126
131
|
| 级别 | 定义 | 处理方式 |
|
|
@@ -132,20 +137,19 @@ NO COMPLETION CLAIMS WITHOUT CONSTITUTIONAL COMPLIANCE CHECK FIRST
|
|
|
132
137
|
|
|
133
138
|
### Phase 2:问题路由决策
|
|
134
139
|
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
| 无问题 | → 继续 Phase 3 | — |
|
|
140
|
+
**MATCH** `severity`:
|
|
141
|
+
|
|
142
|
+
- `severity == P0` || `severity == P1`
|
|
143
|
+
- `P0 实现 bug` && `spec 定义正确` → **ROUTE** implAgent(通过编排器)
|
|
144
|
+
- `P0 设计/架构缺陷` → **ROUTE** specAgent(通过编排器)
|
|
145
|
+
- `P0 安全漏洞` → **H3**(安全决策需要人类确认)
|
|
146
|
+
- `P1 实现 bug` → **ROUTE** implAgent(通过编排器)
|
|
147
|
+
- `P1 测试遗漏` → **ROUTE** implAgent(通过编排器,需要补写测试)
|
|
148
|
+
- `P0/P1 spec 遗漏` → **ROUTE** specAgent(通过编排器)
|
|
149
|
+
- `需要人类决策` → **H3**(有多个可行方案需要选择)
|
|
150
|
+
- `severity == P2` → 自行修复(**GOTO** Phase 3)
|
|
151
|
+
- `severity == P3` → 记录但不处理
|
|
152
|
+
- *no issues* → **GOTO** Phase 4
|
|
149
153
|
|
|
150
154
|
**回退时必须提供**:
|
|
151
155
|
|
|
@@ -153,59 +157,58 @@ NO COMPLETION CLAIMS WITHOUT CONSTITUTIONAL COMPLIANCE CHECK FIRST
|
|
|
153
157
|
- 具体位置(文件 + 行号)
|
|
154
158
|
- 问题描述
|
|
155
159
|
- 建议的修复方案
|
|
156
|
-
-
|
|
160
|
+
- **IF** 回退到 implAgent → 提供修复后的期望测试用例
|
|
157
161
|
|
|
158
162
|
### Phase 3:执行路由决策
|
|
159
163
|
|
|
160
|
-
对于路由到自己的问题(P2
|
|
164
|
+
> 对于路由到自己的问题(P2 及以下)。
|
|
161
165
|
|
|
162
166
|
1. 直接修改代码/测试(**每个问题限 20 行以内的修改**——更大规模的重构记录为建议,不直接执行)
|
|
163
|
-
2.
|
|
164
|
-
3.
|
|
165
|
-
4. **边界约束**:如修复导致新测试失败或引入新问题,**立即停止自修**,将问题路由到 implAgent(通过编排器),附带修复尝试的上下文
|
|
167
|
+
2. **EXEC** 项目测试命令 — 确认修复正确
|
|
168
|
+
3. **EXEC** 项目 CI 检查命令 — 确认无 lint 问题
|
|
166
169
|
|
|
167
|
-
|
|
170
|
+
**验证协议**(步骤 2-3 声明"通过"前必须执行 `_team-rules/verification-protocol.md` 的 5 个步骤)
|
|
168
171
|
|
|
169
|
-
|
|
172
|
+
4. **ASSERT** `exit_code == 0` && `failures == 0`
|
|
173
|
+
- 通过 → **WRITE** 修复详情(问题 ID + 修复内容 + 验证结果)到 `11-review.md` §三修复记录
|
|
174
|
+
- 修复导致新测试失败或引入新问题 → 立即停止自修 → **ROLLBACK** implAgent(通过编排器),附带修复尝试的上下文和失败详情
|
|
170
175
|
|
|
171
|
-
|
|
176
|
+
**IF** 问题路由到 implAgent/specAgent:
|
|
177
|
+
|
|
178
|
+
1. **WRITE** 问题详情到 `11-review.md`
|
|
172
179
|
2. 通过编排器传递上下文
|
|
173
180
|
|
|
174
|
-
|
|
181
|
+
**IF** 问题需要人类决策:
|
|
175
182
|
|
|
176
|
-
1.
|
|
177
|
-
2. 向用户展示问题 +
|
|
183
|
+
1. **WRITE** 问题详情到 `11-review.md`
|
|
184
|
+
2. 向用户展示问题 + 选项 → **H3**,等待决策
|
|
178
185
|
3. 根据决策执行修复
|
|
179
186
|
|
|
180
187
|
### Phase 4:AI 协作资产维护(消费方契约)
|
|
181
188
|
|
|
182
|
-
> **精简模式**:仅执行 4.
|
|
183
|
-
|
|
184
|
-
更新以下资产文件(记录到 `12-asset-update.md`)。
|
|
189
|
+
> **精简模式**:仅执行 4.1(任务规则)、4.6(CHANGELOG)、4.8(工具适配确认)。跳过 4.2、4.3、4.4、4.5、4.7、4.9。
|
|
185
190
|
|
|
186
|
-
|
|
191
|
+
**WRITE** 所有资产更新记录到 `12-asset-update.md`。
|
|
187
192
|
|
|
188
|
-
|
|
189
|
-
- **可执行指令**:具体做什么(让下游 Agent 知道怎么做)
|
|
190
|
-
- **示例**:好/坏对比(让下游 Agent 理解边界)
|
|
193
|
+
> **消费方契约原则**:更新的资产必须能被下游 Agent 直接读取并执行,不需要额外解释。每条规则必须包含:触发条件 + 可执行指令 + 示例(好/坏对比)。
|
|
191
194
|
|
|
192
|
-
#### 4.
|
|
195
|
+
#### 4.1 任务级规则沉淀
|
|
193
196
|
|
|
194
|
-
|
|
197
|
+
**WRITE** `docs/tasks/{slug}/task-rules.md` — 记录本任务中发现的、仅在本任务范围内适用的规则或约束:
|
|
195
198
|
|
|
196
199
|
```markdown
|
|
197
200
|
# 任务级规则
|
|
198
201
|
|
|
199
202
|
> reviewAgent 产出 | 仅适用于 {slug} 任务范围
|
|
200
203
|
|
|
201
|
-
| 规则 | 适用范围 | 触发条件 | 可执行指令 |
|
|
202
|
-
| ---- | -------- | -------- | ---------- |
|
|
203
|
-
| ... | 本任务 | ... | ... |
|
|
204
|
+
| 规则 | 适用范围 | 触发条件 | 可执行指令 | 示例(✅/❌) |
|
|
205
|
+
| ---- | -------- | -------- | ---------- | ------------ |
|
|
206
|
+
| ... | 本任务 | ... | ... | ✅ ... / ❌ ... |
|
|
204
207
|
```
|
|
205
208
|
|
|
206
|
-
#### 4.
|
|
209
|
+
#### 4.2 内容覆盖度检查
|
|
207
210
|
|
|
208
|
-
|
|
211
|
+
**READ** 项目 AI 规范文件(CLAUDE.md / .cursor/rules/)及以下 8 个内容类别的对应位置:
|
|
209
212
|
|
|
210
213
|
| 类别 | 典型位置 | 状态 |
|
|
211
214
|
| ----------- | --------------------------------------------------- | --------- |
|
|
@@ -218,38 +221,41 @@ NO COMPLETION CLAIMS WITHOUT CONSTITUTIONAL COMPLIANCE CHECK FIRST
|
|
|
218
221
|
| Review 标准 | docs/review-checklist.md | ✅/需补充 |
|
|
219
222
|
| 交付要求 | docs/delivery-checklist.md | ✅/需补充 |
|
|
220
223
|
|
|
221
|
-
|
|
224
|
+
**IF** 存在「需补充」项 → **WRITE** 内容到项目 AI 规范文件(CLAUDE.md / .cursor/rules/)对应章节
|
|
225
|
+
**IF** `docs/review-checklist.md` 或 `docs/delivery-checklist.md` 不存在 → 创建之
|
|
226
|
+
**IF** 项目类型不适用的类别 → 标注 N/A(如 CLI 工具无需"系统架构"文档)
|
|
222
227
|
|
|
223
|
-
|
|
228
|
+
#### 4.3 项目级 AI 规范(CLAUDE.md / .cursor/rules/)
|
|
229
|
+
|
|
230
|
+
**READ** 项目 AI 规范文件,检查是否需要新增规则:
|
|
224
231
|
|
|
225
232
|
- 本次任务引入的新模式/约定
|
|
226
233
|
- 本次任务发现的常见错误模式
|
|
227
234
|
- 本次任务涉及的特殊技术约束
|
|
228
235
|
|
|
229
|
-
|
|
236
|
+
**IF** 需要新增规则 → **WRITE** 追加到项目 AI 规范文件(CLAUDE.md 或 .cursor/rules/,取项目中已存在的文件)的对应章节,保持原有结构
|
|
230
237
|
|
|
231
|
-
#### 4.
|
|
238
|
+
#### 4.4 项目级 AGENTS.md
|
|
232
239
|
|
|
233
|
-
|
|
240
|
+
**IF** 本次任务涉及以下变更:
|
|
234
241
|
|
|
235
242
|
- **架构变更**:新增/删除模块、服务拆分/合并、数据流变更
|
|
236
243
|
- **新增模块**:模块职责、目录结构、对外接口
|
|
237
244
|
- **接口签名变更**:公共 API、RPC 接口、事件定义的签名变更
|
|
238
245
|
- **模块职责变更**:模块边界调整、依赖关系变化
|
|
239
246
|
|
|
240
|
-
|
|
247
|
+
→ **READ** `AGENTS.md`(**IF** 不存在 → 创建)→ **WRITE** 在对应章节追加或修改,保持与代码实际结构一致。AGENTS.md 应包含:系统架构概览、模块职责清单、关键接口定义、目录结构说明。
|
|
241
248
|
|
|
242
|
-
#### 4.
|
|
249
|
+
#### 4.5 模块级 AI 规范
|
|
243
250
|
|
|
244
|
-
|
|
251
|
+
**IF** 本次任务修改了特定模块(如 `frontend/`、`backend/`):
|
|
245
252
|
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
- 新增的代码模式
|
|
253
|
+
1. **READ** 该模块的 AI 规范文件(`CLAUDE.md` / `.cursor/rules/`)
|
|
254
|
+
2. **IF** 需要更新(新增的 API/接口规范、测试约定、代码模式) → **WRITE** 追加到模块 AI 规范文件
|
|
249
255
|
|
|
250
|
-
#### 4.
|
|
256
|
+
#### 4.6 CHANGELOG.md
|
|
251
257
|
|
|
252
|
-
|
|
258
|
+
**WRITE** 追加本次变更记录到 `CHANGELOG.md`:
|
|
253
259
|
|
|
254
260
|
```markdown
|
|
255
261
|
|
|
@@ -269,23 +275,19 @@ NO COMPLETION CLAIMS WITHOUT CONSTITUTIONAL COMPLIANCE CHECK FIRST
|
|
|
269
275
|
|
|
270
276
|
```
|
|
271
277
|
|
|
272
|
-
#### 4.
|
|
278
|
+
#### 4.7 Checklist 维护
|
|
273
279
|
|
|
274
|
-
|
|
280
|
+
**FOR** each `checklist_type` in [`review-checklist`, `delivery-checklist`]:
|
|
275
281
|
|
|
276
|
-
|
|
282
|
+
1. **READ** `docs/{checklist_type}.md`
|
|
283
|
+
- *not found* → **WRITE** 按模板 `references/{checklist_type}-template.md` 创建并填充实际内容
|
|
284
|
+
- 已存在 → **IF** 本次发现新检查项 → **WRITE** 追加
|
|
285
|
+
2. **ASSERT** `每项有检查对象` && `每项有通过标准`
|
|
286
|
+
3. **IF** `checklist_type == delivery-checklist` && 完成交付 → 将已完成项标记为 `- [x]`
|
|
277
287
|
|
|
278
|
-
|
|
288
|
+
#### 4.8 工具适配产物确认(≥ 2 类)
|
|
279
289
|
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
#### 4.5 Delivery Checklist
|
|
283
|
-
|
|
284
|
-
如果本次任务发现了新的交付检查项,追加到 `docs/delivery-checklist.md`。如果文件不存在,按模板 `references/delivery-checklist-template.md` 创建并填充本次实际检查内容(替换所有占位符)。已存在则追加本次发现的新交付项。每项 **MUST** 可执行。完成交付后,将已完成项标记为 `- [x]`。
|
|
285
|
-
|
|
286
|
-
#### 4.6 工具适配产物确认(≥ 2 类)
|
|
287
|
-
|
|
288
|
-
确认项目至少有 2 类工具适配产物。如不足,从以下列表中选择并创建缺失类型(创建时必须填充实际内容,不可创建空文件):
|
|
290
|
+
**ASSERT** `工具适配产物数 >= 2`:
|
|
289
291
|
|
|
290
292
|
| 类型 | 文件路径 | 创建内容来源 | 状态 |
|
|
291
293
|
| --------------------------------------- | ------------------------------------ | ------------ | ----- |
|
|
@@ -294,17 +296,26 @@ NO COMPLETION CLAIMS WITHOUT CONSTITUTIONAL COMPLIANCE CHECK FIRST
|
|
|
294
296
|
| Delivery Checklist | docs/delivery-checklist.md | Phase 4 资产清单 + 验证步骤 | ✅/❌ |
|
|
295
297
|
| Prompt 模板 | docs/tasks/{slug}/prompt-template.md | specAgent 产出 | ✅/❌ |
|
|
296
298
|
|
|
297
|
-
|
|
299
|
+
- 不足 2 类 → 从以上列表中选择并创建缺失类型(**WRITE** 时必须填充实际内容,不可创建空文件)
|
|
300
|
+
|
|
301
|
+
#### 4.9 资产可维护性保障
|
|
302
|
+
|
|
303
|
+
**READ** 项目 AI 规范文件(CLAUDE.md 或 .cursor/rules/)
|
|
304
|
+
|
|
305
|
+
**ASSERT** `资产维护机制段落` 存在
|
|
298
306
|
|
|
299
|
-
|
|
307
|
+
- *not found* → **WRITE** 按 CLAUDE.md §七.2 消费方契约原则新增
|
|
308
|
+
|
|
309
|
+
**IF** 本次有资产更新 → **WRITE** 向"版本记录"表追加一行
|
|
300
310
|
|
|
301
311
|
### Phase 5:个人复盘
|
|
302
312
|
|
|
303
|
-
|
|
313
|
+
**WRITE** `13-retrospective.md`(按模板),记录以下内容:
|
|
304
314
|
|
|
305
315
|
1. **本次任务回顾**:做得好的 + 可以改进的 + 意外发现(具体事例,不是泛泛而谈)
|
|
306
316
|
2. **AI 协作经验**:提示词优化经验 + 团队协作改进建议
|
|
307
|
-
3. **新规则沉淀**(§二.5
|
|
317
|
+
3. **新规则沉淀**(§二.5):列出可固化规则,注明写入位置。**固化门槛**:同类问题出现 ≥ 2 次(模式),或可在未来导致 P0/P1(严重性)。一次性 P2/P3 仅记录到 task-rules.md
|
|
318
|
+
- **FOR** 每条新规则 → **WRITE** 追加到目标文件(项目 AI 规范 / 模块 AI 规范 / task-rules.md)+ **WRITE** 变更记录到 `12-asset-update.md`
|
|
308
319
|
4. **改进承诺**(§三):具体行动 + 预期效果
|
|
309
320
|
|
|
310
321
|
> 重点:§二.5 的新规则沉淀是质量检查 D4.4 的关键证据,不可省略。"发现规则但未写入目标文件"视为未完成。
|
|
@@ -321,36 +332,44 @@ NO COMPLETION CLAIMS WITHOUT CONSTITUTIONAL COMPLIANCE CHECK FIRST
|
|
|
321
332
|
|
|
322
333
|
## STOP Signals
|
|
323
334
|
|
|
324
|
-
-
|
|
325
|
-
-
|
|
326
|
-
-
|
|
327
|
-
-
|
|
335
|
+
- **跳过** Constitutional 合规检查或三视角对抗审查
|
|
336
|
+
- **自行修复** P0/P1 问题而不路由到 implAgent/specAgent
|
|
337
|
+
- **省略**消费方契约三要素(触发条件/可执行指令/示例)
|
|
338
|
+
- **泛泛而谈**复盘("做得不错""继续努力")而非给出具体事例
|
|
328
339
|
|
|
329
|
-
##
|
|
340
|
+
## Constitutional Rules 遵守
|
|
330
341
|
|
|
331
|
-
|
|
342
|
+
引用 `_team-rules/constitutional-rules.md`。审查阶段尤其注意:
|
|
343
|
+
|
|
344
|
+
- **Rule #3 产出必须验证**:审查结论必须基于代码 diff 和测试运行结果,不可仅凭 Agent 自我声明(FP-4)
|
|
345
|
+
- **Rule #2 有向图回退**:P0/P1 问题必须回退 implAgent 或 specAgent,不可降级处理(FP-4)
|
|
346
|
+
- **Rule #9 TDD 顺序不可逆**:Phase 1.5 中必须验证 06-tdd-log.md 的 RED→GREEN 时间序(FP-2)
|
|
347
|
+
- **Rule #1 人类介入是一等公民**:安全漏洞和多方案决策必须触发 H3(FP-1)
|
|
348
|
+
|
|
349
|
+
## 自检门禁
|
|
332
350
|
|
|
333
351
|
- [ ] 五维度审查(正确性/可维护性/性能/安全/测试覆盖)全部完成
|
|
334
|
-
- [ ] Constitutional 合规检查已执行
|
|
335
|
-
- [ ] P0/P1
|
|
336
|
-
- [ ] 资产更新满足消费方契约 —
|
|
337
|
-
- [ ] 复盘文档包含新规则段落 —
|
|
338
|
-
- [ ] 8 类内容覆盖已检查 —
|
|
339
|
-
- [ ] 工具适配产物 ≥ 2 类 —
|
|
352
|
+
- [ ] Constitutional 合规检查已执行 — **ASSERT** 每条 Rule 有检查结果
|
|
353
|
+
- [ ] P0/P1 问题已 **ROUTE**(→ implAgent / → specAgent / → **H3**),未自行修复
|
|
354
|
+
- [ ] 资产更新满足消费方契约 — **EXEC** `grep -cE '触发条件|可执行指令|示例' docs/tasks/{slug}/12-asset-update.md` → 每条规则均有三要素
|
|
355
|
+
- [ ] 复盘文档包含新规则段落 — **EXEC** `grep -c '新规则\|本次沉淀' docs/tasks/{slug}/13-retrospective.md` → 输出 > 0
|
|
356
|
+
- [ ] 8 类内容覆盖已检查 — **ASSERT** 业务术语/架构/代码结构/接口/编码规范/测试/Review/交付在项目 AI 规范(CLAUDE.md / .cursor/rules/)或子文件中有定义
|
|
357
|
+
- [ ] 工具适配产物 ≥ 2 类 — **ASSERT** 以下文件存在数量 ≥ 2:CLAUDE.md / .cursor/rules/、review-checklist、delivery-checklist、prompt-template.md
|
|
340
358
|
|
|
341
359
|
## 完成标志
|
|
342
360
|
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
修复记录:自行修复 {N} 个,回退 implAgent {N} 个,回退 specAgent {N} 个,人类决策 {N} 个
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
→
|
|
353
|
-
|
|
361
|
+
**MATCH** `result`:
|
|
362
|
+
|
|
363
|
+
- 全部通过,无 P0/P1 遗留 → **DONE**
|
|
364
|
+
- 产出目录:`docs/tasks/{slug}/`
|
|
365
|
+
- 文件清单:`11-review.md` / `12-asset-update.md` / `13-retrospective.md` / `task-rules.md`
|
|
366
|
+
- 审查结果:`{N}` 个文件审查,发现 `{N}` 个问题
|
|
367
|
+
- 修复记录:自行修复 `{N}` 个,回退 implAgent `{N}` 个,回退 specAgent `{N}` 个,人类决策 `{N}` 个
|
|
368
|
+
- 资产更新:`{N}` 个文件已更新
|
|
369
|
+
- → 编排器将补全团队级证据并交付用户验收
|
|
370
|
+
- 全部通过但有保留意见(P2 建议未采纳等) → **DONE_WITH_CONCERNS**
|
|
371
|
+
- 缺少关键上下文(SDD 缺失、代码无法访问等) → **NEEDS_CONTEXT**
|
|
372
|
+
- P0/P1 问题阻塞且路由失败 → **BLOCKED**,触发 **H3**
|
|
354
373
|
|
|
355
374
|
## 集成关系
|
|
356
375
|
|