dev-playbooks-cn 1.0.11 → 1.0.13
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/bin/devbooks.js +12 -12
- package/package.json +1 -1
- package/skills/_shared/mcp-enhancement-template.md +1 -1
- package/skills/devbooks-brownfield-bootstrap/SKILL.md +1 -1
- package/skills/devbooks-c4-map/SKILL.md +1 -1
- package/skills/devbooks-coder/SKILL.md +1 -1
- package/skills/devbooks-delivery-workflow/SKILL.md +1 -1
- package/skills/devbooks-impact-analysis/SKILL.md +1 -1
- package/skills/devbooks-proposal-author/references//346/217/220/346/241/210/346/222/260/345/206/231/346/217/220/347/244/272/350/257/215.md +1 -1
- package/skills/devbooks-proposal-judge/references//346/217/220/346/241/210/350/243/201/345/206/263/346/217/220/347/244/272/350/257/215.md +25 -2
- package/skills/devbooks-router/SKILL.md +17 -17
- package/skills/devbooks-spec-contract/SKILL.md +1 -1
package/bin/devbooks.js
CHANGED
|
@@ -427,14 +427,14 @@ ${DEVBOOKS_MARKERS.start}
|
|
|
427
427
|
- Coder 禁止修改 tests/
|
|
428
428
|
- 任何新功能/破坏性变更/架构改动：必须先创建 \`dev-playbooks/changes/<id>/\`
|
|
429
429
|
|
|
430
|
-
##
|
|
430
|
+
## 工作流 Skills
|
|
431
431
|
|
|
432
|
-
|
|
|
432
|
+
| Skill | 说明 |
|
|
433
433
|
|------|------|
|
|
434
|
-
|
|
|
435
|
-
|
|
|
436
|
-
|
|
|
437
|
-
|
|
|
434
|
+
| \`devbooks-proposal-author\` | 创建变更提案 |
|
|
435
|
+
| \`devbooks-design-doc\` | 创建设计文档 |
|
|
436
|
+
| \`devbooks-test-owner / devbooks-coder\` | 执行实现 |
|
|
437
|
+
| \`devbooks-spec-gardener\` | 归档变更包 |
|
|
438
438
|
|
|
439
439
|
${DEVBOOKS_MARKERS.end}
|
|
440
440
|
`;
|
|
@@ -545,14 +545,14 @@ function generateAgentsContent(filename) {
|
|
|
545
545
|
- Test Owner 与 Coder 必须独立对话/独立实例；Coder 禁止修改 tests/。
|
|
546
546
|
- 任何新功能/破坏性变更/架构改动：必须先创建 \`dev-playbooks/changes/<id>/\`。
|
|
547
547
|
|
|
548
|
-
##
|
|
548
|
+
## 工作流 Skills
|
|
549
549
|
|
|
550
|
-
|
|
|
550
|
+
| Skill | 说明 |
|
|
551
551
|
|------|------|
|
|
552
|
-
|
|
|
553
|
-
|
|
|
554
|
-
|
|
|
555
|
-
|
|
|
552
|
+
| \`devbooks-proposal-author\` | 创建变更提案 |
|
|
553
|
+
| \`devbooks-design-doc\` | 创建设计文档 |
|
|
554
|
+
| \`devbooks-test-owner / devbooks-coder\` | 执行实现（test-owner/coder/reviewer） |
|
|
555
|
+
| \`devbooks-spec-gardener\` | 归档变更包 |
|
|
556
556
|
|
|
557
557
|
${DEVBOOKS_MARKERS.end}
|
|
558
558
|
`;
|
package/package.json
CHANGED
|
@@ -32,6 +32,29 @@
|
|
|
32
32
|
2) **理由摘要**（3–5 条）
|
|
33
33
|
3) **必须修改项（若 Revise）**：逐条列出
|
|
34
34
|
4) **验证要求**：需要补的证据/测试/检查
|
|
35
|
-
5) **写回指令**：需要写回 `proposal.md` 的变更点
|
|
36
35
|
|
|
37
|
-
|
|
36
|
+
执行要求（必须遵守）：
|
|
37
|
+
- **必须写回**：裁决结果必须使用 Edit 工具写入 `proposal.md` 的 `## Decision Log` 部分，而非仅输出到聊天窗口
|
|
38
|
+
- 写回格式：
|
|
39
|
+
```markdown
|
|
40
|
+
## Decision Log
|
|
41
|
+
|
|
42
|
+
### [日期] 裁决：[Approved|Revise|Rejected]
|
|
43
|
+
|
|
44
|
+
**理由摘要**：
|
|
45
|
+
- [理由1]
|
|
46
|
+
- [理由2]
|
|
47
|
+
- ...
|
|
48
|
+
|
|
49
|
+
**必须修改项**（若 Revise）：
|
|
50
|
+
- [ ] [修改项1]
|
|
51
|
+
- [ ] [修改项2]
|
|
52
|
+
|
|
53
|
+
**验证要求**：
|
|
54
|
+
- [ ] [验证项1]
|
|
55
|
+
- [ ] [验证项2]
|
|
56
|
+
```
|
|
57
|
+
- 若 `## Decision Log` 部分不存在，在 proposal.md 末尾创建该部分
|
|
58
|
+
- 写回完成后，在聊天窗口简要告知用户裁决结果和写回位置
|
|
59
|
+
|
|
60
|
+
现在开始执行裁决并写回 proposal.md。
|
|
@@ -119,16 +119,16 @@ impact_profile:
|
|
|
119
119
|
## 执行计划（基于 Impact 画像）
|
|
120
120
|
|
|
121
121
|
### 必须执行
|
|
122
|
-
1.
|
|
123
|
-
2.
|
|
124
|
-
3.
|
|
122
|
+
1. `devbooks-proposal-author skill` → proposal.md（提案已存在，跳过）
|
|
123
|
+
2. `devbooks-design-doc skill` → design.md（必须）
|
|
124
|
+
3. `devbooks-implementation-plan skill` → tasks.md（必须）
|
|
125
125
|
|
|
126
126
|
### 建议执行（基于 Impact 分析）
|
|
127
|
-
4.
|
|
128
|
-
5.
|
|
127
|
+
4. `devbooks-spec-contract skill` → specs/**（检测到 external_api: true）
|
|
128
|
+
5. `devbooks-c4-map skill` → architecture/c4.md（检测到 architecture_boundary: true）
|
|
129
129
|
|
|
130
130
|
### 可选执行
|
|
131
|
-
6.
|
|
131
|
+
6. `devbooks-impact-analysis skill` → 深度影响分析（affected_modules > 5）
|
|
132
132
|
```
|
|
133
133
|
|
|
134
134
|
### 解析失败处理（AC-012）
|
|
@@ -143,13 +143,13 @@ impact_profile:
|
|
|
143
143
|
- 或 impact_profile YAML 块缺失
|
|
144
144
|
|
|
145
145
|
建议动作：
|
|
146
|
-
1. 运行
|
|
147
|
-
2.
|
|
146
|
+
1. 运行 `devbooks-impact-analysis skill` 生成影响分析
|
|
147
|
+
2. 或直接使用相应 skill
|
|
148
148
|
|
|
149
|
-
|
|
150
|
-
-
|
|
151
|
-
-
|
|
152
|
-
-
|
|
149
|
+
skill 列表：
|
|
150
|
+
- devbooks-design-doc skill → 设计文档
|
|
151
|
+
- devbooks-implementation-plan skill → 编码计划
|
|
152
|
+
- devbooks-spec-contract skill → 规格定义
|
|
153
153
|
```
|
|
154
154
|
|
|
155
155
|
**YAML 解析失败时**：
|
|
@@ -161,7 +161,7 @@ impact_profile:
|
|
|
161
161
|
|
|
162
162
|
建议动作：
|
|
163
163
|
1. 检查 proposal.md 中 impact_profile YAML 格式
|
|
164
|
-
2.
|
|
164
|
+
2. 或直接使用相应 skill 绕过 Router
|
|
165
165
|
```
|
|
166
166
|
|
|
167
167
|
---
|
|
@@ -270,9 +270,9 @@ LSC（大规模同质化修改）建议：
|
|
|
270
270
|
1. 记录学习到的关键洞察到 `proposal.md` 的 Decision Log
|
|
271
271
|
2. 删除 `prototype/` 目录
|
|
272
272
|
|
|
273
|
-
## DevBooks
|
|
273
|
+
## DevBooks Skill 适配
|
|
274
274
|
|
|
275
|
-
DevBooks 使用
|
|
275
|
+
DevBooks 使用 `devbooks-proposal-author skill`、`devbooks-test-owner/coder skill`、`devbooks-spec-gardener skill` 作为入口。
|
|
276
276
|
按上述 A/B/C/D 路由即可，产物路径以项目指路牌里 `<truth-root>/<change-root>` 的映射为准。
|
|
277
277
|
|
|
278
278
|
---
|
|
@@ -326,7 +326,7 @@ MCP 增强规则参考：`skills/_shared/mcp-enhancement-template.md`
|
|
|
326
326
|
|
|
327
327
|
1. 调用 `mcp__ckb__getStatus`（2s 超时）
|
|
328
328
|
2. 若 CKB 可用 → 在路由建议中标注"图基能力已激活"
|
|
329
|
-
3. 若超时或失败 → 在路由建议中标注"图基能力降级"，建议运行
|
|
329
|
+
3. 若超时或失败 → 在路由建议中标注"图基能力降级"，建议运行 devbooks-index-bootstrap skill
|
|
330
330
|
|
|
331
331
|
### 增强模式 vs 基础模式
|
|
332
332
|
|
|
@@ -342,5 +342,5 @@ MCP 增强规则参考：`skills/_shared/mcp-enhancement-template.md`
|
|
|
342
342
|
|
|
343
343
|
```
|
|
344
344
|
⚠️ CKB 索引未激活，图基能力（影响分析、调用图等）将降级。
|
|
345
|
-
建议运行
|
|
345
|
+
建议运行 devbooks-index-bootstrap skill 生成索引以启用完整功能。
|
|
346
346
|
```
|