dev-playbooks-cn 1.7.1 → 1.7.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/bin/devbooks.js
CHANGED
|
@@ -1188,13 +1188,15 @@ function loadConfig(projectDir) {
|
|
|
1188
1188
|
const content = fs.readFileSync(configPath, 'utf-8');
|
|
1189
1189
|
|
|
1190
1190
|
// 解析 ai_tools
|
|
1191
|
-
|
|
1191
|
+
// 修复:使用更健壮的正则,匹配到下一个顶级 key(非缩进的行)或文件结尾
|
|
1192
|
+
const toolsMatch = content.match(/ai_tools:\s*\n((?:[ \t]+-[ \t]+.+\n?)*)/);
|
|
1192
1193
|
const tools = toolsMatch
|
|
1193
1194
|
? toolsMatch[1]
|
|
1194
1195
|
.split('\n')
|
|
1195
1196
|
.map(line => line.trim())
|
|
1196
1197
|
.filter(line => line.startsWith('-'))
|
|
1197
1198
|
.map(line => line.replace(/^-\s*/, '').trim())
|
|
1199
|
+
.filter(line => line.length > 0)
|
|
1198
1200
|
: [];
|
|
1199
1201
|
|
|
1200
1202
|
// 解析 install_scope
|
package/package.json
CHANGED
|
@@ -1,143 +0,0 @@
|
|
|
1
|
-
# DevBooks Skills 渐进披露改进建议
|
|
2
|
-
|
|
3
|
-
## 问题诊断
|
|
4
|
-
|
|
5
|
-
### 当前状态
|
|
6
|
-
- ✅ 已采用多文件结构(SKILL.md + references/ + scripts/)
|
|
7
|
-
- ⚠️ SKILL.md过长(最长633行,超出官方建议的500行)
|
|
8
|
-
- ⚠️ 核心指令与详细规则混在一起
|
|
9
|
-
|
|
10
|
-
### 官方最佳实践要求
|
|
11
|
-
1. SKILL.md < 500行
|
|
12
|
-
2. 核心信息在SKILL.md,详细参考在单独文件
|
|
13
|
-
3. 引用保持一层深(SKILL.md → reference.md,不要 A → B → C)
|
|
14
|
-
4. 脚本可执行但不加载到上下文
|
|
15
|
-
|
|
16
|
-
## 改进方案
|
|
17
|
-
|
|
18
|
-
### 方案1:拆分超长SKILL.md(推荐)
|
|
19
|
-
|
|
20
|
-
**目标**:将633行的 `devbooks-test-owner/SKILL.md` 拆分为:
|
|
21
|
-
|
|
22
|
-
```
|
|
23
|
-
devbooks-test-owner/
|
|
24
|
-
├── SKILL.md (< 200行) # 概览 + 导航 + 核心流程
|
|
25
|
-
├── references/
|
|
26
|
-
│ ├── 测试驱动.md # 已存在
|
|
27
|
-
│ ├── 测试分层策略.md # 已存在
|
|
28
|
-
│ ├── 测试代码提示词.md # 已存在
|
|
29
|
-
│ ├── 禁令与规则.md # 新增:从SKILL.md移出的详细规则
|
|
30
|
-
│ ├── 测试模式与标签.md # 新增:@smoke/@critical/@full详解
|
|
31
|
-
│ └── 证据审计清单.md # 新增:阶段2审计步骤详解
|
|
32
|
-
└── scripts/
|
|
33
|
-
└── evidence-check.sh # 可选:自动化证据检查脚本
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
**SKILL.md 精简后的结构**:
|
|
37
|
-
```markdown
|
|
38
|
-
---
|
|
39
|
-
name: devbooks-test-owner
|
|
40
|
-
description: ...
|
|
41
|
-
---
|
|
42
|
-
|
|
43
|
-
# DevBooks:测试负责人(Test Owner)
|
|
44
|
-
|
|
45
|
-
## 快速开始(Quick Start)
|
|
46
|
-
|
|
47
|
-
我的职责:
|
|
48
|
-
1. 阶段1:编写测试 → 产出Red基线
|
|
49
|
-
2. 阶段2:审计证据 → 勾选AC矩阵
|
|
50
|
-
|
|
51
|
-
## 核心流程
|
|
52
|
-
|
|
53
|
-
[保留最核心的流程图和步骤,约50-100行]
|
|
54
|
-
|
|
55
|
-
## 详细参考(按需阅读)
|
|
56
|
-
|
|
57
|
-
- **必读**:`~/.claude/skills/_shared/references/AI行为规范.md`
|
|
58
|
-
- **禁令与规则**:`references/禁令与规则.md`(包含所有❌禁止项)
|
|
59
|
-
- **测试方法论**:`references/测试驱动.md`
|
|
60
|
-
- **测试分层**:`references/测试分层策略.md`
|
|
61
|
-
- **完整提示词**:`references/测试代码提示词.md`
|
|
62
|
-
- **证据审计**:`references/证据审计清单.md`(阶段2必读)
|
|
63
|
-
|
|
64
|
-
## 常见场景
|
|
65
|
-
|
|
66
|
-
[保留3-5个最常见的场景示例,每个<10行]
|
|
67
|
-
|
|
68
|
-
## 自检清单
|
|
69
|
-
|
|
70
|
-
- [ ] 阶段1:Red基线已产出?
|
|
71
|
-
- [ ] 阶段2:@full测试已通过?
|
|
72
|
-
- [ ] AC矩阵已勾选?
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
### 方案2:标准化引用格式
|
|
76
|
-
|
|
77
|
-
在所有SKILL.md中统一使用以下格式:
|
|
78
|
-
|
|
79
|
-
```markdown
|
|
80
|
-
## 📚 参考文档
|
|
81
|
-
|
|
82
|
-
### 必读(自动加载)
|
|
83
|
-
- `~/.claude/skills/_shared/references/AI行为规范.md`
|
|
84
|
-
|
|
85
|
-
### 按需阅读(需要时再读)
|
|
86
|
-
- **方法论**:`references/测试驱动.md` - 完整TDD方法论
|
|
87
|
-
- **分层策略**:`references/测试分层策略.md` - @smoke/@critical/@full详解
|
|
88
|
-
- **详细规则**:`references/禁令与规则.md` - 所有禁止项和边界条件
|
|
89
|
-
|
|
90
|
-
### 工具脚本(执行不加载)
|
|
91
|
-
```bash
|
|
92
|
-
# 检查证据完整性
|
|
93
|
-
bash scripts/evidence-check.sh <change-id>
|
|
94
|
-
```
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
### 方案3:增加"渐进披露检查"脚本
|
|
98
|
-
|
|
99
|
-
创建一个脚本来检查所有skills是否符合渐进披露原则:
|
|
100
|
-
|
|
101
|
-
```bash
|
|
102
|
-
#!/bin/bash
|
|
103
|
-
# scripts/check-progressive-disclosure.sh
|
|
104
|
-
|
|
105
|
-
echo "检查 Skills 渐进披露合规性..."
|
|
106
|
-
|
|
107
|
-
for skill in skills/devbooks-*/SKILL.md; do
|
|
108
|
-
lines=$(wc -l < "$skill")
|
|
109
|
-
skill_name=$(basename $(dirname "$skill"))
|
|
110
|
-
|
|
111
|
-
if [ "$lines" -gt 500 ]; then
|
|
112
|
-
echo "❌ $skill_name: $lines 行(超出建议的500行)"
|
|
113
|
-
elif [ "$lines" -gt 400 ]; then
|
|
114
|
-
echo "⚠️ $skill_name: $lines 行(接近上限)"
|
|
115
|
-
else
|
|
116
|
-
echo "✅ $skill_name: $lines 行"
|
|
117
|
-
fi
|
|
118
|
-
done
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
## 实施优先级
|
|
122
|
-
|
|
123
|
-
### P0(立即执行)
|
|
124
|
-
1. 拆分 `devbooks-test-owner/SKILL.md`(633行 → <300行)
|
|
125
|
-
2. 拆分 `devbooks-delivery-workflow/SKILL.md`(488行 → <300行)
|
|
126
|
-
3. 拆分 `devbooks-coder/SKILL.md`(480行 → <300行)
|
|
127
|
-
|
|
128
|
-
### P1(下个版本)
|
|
129
|
-
1. 标准化所有skills的引用格式
|
|
130
|
-
2. 为每个skill添加"快速开始"章节
|
|
131
|
-
3. 创建渐进披露检查脚本
|
|
132
|
-
|
|
133
|
-
### P2(持续优化)
|
|
134
|
-
1. 监控SKILL.md行数,防止膨胀
|
|
135
|
-
2. 定期审查references/目录结构
|
|
136
|
-
3. 收集AI使用反馈,优化引用路径
|
|
137
|
-
|
|
138
|
-
## 预期收益
|
|
139
|
-
|
|
140
|
-
1. **性能提升**:SKILL.md更小 → 加载更快 → AI响应更快
|
|
141
|
-
2. **上下文节省**:详细文档按需加载 → 节省token → 可以同时使用更多skills
|
|
142
|
-
3. **可维护性**:职责清晰 → 更新更容易 → 减少冲突
|
|
143
|
-
4. **用户体验**:快速开始 → 降低学习曲线 → 提高采用率
|