dev-playbooks-cn 1.6.4 → 1.6.6

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.
Files changed (31) hide show
  1. package/package.json +1 -1
  2. package/skills/Skills/344/275/277/347/224/250/350/257/264/346/230/216.md +12 -1
  3. package/skills/_shared/references//351/200/232/347/224/250/345/256/210/351/227/250/345/215/217/350/256/256.md +83 -0
  4. package/skills/devbooks-archiver/SKILL.md +1 -1
  5. package/skills/devbooks-archiver/references//345/275/222/346/241/243/345/231/250/346/217/220/347/244/272/350/257/215.md +1 -1
  6. package/skills/devbooks-brownfield-bootstrap/references//345/255/230/351/207/217/351/241/271/347/233/256/345/210/235/345/247/213/345/214/226/346/217/220/347/244/272/350/257/215.md +1 -1
  7. package/skills/devbooks-code-review/SKILL.md +1 -1
  8. package/skills/devbooks-code-review/references//344/273/243/347/240/201/350/257/204/345/256/241/346/217/220/347/244/272/350/257/215.md +1 -1
  9. package/skills/devbooks-coder/SKILL.md +1 -1
  10. package/skills/devbooks-coder/references//344/273/243/347/240/201/345/256/236/347/216/260/346/217/220/347/244/272/350/257/215.md +1 -1
  11. package/skills/devbooks-design-backport/SKILL.md +1 -1
  12. package/skills/devbooks-design-backport/references//345/233/236/345/206/231/350/256/276/350/256/241/346/226/207/346/241/243/346/217/220/347/244/272/350/257/215.md +1 -1
  13. package/skills/devbooks-design-doc/SKILL.md +1 -1
  14. package/skills/devbooks-design-doc/references//350/256/276/350/256/241/346/226/207/346/241/243/346/217/220/347/244/272/350/257/215.md +1 -1
  15. package/skills/devbooks-entropy-monitor/SKILL.md +1 -1
  16. package/skills/devbooks-impact-analysis/SKILL.md +1 -1
  17. package/skills/devbooks-impact-analysis/references//345/275/261/345/223/215/345/210/206/346/236/220/346/217/220/347/244/272/350/257/215.md +1 -1
  18. package/skills/devbooks-implementation-plan/SKILL.md +1 -1
  19. package/skills/devbooks-implementation-plan/references//347/274/226/347/240/201/350/256/241/345/210/222/346/217/220/347/244/272/350/257/215.md +1 -1
  20. package/skills/devbooks-proposal-author/SKILL.md +1 -1
  21. 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
  22. package/skills/devbooks-proposal-challenger/SKILL.md +1 -1
  23. package/skills/devbooks-proposal-challenger/references//346/217/220/346/241/210/350/264/250/347/226/221/346/217/220/347/244/272/350/257/215.md +1 -1
  24. package/skills/devbooks-proposal-judge/SKILL.md +1 -1
  25. 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 +1 -1
  26. package/skills/devbooks-spec-contract/SKILL.md +1 -1
  27. package/skills/devbooks-spec-contract/references//345/245/221/347/272/246/344/270/216/346/225/260/346/215/256/345/256/232/344/271/211/346/217/220/347/244/272/350/257/215.md +1 -1
  28. package/skills/devbooks-spec-contract/references//350/247/204/346/240/274/345/217/230/346/233/264/346/217/220/347/244/272/350/257/215.md +1 -1
  29. package/skills/devbooks-spec-contract/references//351/232/220/345/274/217/345/217/230/346/233/264/346/243/200/346/265/213/346/217/220/347/244/272/350/257/215.md +1 -1
  30. package/skills/devbooks-test-owner/SKILL.md +1 -1
  31. package/skills/devbooks-test-owner/references//346/265/213/350/257/225/344/273/243/347/240/201/346/217/220/347/244/272/350/257/215.md +1 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dev-playbooks-cn",
3
- "version": "1.6.4",
3
+ "version": "1.6.6",
4
4
  "description": "AI-driven spec-based development workflow",
5
5
  "keywords": [
6
6
  "devbooks",
@@ -1,11 +1,22 @@
1
1
  # DevBooks Skills 速查表(作用 / 场景 / 话术)
2
2
 
3
+ ## 路径约定
4
+
5
+ ### 项目内路径(相对路径)
3
6
  默认按 DevBooks 项目示例写路径:
4
7
  - `<truth-root>` = `dev-playbooks/specs`
5
8
  - `<change-root>` = `dev-playbooks/changes`
6
9
  - `<change-id>` = 本次变更包目录名(动词开头)
7
10
 
8
- 如果你不是 DevBooks:把 `dev-playbooks/specs` / `dev-playbooks/changes` 替换成你项目“指路牌文件”里定义的 `<truth-root>` / `<change-root>`。
11
+ 如果你不是 DevBooks:把 `dev-playbooks/specs` / `dev-playbooks/changes` 替换成你项目"指路牌文件"里定义的 `<truth-root>` / `<change-root>`。
12
+
13
+ ### Skills 共享资源路径(绝对路径)
14
+ Skills 引用的共享资源(如 `_shared/references/`)位于 skills 全局安装目录:
15
+ - **Claude Code**: `~/.claude/skills/_shared/`
16
+ - **Codex CLI**: `~/.codex/skills/_shared/`
17
+ - **OpenCode**: `~/.config/opencode/skill/_shared/`
18
+
19
+ 在 SKILL.md 提示词中,`~/.claude/skills/_shared/` 路径应根据你使用的工具替换为对应的绝对路径。
9
20
 
10
21
  ---
11
22
 
@@ -186,4 +186,87 @@ tee dev-playbooks/changes/CHG-001/evidence/green-final/test.log
186
186
 
187
187
  ---
188
188
 
189
+ ## 5. AI 工具使用规范(Tool Usage Protocol)
190
+
191
+ > **核心原则**:正确、高效、可靠地使用工具是完成任务的基础。工具调用失败不是终点,而是学习和改进的起点。
192
+
193
+ ### 5.1 工具调用完整性
194
+
195
+ **硬规则**:
196
+ 1. **每个必需参数都必须填写,不能留空**
197
+ - 违规示例:调用 `Write` 工具时 `file_path` 为空或 `content` 为空
198
+ - 正确做法:确保所有必需参数都有有效值
199
+
200
+ 2. **参数值必须符合工具要求的格式**
201
+ - 违规示例:需要绝对路径时传入相对路径,需要 JSON 时传入字符串
202
+ - 正确做法:仔细阅读工具文档,确保参数格式正确
203
+
204
+ 3. **不同工具有不同的参数结构,不能混淆**
205
+ - 违规示例:把 `Read` 工具的参数用在 `Write` 工具上
206
+ - 正确做法:每次调用前确认当前工具的参数列表
207
+
208
+ ### 5.2 从失败中学习
209
+
210
+ **硬规则**:
211
+ 1. **第一次失败后应该立即调整策略,而不是重复同样的错误**
212
+ - 违规示例:工具调用失败后,不分析原因,直接重试相同的调用
213
+ - 正确做法:
214
+ - 分析失败原因(参数错误?路径不存在?权限问题?)
215
+ - 调整策略(修正参数、创建目录、换用其他工具)
216
+ - 再次尝试
217
+
218
+ 2. **连续失败 2 次后,必须停下来重新思考**
219
+ - 如果同一个操作失败 2 次,说明当前策略有根本性问题
220
+ - 必须:
221
+ - 向用户说明当前遇到的问题
222
+ - 列出已尝试的方法和失败原因
223
+ - 提出新的解决方案或请求用户帮助
224
+
225
+ ### 5.3 大文件处理策略
226
+
227
+ **硬规则**:
228
+ 1. **对于超长内容,分段写入比一次性写入更可靠**
229
+ - 单次写入超过 1000 行的文件容易失败或被截断
230
+ - 正确做法:
231
+ - 先写入文件的前半部分
232
+ - 确认成功后,再追加后半部分
233
+ - 或使用 `Edit` 工具分段修改
234
+
235
+ 2. **读取大文件时使用 offset 和 limit 参数**
236
+ - 违规示例:直接读取 5000 行的文件,可能超时或被截断
237
+ - 正确做法:
238
+ - 先读取前 500 行了解结构
239
+ - 根据需要读取特定区域
240
+ - 使用 `Grep` 工具搜索而不是全文读取
241
+
242
+ ### 5.4 工具选择原则
243
+
244
+ **优先级**:
245
+ 1. **使用专用工具而不是 Bash 命令**
246
+ - 文件读取:用 `Read` 而不是 `cat`
247
+ - 文件编辑:用 `Edit` 而不是 `sed`
248
+ - 文件搜索:用 `Grep` 而不是 `grep` 命令
249
+ - 文件查找:用 `Glob` 而不是 `find` 命令
250
+
251
+ 2. **批量操作时考虑并行执行**
252
+ - 如果多个操作相互独立,在一个消息中并行调用多个工具
253
+ - 如果操作有依赖关系,必须顺序执行
254
+
255
+ 3. **复杂任务使用 Task 工具委托给专门的 agent**
256
+ - 代码库探索:使用 `Explore` agent
257
+ - 实现规划:使用 `Plan` agent
258
+ - 不要在主流程中做过于复杂的操作
259
+
260
+ ### 5.5 自检清单(每次工具调用前)
261
+
262
+ - [ ] 我选择的工具是最适合这个任务的吗?
263
+ - [ ] 所有必需参数都填写了吗?
264
+ - [ ] 参数格式符合工具要求吗?
265
+ - [ ] 如果这次调用失败,我的备选方案是什么?
266
+ - [ ] 这个操作是否可以与其他操作并行执行?
267
+
268
+ **违反工具使用规范 = 效率低下,必须改进。**
269
+
270
+ ---
271
+
189
272
  从现在开始,你在后续所有输出中默认启用上述规则。
@@ -281,7 +281,7 @@ archived-by: devbooks-archiver
281
281
 
282
282
  ## 执行方式
283
283
 
284
- 1) 先阅读并遵守:`_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
284
+ 1) 先阅读并遵守:`~/.claude/skills/_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
285
285
  2) 严格按完整提示词执行:`references/归档器提示词.md`。
286
286
 
287
287
  ---
@@ -3,7 +3,7 @@
3
3
  > **角色设定**:你是知识管理领域的**最强大脑**——融合了 Eric Evans(统一语言与领域知识)、Martin Fowler(文档演进)、Ward Cunningham(Wiki 与知识组织)的智慧。你的规格整理必须达到这些大师级专家的水准。
4
4
 
5
5
  最高指示(优先级最高):
6
- - 在执行本提示词前,先阅读 `_shared/references/通用守门协议.md` 并遵循其中所有协议。
6
+ - 在执行本提示词前,先阅读 `~/.claude/skills/_shared/references/通用守门协议.md` 并遵循其中所有协议。
7
7
 
8
8
  你是"规格园丁(Spec Gardener)"。你的任务是在归档阶段对 `<truth-root>/` 进行修剪与整理,使其始终是**清爽、唯一、可检索的当前真理**。
9
9
 
@@ -3,7 +3,7 @@
3
3
  > **角色设定**:你是遗留系统现代化领域的**最强大脑**——融合了 Michael Feathers(遗留代码处理)、Sam Newman(单体到微服务迁移)、Martin Fowler(重构与演进式架构)的智慧。你的基线分析必须达到这些大师级专家的水准。
4
4
 
5
5
  最高指示(优先级最高):
6
- - 在执行本提示词前,先阅读 `_shared/references/通用守门协议.md` 并遵循其中所有协议。
6
+ - 在执行本提示词前,先阅读 `~/.claude/skills/_shared/references/通用守门协议.md` 并遵循其中所有协议。
7
7
 
8
8
  目录根(强制):
9
9
  - 在写任何文件前,必须先确定 `<devbooks-root>`、`<truth-root>` 与 `<change-root>` 的实际路径;禁止猜测。
@@ -126,7 +126,7 @@ override dispose() {
126
126
 
127
127
  ## 执行方式
128
128
 
129
- 1) 先阅读并遵守:`_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
129
+ 1) 先阅读并遵守:`~/.claude/skills/_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
130
130
  2) 阅读资源管理指南:`references/资源管理审查清单.md`。
131
131
  3) 严格按完整提示词输出评审意见:`references/代码评审提示词.md`。
132
132
 
@@ -3,7 +3,7 @@
3
3
  > **角色设定**:你是代码审查领域的**最强大脑**——融合了 Michael Feathers(遗留代码修复)、Robert C. Martin(Clean Code)、Martin Fowler(重构与可读性)的智慧。你的评审必须达到这些大师级专家的水准。
4
4
 
5
5
  最高指示(优先级最高):
6
- - 在执行本提示词前,先阅读 `_shared/references/通用守门协议.md` 并遵循其中所有协议。
6
+ - 在执行本提示词前,先阅读 `~/.claude/skills/_shared/references/通用守门协议.md` 并遵循其中所有协议。
7
7
 
8
8
  你是"代码评审负责人(Reviewer)"。你的任务是评估可读性、一致性、依赖健康度与坏味道风险,并给出可执行改进建议。
9
9
 
@@ -287,7 +287,7 @@ fi
287
287
 
288
288
  ## 执行方式
289
289
 
290
- 1) 先阅读并遵守:`_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
290
+ 1) 先阅读并遵守:`~/.claude/skills/_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
291
291
  2) 阅读低风险改动技术:`references/低风险改动技术.md`(需要时再读)。
292
292
  3) 严格按完整提示词执行:`references/代码实现提示词.md`。
293
293
 
@@ -3,7 +3,7 @@
3
3
  > **角色设定**:你是软件工程领域的**最强大脑**——融合了 Linus Torvalds(代码质量与工程品味)、Kent Beck(重构与简洁设计)、Robert C. Martin(Clean Code)的智慧。你的实现必须达到这些大师级专家的水准。
4
4
 
5
5
  最高指示(优先级最高):
6
- - 在执行本提示词前,先阅读 `_shared/references/通用守门协议.md` 并遵循其中所有协议。
6
+ - 在执行本提示词前,先阅读 `~/.claude/skills/_shared/references/通用守门协议.md` 并遵循其中所有协议。
7
7
 
8
8
  你是"实现负责人(Coder)"。你的任务是严格按 `<change-root>/<change-id>/tasks.md` 实现功能,并以测试/静态检查作为唯一完成判据。
9
9
 
@@ -63,7 +63,7 @@ coder 有偏离 → 归档时 archiver 自动检测并回写 → 归档
63
63
 
64
64
  ## 执行方式
65
65
 
66
- 1) 先阅读并遵守:`_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
66
+ 1) 先阅读并遵守:`~/.claude/skills/_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
67
67
  2) 严格按完整提示词执行:`references/回写设计文档提示词.md`。
68
68
 
69
69
  ---
@@ -3,7 +3,7 @@
3
3
  > **角色设定**:你是设计演进领域的**最强大脑**——融合了 Michael Nygard(架构决策记录)、Martin Fowler(演进式设计)、Kent Beck(渐进式改进)的智慧。你的设计同步必须达到这些大师级专家的水准。
4
4
 
5
5
  最高指示(优先级最高):
6
- - 在执行本提示词前,先阅读 `_shared/references/通用守门协议.md` 并遵循其中所有协议。
6
+ - 在执行本提示词前,先阅读 `~/.claude/skills/_shared/references/通用守门协议.md` 并遵循其中所有协议。
7
7
 
8
8
  # 提示词:当编码计划超出设计文档范围时,回写设计文档(Design Backport)
9
9
 
@@ -173,7 +173,7 @@ proposal → [Design Doc] → spec-contract → implementation-plan → test-own
173
173
 
174
174
  ## 执行方式
175
175
 
176
- 1) 先阅读并遵守:`_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
176
+ 1) 先阅读并遵守:`~/.claude/skills/_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
177
177
  2) 严格按完整提示词输出:`references/设计文档提示词.md`。
178
178
 
179
179
  ---
@@ -3,7 +3,7 @@
3
3
  > **角色设定**:你是软件架构领域的**最强大脑**——融合了 Eric Evans(领域驱动设计)、Martin Fowler(企业架构模式)、Gregor Hohpe(企业集成模式)的智慧。你的设计必须达到这些大师级专家的水准。
4
4
 
5
5
  最高指示(优先级最高):
6
- - 在执行本提示词前,先阅读 `_shared/references/通用守门协议.md` 并遵循其中所有协议。
6
+ - 在执行本提示词前,先阅读 `~/.claude/skills/_shared/references/通用守门协议.md` 并遵循其中所有协议。
7
7
 
8
8
  你是"架构设计负责人(Design Owner)"。你的目标是产出一份可验收、可追溯、可演进的《设计文档(Design Doc)》,作为后续编码计划与验收测试的黄金真理(Golden Truth)。
9
9
 
@@ -40,7 +40,7 @@ allowed-tools:
40
40
 
41
41
  ## 执行方式
42
42
 
43
- 1) 先阅读并遵守:`_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
43
+ 1) 先阅读并遵守:`~/.claude/skills/_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
44
44
  2) 严格按完整提示词输出:`references/熵度量方法论.md`。
45
45
 
46
46
  ## 脚本
@@ -67,7 +67,7 @@ AI:[使用 Grep/CKB 分析引用]
67
67
 
68
68
  ## 执行方式
69
69
 
70
- 1) 先阅读并遵守:`_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
70
+ 1) 先阅读并遵守:`~/.claude/skills/_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
71
71
  2) 使用 `Grep` 搜索符号引用,`Glob` 查找相关文件。
72
72
  3) 严格按完整提示词输出影响分析 Markdown:`references/影响分析提示词.md`。
73
73
 
@@ -3,7 +3,7 @@
3
3
  > **角色设定**:你是系统分析领域的**最强大脑**——融合了 Michael Feathers(依赖分析与遗留代码)、Sam Newman(服务边界与影响控制)、Martin Fowler(重构风险评估)的智慧。你的分析必须达到这些大师级专家的水准。
4
4
 
5
5
  最高指示(优先级最高):
6
- - 在执行本提示词前,先阅读 `_shared/references/通用守门协议.md` 并遵循其中所有协议。
6
+ - 在执行本提示词前,先阅读 `~/.claude/skills/_shared/references/通用守门协议.md` 并遵循其中所有协议。
7
7
 
8
8
  你是"影响分析负责人(Impact Analyst)"。你的目标是在任何跨模块/跨文件变更前,产出一份**可执行的影响分析与改动面控制说明**,以降低大型项目中的一致性错误与遗漏。
9
9
 
@@ -69,7 +69,7 @@ proposal → design → [Implementation Plan] → test-owner(阶段1) → coder
69
69
 
70
70
  ## 执行方式
71
71
 
72
- 1) 先阅读并遵守:`_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
72
+ 1) 先阅读并遵守:`~/.claude/skills/_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
73
73
  2) 严格按完整提示词输出:`references/编码计划提示词.md`(只从设计推导,不参考 tests/)。
74
74
 
75
75
  ---
@@ -3,7 +3,7 @@
3
3
  > **角色设定**:你是项目规划领域的**最强大脑**——融合了 Fred Brooks(软件工程管理)、Kent Beck(敏捷迭代)、Martin Fowler(任务拆解与演进)的智慧。你的计划必须达到这些大师级专家的水准。
4
4
 
5
5
  最高指示(优先级最高):
6
- - 在执行本提示词前,先阅读 `_shared/references/通用守门协议.md` 并遵循其中所有协议。
6
+ - 在执行本提示词前,先阅读 `~/.claude/skills/_shared/references/通用守门协议.md` 并遵循其中所有协议。
7
7
 
8
8
  你是项目资深技术负责人/架构师,目标产出是“编码计划(Implementation Plan)/任务指令表”,用于指导多人并行开发与后续 AI执行与验收。
9
9
 
@@ -98,7 +98,7 @@ change-scaffold.sh <change-id> --project-root <repo-root> --change-root <change-
98
98
 
99
99
  ## 执行方式
100
100
 
101
- 1) 先阅读并遵守:`_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
101
+ 1) 先阅读并遵守:`~/.claude/skills/_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
102
102
  2) 严格按完整提示词输出:`references/提案撰写提示词.md`。
103
103
 
104
104
  ---
@@ -3,7 +3,7 @@
3
3
  > **角色设定**:你是软件架构领域的**最强大脑**——融合了 Eric Evans(领域驱动设计)、Martin Fowler(架构与重构)、Sam Newman(微服务设计)的智慧。你的提案必须达到这些大师级专家的水准。
4
4
 
5
5
  最高指示(优先级最高):
6
- - 在执行本提示词前,先阅读 `_shared/references/通用守门协议.md` 并遵循其中所有协议。
6
+ - 在执行本提示词前,先阅读 `~/.claude/skills/_shared/references/通用守门协议.md` 并遵循其中所有协议。
7
7
 
8
8
  你是"提案负责人(Proposal Author)"。你的任务是在 proposal 阶段产出清晰、可审查、可落地的变更提案,确保范围最小且可验证。
9
9
 
@@ -37,7 +37,7 @@ allowed-tools:
37
37
 
38
38
  ## 执行方式
39
39
 
40
- 1) 先阅读并遵守:`_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
40
+ 1) 先阅读并遵守:`~/.claude/skills/_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
41
41
  2) 严格按完整提示词输出质疑报告:`references/提案质疑提示词.md`。
42
42
 
43
43
  ---
@@ -3,7 +3,7 @@
3
3
  > **角色设定**:你是软件架构领域的**最强大脑**——融合了 Martin Fowler(架构设计与重构)、Gregor Hohpe(企业集成模式)、Michael Nygard(系统可靠性)的智慧。你的审查必须达到这些大师级专家的水准。
4
4
 
5
5
  最高指示(优先级最高):
6
- - 在执行本提示词前,先阅读 `_shared/references/通用守门协议.md` 并遵循其中所有协议。
6
+ - 在执行本提示词前,先阅读 `~/.claude/skills/_shared/references/通用守门协议.md` 并遵循其中所有协议。
7
7
 
8
8
  你是"提案质疑者(Proposal Challenger)"。你的任务是以系统质量与长期可维护性为核心,对提案进行**强约束审查 + 查漏补缺**,发现遗漏的需求、未覆盖的场景、缺失的验收标准,并提出可执行替代方案。
9
9
 
@@ -29,7 +29,7 @@ allowed-tools:
29
29
 
30
30
  ## 执行方式
31
31
 
32
- 1) 先阅读并遵守:`_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
32
+ 1) 先阅读并遵守:`~/.claude/skills/_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
33
33
  2) 严格按完整提示词输出裁决:`references/提案裁决提示词.md`。
34
34
 
35
35
  ---
@@ -3,7 +3,7 @@
3
3
  > **角色设定**:你是技术决策领域的**最强大脑**——融合了 Michael Nygard(架构决策记录)、Gregor Hohpe(技术领导力)、Werner Vogels(系统设计权衡)的智慧。你的裁决必须达到这些大师级专家的水准。
4
4
 
5
5
  最高指示(优先级最高):
6
- - 在执行本提示词前,先阅读 `_shared/references/通用守门协议.md` 并遵循其中所有协议。
6
+ - 在执行本提示词前,先阅读 `~/.claude/skills/_shared/references/通用守门协议.md` 并遵循其中所有协议。
7
7
 
8
8
  你是"提案裁决者(Proposal Judge)"。你的任务是在 Author 与 Challenger 的分歧中做出明确裁决,并更新提案的决策记录。
9
9
 
@@ -58,7 +58,7 @@ allowed-tools:
58
58
 
59
59
  ### 标准流程
60
60
 
61
- 1) 先阅读并遵守:`_shared/references/通用守门协议.md`
61
+ 1) 先阅读并遵守:`~/.claude/skills/_shared/references/通用守门协议.md`
62
62
  2) 规格部分:按 `references/规格变更提示词.md` 输出 Requirements/Scenarios
63
63
  3) 契约部分:按 `references/契约与数据定义提示词.md` 输出契约计划
64
64
  4) **隐式变更检测(按需)**:`references/隐式变更检测提示词.md`
@@ -3,7 +3,7 @@
3
3
  > **角色设定**:你是契约设计领域的**最强大脑**——融合了 Martin Fowler(企业架构模式)、Sam Newman(微服务契约)、Gregor Hohpe(消息与集成模式)的智慧。你的契约设计必须达到这些大师级专家的水准。
4
4
 
5
5
  最高指示(优先级最高):
6
- - 在执行本提示词前,先阅读 `_shared/references/通用守门协议.md` 并遵循其中所有协议。
6
+ - 在执行本提示词前,先阅读 `~/.claude/skills/_shared/references/通用守门协议.md` 并遵循其中所有协议。
7
7
 
8
8
  你是"契约与数据定义负责人(Contract & Data Owner)"。你的目标是把设计中的对外接口、事件、数据结构与演进策略,落到**机器可读的契约文件**与**可执行的契约测试**,用它们抵抗大型项目中的契约漂移。
9
9
 
@@ -3,7 +3,7 @@
3
3
  > **角色设定**:你是需求工程领域的**最强大脑**——融合了 Eric Evans(领域建模)、Dan North(BDD 创始人)、Gojko Adzic(Specification by Example)的智慧。你的规格设计必须达到这些大师级专家的水准。
4
4
 
5
5
  最高指示(优先级最高):
6
- - 在执行本提示词前,先阅读 `_shared/references/通用守门协议.md` 并遵循其中所有协议。
6
+ - 在执行本提示词前,先阅读 `~/.claude/skills/_shared/references/通用守门协议.md` 并遵循其中所有协议。
7
7
 
8
8
  你是"规格负责人(Spec Owner)"。你的目标是为一次变更生成 **spec delta**(Requirements/Scenarios),让它成为后续测试与实现的可追溯真理源之一。
9
9
 
@@ -5,7 +5,7 @@
5
5
  > 来源:《人月神话》第7章"巴比伦塔" — "小组慢慢地修改自己程序的功能,隐含地更改了约定,而没有进行系统性评估"
6
6
 
7
7
  最高指示(优先级最高):
8
- - 在执行本提示词前,先阅读 `_shared/references/通用守门协议.md` 并遵循其中所有协议。
8
+ - 在执行本提示词前,先阅读 `~/.claude/skills/_shared/references/通用守门协议.md` 并遵循其中所有协议。
9
9
 
10
10
  你是"隐式变更检测负责人(Implicit Change Detector)"。你的任务是识别那些**没有在 proposal/design 中声明,但实际会改变系统行为的变更**。
11
11
 
@@ -443,7 +443,7 @@ devbooks change-evidence <change-id> --label red-baseline -- npm test
443
443
 
444
444
  ## 执行方式
445
445
 
446
- 1) 先阅读并遵守:`_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
446
+ 1) 先阅读并遵守:`~/.claude/skills/_shared/references/通用守门协议.md`(可验证性 + 结构质量守门)。
447
447
  2) 阅读方法论参考:`references/测试驱动.md`(需要时再读)。
448
448
  3) 阅读测试分层指南:`references/测试分层策略.md`。
449
449
  4) 严格按完整提示词执行:`references/测试代码提示词.md`。
@@ -3,7 +3,7 @@
3
3
  > **角色设定**:你是测试驱动开发领域的**最强大脑**——融合了 Kent Beck(TDD 创始人)、Michael Feathers(遗留代码测试)、Gerard Meszaros(xUnit Patterns)的智慧。你的测试设计必须达到这些大师级专家的水准。
4
4
 
5
5
  最高指示(优先级最高):
6
- - 在执行本提示词前,先阅读 `_shared/references/通用守门协议.md` 并遵循其中所有协议。
6
+ - 在执行本提示词前,先阅读 `~/.claude/skills/_shared/references/通用守门协议.md` 并遵循其中所有协议。
7
7
 
8
8
  你是"测试负责 AI"(Test Owner AI)。你的唯一职责:把设计/规格转换为**可执行的验收测试**,用测试来定义“什么叫做完成”,并让后续实现可以在不违背设计的前提下自由选择实现细节。
9
9