@boyingliu01/dsh-plugin-xp-gate 0.38.76 → 0.38.78

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@boyingliu01/dsh-plugin-xp-gate",
3
- "version": "0.38.76",
3
+ "version": "0.38.78",
4
4
  "description": "XP-Gate deterministic quality gates + AI workflow skills as a DeepSeek Harness (DSH) native plugin: gate-check / gate-principles / gate-arch tools + 12 SKILL.md skills",
5
5
  "type": "module",
6
6
  "main": "./lib/index.js",
@@ -3,7 +3,7 @@
3
3
  **Generated:** 2026-11-04
4
4
  **Commit:** eb2097b0
5
5
  **Branch:** sprint/2026-11-03-02
6
- **Version:** 0.38.76.0
6
+ **Version:** 0.38.78.0
7
7
 
8
8
  ## OVERVIEW
9
9
  Delphi Consensus Review — multi-round anonymous expert review (≥90% threshold, exactly 3 experts with distinct executable model IDs). Supports design, requirements, and code-walkthrough modes.
@@ -3,7 +3,7 @@
3
3
  **Generated:** 2026-11-04
4
4
  **Commit:** eb2097b0
5
5
  **Branch:** sprint/2026-11-03-02
6
- **Version:** 0.38.76.0
6
+ **Version:** 0.38.78.0
7
7
 
8
8
  ## OVERVIEW
9
9
  **6-phase** development pipeline (v2.0 compact redesign, Issue #290): PREP → DESIGN → BUILD → VERIFY → SHIP → CLOSE. Phase 3/6 BUILD default build mode is **ralph-loop** (REQ-level iteration; each REQ starts from a clean context instead of accumulating one across REQs). HARD-GATE between DESIGN (2/6) and BUILD (3/6): design must pass Delphi review (≥90% consensus) before any coding.
@@ -51,7 +51,7 @@ skill(name="grill-with-docs", user_message="[需求描述]")
51
51
  grill-with-docs 执行:
52
52
  1. **逐个追问决策树** — 每题附推荐答案;事实自行探查,决策留给用户
53
53
  2. **同步维护 CONTEXT.md** — 项目上下文沉淀(`domain-modeling` 内置)
54
- 3. **同步维护 ADR** — `docs/adr/ADR-NNNN-*.md` 架构决策记录
54
+ 3. **同步维护 ADR** — 架构决策记录,路径与命名以 `skills/domain-modeling/ADR-FORMAT.md` 为准(`docs/adr/{NNNN}-{kebab-case-title}.md`)
55
55
  4. **达成共享理解** — 需求边界、用户场景、验收标准清晰化
56
56
 
57
57
  ### Step 2: R1 需求评审(#368 恢复的第一点评审)
@@ -131,6 +131,66 @@ orchestrator 基于访谈记录 + CONTEXT.md + R1 评审结论生成设计文档
131
131
  - 收到用户 APPROVED 后,自动进入 Part B
132
132
  - 如果用户未 APPROVED,BLOCK 并等待
133
133
 
134
+ ### Step 4b: ADR 门 — 每个 sprint 都必须交付一条记录
135
+
136
+ > **为什么这一步存在**:`docs/adr/` 曾长期只有 3 份记录,而 `grill-with-docs` 有能力写
137
+ > ADR、文档也把 ADR 列在"输出"里——但**没有任何条件要求它发生**。于是它没有发生。
138
+ > 这正是 ADR-0003 记录的缺陷形态:**声明了,但没执行**。
139
+ > 清单里的一项只是建议;**完成条件**才是保证。
140
+
141
+ **这一步不要求你"判断本次 sprint 是否触碰架构"**——那种判断没有产物、无法审计,
142
+ 执行者会不自觉地答"没有",于是门形同不存在。改为:**任何 sprint 都必须写出一个文件**,
143
+ 写的是哪个由你决定,但"没写"不是选项。
144
+
145
+ **产物**:`.sprint-state/phase-outputs/phase-2-adr.json`
146
+
147
+ ```json
148
+ {
149
+ "decision": "recorded",
150
+ "adr": "docs/adr/0007-switch-to-riverpod.md",
151
+ "reason": "引入新的状态管理方案替代 provider,属于难以回退的技术选型变更;ADR 记录了被否决的选项 B/C 及理由"
152
+ }
153
+ ```
154
+
155
+ 或
156
+
157
+ ```json
158
+ {
159
+ "decision": "not_needed",
160
+ "reason": "只修改 src/gate-12 内部的条件判断,未新增或删除模块边界,未改变依赖方向,未引入或替换技术选型"
161
+ }
162
+ ```
163
+
164
+ `decision` 只允许这两个值。`reason` 在两种情况下都必填:`recorded` 时说明这条决策
165
+ **为什么值得记**,`not_needed` 时说明**凭什么判定不需要**。
166
+
167
+ **若有 ADR**:路径必须真实存在,命名遵循 `skills/domain-modeling/ADR-FORMAT.md`
168
+ (`docs/adr/{NNNN}-{kebab-case-title}.md`,`{NNNN}` 为零填充递增序号)。
169
+ 内容必须包含**决策**与**被否决的备选方案及理由**——后者是未来读者唯一无法自行重建的
170
+ 部分,也是 ADR 存在的全部价值;只写结论的 ADR 等于没有。
171
+
172
+ **哪些改动通常生成 ADR**(用于提高 `recorded` 的比例,不是豁免清单):
173
+
174
+ | 信号 | 例子 |
175
+ |---|---|
176
+ | 新增或取消模块、层边界 | 拆包、合并包、新增目录层级 |
177
+ | 改变依赖方向 | A 依赖 B 改为 B 依赖 A |
178
+ | 引入或替换关键技术选型 | 换 ORM、换构建工具、换通信协议 |
179
+ | 做出**难以回退**的决策 | 数据模型、公开 API 形状、存储格式 |
180
+ | 出现被否决的备选方案且有理由 | 选了 A 而不是 B,B 更好为什么不用 |
181
+
182
+ > 与 AGENTS.md 的 SKIP 规则同源:**"没有决策要记"与"忘了记决策"必须可区分**。
183
+ > 前者是一份带理由的 JSON,后者是该文件不存在。差别在产物上,不在措辞上。
184
+
185
+ **门禁行为**(四条都由脚本判定,不看叙述):
186
+
187
+ 1. `.sprint-state/phase-outputs/phase-2-adr.json` 不存在 → BLOCK,不可进入 Part B。
188
+ 2. `decision` 不是 `recorded` / `not_needed` 之一 → BLOCK。
189
+ 3. `reason` 为空或短于 20 字符 → BLOCK(`无`、`n/a`、`skip` 这类不算理由)。
190
+ 4. `decision` 为 `recorded` 但 `adr` 指向的文件不存在 → BLOCK。
191
+
192
+ > 第 1 条是这一步的全部要点:**门检查的是产物是否存在,不是你声称自己想过**。
193
+
134
194
  ### 暂停点
135
195
 
136
196
  | 暂停点 | 触发条件 | 用户操作 | 自动恢复条件 |
@@ -141,7 +201,7 @@ orchestrator 基于访谈记录 + CONTEXT.md + R1 评审结论生成设计文档
141
201
  ### 输出
142
202
 
143
203
  - CONTEXT.md(项目上下文沉淀)
144
- - ADR 文件(`docs/adr/ADR-NNNN-*.md`)
204
+ - ADR 文件(`docs/adr/{NNNN}-{kebab-case-title}.md`,Step 4b 的产出;若豁免则记录理由)
145
205
  - requirements-reviewed.json(`.sprint-state/phase-outputs/`)
146
206
  - Design Document(`docs/plans/YYYY-MM-DD-<topic>-design.md`)
147
207
  - 进入 Part B 自动执行(使用设计文档作为输入)
@@ -3,7 +3,7 @@
3
3
  **Generated:** 2026-11-04
4
4
  **Commit:** eb2097b0
5
5
  **Branch:** sprint/2026-11-03-02
6
- **Version:** 0.38.76.0
6
+ **Version:** 0.38.78.0
7
7
 
8
8
  ## OVERVIEW
9
9
  Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.