dev-playbooks-cn 1.5.1 → 1.5.2
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
CHANGED
|
@@ -81,10 +81,21 @@ npx dev-playbooks-cn@latest init
|
|
|
81
81
|
|
|
82
82
|
### 安装落点
|
|
83
83
|
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
84
|
+
初始化时可选择 Skills 安装位置：
|
|
85
|
+
|
|
86
|
+
| 安装范围 | 说明 | 路径示例 |
|
|
87
|
+
|----------|------|----------|
|
|
88
|
+
| **项目级**（默认） | 仅当前项目可用 | `.claude/skills/devbooks-*` |
|
|
89
|
+
| **全局** | 所有项目共享 | `~/.claude/skills/devbooks-*` |
|
|
90
|
+
|
|
91
|
+
```bash
|
|
92
|
+
# 交互式选择
|
|
93
|
+
dev-playbooks-cn init
|
|
94
|
+
|
|
95
|
+
# 非交互式指定
|
|
96
|
+
dev-playbooks-cn init --tools claude --scope project # 项目级
|
|
97
|
+
dev-playbooks-cn init --tools claude --scope global # 全局
|
|
98
|
+
```
|
|
88
99
|
|
|
89
100
|
### 快速集成
|
|
90
101
|
|
|
@@ -193,6 +204,7 @@ DevBooks 使用两个目录根：
|
|
|
193
204
|
|-------|------|
|
|
194
205
|
| `devbooks-entropy-monitor` | 系统熵度量 |
|
|
195
206
|
| `devbooks-brownfield-bootstrap` | 存量项目初始化 |
|
|
207
|
+
| `devbooks-convergence-audit` | 收敛性审计（反迷惑设计） |
|
|
196
208
|
|
|
197
209
|
---
|
|
198
210
|
|
package/package.json
CHANGED
|
@@ -357,3 +357,35 @@
|
|
|
357
357
|
输入：`tests/**` + `dev-playbooks/changes/<change-id>/verification.md`（如有）
|
|
358
358
|
输出：覆盖盲区 / 边界条件遗漏 / 可维护性风险 / 改进建议。
|
|
359
359
|
```
|
|
360
|
+
|
|
361
|
+
---
|
|
362
|
+
|
|
363
|
+
## `devbooks-convergence-audit`（Convergence Auditor）【新】
|
|
364
|
+
|
|
365
|
+
- 作用：以证据优先、声明存疑的原则评估 DevBooks 工作流收敛性，检测"西西弗斯反模式"和"假完成"。主动验证而非信任文档声明。
|
|
366
|
+
- **反迷惑设计**：不相信文档中的任何断言（Status: Done、AC 打勾等），必须通过可验证证据确认。
|
|
367
|
+
- 使用场景：
|
|
368
|
+
- 你想评估工作流的真实收敛性（而非文档声明）
|
|
369
|
+
- 你怀疑某个变更包是"假完成"或"过时证据"
|
|
370
|
+
- 你想检测西西弗斯困境（反复返工但无法收敛）
|
|
371
|
+
- 使用话术：
|
|
372
|
+
```text
|
|
373
|
+
你现在是 Convergence Auditor。请点名使用 `devbooks-convergence-audit`。
|
|
374
|
+
先读：`dev-playbooks/project.md`（如存在）
|
|
375
|
+
目标：对指定变更包进行收敛性审计。
|
|
376
|
+
|
|
377
|
+
请按反迷惑原则执行：
|
|
378
|
+
1) 读取 `dev-playbooks/changes/<change-id>/` 下的所有文档
|
|
379
|
+
2) 对每个"声明"（Status=Done、AC 打勾等）进行证据验证
|
|
380
|
+
3) 实际运行测试验证（如可能）
|
|
381
|
+
4) 输出：声明 vs 证据对比表 + 可信度评分 + 迷惑检测结果
|
|
382
|
+
|
|
383
|
+
变更包：<change-id>
|
|
384
|
+
truth-root：dev-playbooks/specs
|
|
385
|
+
change-root：dev-playbooks/changes
|
|
386
|
+
```
|
|
387
|
+
- 可信度评分说明：
|
|
388
|
+
- 90-100：✅ 可信收敛，继续当前流程
|
|
389
|
+
- 70-89：⚠️ 部分可信，需要补充验证
|
|
390
|
+
- 50-69：🟠 存疑，需要返工部分环节
|
|
391
|
+
- < 50：🔴 不可信（西西弗斯困境），需要全面审查
|