dev-playbooks-cn 1.0.7 → 1.0.10
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 +14 -72
- package/package.json +1 -1
- package/templates/dev-playbooks/README.md +69 -109
- package/templates/dev-playbooks/docs/DevBooks/351/205/215/347/275/256/346/214/207/345/215/227.md +204 -0
- package/templates/dev-playbooks/docs/workflow-diagram.svg +203 -0
- package/templates/claude-commands/devbooks/apply.md +0 -38
- package/templates/claude-commands/devbooks/archive.md +0 -33
- package/templates/claude-commands/devbooks/backport.md +0 -19
- package/templates/claude-commands/devbooks/bootstrap.md +0 -19
- package/templates/claude-commands/devbooks/c4.md +0 -19
- package/templates/claude-commands/devbooks/challenger.md +0 -19
- package/templates/claude-commands/devbooks/code.md +0 -19
- package/templates/claude-commands/devbooks/debate.md +0 -19
- package/templates/claude-commands/devbooks/delivery.md +0 -19
- package/templates/claude-commands/devbooks/design.md +0 -19
- package/templates/claude-commands/devbooks/entropy.md +0 -19
- package/templates/claude-commands/devbooks/federation.md +0 -19
- package/templates/claude-commands/devbooks/gardener.md +0 -19
- package/templates/claude-commands/devbooks/impact.md +0 -19
- package/templates/claude-commands/devbooks/index.md +0 -19
- package/templates/claude-commands/devbooks/judge.md +0 -19
- package/templates/claude-commands/devbooks/plan.md +0 -19
- package/templates/claude-commands/devbooks/proposal.md +0 -19
- package/templates/claude-commands/devbooks/quick.md +0 -42
- package/templates/claude-commands/devbooks/review.md +0 -19
- package/templates/claude-commands/devbooks/router.md +0 -19
- package/templates/claude-commands/devbooks/spec.md +0 -19
- package/templates/claude-commands/devbooks/test-review.md +0 -19
- package/templates/claude-commands/devbooks/test.md +0 -19
- package/templates/dev-playbooks/docs/DevBooks/345/256/211/350/243/205/346/217/220/347/244/272/350/257/215.md +0 -42
- package/templates/dev-playbooks/docs/DevBooks/351/233/206/346/210/220/346/250/241/346/235/277/357/274/210/345/215/217/350/256/256/346/227/240/345/205/263/357/274/211.md +0 -120
- package/templates/dev-playbooks/docs/Slash /345/221/275/344/273/244/344/275/277/347/224/250/346/214/207/345/215/227.md" +0 -485
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 900 650" width="900" height="650">
|
|
2
|
+
<defs>
|
|
3
|
+
<!-- 渐变定义 -->
|
|
4
|
+
<linearGradient id="proposalGrad" x1="0%" y1="0%" x2="0%" y2="100%">
|
|
5
|
+
<stop offset="0%" style="stop-color:#667eea;stop-opacity:1" />
|
|
6
|
+
<stop offset="100%" style="stop-color:#764ba2;stop-opacity:1" />
|
|
7
|
+
</linearGradient>
|
|
8
|
+
<linearGradient id="applyGrad" x1="0%" y1="0%" x2="0%" y2="100%">
|
|
9
|
+
<stop offset="0%" style="stop-color:#11998e;stop-opacity:1" />
|
|
10
|
+
<stop offset="100%" style="stop-color:#38ef7d;stop-opacity:1" />
|
|
11
|
+
</linearGradient>
|
|
12
|
+
<linearGradient id="archiveGrad" x1="0%" y1="0%" x2="0%" y2="100%">
|
|
13
|
+
<stop offset="0%" style="stop-color:#8e2de2;stop-opacity:1" />
|
|
14
|
+
<stop offset="100%" style="stop-color:#4a00e0;stop-opacity:1" />
|
|
15
|
+
</linearGradient>
|
|
16
|
+
<linearGradient id="gateGrad" x1="0%" y1="0%" x2="100%" y2="0%">
|
|
17
|
+
<stop offset="0%" style="stop-color:#ff416c;stop-opacity:1" />
|
|
18
|
+
<stop offset="100%" style="stop-color:#ff4b2b;stop-opacity:1" />
|
|
19
|
+
</linearGradient>
|
|
20
|
+
|
|
21
|
+
<!-- 阴影 -->
|
|
22
|
+
<filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
|
|
23
|
+
<feDropShadow dx="2" dy="4" stdDeviation="4" flood-opacity="0.2"/>
|
|
24
|
+
</filter>
|
|
25
|
+
|
|
26
|
+
<!-- 箭头标记 -->
|
|
27
|
+
<marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
|
|
28
|
+
<polygon points="0 0, 10 3.5, 0 7" fill="#6c757d"/>
|
|
29
|
+
</marker>
|
|
30
|
+
</defs>
|
|
31
|
+
|
|
32
|
+
<!-- 背景 -->
|
|
33
|
+
<rect width="900" height="650" fill="#f8f9fa"/>
|
|
34
|
+
|
|
35
|
+
<!-- 标题 -->
|
|
36
|
+
<text x="450" y="40" font-family="Arial, sans-serif" font-size="24" font-weight="bold" fill="#2d3748" text-anchor="middle">DevBooks 工作流</text>
|
|
37
|
+
<text x="450" y="65" font-family="Arial, sans-serif" font-size="14" fill="#6c757d" text-anchor="middle">角色隔离 + 质量闸门 + 证据驱动</text>
|
|
38
|
+
|
|
39
|
+
<!-- ========== PROPOSAL 阶段 ========== -->
|
|
40
|
+
<g transform="translate(30, 90)">
|
|
41
|
+
<!-- 阶段标签 -->
|
|
42
|
+
<rect x="0" y="0" width="250" height="240" rx="15" fill="url(#proposalGrad)" filter="url(#shadow)" opacity="0.15"/>
|
|
43
|
+
<rect x="0" y="0" width="250" height="35" rx="15" fill="url(#proposalGrad)"/>
|
|
44
|
+
<rect x="0" y="17" width="250" height="18" fill="url(#proposalGrad)"/>
|
|
45
|
+
<text x="125" y="24" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="white" text-anchor="middle">PROPOSAL 阶段</text>
|
|
46
|
+
<text x="125" y="55" font-family="Arial, sans-serif" font-size="11" fill="#6c757d" text-anchor="middle">禁止写代码</text>
|
|
47
|
+
|
|
48
|
+
<!-- 步骤节点 -->
|
|
49
|
+
<rect x="20" y="70" width="210" height="40" rx="8" fill="white" stroke="#667eea" stroke-width="2"/>
|
|
50
|
+
<text x="125" y="95" font-family="Arial, sans-serif" font-size="12" fill="#4a5568" text-anchor="middle">proposal.md (提案)</text>
|
|
51
|
+
|
|
52
|
+
<rect x="20" y="120" width="210" height="40" rx="8" fill="white" stroke="#667eea" stroke-width="2"/>
|
|
53
|
+
<text x="125" y="145" font-family="Arial, sans-serif" font-size="12" fill="#4a5568" text-anchor="middle">design.md (设计)</text>
|
|
54
|
+
|
|
55
|
+
<rect x="20" y="170" width="210" height="40" rx="8" fill="white" stroke="#667eea" stroke-width="2"/>
|
|
56
|
+
<text x="125" y="195" font-family="Arial, sans-serif" font-size="12" fill="#4a5568" text-anchor="middle">tasks.md (计划)</text>
|
|
57
|
+
</g>
|
|
58
|
+
|
|
59
|
+
<!-- 三角辩论框 -->
|
|
60
|
+
<g transform="translate(30, 350)">
|
|
61
|
+
<rect x="0" y="0" width="250" height="100" rx="10" fill="white" stroke="#667eea" stroke-width="2" stroke-dasharray="5,5" filter="url(#shadow)"/>
|
|
62
|
+
<text x="125" y="25" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#667eea" text-anchor="middle">三角辩论 (可选)</text>
|
|
63
|
+
<text x="125" y="50" font-family="Arial, sans-serif" font-size="11" fill="#6c757d" text-anchor="middle">Author / Challenger / Judge</text>
|
|
64
|
+
<text x="125" y="70" font-family="Arial, sans-serif" font-size="10" fill="#6c757d" text-anchor="middle">高风险变更必须通过</text>
|
|
65
|
+
<text x="125" y="88" font-family="Arial, sans-serif" font-size="10" fill="#38a169" text-anchor="middle">Decision: Approved / Revise / Rejected</text>
|
|
66
|
+
</g>
|
|
67
|
+
|
|
68
|
+
<!-- ========== APPLY 阶段 ========== -->
|
|
69
|
+
<g transform="translate(320, 90)">
|
|
70
|
+
<!-- 阶段标签 -->
|
|
71
|
+
<rect x="0" y="0" width="260" height="360" rx="15" fill="url(#applyGrad)" filter="url(#shadow)" opacity="0.15"/>
|
|
72
|
+
<rect x="0" y="0" width="260" height="35" rx="15" fill="url(#applyGrad)"/>
|
|
73
|
+
<rect x="0" y="17" width="260" height="18" fill="url(#applyGrad)"/>
|
|
74
|
+
<text x="130" y="24" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="white" text-anchor="middle">APPLY 阶段</text>
|
|
75
|
+
<text x="130" y="55" font-family="Arial, sans-serif" font-size="11" fill="#6c757d" text-anchor="middle">角色隔离强制执行</text>
|
|
76
|
+
|
|
77
|
+
<!-- Test Owner 区域 -->
|
|
78
|
+
<rect x="15" y="70" width="230" height="120" rx="10" fill="white" stroke="#e53e3e" stroke-width="2" stroke-dasharray="8,4"/>
|
|
79
|
+
<text x="130" y="90" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#e53e3e" text-anchor="middle">Chat A: Test Owner</text>
|
|
80
|
+
<text x="130" y="110" font-family="Arial, sans-serif" font-size="10" fill="#6c757d" text-anchor="middle">独立对话 / 独立实例</text>
|
|
81
|
+
|
|
82
|
+
<rect x="30" y="120" width="200" height="30" rx="6" fill="#fed7d7" stroke="#e53e3e" stroke-width="1"/>
|
|
83
|
+
<text x="130" y="140" font-family="Arial, sans-serif" font-size="11" fill="#c53030" text-anchor="middle">verification.md + tests/</text>
|
|
84
|
+
|
|
85
|
+
<rect x="30" y="155" width="200" height="25" rx="6" fill="#fc8181"/>
|
|
86
|
+
<text x="130" y="172" font-family="Arial, sans-serif" font-size="11" font-weight="bold" fill="white" text-anchor="middle">先跑出 RED 基线</text>
|
|
87
|
+
|
|
88
|
+
<!-- Coder 区域 -->
|
|
89
|
+
<rect x="15" y="205" width="230" height="120" rx="10" fill="white" stroke="#38a169" stroke-width="2" stroke-dasharray="8,4"/>
|
|
90
|
+
<text x="130" y="225" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#38a169" text-anchor="middle">Chat B: Coder</text>
|
|
91
|
+
<text x="130" y="245" font-family="Arial, sans-serif" font-size="10" fill="#6c757d" text-anchor="middle">独立对话 / 独立实例</text>
|
|
92
|
+
|
|
93
|
+
<rect x="30" y="255" width="200" height="30" rx="6" fill="#c6f6d5" stroke="#38a169" stroke-width="1"/>
|
|
94
|
+
<text x="130" y="275" font-family="Arial, sans-serif" font-size="11" fill="#276749" text-anchor="middle">按 tasks.md 实现</text>
|
|
95
|
+
|
|
96
|
+
<rect x="30" y="290" width="200" height="25" rx="6" fill="#48bb78"/>
|
|
97
|
+
<text x="130" y="307" font-family="Arial, sans-serif" font-size="11" font-weight="bold" fill="white" text-anchor="middle">让闸门变 GREEN</text>
|
|
98
|
+
|
|
99
|
+
<!-- 禁止标记 -->
|
|
100
|
+
<rect x="60" y="330" width="140" height="20" rx="4" fill="#feb2b2"/>
|
|
101
|
+
<text x="130" y="344" font-family="Arial, sans-serif" font-size="10" font-weight="bold" fill="#c53030" text-anchor="middle">Coder 禁止改 tests/</text>
|
|
102
|
+
</g>
|
|
103
|
+
|
|
104
|
+
<!-- ========== ARCHIVE 阶段 ========== -->
|
|
105
|
+
<g transform="translate(620, 90)">
|
|
106
|
+
<!-- 阶段标签 -->
|
|
107
|
+
<rect x="0" y="0" width="250" height="240" rx="15" fill="url(#archiveGrad)" filter="url(#shadow)" opacity="0.15"/>
|
|
108
|
+
<rect x="0" y="0" width="250" height="35" rx="15" fill="url(#archiveGrad)"/>
|
|
109
|
+
<rect x="0" y="17" width="250" height="18" fill="url(#archiveGrad)"/>
|
|
110
|
+
<text x="125" y="24" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="white" text-anchor="middle">ARCHIVE 阶段</text>
|
|
111
|
+
<text x="125" y="55" font-family="Arial, sans-serif" font-size="11" fill="#6c757d" text-anchor="middle">质量闸门检查</text>
|
|
112
|
+
|
|
113
|
+
<!-- 步骤节点 -->
|
|
114
|
+
<rect x="20" y="70" width="210" height="40" rx="8" fill="white" stroke="#8e2de2" stroke-width="2"/>
|
|
115
|
+
<text x="125" y="95" font-family="Arial, sans-serif" font-size="12" fill="#4a5568" text-anchor="middle">Code Review</text>
|
|
116
|
+
|
|
117
|
+
<rect x="20" y="120" width="210" height="40" rx="8" fill="white" stroke="#8e2de2" stroke-width="2"/>
|
|
118
|
+
<text x="125" y="145" font-family="Arial, sans-serif" font-size="12" fill="#4a5568" text-anchor="middle">Spec Gardener</text>
|
|
119
|
+
|
|
120
|
+
<rect x="20" y="170" width="210" height="40" rx="8" fill="white" stroke="#8e2de2" stroke-width="2"/>
|
|
121
|
+
<text x="125" y="195" font-family="Arial, sans-serif" font-size="12" fill="#4a5568" text-anchor="middle">合并到 truth-root</text>
|
|
122
|
+
</g>
|
|
123
|
+
|
|
124
|
+
<!-- ========== 质量闸门 ========== -->
|
|
125
|
+
<g transform="translate(620, 350)">
|
|
126
|
+
<rect x="0" y="0" width="250" height="130" rx="10" fill="white" stroke="url(#gateGrad)" stroke-width="2" filter="url(#shadow)"/>
|
|
127
|
+
<text x="125" y="25" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#e53e3e" text-anchor="middle">质量闸门</text>
|
|
128
|
+
|
|
129
|
+
<!-- 闸门列表 -->
|
|
130
|
+
<circle cx="30" cy="50" r="8" fill="#48bb78"/>
|
|
131
|
+
<text x="45" y="54" font-family="Arial, sans-serif" font-size="10" fill="#4a5568">Green 证据存在</text>
|
|
132
|
+
|
|
133
|
+
<circle cx="30" cy="72" r="8" fill="#48bb78"/>
|
|
134
|
+
<text x="45" y="76" font-family="Arial, sans-serif" font-size="10" fill="#4a5568">任务全部完成</text>
|
|
135
|
+
|
|
136
|
+
<circle cx="30" cy="94" r="8" fill="#48bb78"/>
|
|
137
|
+
<text x="45" y="98" font-family="Arial, sans-serif" font-size="10" fill="#4a5568">角色边界未违规</text>
|
|
138
|
+
|
|
139
|
+
<circle cx="30" cy="116" r="8" fill="#48bb78"/>
|
|
140
|
+
<text x="45" y="120" font-family="Arial, sans-serif" font-size="10" fill="#4a5568">无失败记录</text>
|
|
141
|
+
</g>
|
|
142
|
+
|
|
143
|
+
<!-- ========== 连接箭头 ========== -->
|
|
144
|
+
<!-- Proposal -> Apply -->
|
|
145
|
+
<path d="M 280 210 L 320 210" stroke="#6c757d" stroke-width="2" fill="none" marker-end="url(#arrowhead)"/>
|
|
146
|
+
|
|
147
|
+
<!-- Apply -> Archive -->
|
|
148
|
+
<path d="M 580 210 L 620 210" stroke="#6c757d" stroke-width="2" fill="none" marker-end="url(#arrowhead)"/>
|
|
149
|
+
|
|
150
|
+
<!-- Test Owner -> Coder (内部) -->
|
|
151
|
+
<path d="M 450 205 L 450 205" stroke="#6c757d" stroke-width="1" fill="none"/>
|
|
152
|
+
|
|
153
|
+
<!-- ========== 产物流转 ========== -->
|
|
154
|
+
<g transform="translate(30, 480)">
|
|
155
|
+
<rect x="0" y="0" width="840" height="80" rx="10" fill="#edf2f7" stroke="#cbd5e0" stroke-width="1"/>
|
|
156
|
+
<text x="420" y="25" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#4a5568" text-anchor="middle">产物流转</text>
|
|
157
|
+
|
|
158
|
+
<!-- 产物节点 -->
|
|
159
|
+
<rect x="20" y="40" width="100" height="28" rx="5" fill="#667eea"/>
|
|
160
|
+
<text x="70" y="58" font-family="Arial, sans-serif" font-size="10" fill="white" text-anchor="middle">proposal.md</text>
|
|
161
|
+
|
|
162
|
+
<text x="130" y="55" font-family="Arial, sans-serif" font-size="14" fill="#6c757d">→</text>
|
|
163
|
+
|
|
164
|
+
<rect x="145" y="40" width="90" height="28" rx="5" fill="#667eea"/>
|
|
165
|
+
<text x="190" y="58" font-family="Arial, sans-serif" font-size="10" fill="white" text-anchor="middle">design.md</text>
|
|
166
|
+
|
|
167
|
+
<text x="245" y="55" font-family="Arial, sans-serif" font-size="14" fill="#6c757d">→</text>
|
|
168
|
+
|
|
169
|
+
<rect x="260" y="40" width="80" height="28" rx="5" fill="#667eea"/>
|
|
170
|
+
<text x="300" y="58" font-family="Arial, sans-serif" font-size="10" fill="white" text-anchor="middle">tasks.md</text>
|
|
171
|
+
|
|
172
|
+
<text x="350" y="55" font-family="Arial, sans-serif" font-size="14" fill="#6c757d">→</text>
|
|
173
|
+
|
|
174
|
+
<rect x="365" y="40" width="110" height="28" rx="5" fill="#38a169"/>
|
|
175
|
+
<text x="420" y="58" font-family="Arial, sans-serif" font-size="10" fill="white" text-anchor="middle">verification.md</text>
|
|
176
|
+
|
|
177
|
+
<text x="485" y="55" font-family="Arial, sans-serif" font-size="14" fill="#6c757d">→</text>
|
|
178
|
+
|
|
179
|
+
<rect x="500" y="40" width="80" height="28" rx="5" fill="#38a169"/>
|
|
180
|
+
<text x="540" y="58" font-family="Arial, sans-serif" font-size="10" fill="white" text-anchor="middle">evidence/</text>
|
|
181
|
+
|
|
182
|
+
<text x="590" y="55" font-family="Arial, sans-serif" font-size="14" fill="#6c757d">→</text>
|
|
183
|
+
|
|
184
|
+
<rect x="605" y="40" width="100" height="28" rx="5" fill="#8e2de2"/>
|
|
185
|
+
<text x="655" y="58" font-family="Arial, sans-serif" font-size="10" fill="white" text-anchor="middle">truth-root</text>
|
|
186
|
+
|
|
187
|
+
<text x="715" y="55" font-family="Arial, sans-serif" font-size="14" fill="#6c757d">→</text>
|
|
188
|
+
|
|
189
|
+
<rect x="730" y="40" width="90" height="28" rx="5" fill="#8e2de2"/>
|
|
190
|
+
<text x="775" y="58" font-family="Arial, sans-serif" font-size="10" fill="white" text-anchor="middle">DONE</text>
|
|
191
|
+
</g>
|
|
192
|
+
|
|
193
|
+
<!-- ========== 底部说明 ========== -->
|
|
194
|
+
<g transform="translate(30, 580)">
|
|
195
|
+
<text x="0" y="15" font-family="Arial, sans-serif" font-size="11" fill="#718096">
|
|
196
|
+
<tspan font-weight="bold" fill="#e53e3e">硬约束: </tspan>
|
|
197
|
+
<tspan>Test Owner 与 Coder 必须独立对话。"完成"由测试/构建证据定义,而非 AI 自我声明。</tspan>
|
|
198
|
+
</text>
|
|
199
|
+
<text x="0" y="35" font-family="Arial, sans-serif" font-size="10" fill="#a0aec0">
|
|
200
|
+
<tspan>Skills: devbooks-proposal-author → devbooks-design-doc → devbooks-implementation-plan → devbooks-test-owner → devbooks-coder → devbooks-code-review → devbooks-spec-gardener</tspan>
|
|
201
|
+
</text>
|
|
202
|
+
</g>
|
|
203
|
+
</svg>
|
|
@@ -1,38 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
skill: multi-role
|
|
3
|
-
backward-compat: true
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# /devbooks:apply
|
|
7
|
-
|
|
8
|
-
**向后兼容命令**:执行 Apply 阶段(Test Owner 或 Coder)。
|
|
9
|
-
|
|
10
|
-
## 用途
|
|
11
|
-
|
|
12
|
-
此命令是向后兼容命令,保持与原有 `/devbooks:apply` 调用方式一致。
|
|
13
|
-
|
|
14
|
-
## 新版本替代方案
|
|
15
|
-
|
|
16
|
-
建议使用以下直达命令:
|
|
17
|
-
|
|
18
|
-
| 角色 | 新命令 | 说明 |
|
|
19
|
-
|------|--------|------|
|
|
20
|
-
| Test Owner | `/devbooks:test` | 测试负责人,产出 verification.md |
|
|
21
|
-
| Coder | `/devbooks:code` | 实现负责人,按 tasks.md 实现 |
|
|
22
|
-
|
|
23
|
-
## 参数
|
|
24
|
-
|
|
25
|
-
- `--role test-owner`:以 Test Owner 角色执行
|
|
26
|
-
- `--role coder`:以 Coder 角色执行
|
|
27
|
-
|
|
28
|
-
## 角色隔离
|
|
29
|
-
|
|
30
|
-
Test Owner 和 Coder 必须在独立会话中执行。
|
|
31
|
-
|
|
32
|
-
## 迁移说明
|
|
33
|
-
|
|
34
|
-
```
|
|
35
|
-
旧命令 新命令
|
|
36
|
-
/devbooks:apply --role test-owner → /devbooks:test
|
|
37
|
-
/devbooks:apply --role coder → /devbooks:code
|
|
38
|
-
```
|
|
@@ -1,33 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
skill: devbooks-spec-gardener
|
|
3
|
-
backward-compat: true
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# /devbooks:archive
|
|
7
|
-
|
|
8
|
-
**向后兼容命令**:执行归档阶段。
|
|
9
|
-
|
|
10
|
-
## 用途
|
|
11
|
-
|
|
12
|
-
此命令是向后兼容命令,保持与原有 `/devbooks:archive` 调用方式一致。
|
|
13
|
-
|
|
14
|
-
内部调用 `devbooks-spec-gardener` Skill。
|
|
15
|
-
|
|
16
|
-
## 新版本替代方案
|
|
17
|
-
|
|
18
|
-
建议使用直达命令:
|
|
19
|
-
|
|
20
|
-
```
|
|
21
|
-
/devbooks:gardener
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
## 功能
|
|
25
|
-
|
|
26
|
-
归档前修剪与维护 <truth-root>(去重合并/删除过时/目录整理/一致性修复),避免 specs 堆叠失控。
|
|
27
|
-
|
|
28
|
-
## 迁移说明
|
|
29
|
-
|
|
30
|
-
```
|
|
31
|
-
旧命令 新命令
|
|
32
|
-
/devbooks:archive → /devbooks:gardener
|
|
33
|
-
```
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
skill: devbooks-design-backport
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /devbooks:backport
|
|
6
|
-
|
|
7
|
-
触发 Skill:`devbooks-design-backport`
|
|
8
|
-
|
|
9
|
-
## 用途
|
|
10
|
-
|
|
11
|
-
把实现过程中发现的新约束、冲突、缺口回写到 design.md,保持设计为黄金真理,并标注决策与影响。
|
|
12
|
-
|
|
13
|
-
## 典型使用场景
|
|
14
|
-
|
|
15
|
-
- 实现中发现设计遗漏或冲突
|
|
16
|
-
- 需要更新设计文档以反映实际
|
|
17
|
-
- 保持设计与实现的一致性
|
|
18
|
-
|
|
19
|
-
请点名使用 `devbooks-design-backport` 执行相应任务。
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
skill: devbooks-brownfield-bootstrap
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /devbooks:bootstrap
|
|
6
|
-
|
|
7
|
-
触发 Skill:`devbooks-brownfield-bootstrap`
|
|
8
|
-
|
|
9
|
-
## 用途
|
|
10
|
-
|
|
11
|
-
存量项目初始化:在当前真理目录为空时生成项目画像、术语表、基线规格与最小验证锚点,避免"边补 specs 边改行为"。
|
|
12
|
-
|
|
13
|
-
## 典型使用场景
|
|
14
|
-
|
|
15
|
-
- 老项目接入 DevBooks
|
|
16
|
-
- 建立项目 glossary 和基线
|
|
17
|
-
- 生成初始项目画像
|
|
18
|
-
|
|
19
|
-
请点名使用 `devbooks-brownfield-bootstrap` 执行相应任务。
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
skill: devbooks-c4-map
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /devbooks:c4
|
|
6
|
-
|
|
7
|
-
触发 Skill:`devbooks-c4-map`
|
|
8
|
-
|
|
9
|
-
## 用途
|
|
10
|
-
|
|
11
|
-
维护/更新项目的 C4 架构地图(当前真理),并按变更输出 C4 Delta。
|
|
12
|
-
|
|
13
|
-
## 典型使用场景
|
|
14
|
-
|
|
15
|
-
- 画架构图或更新边界定义
|
|
16
|
-
- 分析模块依赖方向
|
|
17
|
-
- 记录架构变更的 Delta
|
|
18
|
-
|
|
19
|
-
请点名使用 `devbooks-c4-map` 执行相应任务。
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
skill: devbooks-proposal-challenger
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /devbooks:challenger
|
|
6
|
-
|
|
7
|
-
触发 Skill:`devbooks-proposal-challenger`
|
|
8
|
-
|
|
9
|
-
## 用途
|
|
10
|
-
|
|
11
|
-
对 proposal.md 发起质疑与查漏补缺,指出风险、遗漏、不一致并给结论。发现缺失的验收标准和未覆盖场景。
|
|
12
|
-
|
|
13
|
-
## 典型使用场景
|
|
14
|
-
|
|
15
|
-
- 提案撰写完成后需要质疑审查
|
|
16
|
-
- 需要识别潜在风险和遗漏
|
|
17
|
-
- 执行提案对辩流程中的 Challenger 角色
|
|
18
|
-
|
|
19
|
-
请点名使用 `devbooks-proposal-challenger` 执行相应任务。
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
skill: devbooks-coder
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /devbooks:code
|
|
6
|
-
|
|
7
|
-
触发 Skill:`devbooks-coder`
|
|
8
|
-
|
|
9
|
-
## 用途
|
|
10
|
-
|
|
11
|
-
以 Coder 角色严格按 tasks.md 实现功能并跑闸门,禁止修改 tests/,以测试/静态检查为唯一完成判据。
|
|
12
|
-
|
|
13
|
-
## 典型使用场景
|
|
14
|
-
|
|
15
|
-
- 按计划实现代码功能
|
|
16
|
-
- 修复测试失败让闸门全绿
|
|
17
|
-
- 断点续做(自动识别已完成任务)
|
|
18
|
-
|
|
19
|
-
请点名使用 `devbooks-coder` 执行相应任务。
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
skill: devbooks-proposal-debate-workflow
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /devbooks:debate
|
|
6
|
-
|
|
7
|
-
触发 Skill:`devbooks-proposal-debate-workflow`
|
|
8
|
-
|
|
9
|
-
## 用途
|
|
10
|
-
|
|
11
|
-
在 proposal 阶段执行"提案-质疑-裁决"三角对辩流程,强制三角色隔离并写回 Decision Log。
|
|
12
|
-
|
|
13
|
-
## 典型使用场景
|
|
14
|
-
|
|
15
|
-
- 需要完整执行提案审核流程
|
|
16
|
-
- 自动协调 Author、Challenger、Judge 三个角色
|
|
17
|
-
- 确保决策过程有记录可追溯
|
|
18
|
-
|
|
19
|
-
请点名使用 `devbooks-proposal-debate-workflow` 执行相应任务。
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
skill: devbooks-delivery-workflow
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /devbooks:delivery
|
|
6
|
-
|
|
7
|
-
触发 Skill:`devbooks-delivery-workflow`
|
|
8
|
-
|
|
9
|
-
## 用途
|
|
10
|
-
|
|
11
|
-
把一次变更跑成可追溯闭环(Design→Plan→Trace→Verify→Implement→Archive),明确 DoD、追溯矩阵与角色隔离。
|
|
12
|
-
|
|
13
|
-
## 典型使用场景
|
|
14
|
-
|
|
15
|
-
- 需要完整的交付验收流程
|
|
16
|
-
- 生成追溯矩阵和 DoD 检查
|
|
17
|
-
- 确保变更包符合关账标准
|
|
18
|
-
|
|
19
|
-
请点名使用 `devbooks-delivery-workflow` 执行相应任务。
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
skill: devbooks-design-doc
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /devbooks:design
|
|
6
|
-
|
|
7
|
-
触发 Skill:`devbooks-design-doc`
|
|
8
|
-
|
|
9
|
-
## 用途
|
|
10
|
-
|
|
11
|
-
产出变更包的设计文档(design.md),只写 What/Constraints 与 AC-xxx,不写实现步骤。
|
|
12
|
-
|
|
13
|
-
## 典型使用场景
|
|
14
|
-
|
|
15
|
-
- 提案通过后需要详细设计
|
|
16
|
-
- 定义验收标准和约束条件
|
|
17
|
-
- 明确 C4 Delta 和架构影响
|
|
18
|
-
|
|
19
|
-
请点名使用 `devbooks-design-doc` 执行相应任务。
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
skill: devbooks-entropy-monitor
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /devbooks:entropy
|
|
6
|
-
|
|
7
|
-
触发 Skill:`devbooks-entropy-monitor`
|
|
8
|
-
|
|
9
|
-
## 用途
|
|
10
|
-
|
|
11
|
-
定期采集系统熵度量(结构熵/变更熵/测试熵/依赖熵),生成量化报告,当指标超阈值时建议重构。
|
|
12
|
-
|
|
13
|
-
## 典型使用场景
|
|
14
|
-
|
|
15
|
-
- 监控代码复杂度趋势
|
|
16
|
-
- 识别需要重构的区域
|
|
17
|
-
- 量化技术债务程度
|
|
18
|
-
|
|
19
|
-
请点名使用 `devbooks-entropy-monitor` 执行相应任务。
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
skill: devbooks-federation
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /devbooks:federation
|
|
6
|
-
|
|
7
|
-
触发 Skill:`devbooks-federation`
|
|
8
|
-
|
|
9
|
-
## 用途
|
|
10
|
-
|
|
11
|
-
跨仓库联邦分析与契约同步。当变更涉及对外 API/契约、或需要分析跨仓库影响时使用。
|
|
12
|
-
|
|
13
|
-
## 典型使用场景
|
|
14
|
-
|
|
15
|
-
- 分析跨仓库影响
|
|
16
|
-
- 同步上下游依赖契约
|
|
17
|
-
- 多仓库协调变更
|
|
18
|
-
|
|
19
|
-
请点名使用 `devbooks-federation` 执行相应任务。
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
skill: devbooks-spec-gardener
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /devbooks:gardener
|
|
6
|
-
|
|
7
|
-
触发 Skill:`devbooks-spec-gardener`
|
|
8
|
-
|
|
9
|
-
## 用途
|
|
10
|
-
|
|
11
|
-
归档前修剪与维护 truth-root(去重合并、删除过时、目录整理、一致性修复),避免 specs 堆叠失控。
|
|
12
|
-
|
|
13
|
-
## 典型使用场景
|
|
14
|
-
|
|
15
|
-
- 变更包归档前的收尾清理
|
|
16
|
-
- specs 目录需要去重和整理
|
|
17
|
-
- 清理过时的规范文档
|
|
18
|
-
|
|
19
|
-
请点名使用 `devbooks-spec-gardener` 执行相应任务。
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
skill: devbooks-impact-analysis
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /devbooks:impact
|
|
6
|
-
|
|
7
|
-
触发 Skill:`devbooks-impact-analysis`
|
|
8
|
-
|
|
9
|
-
## 用途
|
|
10
|
-
|
|
11
|
-
跨模块/跨文件/对外契约变更前做影响分析,产出可直接写入 proposal.md 的 Impact 部分。
|
|
12
|
-
|
|
13
|
-
## 典型使用场景
|
|
14
|
-
|
|
15
|
-
- 变更前评估影响范围
|
|
16
|
-
- 识别受影响的模块和 API
|
|
17
|
-
- 分析兼容性风险
|
|
18
|
-
|
|
19
|
-
请点名使用 `devbooks-impact-analysis` 执行相应任务。
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
skill: devbooks-index-bootstrap
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /devbooks:index
|
|
6
|
-
|
|
7
|
-
触发 Skill:`devbooks-index-bootstrap`
|
|
8
|
-
|
|
9
|
-
## 用途
|
|
10
|
-
|
|
11
|
-
自动检测项目语言栈并生成 SCIP 索引,激活图基代码理解能力。
|
|
12
|
-
|
|
13
|
-
## 典型使用场景
|
|
14
|
-
|
|
15
|
-
- 首次进入大型项目需要索引
|
|
16
|
-
- CKB 报告索引缺失时
|
|
17
|
-
- 更新代码后重建索引
|
|
18
|
-
|
|
19
|
-
请点名使用 `devbooks-index-bootstrap` 执行相应任务。
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
skill: devbooks-proposal-judge
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /devbooks:judge
|
|
6
|
-
|
|
7
|
-
触发 Skill:`devbooks-proposal-judge`
|
|
8
|
-
|
|
9
|
-
## 用途
|
|
10
|
-
|
|
11
|
-
对 proposal 阶段进行裁决,输出 Approved/Revise/Rejected 并写回 proposal.md 的 Decision Log。
|
|
12
|
-
|
|
13
|
-
## 典型使用场景
|
|
14
|
-
|
|
15
|
-
- 提案对辩完成后需要最终裁决
|
|
16
|
-
- 需要决定提案是否可以进入实现阶段
|
|
17
|
-
- 记录决策理由和条件
|
|
18
|
-
|
|
19
|
-
请点名使用 `devbooks-proposal-judge` 执行相应任务。
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
skill: devbooks-implementation-plan
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /devbooks:plan
|
|
6
|
-
|
|
7
|
-
触发 Skill:`devbooks-implementation-plan`
|
|
8
|
-
|
|
9
|
-
## 用途
|
|
10
|
-
|
|
11
|
-
从设计文档推导编码计划(tasks.md),输出可跟踪的主线计划、临时计划、断点区,并绑定验收锚点。
|
|
12
|
-
|
|
13
|
-
## 典型使用场景
|
|
14
|
-
|
|
15
|
-
- 设计完成后需要拆分实现任务
|
|
16
|
-
- 需要可跟踪的里程碑和验收锚点
|
|
17
|
-
- 规划并行和串行任务依赖
|
|
18
|
-
|
|
19
|
-
请点名使用 `devbooks-implementation-plan` 执行相应任务。
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
skill: devbooks-proposal-author
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /devbooks:proposal
|
|
6
|
-
|
|
7
|
-
触发 Skill:`devbooks-proposal-author`
|
|
8
|
-
|
|
9
|
-
## 用途
|
|
10
|
-
|
|
11
|
-
撰写变更提案(proposal.md),作为后续 Design/Spec/Plan 的入口。对设计性决策会呈现选项给用户选择。
|
|
12
|
-
|
|
13
|
-
## 典型使用场景
|
|
14
|
-
|
|
15
|
-
- 启动新的变更/功能开发
|
|
16
|
-
- 需要分析为什么要改、改动范围、影响面
|
|
17
|
-
- 坏味道重构需要立项时
|
|
18
|
-
|
|
19
|
-
请点名使用 `devbooks-proposal-author` 执行相应任务。
|
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
skill: multi-skill
|
|
3
|
-
backward-compat: true
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# /devbooks:quick
|
|
7
|
-
|
|
8
|
-
**向后兼容命令**:快速模式(小变更)。
|
|
9
|
-
|
|
10
|
-
## 用途
|
|
11
|
-
|
|
12
|
-
此命令是向后兼容命令,保持与原有 `/devbooks:quick` 调用方式一致。
|
|
13
|
-
|
|
14
|
-
适用于小型变更,跳过部分流程。
|
|
15
|
-
|
|
16
|
-
## 新版本替代方案
|
|
17
|
-
|
|
18
|
-
建议使用 Router 获取完整路由建议:
|
|
19
|
-
|
|
20
|
-
```
|
|
21
|
-
/devbooks:router
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
Router 会根据变更规模自动推荐最短路径。
|
|
25
|
-
|
|
26
|
-
## 快速模式约束
|
|
27
|
-
|
|
28
|
-
- 仅适用于单文件或少量文件变更
|
|
29
|
-
- 不涉及对外 API 变更
|
|
30
|
-
- 不涉及架构边界变更
|
|
31
|
-
- 不涉及数据模型变更
|
|
32
|
-
|
|
33
|
-
## 边界检查
|
|
34
|
-
|
|
35
|
-
如果变更超出快速模式边界,会自动建议切换到完整流程。
|
|
36
|
-
|
|
37
|
-
## 迁移说明
|
|
38
|
-
|
|
39
|
-
```
|
|
40
|
-
旧命令 新命令
|
|
41
|
-
/devbooks:quick → /devbooks:router(会自动推荐快速路径)
|
|
42
|
-
```
|