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
- const toolsMatch = content.match(/ai_tools:\s*([\s\S]*?)(?=\n\w|\n$|$)/);
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,6 +1,6 @@
1
1
  {
2
2
  "name": "dev-playbooks-cn",
3
- "version": "1.7.1",
3
+ "version": "1.7.2",
4
4
  "description": "AI-driven spec-based development workflow",
5
5
  "keywords": [
6
6
  "devbooks",
@@ -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. **用户体验**:快速开始 → 降低学习曲线 → 提高采用率